GitHub Actions实现Hexo博客自动化
基础环境
原环境
仓库：存放静态网页的仓库（公开）
工作流：本地撰写博客-->执行编译，生成静态网页-->推送静态网页到仓库-->访问发布的网页
新环境
仓库1：存放博客源码的仓库（私有）
仓库2：存放静态网页的仓库（公开）
工作流：本地撰写博客-->源码推送至仓库1-->使用GitHub Actions自动编译和推送静态网页到仓库2-->访问发布的网页
INFO
与原环境相比，在新环境下的工作流，将手动执行由两步缩减至一步，同时了保证源码存有备份，也可直接在GitHub仓库中在线编辑，降低对设备的依赖性。
本文是在有原环境的基础上进行
新建仓库存放源码
在github中创建一个新仓库用来存放博客源码，并设置可见性设为Private。
设置身份验证令牌
1.点击头像，选择 “Settings” -> “Developer settings” -> “Personal access tokens”->”Tokens（classic）“，点击 “Generate new token”，选择”Generate new token（classic）“，验证后，指定一个描述性名称，选择令牌的有效时间为"No expiration"（永不过期），选择要授予此令牌的范围或权限，勾选repo和workflows 项即可。点击”Generate token“，完成创建。
2.创建完成后，复制保存token，后面要用。
3.进入刚创建好的私有仓库，进入仓库的“Settings” -> “Secrets and variables” -> “Actions”。点击”Repository secrets“中的“New repository secret”，自定义输入Actions secrets 的名字，并将第2步复制的token粘贴至Secrets框中，点击”Add secret“保存。
创建 Github Actions 脚本
1.在本地博客的根目录的.github目录下新建workflows目录，并在workflows目录中创建Github Actions 脚本文件autodeploy.yml。
name: Hexo编译发布静态网页至Github Page
on:
push:
branches:
- main #默认分支
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- name: 检查源码
uses: actions/checkout@v4
with:
ref: main #默认分支
path: blog #源码在ubuntu服务器中的存放目录
fetch-depth: 0 #获取所有分支和标签的所有历史记录
- name: 获取文章更新的最新时间
run: |
git ls-files -z '*.md' | while read -d '' path; do
touch -d "$(git log -1 --format="@%ct" "$path")" "$path"
done
working-directory: ./blog/source/_posts
- name: 安装Node.js
uses: actions/setup-node@v4
with:
node-version: "24" #对应本地使用版本
cache: 'npm' #启用npm依赖缓存
cache-dependency-path: '**/package-lock.json' #指定缓存依赖的 lock 文件路径
- name: 下载依赖
run: npm install
working-directory: ./blog
- name: 安装Hexo
run: |
export TZ='Asia/Shanghai'
npm install -g hexo-cli
working-directory: ./blog
- name: 缓存Hexo
id: cache-npm
uses: actions/cache@v4
env:
cache-name: cache-node-modules
with:
path: node_modules
key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
restore-keys: |
${{ runner.os }}-build-${{ env.cache-name }}-
${{ runner.os }}-build-
${{ runner.os }}-
- name: 编译生成静态网页
run: |
hexo clean
hexo generate
working-directory: ./blog
- name: 发布至GitHub Pages
uses: peaceiris/actions-gh-pages@v4
with:
personal_token: ${{ secrets.PERSONAL_TOKEN }} #此处的PERSONAL_TOKEN改为之前设置的设置身份验证令牌的名称
publish_dir: ./blog/public
external_repository: username/username.github.io #更改为仓库2的名字, username是你的用户名
publish_branch: main #仓库2发布静态页面的对应分支TIP
修复了使用github actions造成博客的更新时间错误的问题
2.在本地博客的根目录进行仓库的git初始化。
git init
git branch -M main
git remote add origin
git@github.com:用户名/仓库1名称.git3.在本地博客的根目录下，设置提交git的用户和邮箱，仅在当前目录下生效。（也可设置全局生效）
git config user.name '用户名'
git config user.email '邮箱地址'4.将themes\butterfly目录下的.git目录移除，执行以下命令提交源码到仓库1中。
git add .
git commit -m "github actions"
git push -u origin main5.提交完成后，在仓库1中的”Actions“中查看工作流的执行状态。执行成功后，仓库2的静态页面会同步更新。
参考链接
