PATH A / CLOUDFLARE PAGES

AI 生成静态站部署:Cloudflare Pages 全流程

这一页只讲静态站路线。WordPress 网站要装 PHP 与数据库,请看 WordPress 部署那一页,两者不要混用。

路线区分本页对应 AI 生成静态站方案(499 / 999 / 1999 元)。如果你要部署的是 WordPress 网站,请改看 WordPress 主机部署说明 —— 那边需要处理 DNS、PHP、MySQL、缓存与备份。

一、和 WordPress 部署的本质区别

环节AI 静态站 / PagesWordPress / 主机
上传的东西预先生成好的 HTML 文件程序文件 + 数据库
服务端运行时无PHP + MySQL + Web 服务器
HTTPS平台自动签发手动申请并配置
域名解析CNAME 指向 PagesA 记录指向服务器 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)

  1. 本地构建与校验
    node build.mjs
    node check.mjs
    node preview.mjs   # 打开 http://localhost:4173/ 逐页点一遍
  2. 创建项目Cloudflare 控制台 → Workers 和 Pages → 创建 → Pages → 直接上传,给项目起个名字。
  3. 上传把 site/ 文件夹整个拖进去,等待部署完成,会得到一个 项目名.pages.dev 的预览地址。
  4. 后续更新重新构建后再次上传整个目录;适合一次性交付、客户不打算自己改代码的情况。

方式 B:连接 Git 仓库(推荐,可持续部署)

  1. 推仓库把项目推到 GitHub / GitLab,私有仓库也可以,site/ 一并提交(或让 Pages 执行构建命令)。
  2. 填构建配置框架预设选 None;构建命令留空(已提交 site/)或填 node build.mjs;构建输出目录必须填 site。
  3. 自动部署之后每次 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
注意www 与 http→https 的规范化优先在 Cloudflare「批量重定向」或页面规则里做,不要在 _redirects 里写通配规则,容易造成循环。改版前一定先整理 301 映射表。

五、自定义域名与 HTTPS

在 Pages 项目的「自定义域」里添加域名,按提示把 DNS 记录指向 Pages 提供的 CNAME,证书会自动签发。域名本身托管在 Cloudflare 时可开启代理模式,并统一设置「始终使用 HTTPS」与 www 规范化。

绑定完成后回到 site.config.mjs 把 baseUrl 改成正式域名,重新构建并部署一次,避免 canonical 和站点地图还指向 pages.dev 预览域名。

六、缓存回温与更新流程

  1. 重新部署内容改动 → node build.mjs → 上传或 push 触发自动部署。
  2. 清缓存必要时在 Cloudflare 里 Purge Everything,但注意清缓存后第一次测速不作数。
  3. 等回温等 CDN 边缘节点重新缓存,多次访问主要页面。
  4. 再判断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 等 UACloudflare 安全事件日志
性能回温后 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 不生效文件不在输出目录根部,或缩进格式不对检查路径与「路径行 + 缩进头行」格式

延伸阅读

FAQ

关于静态站部署,你可能想问

上传方式、要不要花钱、以后怎么更新内容 —— 这几件事问得最多。还有别的疑问,随时联系我。

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。本站全站按层级生成相对路径,本地预览与线上行为一致;部署前先用预览服务器逐页点一遍链接。

需要有人直接帮你部署上线?

把域名和 Cloudflare 账号准备好,我按这份清单逐项做完并给你验收报告。