Hexo + VPS(主站)+ GitHub Pages(从站)双部署零基础完全指南
✅ 适用人群:完全零基础小白,不需要任何编程或Linux基础
✅ 操作系统:本地Windows 10,VPS系统Ubuntu 22.04 LTS
✅ 最终效果:一条命令同时部署到两个服务器,VPS为主访问站、GitHub为备份站,任意一边宕机不影响另一边
✅ 博客主题:Material Design 风格 indigo 主题
📌 开始前准备清单
在正式开始前,请先确认你已经准备好以下东西:
| 物品 | 说明 | 必须? |
|---|---|---|
| 一台Win10电脑 | 可以正常上网 | ✅ 必须 |
| 一个VPS服务器 | Ubuntu 22.04 LTS系统,有公网IP、能SSH连接 | ✅ 必须 |
| VPS的IP地址、root密码 | 购买VPS时服务商发给你的信息 | ✅ 必须 |
| 一个GitHub账号 | 免费注册即可 | ✅ 必须 |
| 一个域名(可选) | 没有域名可以直接用IP访问,不影响功能 | ⭕ 可选 |
| 连接VPS的工具 | 推荐免费软件 FinalShell,系统自带cmd也可以 | ✅ 必须 |
💡 如果你还不会连接VPS:先下载安装FinalShell,打开后点击左上角文件夹→新建连接,输入名称、主机(VPS的IP)、端口(默认22)、用户名(root)、密码,确定后双击连接即可,看到黑色终端界面就是连上了。
第一阶段:本地Win10环境安装
步骤1.1:安装Git
操作位置:你的Win10电脑,用浏览器操作
- 打开浏览器,访问Git官网下载页:https://git-scm.com/download/win
- 页面会自动识别系统,点击 "Click here to download" 开始下载(文件约50MB)
- 下载完成后双击安装包,打开安装向导:
- 第一步点击 Next
- 安装路径默认即可(
C:\Program Files\Git),点击Next - 接下来所有页面全部保持默认选项,一直点Next,直到最后一页
- 最后点击 Install 等待安装完成
- 安装完成后点击Finish
✅ 验证是否安装成功:
- 按键盘
Win + R,弹出运行框 - 输入
cmd,按回车,打开黑色的命令提示符窗口 - 在窗口中输入以下命令,按回车:
git --version - 如果显示类似
git version 2.43.0.windows.1的版本号信息,说明安装成功! - 如果提示"不是内部或外部命令",请重启电脑再试,还是不行就重新安装Git。
步骤1.2:安装Node.js(Hexo运行环境)
⚠️ 特别提醒:indigo主题是比较经典的老主题,不要安装最新的Node.js 20/22版本,会出现兼容性报错!我们安装稳定的Node.js 18.x LTS版本。
操作位置:你的Win10电脑,浏览器+命令提示符
- 打开浏览器访问Node.js历史版本下载页:https://nodejs.org/dist/v18.20.4/
- 在列表中找到
node-v18.20.4-x64.msi,点击下载(适用于64位Win10) - 下载完成后双击安装包打开:
- 勾选 "I accept the terms in the License Agreement",点击Next
- 安装路径默认即可(
C:\Program Files\nodejs\),点击Next - 接下来所有页面保持默认,一路Next,最后点击Install
- 等待安装完成,点击Finish
✅ 验证是否安装成功:
- 关闭之前打开的所有cmd窗口,重新打开一个新的cmd窗口(这一步很重要!否则找不到命令)
- 依次输入以下两个命令,每个输完按回车:
node -v npm -v - 如果分别显示:
v18.20.4(Node版本)10.x.x类似的数字(npm版本)
说明安装成功!
(推荐)配置国内镜像加速:
因为npm默认服务器在国外,下载插件很慢,我们换成国内淘宝镜像,在cmd中输入:
npm config set registry https://registry.npmmirror.com
执行完没有任何提示就是成功了。
步骤1.3:安装Hexo命令行工具
操作位置:Win10命令提示符(cmd)
在cmd窗口中输入以下命令,按回车执行:
npm install -g [email protected]
等待1-3分钟,会显示很多下载安装信息,滚动完成后回到命令行提示符就是安装完了。
✅ 验证安装成功:
在cmd中输入:
hexo -v
如果显示hexo-cli版本以及一堆依赖信息,说明Hexo安装成功!
第二阶段:本地创建博客并安装indigo主题
步骤2.1:选择博客存放位置,初始化博客
操作位置:Win10命令提示符(cmd)
我们把博客放在D盘根目录,方便后续查找。
- 在cmd中依次输入以下命令,每输完一行按一次回车:
# 切换到D盘 d: # 初始化博客,文件夹名称叫blog hexo init blog # 进入blog文件夹 cd blog # 安装博客依赖 npm install
💡 命令说明:
d:是切换到D盘,如果你想放其他盘就换成对应的盘符,比如e:hexo init blog会自动创建blog文件夹,并下载Hexo基础文件npm install安装Hexo运行需要的依赖包,需要等1-2分钟
执行完成后,打开D盘,你会看到多了一个 blog文件夹,里面有很多文件,说明初始化成功。
步骤2.2:本地预览默认博客
我们先测试一下Hexo能不能正常运行:
- 在cmd中(当前已经在D:\blog目录下)输入:
hexo clean && hexo g && hexo s - 等待几秒,显示
INFO Hexo is running at http://localhost:4000/就是启动成功了 - 打开浏览器,地址栏输入
http://localhost:4000,按回车 - 你会看到Hexo默认的Hello World页面,说明博客基础环境正常!
- 停止服务:回到cmd窗口,按
Ctrl + C,会提示"终止批处理操作吗(Y/N)?",输入Y按回车,就停止了本地预览服务。
步骤2.3:下载安装indigo主题
操作位置:Win10命令提示符(cmd,当前在D:\blog目录)
-
执行命令克隆主题文件:
git clone -b master https://github.com/yscoder/hexo-theme-indigo.git themes/indigo等待下载完成,进度到100%就好了。
-
安装indigo主题必须的依赖插件:
npm install [email protected] [email protected] [email protected] [email protected] [email protected] --save各插件作用:
- hexo-renderer-less:indigo用less语法写样式,必须装这个才能正常显示CSS样式
- hexo-generator-feed:生成RSS订阅文件
- hexo-generator-json-content:生成站内搜索需要的数据源
- hexo-helper-qrcode:文章分享二维码功能
- hexo-deployer-git:Git自动部署插件,后面一键部署必须用
等待安装完成,没有红色error报错就是成功。
步骤2.4:修改站点配置,启用indigo主题
Hexo有两个配置文件,我们现在改的是站点根目录的配置文件,不是主题目录里的。
- 打开D盘的blog文件夹,找到根目录下的
_config.yml文件 - 右键点击这个文件,选择"打开方式"→用记事本或者Notepad++打开(推荐Notepad++,不会改坏格式)
- 找到大概第90行左右的
theme: landscape这一行,把landscape改成indigo,改成:theme: indigo - 顺便找到文件开头部分,修改成你自己的博客信息(这部分是自定义的,你可以随便写):
title: 我的个人博客 subtitle: '记录技术与生活' description: '一个使用Hexo+indigo主题搭建的博客' keywords: 博客,编程,生活 author: 你的名字 language: zh-CN timezone: Asia/Shanghai - 按
Ctrl+S保存文件,然后关闭编辑器。
⚠️ 注意!YAML文件格式要求非常严格:冒号后面必须有一个空格,比如
title: 我的博客,不能写成title:我的博客,否则会报错!
步骤2.5:创建标签页和分类页
indigo主题需要标签和分类页面,我们手动创建一下:
-
回到cmd窗口(当前在D:\blog目录),执行:
hexo new page tags hexo new page categories执行完会提示
INFO Created: .../source/tags/index.md和对应的categories文件。 -
打开
D:\blog\source\tags\index.md文件,把里面的内容全部删除,替换成下面的内容:--- title: 标签 date: 2026-01-01 00:00:00 layout: tags comments: false ---保存关闭。
-
打开
D:\blog\source\categories\index.md文件,把内容全部删除,替换成:--- title: 分类 date: 2026-01-01 00:00:00 layout: categories comments: false ---保存关闭。
步骤2.6:预览indigo主题效果
再次启动本地预览,看看主题有没有正常显示:
- 在cmd中执行:
hexo clean && hexo g && hexo s - 浏览器打开
http://localhost:4000 - 现在你应该看到蓝色Material Design风格的博客界面,左侧是导航栏,有首页、归档、标签等按钮,说明主题安装成功!
- 如果页面样式乱了、没有颜色、全是文字,说明hexo-renderer-less插件没装好,回到步骤2.3重新安装一遍插件。
- 确认没问题后,按
Ctrl+C输入Y停止服务。
第三阶段:配置GitHub Pages从站(备份)
步骤3.1:注册GitHub账号
- 打开浏览器访问:https://github.com
- 点击右上角Sign up,按照提示注册账号:
- 输入你的邮箱
- 设置密码
- 设置用户名(这个用户名非常重要,后面你的从站地址就是 用户名.github.io,建议用简单好记的英文字母)
- 完成人机验证,注册成功
步骤3.2:生成SSH密钥,配置免密连接
SSH密钥相当于你电脑的身份证,配置之后,你往GitHub推送代码就不用每次输密码了。
在本地Win10的cmd中执行:
-
输入以下命令(把里面的邮箱换成你注册GitHub用的邮箱),按回车:
ssh-keygen -t rsa -C "你注册GitHub的邮箱@xxx.com" -
接下来会连续问你三个问题,什么都不用输入,直接按三次回车:
- 第一次问你密钥保存位置:直接回车,用默认位置
- 第二次问你设置密码:直接回车,不设密码
- 第三次确认密码:直接回车
-
执行完成后,密钥已经生成好了,位置在:
C:\Users\你的电脑用户名\.ssh\id_rsa:私钥,保存在你自己电脑上,绝对不能给别人看id_rsa.pub:公钥,这个要上传到GitHub和VPS
-
查看并复制公钥内容,在cmd中输入:
cat ~/.ssh/id_rsa.pub会输出一长串内容,从
ssh-rsa开头,到你的邮箱结尾。用鼠标选中全部内容,右键点击复制(或者按Ctrl+Insert复制)。
步骤3.3:把公钥添加到GitHub账号
- 登录GitHub,点击右上角你的头像→选择Settings
- 在左侧菜单栏找到 SSH and GPG keys(在Access分类下面)
- 点击右上角绿色的 New SSH key 按钮
- 填写:
- Title:随便写,比如"我的Win10电脑",只是个标记
- Key type:保持默认 Authentication Key
- Key:把刚才复制的公钥内容完整粘贴进去(一个字符都不要漏,也不要多空格)
- 点击绿色的 Add SSH key 按钮,可能需要你输入GitHub密码确认。
✅ 测试连接是否成功:
在cmd中输入:
ssh -T [email protected]
第一次连接会问你 Are you sure you want to continue connecting?,输入 yes按回车。
如果显示 Hi 你的用户名! You've successfully authenticated, but GitHub does not provide shell access.,说明配置成功!
步骤3.4:创建GitHub Pages仓库
- 登录GitHub,点击右上角的 + 号→选择New repository(新建仓库)
- 填写仓库信息:
- Repository name(仓库名):这里必须填
你的用户名.github.io- 举个例子:如果你的GitHub用户名是
zhangsan,就填zhangsan.github.io - ❌ 不能填别的名字!否则GitHub Pages无法访问!
- 举个例子:如果你的GitHub用户名是
- Description:随便写,比如"My Hexo Blog"
- 选择 Public(公开仓库,免费用户必须选公开才能用Pages)
- 不要勾选 "Add a README file"、"Add .gitignore"、"Choose a license"这三个选项,保持空
- Repository name(仓库名):这里必须填
- 点击最下面绿色的 Create repository 按钮,仓库就创建好了。
这个仓库就是后面存放我们从站静态文件的地方,暂时先放着,后面配置部署的时候再用。
第四阶段:配置Ubuntu VPS主站(核心部分)
接下来所有命令都是在你的VPS终端里执行的,用FinalShell或者cmd连接上VPS,用root用户登录。
每输完一条命令按回车,等执行完再输入下一条。
步骤4.1:连接VPS,更新系统,安装基础软件
用FinalShell连接你的VPS,登录成功后看到root@xxx:~# 提示符,开始执行命令:
-
先更新系统软件包列表并升级已安装软件:
apt update && apt upgrade -y第一次执行可能需要等几分钟,滚动完回到命令提示符就是完成了。如果中间弹出对话框问你要不要重启服务,直接按回车确认即可。
-
安装需要用到的软件:Nginx(Web服务器)、Git、防火墙ufw、curl:
apt install -y nginx git curl ufw等待安装完成。
-
启动Nginx并设置开机自动启动:
systemctl start nginx systemctl enable nginx
✅ 验证Nginx是否正常运行:
打开你本地电脑的浏览器,地址栏输入 http://你的VPS公网IP,按回车。
如果能看到"Welcome to nginx!"的默认欢迎页面,说明Nginx安装成功了!
步骤4.2:创建专门用于部署的git用户
出于安全考虑,我们不用root用户直接部署博客,创建一个单独的git用户来做部署操作:
-
创建git用户并设置密码:
adduser git- 会提示你输入密码:自己设置一个密码,输入两遍(输入的时候屏幕不会显示,是正常的,输完按回车就行)
- 接下来会问你Full Name、Room Number等信息,全部直接按回车跳过即可,最后问你Is the information correct? 输入
Y按回车。
-
给git用户添加sudo权限,方便后面操作:
usermod -aG sudo git
步骤4.3:配置VPS的SSH免密登录
和GitHub一样,我们需要让本地电脑能免密码连接VPS的git用户,这样部署的时候不用输密码。
所有命令都在VPS终端中执行:
-
切换到git用户:
su - git你会发现命令提示符从
root@xxx变成了git@xxx,说明切换成功了。 -
创建.ssh目录并设置正确的权限:
mkdir -p ~/.ssh chmod 700 ~/.ssh touch ~/.ssh/authorized_keys chmod 600 ~/.ssh/authorized_keys这些命令没有任何提示就是执行成功了。
-
打开authorized_keys文件,把你本地电脑的公钥粘贴进去:
nano ~/.ssh/authorized_keys- 会打开nano编辑器,现在是空白的
- 右键点击编辑器窗口,选择粘贴,把之前复制的id_rsa.pub公钥内容完整粘贴进去
- 粘贴完成后,按键盘
Ctrl + O(字母O,不是零),底部会提示File Name to Write,直接按回车确认保存 - 按
Ctrl + X退出编辑器
-
退出git用户,回到root:
exit
✅ 在本地Win10电脑测试免密登录是否成功:
打开本地cmd窗口,输入:
ssh git@你的VPS_IP
- 第一次连接会问你
Are you sure you want to continue connecting?,输入yes按回车 - 如果不需要输入密码,直接登录进去,看到git@xxx的提示符,说明配置成功!
- 输入
exit退出VPS连接,回到本地cmd。
步骤4.4:创建网站根目录和Git裸仓库
我们需要两个目录:
/var/www/hexo:存放博客静态网页文件,Nginx从这里读文件给访客看/var/repo/hexo.git:Git裸仓库,用来接收本地电脑推送上来的文件
回到VPS的root终端执行:
-
创建网站根目录,并设置权限给git用户:
mkdir -p /var/www/hexo chown -R git:git /var/www/hexo chmod -R 755 /var/www/hexo -
创建Git裸仓库目录:
mkdir -p /var/repo cd /var/repo git init --bare hexo.git显示
Initialized empty Git repository in /var/repo/hexo.git/就是成功了。 -
给仓库设置正确的权限,让git用户可以读写:
chown -R git:git hexo.git chmod -R 755 hexo.git
步骤4.5:配置Git自动部署钩子(最关键一步!)
钩子的作用是:当你在本地执行 hexo d推送文件到VPS的Git仓库时,Git会自动把静态网页文件复制到Nginx的网站目录 /var/www/hexo,不需要你手动操作。
在VPS的root终端执行:
-
编辑post-receive钩子文件:
nano /var/repo/hexo.git/hooks/post-receive -
编辑器打开后,完整复制下面的内容,右键粘贴进去:
#!/bin/bash GIT_REPO=/var/repo/hexo.git TMP_GIT_CLONE=/tmp/hexo_temp PUBLIC_WWW=/var/www/hexo # 清理临时目录 rm -rf ${TMP_GIT_CLONE} # 把最新的代码克隆到临时目录 git clone ${GIT_REPO} ${TMP_GIT_CLONE} # 清空网站目录里的旧文件 rm -rf ${PUBLIC_WWW}/* # 把新的静态文件复制到网站根目录 cp -rf ${TMP_GIT_CLONE}/* ${PUBLIC_WWW}/ # 清理临时文件 rm -rf ${TMP_GIT_CLONE} echo "=== 博客部署成功! ===" -
按
Ctrl+O→ 回车保存,按Ctrl+X退出编辑器。 -
给钩子文件添加可执行权限,并设置所有者为git用户:
chmod +x /var/repo/hexo.git/hooks/post-receive chown git:git /var/repo/hexo.git/hooks/post-receive
步骤4.6:配置Nginx网站
现在告诉Nginx我们的网站在哪里,怎么访问。
-
创建站点配置文件:
nano /etc/nginx/sites-available/hexo -
编辑器打开后,粘贴下面的内容:
server { listen 80 default_server; listen [::]:80 default_server; # 这里填你的域名,没有域名就填你的VPS公网IP地址 server_name 这里替换成你的VPS_IP或者你的域名; # 网站根目录,就是我们之前创建的/var/www/hexo root /var/www/hexo; index index.html index.htm; # 访问日志和错误日志位置 access_log /var/log/nginx/hexo_access.log; error_log /var/log/nginx/hexo_error.log; location / { # 尝试访问文件,找不到返回404 try_files $uri $uri/ =404; } # 静态资源缓存,加快访问速度 location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ { expires 30d; add_header Cache-Control "public, immutable"; } } -
⚠️ 一定要修改:把
server_name 这里替换成你的VPS_IP或者你的域名;这一行,把中文替换成你自己的VPS公网IP。比如你的IP是123.45.67.89,就改成:server_name 123.45.67.89; -
按
Ctrl+O→ 回车保存,按Ctrl+X退出编辑器。 -
启用这个站点:建立软链接到sites-enabled目录:
ln -s /etc/nginx/sites-available/hexo /etc/nginx/sites-enabled/ -
删除Nginx默认的站点配置,避免冲突:
rm -f /etc/nginx/sites-enabled/default -
测试Nginx配置是否正确:
nginx -t✅ 如果显示:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful说明配置没有问题!如果有error,回去检查刚才粘贴的配置有没有写错。
-
重启Nginx让配置生效:
systemctl restart nginx
步骤4.7:配置防火墙,允许网站访问
Ubuntu默认有ufw防火墙,我们需要放开HTTP和HTTPS端口,否则外面访问不到:
-
依次执行以下命令:
# 允许SSH连接(必须!否则你会被关在VPS外面!) ufw allow OpenSSH # 允许Nginx的HTTP和HTTPS ufw allow 'Nginx Full' # 启用防火墙 ufw --force enable -
查看防火墙状态确认:
ufw status✅ 看到80/tcp和443/tcp是ALLOW状态就可以了。
第五阶段:配置Hexo一键双部署
现在回到你本地Win10电脑,打开D:\blog目录下的站点配置文件 _config.yml,我们配置自动同时部署到VPS和GitHub两个地方。
步骤5.1:修改deploy配置
- 用记事本/Notepad++打开
D:\_config.yml - 滚动到文件最底部,找到
deploy:这一部分(如果没有就自己在最后加) - 把原来的内容删掉,替换成下面的内容:
deploy:
type: git
repo:
# VPS主站配置:把下面的"你的VPS_IP"换成你真实的VPS公网IP
vps: git@你的VPS_IP:/var/repo/hexo.git,master
# GitHub从站配置:把"你的GitHub用户名"换成你真实的GitHub用户名
github: [email protected]:你的GitHub用户名/你的GitHub用户名.github.io.git,main
# 部署时自动填写提交信息,不用改
message: "Site updated: {{ now('yyyy-MM-dd HH:mm:ss') }}"
⚠️ 这里一定要替换成你自己的信息!举个例子:
- 假设你的VPS IP是
123.45.67.89 - GitHub用户名是
zhangsan - 那么配置应该是这样:
vps: [email protected]:/var/repo/hexo.git,master github: [email protected]:zhangsan/zhangsan.github.io.git,main
- 按
Ctrl+S保存文件,关闭编辑器。
第六阶段:第一次部署!见证成果
激动人心的时刻到了!我们执行第一次部署,把博客同时发到VPS和GitHub。
步骤6.1:执行部署命令
回到本地Win10的cmd窗口,当前在 D:\blog目录下,执行:
hexo clean && hexo g -d
这个命令会自动做三件事:
hexo clean:清理之前生成的旧缓存和旧文件hexo g(generate):根据你的文章和主题,重新生成所有静态网页文件hexo d(deploy):自动把生成的文件通过Git同时推送到VPS主站和GitHub从站
等待命令执行完成,你会看到终端输出:
- 先是一堆文件生成的信息
- 然后是两次git push的过程,分别推送到vps和github
- 最后显示
INFO Deploy done: git就是部署成功了!
步骤6.2:访问VPS主站测试
打开浏览器,地址栏输入 http://你的VPS_IP,按回车。
✅ 你应该能看到和本地预览一模一样的indigo主题博客!这说明VPS主站部署成功了!
如果访问显示403 Forbidden:回到VPS执行
chown -R git:git /var/www/hexo && chmod -R 755 /var/www/hexo,然后刷新浏览器。
步骤6.3:开启GitHub Pages并测试从站
第一次部署到GitHub后,需要手动开启Pages功能:
- 浏览器登录GitHub,打开你之前创建的
用户名.github.io仓库 - 点击仓库顶部的 Settings 标签
- 在左侧菜单找到 Pages(在Code and automation分类下面)
- 在Source部分:
- Source选择 Deploy from a branch
- Branch下拉框,第一个选 main,第二个选 / (root)
- 点击 Save 按钮
- 页面上方会提示"Your site is ready to be published at https://用户名.github.io/",等待1-2分钟让GitHub生效
然后访问 https://你的用户名.github.io,你会看到一模一样的博客!说明GitHub从站备份也成功了!
🎉 恭喜你!双部署已经全部完成!
📖 日常使用指南
写新文章并发布
- 打开cmd,进入D:\blog目录
- 执行命令新建文章:
hexo new "我的第一篇文章" - 打开
D:\blog\source\_posts\文件夹,找到我的第一篇文章.md文件,用Markdown编辑器(推荐Typora、VS Code,或者直接用记事本)编辑内容,写完保存。 - 执行一键部署命令:
hexo clean && hexo g -d - 等几十秒部署完成,刷新你的博客网站就能看到新文章了,VPS和GitHub两边会同时更新。
Hexo常用命令速查表
| 命令 | 作用 | 使用频率 |
|---|---|---|
hexo n "文章标题" |
新建一篇文章 | 很常用 |
hexo new page "页面名" |
新建独立页面(比如关于我) | 偶尔用 |
hexo clean |
清理缓存和旧的生成文件 | 每次部署前用 |
hexo g |
生成静态网页文件到public目录 | 每次部署前用 |
hexo s |
启动本地预览服务,localhost:4000查看 | 写文章时预览用 |
hexo d |
部署到VPS和GitHub | 写完发布用 |
hexo clean && hexo g -d |
一键清理+生成+部署(最常用) | 每次发文章直接用这个 |
🎨 indigo主题基础个性化配置
主题的配置文件在 D:\blog\themes\indigo\_config.yml,你可以根据自己的喜好修改:
-
修改头像:
- 把你的头像图片命名为
avatar.jpg,放到themes/indigo/source/img/文件夹,替换原来的文件即可
- 把你的头像图片命名为
-
修改顶部背景图:
- 替换
themes/indigo/source/img/brand.jpg文件就是顶部背景图
- 替换
-
修改导航菜单:
- 打开主题配置文件,找到menu部分,可以添加或修改导航链接
-
添加社交链接:
- 找到social部分,填写你的GitHub主页、邮箱、微博等链接
-
配置评论系统:
- indigo默认支持Valine评论,注册一个LeanCloud账号,把appId和appKey填到配置文件的valine部分即可
-
配置站点统计:
- 可以填百度统计或者Google Analytics的ID,查看网站访问数据
⚠️ 注意:修改主题配置文件后,需要重新执行
hexo clean && hexo g才能生效,本地预览看没问题了再部署。
❓ 常见问题排查(遇到问题先看这里!)
问题1:部署时提示 Permission denied (publickey,password)
原因:SSH密钥配置不对,本地电脑连不上VPS或GitHub。
解决方法:
- 测试本地能不能免密连GitHub:
ssh -T [email protected],失败就重新配置GitHub的SSH密钥 - 测试本地能不能免密连VPS:
ssh git@你的VPS_IP,失败就检查VPS上git用户的authorized_keys里的公钥是不是粘贴正确了,有没有多换行或者少字符 - 确认VPS上/var/repo和/var/www/hexo的所有者都是git用户,执行:
chown -R git:git /var/repo /var/www/hexo
问题2:访问VPSIP显示403 Forbidden
原因:网站目录权限不对,或者目录里没有index.html文件
解决方法:
- 在VPS执行:
ls /var/www/hexo,看看有没有index.html文件 - 如果没有,说明部署钩子没执行成功,检查post-receive文件有没有加执行权限,路径对不对
- 如果有文件,执行:
chown -R git:git /var/www/hexo && chmod -R 755 /var/www/hexo,然后刷新浏览器 - 重启Nginx:
systemctl restart nginx
问题3:indigo主题样式错乱、没有颜色、排版乱了
原因:less渲染插件没装好
解决方法:
- 在本地博客目录重新安装:
npm install [email protected] --save - 执行
hexo clean,再重新生成预览
问题4:GitHub Pages访问404
原因:要么仓库名不对,要么Pages没开对分支
解决方法:
- 确认仓库名严格是
你的用户名.github.io,一个字符都不能错,包括大小写 - 去Settings→Pages里确认分支选的是main,根目录/root
- 第一次开启Pages需要等1-3分钟才能生效,耐心等一会再刷新
- 如果还是不行,去仓库的Actions标签看看部署有没有报错
问题5:hexo命令提示"不是内部或外部命令"
原因:Node.js安装后环境变量没生效
解决方法:
- 关闭所有cmd窗口,重新打开一个新的cmd再试
- 还是不行就重启电脑
- 重启还不行就重新安装Node.js 18版本
问题6:部署到VPS后网页还是旧的、不更新
原因:Nginx缓存,或者浏览器缓存
解决方法:
- VPS上重启Nginx:
systemctl restart nginx - 浏览器按
Ctrl+F5强制刷新页面(跳过缓存) - 确认/var/www/hexo目录里的文件是最新修改时间
🔄 主从切换方法
如果你的VPS需要重启、维护、或者暂时出问题,你只需要:
- 把你的域名DNS解析记录,从VPS的IP改成GitHub Pages的地址(GitHub Pages可以绑定自定义域名)
- 等DNS生效后,访客就会访问GitHub上的备份站,内容完全一样
- 等VPS恢复后,再把DNS解析改回VPS的IP即可,访客完全无感知
两边的文件是完全同步的,每次部署两边同时更新,不用担心数据不一致。
💾 博客备份建议
你的整个博客源文件都在本地D:\blog目录下,建议你:
- 定期把整个blog文件夹打包备份到网盘或者其他地方
- 或者在GitHub上新建一个私有仓库,把整个blog源文件也推上去备份,这样即使本地电脑坏了,源文件也不会丢
- VPS和GitHub上只有生成后的静态网页,没有你的Markdown源文件和配置,所以本地的源文件一定要备份好!
🎉 至此,整个双部署博客就搭建完成了!你已经拥有了一个完全属于自己的、双备份的个人博客。开始你的写作之旅吧!
评论区