Hexo 博客部署指南

本文记录如何使用 GitHub Actions 自动部署 Hexo 博客到 GitHub Pages。

1. 准备工作

1.1 创建 GitHub 仓库

在 GitHub 上创建一个新仓库，命名为 username.github.io（将 username 替换为你的 GitHub 用户名）。

1.2 安装 Node.js

确保本地安装了 Node.js（建议 v18+）和 npm。

1
2

node -v
npm -v

1.3 安装 Hexo CLI

1

npm install -g hexo-cli

2. 初始化项目

2.1 创建博客项目

1
2
3

hexo init myblog
cd myblog
npm install

2.2 选择主题

本博客使用 one-paper 主题，简洁美观，专注于写作体验。

1

git clone https://github.com/liruiying728/hexo-theme-one-paper.git themes/one-paper

在 _config.yml 中设置：

1

theme: one-paper

3. 配置 GitHub Actions

在 .github/workflows/pages.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

name: Deploy Hexo to GitHub Pages

on:
  push:
    branches:
      - master
  workflow_dispatch:

permissions:
  contents: write
  pages: write
  id-token: write

concurrency:
  group: pages
  cancel-in-progress: false

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: "20"
          cache: npm

      - name: Install dependencies
        run: npm ci

      - name: Generate site
        run: npm run build

      - name: Deploy to GitHub Pages
        uses: peaceiris/actions-gh-pages@v4
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: ./public
          publish_branch: gh-pages
          cname: www.yourdomain.cn

4. 部署到 GitHub

4.1 初始化 Git 仓库

1
2
3

git init
git add .
git commit -m "Initial commit"

4.2 添加远程仓库

1
2
3

git remote add origin https://github.com/username/username.github.io.git
git branch -M master
git push -u origin master

4.3 配置 GitHub Pages

1. 进入仓库 Settings → Pages
2. Source 选择 GitHub Actions
3. Custom domain 输入你的域名（如 www.yourdomain.cn）
4. 勾选 Enforce HTTPS

5. 域名解析

在域名服务商处添加 DNS 记录：

GitHub Pages 官方 IP：185.199.108.153 ~ 185.199.111.153

6. 写文章

1

hexo new "文章标题"

文章创建在 source/_posts/ 目录下，使用 Markdown 编写。

7. 自动化流程

以后只需：

1. 写完文章后 git add . && git commit -m "xxx" && git push
2. GitHub Actions 自动构建并部署
3. 访问 https://username.github.io 或你的自定义域名

相关链接

• Hexo 官方文档
• one-paper 主题
• GitHub Pages 文档