AI 生成静态站部署:Cloudflare Pages 全流程
这一页只讲静态站路线。WordPress 网站要装 PHP 与数据库,请看 WordPress 部署那一页,两者不要混用。
一、和 WordPress 部署的本质区别
| 环节 | AI 静态站 / Pages | WordPress / 主机 |
|---|---|---|
| 上传的东西 | 预先生成好的 HTML 文件 | 程序文件 + 数据库 |
| 服务端运行时 | 无 | PHP + MySQL + Web 服务器 |
| HTTPS | 平台自动签发 | 手动申请并配置 |
| 域名解析 | CNAME 指向 Pages | A 记录指向服务器 IP |
| 需要备份吗 | 源码仓库即备份 | 需定期备份文件与数据库 |
| 更新方式 | 改内容 → 重新构建部署 | 后台直接编辑发布 |
换句话说,静态站把「生成页面」这件事提前到构建阶段完成了,用户请求时边缘节点只需要把一个现成文件发出去。这也是它比 WordPress 快、且几乎没有维护成本的原因。
二、部署产物:site/ 目录里有什么
本站由 build.mjs 从 site.config.mjs 与 src/ 生成,输出目录就是 site/。Cloudflare Pages 只需要这一个目录:
site/
├─ index.html 首页
├─ services/.../index.html 服务页(目录式 URL)
├─ blog/.../index.html 文章页
├─ pricing/index.html 报价页
├─ deploy/.../index.html 部署说明页
├─ assets/css/style.css 全站样式(单文件)
├─ assets/js/app.js 轻量交互(无框架)
├─ sitemap.xml 全部可索引 URL
├─ robots.txt 爬虫与 AI 爬虫策略
├─ llms.txt / llms-full.txt GEO 站点说明
├─ feed.xml RSS
├─ _headers 安全头与缓存规则
├─ _redirects 301 映射
├─ favicon.svg
└─ 404.html
site.config.mjs 里的 baseUrl 改成正式域名,重新构建后 canonical、OG、sitemap、llms.txt 会一起更新。全站链接按页面层级生成相对路径,所以本地双击 HTML 也不会丢样式。三、三种部署方式
方式 A:直接上传目录(最快,不用 Git)
- 本地构建与校验
node build.mjs node check.mjs node preview.mjs # 打开 http://localhost:4173/ 逐页点一遍 - 创建项目Cloudflare 控制台 → Workers 和 Pages → 创建 → Pages → 直接上传,给项目起个名字。
- 上传把
site/文件夹整个拖进去,等待部署完成,会得到一个项目名.pages.dev的预览地址。 - 后续更新重新构建后再次上传整个目录;适合一次性交付、客户不打算自己改代码的情况。
方式 B:连接 Git 仓库(推荐,可持续部署)
- 推仓库把项目推到 GitHub / GitLab,私有仓库也可以,
site/一并提交(或让 Pages 执行构建命令)。 - 填构建配置框架预设选
None;构建命令留空(已提交 site/)或填node build.mjs;构建输出目录必须填site。 - 自动部署之后每次 push 到生产分支都会自动重新构建部署,内容更新走「改文件 → 提交 → 自动上线」。
方式 C:Wrangler CLI(适合放进 CI)
npm install -g wrangler
wrangler login
wrangler pages deploy site --project-name=my-site
四、_headers 与 _redirects 完整示例
这两个文件放在输出目录根部,Pages 会自动识别,等价于给静态站加一层轻量服务器配置。
# _headers
/*
X-Content-Type-Options: nosniff
X-Frame-Options: SAMEORIGIN
Referrer-Policy: strict-origin-when-cross-origin
Permissions-Policy: geolocation=(), microphone=(), camera=()
Strict-Transport-Security: max-age=31536000; includeSubDomains
/assets/*
Cache-Control: public, max-age=31536000, immutable
# _redirects(格式:旧路径 新路径 状态码)
# 改版时把旧 URL 逐行登记,保住已有收录
/old-landing /services/wordpress/ 301
/home / 301
五、自定义域名与 HTTPS
在 Pages 项目的「自定义域」里添加域名,按提示把 DNS 记录指向 Pages 提供的 CNAME,证书会自动签发。域名本身托管在 Cloudflare 时可开启代理模式,并统一设置「始终使用 HTTPS」与 www 规范化。
绑定完成后回到 site.config.mjs 把 baseUrl 改成正式域名,重新构建并部署一次,避免 canonical 和站点地图还指向 pages.dev 预览域名。
六、缓存回温与更新流程
- 重新部署内容改动 →
node build.mjs→ 上传或 push 触发自动部署。 - 清缓存必要时在 Cloudflare 里 Purge Everything,但注意清缓存后第一次测速不作数。
- 等回温等 CDN 边缘节点重新缓存,多次访问主要页面。
- 再判断PageSpeed Insights 移动端多次测试取中位数,与上线基线对比后再下结论。
这条 SOP 对 WordPress 路线同样适用,只是那边还要额外处理页面缓存插件与对象缓存的清理顺序。
七、SEO / GEO 上线核验清单
| 项目 | 要求 | 验证 |
|---|---|---|
| 内容可见性 | 正文直接写在 HTML,禁用 JS 后仍完整 | 浏览器禁用 JS 检查 |
| URL | 目录式 /pricing/ 对应 index.html,末尾斜杠统一 | 逐页点击无 404 |
| canonical / OG | 使用正式域名的绝对地址 | 查看页面源码 |
| sitemap.xml | 只含 200 且可索引的规范 URL | 直接访问并抽查 |
| robots.txt | 未携带开发环境的 Disallow,已放行 AI 爬虫 | 直接访问 /robots.txt |
| llms.txt | 站点说明与核心页面清单可访问 | 直接访问 /llms.txt |
| 结构化数据 | JSON-LD 无解析错误,实体信息一致 | Rich Results Test |
| AI 爬虫 | 检查 WAF / Bot Fight Mode 未拦截 GPTBot 等 UA | Cloudflare 安全事件日志 |
| 性能 | 回温后 PSI 移动端,LCP ≤ 2.5s、CLS ≤ 0.1 | 多次测试取中位数 |
八、常见报错速查
| 现象 | 原因 | 处理 |
|---|---|---|
| 首页 404 | 输出目录填错,或 index.html 不在根目录 | 确认输出目录为 site 且 site/index.html 存在 |
| 样式全丢 | 页面用了 /assets/... 绝对路径 | 改用按层级生成的相对路径 |
| 子页 404 | 链接写 /about 但没有 /about/index.html | 统一目录式 URL,末尾带斜杠 |
| 更新后还是旧内容 | CDN 缓存未刷新 | 重新部署,必要时 Purge Cache 后等回温 |
| canonical 指向 pages.dev | 绑定域名后没改配置就部署 | 改 site.config.mjs 的 baseUrl 后重新构建 |
| _headers 不生效 | 文件不在输出目录根部,或缩进格式不对 | 检查路径与「路径行 + 缩进头行」格式 |
延伸阅读
关于静态站部署,你可能想问
上传方式、要不要花钱、以后怎么更新内容 —— 这几件事问得最多。还有别的疑问,随时联系我。
AI 生成的静态站怎么部署到 Cloudflare?
先由构建脚本生成 site/ 目录,然后在 Cloudflare Pages 创建项目:可以直接拖拽上传 site/,也可以连接 Git 仓库并把构建输出目录填 site。绑定自定义域名后自动签发 HTTPS,最后提交 sitemap.xml 给搜索引擎。
Cloudflare Pages 部署要花钱吗?
Pages 有较宽松的免费额度,个人与中小展示站通常完全够用,包含全球 CDN 与自动 HTTPS。超出额度的带宽或构建次数按官方当期套餐规则计费。相比 WordPress 路线,通常可以省掉主机年费。
静态站更新内容需要重新部署吗?
需要:改内容数据 → 执行构建脚本 → 推送或重新上传。若连接了 Git,push 后会自动构建部署。需要非技术同事频繁发文的场景,建议接 Headless CMS 或直接选 WordPress 路线。
部署后样式丢失或子页 404 怎么排查?
三个常见原因:构建输出目录填错、页面里用了 /assets/ 这类绝对路径、目录式 URL 没有对应的 index.html。本站全站按层级生成相对路径,本地预览与线上行为一致;部署前先用预览服务器逐页点一遍链接。