使用GitHub Actions实现Hexo博客的自动化发布

基础环境

原环境

仓库：存放静态网页的仓库（公开）

工作流：本地撰写博客—>执行编译，生成静态网页—>推送静态网页到仓库—>访问发布的网页

新环境

仓库1：存放博客源码的仓库（私有）

仓库2：存放静态网页的仓库（公开）

工作流：本地撰写博客—>源码推送至仓库1—>使用GitHub Actions自动编译和推送静态网页到仓库2—>访问发布的网页

与原环境相比，在新环境下的工作流，将手动执行由两步缩减至一步，同时了保证源码存有备份，也可直接在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发布静态页面的对应分支

修复了使用github actions造成博客的更新时间错误的问题

2.在本地博客的根目录进行仓库的git初始化。

git init
git branch -M main
git remote add origin 
git@github.com:用户名/仓库1名称.git

3.在本地博客的根目录下，设置提交git的用户和邮箱，仅在当前目录下生效。（也可设置全局生效）

1 2	git config user.name '用户名' git config user.email '邮箱地址'

4.将themes\butterfly目录下的.git目录移除，执行以下命令提交源码到仓库1中。

1
2
3

git add .
git commit -m "github actions"
git push -u origin main

5.提交完成后，在仓库1中的”Actions“中查看工作流的执行状态。执行成功后，仓库2的静态页面会同步更新。

参考链接

安知鱼 | 使用 Github Action 自动部署

https://blog.anheyu.com/posts/asdx.html

Gavin Zhou's Blog | 利用 GitHub Actions 实现自动化部署 Hexo 到 Github Pages

https://blog.leonus.cn/2022/footer.html

peaceiris | github仓库actions-gh-pages

https://github.com/peaceiris/actions-gh-pages

博客搭建系列文章