使用Hexo+Github Pages搭建个人博客

很多人都有个人博客的需求，搭建博客的方法也多种多样。本文将介绍如何利用Hexo框架搭建博客，并使用Github Actions自动部署到GitHub上。

创建Hexo项目

Hexo官方文档：https://hexo.io/zh-cn/docs/

前提条件：需要有Node.js环境

1. 安装

npm install -g hexo-cli

2. 创建站点

hexo init <folder>
cd <folder>
npm install

此时站点的基础框架搭建成功！接下来就可以进行简单的写作了。当然，你可以根据官方文档进行个性化修改，如更换主题等。

部署到Github

创建博客仓库

此仓库存放生成的静态页面。

仓库注意项：

• 必须为公有仓库
• 仓库名为 <username>.github.io

一键部署

1. 安装 hexo-deployer-git

npm install hexo-deployer-git --save

2. 修改Hexo项目 _config.yaml 文件

deploy:
  type: git
  repo: <repository url> #可以是SSH或HTTPS链接
  branch: [branch] #Github Pages固定分支 gh-pages

3. 推送到Github

注：除非你使用令牌或 SSH 密钥认证(推荐使用)，否则你会被提示提供目标仓库的用户名和密码。

hexo clean&&hexo deploy

此时，你已经完成了使用Hexo搭建博客并部署到Github上的任务。

但若感觉每次都需要重新部署太过繁琐，则可继续往后看如何使用Github Actions自动部署。

---

Github Actions自动部署

本文使用 hexo-theme-keep 项目提供的自动部署脚本hexo-deploy-github-pages-action

1. 创建源码仓库

   此仓库存放博客站点的源码。最好为私有，保证安全。

为避免不必要的文件上传，Hexo范例提供的 .gitignore 文件如下：

.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
_multiconfig.yml

2. 创建一个有 repo 和 workflow 权限的 GitHub Token。

3. 将token添加到私有源码仓库的 Secrets

4. 在Hexo项目的 .github/workflows 目录下创建一个 xxx.yml 文件，模板如下：

name: deploying Hexo project to GitHub pages
on:
  push:
    branches:
      - main # main 分支有 push 行为时就触发这个 action

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

      - name: Build and Deploy
        uses: theme-keep/hexo-deploy-github-pages-action@master # 使用专门部署 Hexo 到 GitHub pages 的 action
        env:
          PERSONAL_TOKEN: ${{ secrets.HEXO_SITE }} # 上一步起的 secret 名
          PUBLISH_REPOSITORY: <username>/<username>.github.io # 博客仓库，格式：GitHub 用户名/仓库名
          BRANCH: gh-pages # 分支，填 gh-pages 就行
          PUBLISH_DIR: ./public # 部署 public 目录下的文件

至此，自动部署完成！

参考文章

• keep作者大大亲自写的自动部署教程
• Hexo官方文档