采用Github Action实现Hexo站点自动部署

本文最后更新于 2025年4月9日 晚上

参考了这篇和这篇文章并自己改良了一下。

1. 创建自己的GitHub Token实现免认证登录

在GitHub中打开tokens创建页，创建新的token，勾选repo权限，然后复制生成的token。

2. 修改自己hexo项目的部署方式

在本地hexo项目的根目录下找到_config.yml文件，修改deploy部分的内容如下：

1
2
3
4
deploy:
  type: git
  repo: https://{token}@github.com/{username}/{username}.github.io.git
  branch: master

其中，{token}是第一步中生成的token，{username}是你的GitHub用户名。

3. 创建GitHub Action

在hexo项目的根目录下创建.github/workflows目录，然后在workflows目录下创建一个yml文件，文件名可以自定义，内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
name: Blog CI/CD # 脚本 workflow 名称

on:
  push:
    branches: [main, master] # 当监测 main,master 的 push
    paths: # 监测的路径。
      - '*.json'
      - '**.yml'
      - '**/source/**'
      - '**/scaffolds/**'
      - '**/themes/**'

jobs:
  deploy: # 任务名称
    runs-on: ubuntu-latest # 指定最新 ubuntu 系统
    steps:
      - uses: actions/checkout@v4 # 拉取仓库代码
      - name: Use Node.js 18
        uses: actions/setup-node@v4 # 设置 node.js 环境
        with:
          # Examples: 20, 18.19, >=16.20.2, lts/Iron, lts/Hydrogen, *, latest, current, node
          # Ref: https://github.com/actions/setup-node#supported-version-syntax
          node-version: "18"
      - name: Cache node_modules # 缓存 node_modules，提高编译速度，毕竟每月只有 2000 分钟。
        uses: actions/cache@v4 # 亲测 Github 服务器编译速度比我自己电脑都快，如果每次构建按5分钟计算，我们每个月可以免费部署 400 次，Github yyds！！！
        env:
          cache-name: cache-node-modules
        with:
          path: ~/.npm
          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: Install Dependencies # 安装源代码所需插件
        run: npm install
      - name: Install Hexo-cli # 安装 Hexo
        run: npm install -g hexo-cli --save
      - name: Build Blog # 编译创建静态博客文件
        run: |
          hexo clean
          hexo g
      - name: Deploy Blog # 设置 git 信息并推送静态博客文件
        run: |
          git config --global user.name "ZXF1001"
          git config --global user.email "1809996465@qq.com"
          hexo deploy

      - run: echo "Deploy Finished!"

4. 提交代码

将修改后的hexo项目推送到GitHub，然后在GitHub中打开Actions页面，可以看到自动部署的过程。以后每次把更新提交到GitHub，GitHub Action都会自动部署hexo站点。可以从仓库的Action页面中看到部署的过程。