Cloudflare一键部署主题

此博客由Cloudflare免费部署

部署流程

1. 克隆仓库

git clone https://github.com/uxiaohan/vhAstro-Theme.git 
cd vhAstro-Theme

配置说明
修改前请参考：vhAstro主题配置文档
暂不执行 npm install

2. 推送至GitHub

将配置好的项目推送到您的GitHub仓库

3. Cloudflare配置

访问 Cloudflare控制台
进入 Workers & Pages → 创建应用程序 → Pages
连接Git仓库并授权访问

环境变量设置

键	值
`NODE_VERSION`	`18.19.0`

构建命令配置

npm install --force && npm run build

4. 依赖冲突解决方案

常见错误

log npm ERR! Invalid: lock file's yaml@1.10.2 does not satisfy yaml@2.7.1

解决方案

修改 package.json：


{ "overrides": 
    { 
      "yaml": "2.7.1", 
      "cosmiconfig": 
          { 
            "yaml": "2.7.1"
          },
          "cssnano": 
          { 
            "yaml": "2.7.1"
          }, 
          "postcss-load-config": 
          { 
            "yaml": "2.7.1"
          }
    }
}

创建 .npmrc 文件：

shamefully-hoist=true
save-exact=true

重建依赖：

rm -rf node_modules package-lock.json npm install --force
# 只要删除 node_modules package-lock.json 再次执行 npm install --force 即可

验证命令

npm ls yaml --all

应输出 → [email protected]

完成之后push 到GitHub仓库 cloudflare 会自己构建你的新提交，最后默认会生成一个 *.pages.dev 域名，可以访问此域名查看效果

自定义域名

进入 Pages 项目设置
选择 自定义域
输入已备案（不备案也ok）的域名并按指引配置DNS

部署验证

完成部署后，可通过以下方式验证：

✅ Cloudflare 控制台显示构建成功状态
✅ 访问自动生成的 *.pages.dev 域名
✅ 检查控制台无报错信息

返回目录

UF4

目录