前言
为便于叙述，统一说明如下：
- 博客 github 源码仓库默认分支为 main，ssh 地址：
git@github.com:username/blog.git -
username.github.io：博客部署仓库，默认分支为 main -
hexo_deploy：本地私钥文件 - `hexo_deploy.pub：本地公钥文件
- 主题以 NexT 8.13.2 为例
本地 hexo 安装、主题部署流程较简单，步骤省略。
1、配置本地博客源代码库
在本地博客源代码仓库根目录 _config.yml 文件中增加如下部署配置：
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: git
repo: git@github.com:username/username.github.io.git
branch: main
注意：github 目前仅允许 ssh 提交，部署仓库必须为 ssh 地址
2、配置专用密钥对
本地重新生成一组密钥对，如 hexo_deploy.pub 与 hexo_deploy。私钥配置到 github 源码仓库的 repository secret，公钥配置到 username.github.io 部署仓库的 Deploy keys。该密钥对专用于「源码仓库」与「部署仓库」之间的 Action 自动部署。
github 源码库新建后即可配置：依次进入
Settings -> Secrets -> Actions -> New repository secret，名称取HEXO_DEPLOY_SECRET，值取自hexo_deploy内容；username.github.io.git部署仓库配置步骤略。
也可以拿用户公钥 SSH keys（可访问全部仓库）及其对应的私钥完成该步骤，但是用户公钥不一致时（比如办公室和家里使用的用户公钥不同，除非复制同一份密钥对），Action 自动部署的私钥也要更改，使用专用密钥对可避免这个问题。
3、创建 Action
在本地博客源代码库根目录下创建 .github/workflows/deploy.yml 文件，参考内容如下：
name: hexo-blog-deploy
on:
push:
branches:
- main
env:
GIT_USER: username
GIT_EMAIL: username@gmail.com
DEPLOY_REPO: username/username.github.io
DEPLOY_BRANCH: main
jobs:
build:
name: Build on node ${{ matrix.node_version }} and ${{ matrix.os }}
runs-on: ubuntu-latest
strategy:
matrix:
os: [ubuntu-latest]
node_version: [19.x]
steps:
- name: Checkout
uses: actions/checkout@v2
- name: Checkout deploy repo
uses: actions/checkout@v2
with:
repository: ${{ env.DEPLOY_REPO }}
ref: ${{ env.DEPLOY_BRANCH }}
path: .deploy_git
- name: Use Node.js ${{ matrix.node_version }}
uses: actions/setup-node@v1
with:
node-version: ${{ matrix.node_version }}
- name: Configuration environment
env:
HEXO_DEPLOY_SECRET: ${{secrets.HEXO_DEPLOY_SECRET}}
run: |
sudo timedatectl set-timezone "Asia/Shanghai"
# 配置私钥，否则无法访问部署库，提示 git@github.com: Permission denied (publickey).
mkdir -p ~/.ssh/
echo "$HEXO_DEPLOY_SECRET" > ~/.ssh/id_rsa
chmod 600 ~/.ssh/id_rsa
ssh-keyscan github.com >> ~/.ssh/known_hosts
# 设置用户名和邮箱，否则提示 Please tell me who you are.
git config --global user.name $GIT_USER
git config --global user.email $GIT_EMAIL
- name: Install dependencies
run: |
npm install
npm install hexo-deployer-git --save
# 全局搜索插件
npm install hexo-generator-searchdb --save
- name: Deploy hexo
run: |
npm run deploy
4、提交
配置完成后提交到 github 源码仓库即可触发 Action
（可选）部署留言栏 Utterances
安装 github 应用： https://github.com/apps/utterances
next 最新版本已经集成 Utterances，因此不需要复制安装完成后的模板，直接在主题文件根目录下设置 _config.yml 文件即可：
# Utterances
# For more information: https://utteranc.es
utterances:
enable: true
repo: username/username.github.io # Github repository owner and name
# Available values: pathname | url | title | og:title
issue_term: pathname
# Available values: github-light | github-dark | preferred-color-scheme | github-dark-orange | icy-dark | dark-blue | photon-dark | boxy-light
theme: github-light
（可选）部署域名
参考官方文档：验证用户站点的域
注意：需要在 blog 源代码库 source 目录下放置 CNAME 文件。之后步骤按官方文档进行
