一、配置 GitHub 自动化部署

1. 获取 GitHub Token

打开 Personal settings -> Developer settings -> Personal access tokens
设置权限为 repo 和 public repo

3. 保存生成的 Token如（ghp_1Y7FpPnoCPlSqHPmTPbntYi3PJtdkbD2gV7jo）
4. 在博客代码仓库的 Secrets 中添加名为 PERSONAL_TOKEN 的变量，后续步骤将用到。

2. 创建 GitHub Actions

在博客仓库页面，点击 Actions。
选择 Set up a workflow yourself。
输入以下 YAML 配置并点击 Start commit ：

name: 自动部署
# 当有改动推送到master分支时，启动Action
on:
  push:
    branches:
      - main
      #2020年10月后github新建仓库默认分支改为main，注意更改
  release:
    types:
      - published

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: 检查分支
        uses: actions/checkout@v2
        with:
          ref: main

      - name: 安装 Node
        uses: actions/setup-node@v1
        with:
          node-version: "23"

      - name: 安装 Hexo
        run: |
          export TZ='Asia/Shanghai'
          npm install hexo-cli -g

      - name: 缓存 Hexo
        id: cache-npm
        uses: actions/cache@v3
        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: 安装依赖
        if: ${{ steps.cache-npm.outputs.cache-hit != 'true' }}
        run: |
          npm install --save

      - name: 生成静态文件
        run: |
          hexo clean
          hexo generate

      - name: 部署到Github
        uses: JamesIves/github-pages-deploy-action@v4
        with:
          token: ghp_ZFuGe3rmUbea1uqI7jjwAyRYXSKjk83kOX6啊
          repository-name: goodboy010/goodboy010.github.io
          branch: main
          folder: public
          commit-message: "${{ github.event.head_commit.message }} Updated By Github Actions"

参考文档：

二、通过 Vercel 部署 Qexo

1. 一键部署

点击以下按钮完成一键部署：Vercel 一键部署

注意：首次部署可能会出现错误提示，可忽略并继续后续步骤。

2. 修改 Node.js 版本

由于 Vercel 的已知问题，需将项目的 Node.js 版本调整为 18.x。
路径：Settings -> General -> Node.js Version

3. 创建 Vercel 数据库

进入Vercel Storage 页面。
点击 *Create Database，选择 Neon ，设置区域为 Washington, DC., USA - iad1，创建免费数据库。

4. 绑定项目

在 Projects 页面选择对应项目，点击 Connect Project 进行绑定。

5. 部署 Qexo

回到项目页面，点击Redeploy 开始部署。部署完成后，无报错即可访问域名进入初始化页面。

初始化配置

GitHub 配置

填写博客源码所在仓库的分支名称，例如：main

GitHub 密钥

填写生成的 GitHub Token，例如：ghp_1Y7FpPnoCPlSqHPmTPbntYi3PJtdkbD2gV7jo

仓库路径

例如：goodboy/goodboy.github.io
若 Hexo 源码在仓库根目录，则留空；否则填写路径：path/

项目分支：例如main

Vercel 配置

VERCEL_TOKEN：在Vercel 账户设置中生成。如：UoS34hKez6sOsMfl8vos8uL7
PROJECT_ID：在 Project Settings -> General -> Project ID 中找到。如：prj_jIoKAB7of6GQ9GrYEGb3s25Dwyuh

配置完成后，即可登录后台管理博客内容。