博客部署配置

本仓库当前是：GitHub 推 main → Cloudflare Pages 构建 pnpm run build → 静态资源上 CDN。下面记的是实际在用的域名与目录，换平台时只改对照表即可。

与仓库的差异

Node 22.x、Cloudflare 面板项 以 Cloudflare Pages 构建日志为准（仓库内无 wrangler.toml / .github/workflows）。部署后 SEO（站长验证、robots 策略）见仓库根目录 部署后SEO配置.md。

部署架构

Cloudflare Pages 配置

配置项	值
构建命令	pnpm run build
输出目录	docs/.vuepress/dist
Node.js 版本	22.x
包管理器	pnpm

域名配置

域名	类型	指向
www.zhaofutao.cn	CNAME	Cloudflare Pages
zhaofutao.cn	CNAME	Cloudflare Pages

部署流程

部署命令

# 本地预览
pnpm install
pnpm run dev

# 构建
pnpm run build

# 构建异常：清理缓存后再试
rm -rf docs/.vuepress/.cache docs/.vuepress/.temp

# 提交并部署
git add .
git commit -m "更新内容"
git push origin main

HTTPS 配置

Cloudflare Pages 自动提供：

• SSL 证书自动申请
• 证书自动续期
• HTTP/2 支持
• HTTP/3（QUIC）支持

其他部署方案

Vercel

Build Command: pnpm run build
Output Directory: docs/.vuepress/dist

GitHub Pages

备选方案

仓库 当前未包含 下列 workflow，仅为迁移到其他平台时的模板。

# .github/workflows/deploy.yml
name: Deploy
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '22'
      - run: pnpm install
      - run: pnpm run build
      - uses: peaceiris/actions-gh-pages@v4
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: docs/.vuepress/dist

常见问题

构建失败

1. 本地复现：pnpm install && pnpm run build
2. 清理 docs/.vuepress/.cache 与 .temp 后重试
3. 查看 Cloudflare 构建日志与 Node 版本（面板 vs package.json）
4. 对照 博客操作指南 排障流程

更新未生效

1. 确认 git push 成功
2. 检查 Cloudflare 部署状态
3. 清除 Cloudflare 缓存