Github Pages搭建Hexo博客

GitHub Actions 是 GitHub 推出的持续集成服务,入门教程可参考:GitHub Actions 入门教程。

新建两个仓库

_www : 私有仓库,存储源代码内容,生成文件
xxx.github.io : 公开仓库,主要存在编译后的public内容

操作步骤

1.获取 GH_TOKEN
首先到个人中心设置Setting->Developer Settings-> Personal access tokens->tokens (classic),新建一个token即可。
token 能让 GitHub Actions 构建所在的虚拟系统对发布仓库拥有权限可以进行推送操作。

2.设置 Actions Secrets
新建 _www 仓库,将本地目录的 hexo 源码推送到_www 仓库里,然后进到 _www 仓库的 Setting->secrets and variables ->Actions 在Repository secrets里新建一个名为[ACCESS_TOKEN]的键值项,内容填上一步获取到的 token 值。

3.Actions 设置
在博客源码根目录下新建目录 .github/workflows ,然后在其下新建任务文件 deploy.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
name: Publish Hexo to gitpage
on:
push:
branches:
- main # 如果源码与gitpage用同一仓库则修改为hexo源码对应分支
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
with:
ref: main
- name: Install dependencies
run: |
npm install -g hexo-cli # 给虚拟机装上hexo运行环境
npm install # 安装 package.json 中记录的所有插件
- name: Generate Hexo site
run: |
hexo clean
hexo generate
- name: Deploy to B repo
uses: peaceiris/actions-gh-pages@v3
with:
personal_token: ${{ secrets.ACCESS_TOKEN }} # Personal access token
external_repository: xxxx/xxxx.github.io # 发布的仓库地址
PUBLISH_BRANCH: main
PUBLISH_DIR: ./public

4.至此所有的就完成了


Github Pages搭建Hexo博客
http://060800.xyz/2025/07/04/Github Pages搭建Hexo博客/
作者
砖头
发布于
2025年7月4日
许可协议