第一步：配置 Mizuki#

在 Mizuki/.github/workflows/deploy.yml 中找到

1
# 如果需要启用内容分离,取消以下注释并配置
2
# ENABLE_CONTENT_SYNC: true
3
# CONTENT_REPO_URL: ${{ secrets.CONTENT_REPO_URL }}
4
# USE_SUBMODULE: true

把代码注释去掉，如下：

1
# 如果需要启用内容分离,取消以下注释并配置
2
ENABLE_CONTENT_SYNC: true
3
CONTENT_REPO_URL: ${{ secrets.CONTENT_REPO_URL }}
4
USE_SUBMODULE: true

推送代码到 github

第二步：配置 Mizuki-Content#

在 Mizuki-Content/.github/workflows/trigger-build.yml 中找到

1
repository: your-username/Mizuki  # ⚠️ 改为你的代码仓库,格式: owner/repo

改为你的Mizuki仓库，如

1
repository: hcl55/Mizuki

推送代码到 github

1. 生成 Token：
   • GitHub 头像 -> Settings -> Developer settings -> Personal access tokens -> Tokens (classic) -> Generate new token (classic) 一键传送
   • Note：填 Mizuki Content Trigger
   • Expiration：选择 No expiration
   • Select scopes：必须勾选 ✅ repo (Full control of private repositories)。
   • 点击 Generate token
   • 复制生成的 Token (ghp_xxxx)，先记下来，后面有用。
2. 存入 Secrets：
   • 内容仓库 (Mizuki-Content) -> Settings -> Secrets and variables -> Actions -> New repository secret
   • Name：填 DISPATCH_TOKEN
   • Secret：填刚才生成的 Token (ghp_xxxx)
   • 点击 Add secret

第三步：配置 Cloudflare#

1. 计算 -> Workers 和 Pages -> 创建应用程序 -> 想要部署 Pages？开始使用 -> 导入现有 Git 存储库 -> 选择 Mizuki

   • 框架预设：Astro
   • 构建命令：pnpm build
   • 构建输出目录：dist

2. 点击部署 -> 继续处理项目 -> 设置 -> 变量和机密

   • 添加 -> 类型：文本 -> 变量名称：ENABLE_CONTENT_SYNC -> 值：true
   • 继续添加 -> 类型：密钥 -> 变量名称：CONTENT_REPO_URL -> 值：https://ghp_xxxx@github.com/你的用户名/Mizuki-Content.git

   注：ghp_xxxx 为上面让你保存好的 Token，用户名记得替换

3. 做完这步后，点击部署，然后重试部署

现在你的博客就可以正常访问了

有域名的话还可以点击“自定义域”，设置你的域名

第四步：配置内容仓库触发部署#

1. 配置 Cloudflare 部署挂钩：

   • 打开项目页面 -> 设置 -> 部署挂钩
   • 部署挂钩名称：trigger
   • 点击保存后，找到“要使用此部署挂钩，请将此 URL 添加到您的外部服务”下方的 URL 进行复制

2. 配置 Mizuki-Content 环境变量：

   • 内容仓库 (Mizuki-Content) -> Settings -> Secrets and variables -> Actions -> New repository secret
   • Name：填 CF_DEPLOY_HOOK
   • Secret：填刚才复制的 URL
   • 点击 Add secret

3. 配置触发器：

   • 找到 Mizuki.github\workflows\trigger-cloudflare.yml.example
   • 把 trigger-cloudflare.yml.example 重命名为 trigger-cloudflare.yml
   • 注意在 19 行代码处修改为你的分支，如 main
   • 推送代码到 github