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电脑,用浏览器操作

  1. 打开浏览器,访问Git官网下载页:https://git-scm.com/download/win
  2. 页面会自动识别系统,点击 "Click here to download" 开始下载(文件约50MB)
  3. 下载完成后双击安装包,打开安装向导:
    • 第一步点击 Next
    • 安装路径默认即可(C:\Program Files\Git),点击Next
    • 接下来所有页面全部保持默认选项,一直点Next,直到最后一页
    • 最后点击 Install 等待安装完成
    • 安装完成后点击Finish

✅ 验证是否安装成功:

  1. 按键盘 Win + R,弹出运行框
  2. 输入 cmd,按回车,打开黑色的命令提示符窗口
  3. 在窗口中输入以下命令,按回车:
    git --version
    
  4. 如果显示类似 git version 2.43.0.windows.1 的版本号信息,说明安装成功!
  5. 如果提示"不是内部或外部命令",请重启电脑再试,还是不行就重新安装Git。

步骤1.2:安装Node.js(Hexo运行环境)

⚠️ 特别提醒:indigo主题是比较经典的老主题,不要安装最新的Node.js 20/22版本,会出现兼容性报错!我们安装稳定的Node.js 18.x LTS版本。

操作位置:你的Win10电脑,浏览器+命令提示符

  1. 打开浏览器访问Node.js历史版本下载页:https://nodejs.org/dist/v18.20.4/
  2. 在列表中找到 node-v18.20.4-x64.msi,点击下载(适用于64位Win10)
  3. 下载完成后双击安装包打开:
    • 勾选 "I accept the terms in the License Agreement",点击Next
    • 安装路径默认即可(C:\Program Files\nodejs\),点击Next
    • 接下来所有页面保持默认,一路Next,最后点击Install
    • 等待安装完成,点击Finish

✅ 验证是否安装成功:

  1. 关闭之前打开的所有cmd窗口,重新打开一个新的cmd窗口(这一步很重要!否则找不到命令)
  2. 依次输入以下两个命令,每个输完按回车:
    node -v
    npm -v
    
  3. 如果分别显示:
    • 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盘根目录,方便后续查找。

  1. 在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能不能正常运行:

  1. 在cmd中(当前已经在D:\blog目录下)输入:
    hexo clean && hexo g && hexo s
    
  2. 等待几秒,显示 INFO Hexo is running at http://localhost:4000/ 就是启动成功了
  3. 打开浏览器,地址栏输入 http://localhost:4000,按回车
  4. 你会看到Hexo默认的Hello World页面,说明博客基础环境正常!
  5. 停止服务:回到cmd窗口,按 Ctrl + C,会提示"终止批处理操作吗(Y/N)?",输入 Y按回车,就停止了本地预览服务。

步骤2.3:下载安装indigo主题

操作位置:Win10命令提示符(cmd,当前在D:\blog目录)

  1. 执行命令克隆主题文件:

    git clone -b master https://github.com/yscoder/hexo-theme-indigo.git themes/indigo
    

    等待下载完成,进度到100%就好了。

  2. 安装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有两个配置文件,我们现在改的是站点根目录的配置文件,不是主题目录里的。

  1. 打开D盘的blog文件夹,找到根目录下的 _config.yml 文件
  2. 右键点击这个文件,选择"打开方式"→用记事本或者Notepad++打开(推荐Notepad++,不会改坏格式)
  3. 找到大概第90行左右的 theme: landscape 这一行,把 landscape改成 indigo,改成:
    theme: indigo
    
  4. 顺便找到文件开头部分,修改成你自己的博客信息(这部分是自定义的,你可以随便写):
    title: 我的个人博客
    subtitle: '记录技术与生活'
    description: '一个使用Hexo+indigo主题搭建的博客'
    keywords: 博客,编程,生活
    author: 你的名字
    language: zh-CN
    timezone: Asia/Shanghai
    
  5. 按 Ctrl+S 保存文件,然后关闭编辑器。

⚠️ 注意!YAML文件格式要求非常严格:冒号后面必须有一个空格,比如 title: 我的博客,不能写成 title:我的博客,否则会报错!


步骤2.5:创建标签页和分类页

indigo主题需要标签和分类页面,我们手动创建一下:

  1. 回到cmd窗口(当前在D:\blog目录),执行:

    hexo new page tags
    hexo new page categories
    

    执行完会提示 INFO Created: .../source/tags/index.md 和对应的categories文件。

  2. 打开 D:\blog\source\tags\index.md 文件,把里面的内容全部删除,替换成下面的内容:

    ---
    title: 标签
    date: 2026-01-01 00:00:00
    layout: tags
    comments: false
    ---
    

    保存关闭。

  3. 打开 D:\blog\source\categories\index.md 文件,把内容全部删除,替换成:

    ---
    title: 分类
    date: 2026-01-01 00:00:00
    layout: categories
    comments: false
    ---
    

    保存关闭。


步骤2.6:预览indigo主题效果

再次启动本地预览,看看主题有没有正常显示:

  1. 在cmd中执行:
    hexo clean && hexo g && hexo s
    
  2. 浏览器打开 http://localhost:4000
  3. 现在你应该看到蓝色Material Design风格的博客界面,左侧是导航栏,有首页、归档、标签等按钮,说明主题安装成功!
  4. 如果页面样式乱了、没有颜色、全是文字,说明hexo-renderer-less插件没装好,回到步骤2.3重新安装一遍插件。
  5. 确认没问题后,按 Ctrl+C输入Y停止服务。

第三阶段:配置GitHub Pages从站(备份)

步骤3.1:注册GitHub账号

  1. 打开浏览器访问:https://github.com
  2. 点击右上角Sign up,按照提示注册账号:
    • 输入你的邮箱
    • 设置密码
    • 设置用户名(这个用户名非常重要,后面你的从站地址就是 用户名.github.io,建议用简单好记的英文字母)
    • 完成人机验证,注册成功

步骤3.2:生成SSH密钥,配置免密连接

SSH密钥相当于你电脑的身份证,配置之后,你往GitHub推送代码就不用每次输密码了。

在本地Win10的cmd中执行:

  1. 输入以下命令(把里面的邮箱换成你注册GitHub用的邮箱),按回车:

    ssh-keygen -t rsa -C "你注册GitHub的邮箱@xxx.com"
    
  2. 接下来会连续问你三个问题,什么都不用输入,直接按三次回车:

    • 第一次问你密钥保存位置:直接回车,用默认位置
    • 第二次问你设置密码:直接回车,不设密码
    • 第三次确认密码:直接回车
  3. 执行完成后,密钥已经生成好了,位置在:C:\Users\你的电脑用户名\.ssh\

    • id_rsa:私钥,保存在你自己电脑上,绝对不能给别人看
    • id_rsa.pub:公钥,这个要上传到GitHub和VPS
  4. 查看并复制公钥内容,在cmd中输入:

    cat ~/.ssh/id_rsa.pub
    

    会输出一长串内容,从 ssh-rsa开头,到你的邮箱结尾。用鼠标选中全部内容,右键点击复制(或者按Ctrl+Insert复制)。


步骤3.3:把公钥添加到GitHub账号

  1. 登录GitHub,点击右上角你的头像→选择Settings
  2. 在左侧菜单栏找到 SSH and GPG keys(在Access分类下面)
  3. 点击右上角绿色的 New SSH key 按钮
  4. 填写:
    • Title:随便写,比如"我的Win10电脑",只是个标记
    • Key type:保持默认 Authentication Key
    • Key:把刚才复制的公钥内容完整粘贴进去(一个字符都不要漏,也不要多空格)
  5. 点击绿色的 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仓库

  1. 登录GitHub,点击右上角的 + 号→选择New repository(新建仓库)
  2. 填写仓库信息:
    • Repository name(仓库名):这里必须填 你的用户名.github.io
      • 举个例子:如果你的GitHub用户名是 zhangsan,就填 zhangsan.github.io
      • ❌ 不能填别的名字!否则GitHub Pages无法访问!
    • Description:随便写,比如"My Hexo Blog"
    • 选择 Public(公开仓库,免费用户必须选公开才能用Pages)
    • 不要勾选 "Add a README file"、"Add .gitignore"、"Choose a license"这三个选项,保持空
  3. 点击最下面绿色的 Create repository 按钮,仓库就创建好了。

这个仓库就是后面存放我们从站静态文件的地方,暂时先放着,后面配置部署的时候再用。


第四阶段:配置Ubuntu VPS主站(核心部分)

接下来所有命令都是在你的VPS终端里执行的,用FinalShell或者cmd连接上VPS,用root用户登录。
每输完一条命令按回车,等执行完再输入下一条。

步骤4.1:连接VPS,更新系统,安装基础软件

用FinalShell连接你的VPS,登录成功后看到root@xxx:~# 提示符,开始执行命令:

  1. 先更新系统软件包列表并升级已安装软件:

    apt update && apt upgrade -y
    

    第一次执行可能需要等几分钟,滚动完回到命令提示符就是完成了。如果中间弹出对话框问你要不要重启服务,直接按回车确认即可。

  2. 安装需要用到的软件:Nginx(Web服务器)、Git、防火墙ufw、curl:

    apt install -y nginx git curl ufw
    

    等待安装完成。

  3. 启动Nginx并设置开机自动启动:

    systemctl start nginx
    systemctl enable nginx
    

✅ 验证Nginx是否正常运行:
打开你本地电脑的浏览器,地址栏输入 http://你的VPS公网IP,按回车。
如果能看到"Welcome to nginx!"的默认欢迎页面,说明Nginx安装成功了!


步骤4.2:创建专门用于部署的git用户

出于安全考虑,我们不用root用户直接部署博客,创建一个单独的git用户来做部署操作:

  1. 创建git用户并设置密码:

    adduser git
    
    • 会提示你输入密码:自己设置一个密码,输入两遍(输入的时候屏幕不会显示,是正常的,输完按回车就行)
    • 接下来会问你Full Name、Room Number等信息,全部直接按回车跳过即可,最后问你Is the information correct? 输入 Y按回车。
  2. 给git用户添加sudo权限,方便后面操作:

    usermod -aG sudo git
    

步骤4.3:配置VPS的SSH免密登录

和GitHub一样,我们需要让本地电脑能免密码连接VPS的git用户,这样部署的时候不用输密码。

所有命令都在VPS终端中执行:

  1. 切换到git用户:

    su - git
    

    你会发现命令提示符从 root@xxx变成了 git@xxx,说明切换成功了。

  2. 创建.ssh目录并设置正确的权限:

    mkdir -p ~/.ssh
    chmod 700 ~/.ssh
    touch ~/.ssh/authorized_keys
    chmod 600 ~/.ssh/authorized_keys
    

    这些命令没有任何提示就是执行成功了。

  3. 打开authorized_keys文件,把你本地电脑的公钥粘贴进去:

    nano ~/.ssh/authorized_keys
    
    • 会打开nano编辑器,现在是空白的
    • 右键点击编辑器窗口,选择粘贴,把之前复制的id_rsa.pub公钥内容完整粘贴进去
    • 粘贴完成后,按键盘 Ctrl + O(字母O,不是零),底部会提示File Name to Write,直接按回车确认保存
    • 按 Ctrl + X 退出编辑器
  4. 退出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终端执行:

  1. 创建网站根目录,并设置权限给git用户:

    mkdir -p /var/www/hexo
    chown -R git:git /var/www/hexo
    chmod -R 755 /var/www/hexo
    
  2. 创建Git裸仓库目录:

    mkdir -p /var/repo
    cd /var/repo
    git init --bare hexo.git
    

    显示 Initialized empty Git repository in /var/repo/hexo.git/ 就是成功了。

  3. 给仓库设置正确的权限,让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终端执行:

  1. 编辑post-receive钩子文件:

    nano /var/repo/hexo.git/hooks/post-receive
    
  2. 编辑器打开后,完整复制下面的内容,右键粘贴进去:

    #!/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 "=== 博客部署成功! ==="
    
  3. 按 Ctrl+O → 回车保存,按 Ctrl+X 退出编辑器。

  4. 给钩子文件添加可执行权限,并设置所有者为git用户:

    chmod +x /var/repo/hexo.git/hooks/post-receive
    chown git:git /var/repo/hexo.git/hooks/post-receive
    

步骤4.6:配置Nginx网站

现在告诉Nginx我们的网站在哪里,怎么访问。

  1. 创建站点配置文件:

    nano /etc/nginx/sites-available/hexo
    
  2. 编辑器打开后,粘贴下面的内容:

    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";
        }
    }
    
  3. ⚠️ 一定要修改:把 server_name 这里替换成你的VPS_IP或者你的域名;这一行,把中文替换成你自己的VPS公网IP。比如你的IP是 123.45.67.89,就改成:

    server_name 123.45.67.89;
    
  4. 按 Ctrl+O → 回车保存,按 Ctrl+X 退出编辑器。

  5. 启用这个站点:建立软链接到sites-enabled目录:

    ln -s /etc/nginx/sites-available/hexo /etc/nginx/sites-enabled/
    
  6. 删除Nginx默认的站点配置,避免冲突:

    rm -f /etc/nginx/sites-enabled/default
    
  7. 测试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,回去检查刚才粘贴的配置有没有写错。

  8. 重启Nginx让配置生效:

    systemctl restart nginx
    

步骤4.7:配置防火墙,允许网站访问

Ubuntu默认有ufw防火墙,我们需要放开HTTP和HTTPS端口,否则外面访问不到:

  1. 依次执行以下命令:

    # 允许SSH连接(必须!否则你会被关在VPS外面!)
    ufw allow OpenSSH
    # 允许Nginx的HTTP和HTTPS
    ufw allow 'Nginx Full'
    # 启用防火墙
    ufw --force enable
    
  2. 查看防火墙状态确认:

    ufw status
    

    ✅ 看到80/tcp和443/tcp是ALLOW状态就可以了。


第五阶段:配置Hexo一键双部署

现在回到你本地Win10电脑,打开D:\blog目录下的站点配置文件 _config.yml,我们配置自动同时部署到VPS和GitHub两个地方。

步骤5.1:修改deploy配置

  1. 用记事本/Notepad++打开 D:\_config.yml
  2. 滚动到文件最底部,找到 deploy:这一部分(如果没有就自己在最后加)
  3. 把原来的内容删掉,替换成下面的内容:
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
    
  1. 按 Ctrl+S 保存文件,关闭编辑器。

第六阶段:第一次部署!见证成果

激动人心的时刻到了!我们执行第一次部署,把博客同时发到VPS和GitHub。

步骤6.1:执行部署命令

回到本地Win10的cmd窗口,当前在 D:\blog目录下,执行:

hexo clean && hexo g -d

这个命令会自动做三件事:

  1. hexo clean:清理之前生成的旧缓存和旧文件
  2. hexo g(generate):根据你的文章和主题,重新生成所有静态网页文件
  3. 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功能:

  1. 浏览器登录GitHub,打开你之前创建的 用户名.github.io 仓库
  2. 点击仓库顶部的 Settings 标签
  3. 在左侧菜单找到 Pages(在Code and automation分类下面)
  4. 在Source部分:
    • Source选择 Deploy from a branch
    • Branch下拉框,第一个选 main,第二个选 / (root)
  5. 点击 Save 按钮
  6. 页面上方会提示"Your site is ready to be published at https://用户名.github.io/",等待1-2分钟让GitHub生效

然后访问 https://你的用户名.github.io,你会看到一模一样的博客!说明GitHub从站备份也成功了!

🎉 恭喜你!双部署已经全部完成!


📖 日常使用指南

写新文章并发布

  1. 打开cmd,进入D:\blog目录
  2. 执行命令新建文章:
    hexo new "我的第一篇文章"
    
  3. 打开 D:\blog\source\_posts\ 文件夹,找到 我的第一篇文章.md文件,用Markdown编辑器(推荐Typora、VS Code,或者直接用记事本)编辑内容,写完保存。
  4. 执行一键部署命令:
    hexo clean && hexo g -d
    
  5. 等几十秒部署完成,刷新你的博客网站就能看到新文章了,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,你可以根据自己的喜好修改:

  1. 修改头像:

    • 把你的头像图片命名为 avatar.jpg,放到 themes/indigo/source/img/ 文件夹,替换原来的文件即可
  2. 修改顶部背景图:

    • 替换 themes/indigo/source/img/brand.jpg 文件就是顶部背景图
  3. 修改导航菜单:

    • 打开主题配置文件,找到menu部分,可以添加或修改导航链接
  4. 添加社交链接:

    • 找到social部分,填写你的GitHub主页、邮箱、微博等链接
  5. 配置评论系统:

    • indigo默认支持Valine评论,注册一个LeanCloud账号,把appId和appKey填到配置文件的valine部分即可
  6. 配置站点统计:

    • 可以填百度统计或者Google Analytics的ID,查看网站访问数据

⚠️ 注意:修改主题配置文件后,需要重新执行 hexo clean && hexo g 才能生效,本地预览看没问题了再部署。


❓ 常见问题排查(遇到问题先看这里!)

问题1:部署时提示 Permission denied (publickey,password)

原因:SSH密钥配置不对,本地电脑连不上VPS或GitHub。
解决方法:

  1. 测试本地能不能免密连GitHub:ssh -T [email protected],失败就重新配置GitHub的SSH密钥
  2. 测试本地能不能免密连VPS:ssh git@你的VPS_IP,失败就检查VPS上git用户的authorized_keys里的公钥是不是粘贴正确了,有没有多换行或者少字符
  3. 确认VPS上/var/repo和/var/www/hexo的所有者都是git用户,执行:chown -R git:git /var/repo /var/www/hexo

问题2:访问VPSIP显示403 Forbidden

原因:网站目录权限不对,或者目录里没有index.html文件
解决方法:

  1. 在VPS执行:ls /var/www/hexo,看看有没有index.html文件
  2. 如果没有,说明部署钩子没执行成功,检查post-receive文件有没有加执行权限,路径对不对
  3. 如果有文件,执行:chown -R git:git /var/www/hexo && chmod -R 755 /var/www/hexo,然后刷新浏览器
  4. 重启Nginx:systemctl restart nginx

问题3:indigo主题样式错乱、没有颜色、排版乱了

原因:less渲染插件没装好
解决方法:

  1. 在本地博客目录重新安装:npm install [email protected] --save
  2. 执行 hexo clean,再重新生成预览

问题4:GitHub Pages访问404

原因:要么仓库名不对,要么Pages没开对分支
解决方法:

  1. 确认仓库名严格是 你的用户名.github.io,一个字符都不能错,包括大小写
  2. 去Settings→Pages里确认分支选的是main,根目录/root
  3. 第一次开启Pages需要等1-3分钟才能生效,耐心等一会再刷新
  4. 如果还是不行,去仓库的Actions标签看看部署有没有报错

问题5:hexo命令提示"不是内部或外部命令"

原因:Node.js安装后环境变量没生效
解决方法:

  1. 关闭所有cmd窗口,重新打开一个新的cmd再试
  2. 还是不行就重启电脑
  3. 重启还不行就重新安装Node.js 18版本

问题6:部署到VPS后网页还是旧的、不更新

原因:Nginx缓存,或者浏览器缓存
解决方法:

  1. VPS上重启Nginx:systemctl restart nginx
  2. 浏览器按 Ctrl+F5强制刷新页面(跳过缓存)
  3. 确认/var/www/hexo目录里的文件是最新修改时间

🔄 主从切换方法

如果你的VPS需要重启、维护、或者暂时出问题,你只需要:

  1. 把你的域名DNS解析记录,从VPS的IP改成GitHub Pages的地址(GitHub Pages可以绑定自定义域名)
  2. 等DNS生效后,访客就会访问GitHub上的备份站,内容完全一样
  3. 等VPS恢复后,再把DNS解析改回VPS的IP即可,访客完全无感知

两边的文件是完全同步的,每次部署两边同时更新,不用担心数据不一致。


💾 博客备份建议

你的整个博客源文件都在本地D:\blog目录下,建议你:

  1. 定期把整个blog文件夹打包备份到网盘或者其他地方
  2. 或者在GitHub上新建一个私有仓库,把整个blog源文件也推上去备份,这样即使本地电脑坏了,源文件也不会丢
  3. VPS和GitHub上只有生成后的静态网页,没有你的Markdown源文件和配置,所以本地的源文件一定要备份好!

🎉 至此,整个双部署博客就搭建完成了!你已经拥有了一个完全属于自己的、双备份的个人博客。开始你的写作之旅吧!