深度文章 / 速度优化

静态网站部署 Cloudflare Pages 实操:为什么比 WordPress 更快

以本站为例讲解纯静态站架构:构建脚本如何一次生成全站 HTML、sitemap、robots 与 llms.txt,Cloudflare Pages 的 Git 连接、拖拽上传与 Wrangler 三种部署方式,_headers 与 _redirects 配置示例,自定义域名绑定,以及静态站的 SEO/GEO 注意事项与常见报错。

一、为什么静态站能快一个数量级

动态站每次访问通常要经历:接收请求 → 启动 PHP → 查询数据库 → 拼装 HTML → 返回。静态站把这一步整个提前到「构建时」,用户请求时服务器只需要把一个已经存在的文件发出去,而且这个文件往往就在离他最近的边缘节点上。

维度WordPress 动态站静态站 + Cloudflare Pages
TTFB常 200–800ms,受主机与缓存命中影响边缘命中时常见 20–100ms
托管成本主机 200–1000 元/年起免费额度通常覆盖中小展示站
安全维护需更新核心、主题、插件、打补丁没有服务端程序可执行,攻击面很小
流量峰值容易压垮 PHP-FPM 与数据库边缘网络天然抗峰值
内容更新后台可视化编辑改文件 → 构建 → 部署
动态功能表单、会员、商城开箱即用需接第三方 API / 云函数 / 表单服务

对展示型官网、落地页、文档站来说,这套取舍非常划算:把不常变的内容变成文件,把复杂功能交给专门的服务。

二、本站的真实目录结构

你现在看的这个站就是纯静态站,没有数据库、没有后台、没有插件。项目结构如下:

项目根目录/
├─ site.config.mjs        站点配置:域名、品牌、联系方式、方案价格
├─ build.mjs              构建脚本:生成全部页面与站点级文件
├─ src/
│  ├─ partials.mjs        全站模板:header/footer/SEO 标签/结构化数据
│  ├─ pages-core.mjs      首页、服务、报价、关于、联系、FAQ 等内容
│  ├─ pages-services.mjs  6 个服务详情页
│  ├─ articles/           12 篇文章,按 4 个主题集群分文件
│  ├─ styles.css          全站样式
│  └─ app.js              轻量交互(移动端菜单、目录高亮、复制)
└─ site/                  ★ 部署目录:Cloudflare Pages 只上传这里
   ├─ index.html
   ├─ services/.../index.html
   ├─ deploy/.../index.html
   ├─ blog/.../index.html
   ├─ assets/css/style.css
   ├─ assets/js/app.js
   ├─ sitemap.xml
   ├─ robots.txt
   ├─ llms.txt
   ├─ llms-full.txt
   ├─ feed.xml
   ├─ _headers
   ├─ _redirects
   ├─ favicon.svg
   └─ 404.html

关键点在 site.config.mjs:域名、品牌名、联系方式、方案价格只写一次,改完执行 node build.mjs,全站 canonical、OG、结构化数据、sitemap、llms.txt 会一起更新。这避免了静态站最烦人的问题 —— 改一个电话要翻二十个 HTML。

三、构建脚本到底做了什么

  1. 汇总内容读取所有页面与文章数据,检查 slug 是否重复、内链是否指向存在的页面。
  2. 统一套模板每页注入 title/description/keywords/canonical/OG、语义化 header/main/footer、面包屑与 JSON-LD 结构化数据。
  3. 相对路径按页面层级自动计算 ../ 前缀,保证本地双击 HTML 也能正常预览,部署后同样有效。
  4. 生成站点级文件sitemap.xml(含 lastmod)、robots.txt(含 AI 爬虫放行)、llms.txt / llms-full.txt、feed.xml、_headers、_redirects、404.html。
  5. 输出静态资源把单文件 CSS 与 JS 复制到 assets 目录,无外部字体、无框架、无构建依赖。
为什么不用现成静态站生成器这个项目页面结构固定、内容以中文长文为主,一个百来行的 Node 脚本就能完全掌控输出,比引入框架更可控、更容易按需注入 SEO/GEO 标签,也不产生依赖升级负担。选工具的标准是「够用且可控」。

四、Cloudflare Pages 三种部署方式

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

  1. 推仓库把项目推到 GitHub / GitLab,私有仓库也可以。
  2. 创建项目Cloudflare 控制台 → Workers 和 Pages → 创建 → Pages → 连接到 Git。
  3. 填构建配置框架预设选 None,构建命令留空(或填 node build.mjs 并把 site/ 提交到仓库),构建输出目录填 site。
  4. 部署保存后自动构建,之后每次 push 到生产分支都会自动重新部署。

方式 B:直接上传目录(最快,不用 Git)

控制台创建 Pages 项目时选「直接上传」,把本地 site/ 文件夹拖进去即可。适合一次性交付、客户不打算自己维护代码的情况。后续更新需要重新上传整个目录。

方式 C:Wrangler CLI(适合自动化)

npm install -g wrangler
wrangler login
wrangler pages deploy site --project-name=my-site

可以放进 CI 里,配合构建脚本实现「内容改动 → 自动部署」。

五、_headers 与 _redirects:Pages 的两个隐藏利器

这两个文件放在输出目录根部,Cloudflare Pages 会自动识别,等价于给站点加了一层轻量的服务器配置。

_headers 用来设置缓存与安全响应头,示例:

/*
  X-Content-Type-Options: nosniff
  X-Frame-Options: SAMEORIGIN
  Referrer-Policy: strict-origin-when-cross-origin
  Permissions-Policy: geolocation=(), microphone=(), camera=()

/assets/*
  Cache-Control: public, max-age=31536000, immutable

/*.html
  Cache-Control: public, max-age=0, must-revalidate

_redirects 用来做 URL 规范化与旧链接跳转(迁移时保排名很关键):

/home  /  301
/wordpress-jianzhan  /services/wordpress/  301
/blog/old-post  /blog/wordpress-build-cost/  301
/*  /404.html  404
注意URL 规范化(带不带 www、http → https)优先在 Cloudflare 的「批量重定向」或页面规则里做,避免在 _redirects 里写通配规则造成循环。改版时一定要先整理 301 映射表再上线。

六、绑定自定义域名与 HTTPS

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

绑定完成后回到 site.config.mjs 把 baseUrl 改成正式域名,重新构建并部署一次 —— canonical、OG、sitemap、llms.txt 里的绝对地址会全部同步,避免出现「站点地图还指向 pages.dev」这类问题。

七、静态站的 SEO 与 GEO 注意点

项目做法常见错误
内容可见性正文直接写在 HTML 里,语义标签完整内容靠 JS 异步注入,爬虫与 AI 抓不到
URL目录式 /blog/slug/ + index.html链接指向 .html 文件却又配了目录式 canonical
canonical / OG用配置里的正式域名生成绝对地址沿用开发用的 localhost 或 pages.dev 地址
sitemap.xml由构建脚本按页面清单自动生成手维护,新增文章忘记加进去
robots.txt允许主流搜索引擎与 AI 爬虫把开发环境的 Disallow 带到正式站
llms.txt站点说明 + 核心页面清单,供 AI 读取写成营销文案,没有可引用的事实
结构化数据每页按类型注入 JSON-LD 并用 @graph 统一实体多页声明互相矛盾的品牌实体信息

一句话:静态站的 SEO 上限取决于 HTML 质量,不取决于有没有 CMS。把标签、结构、内链和内容做扎实,静态站往往因为速度快而更有优势。GEO 的具体配置可以看 生成式引擎优化完全指南。

八、常见报错速查

现象原因处理
首页 404输出目录填错,或 index.html 不在根目录确认构建输出目录是 site,且 site/index.html 存在
样式全丢页面里用了 /assets/... 绝对路径改用相对路径,或确认部署在域名根目录
子页 404用了 /about 这样的链接但没有 /about/index.html统一目录式 URL,末尾带斜杠
更新后还是旧内容CDN 缓存未刷新Pages 里重新部署,必要时 Purge Cache 后等回温
canonical 指向旧域名配置没改就部署改 site.config.mjs 后重新构建

小结

静态站不是「低端建站」,而是一种把复杂度前置到构建阶段、把运行时降到最低的架构选择。对展示型官网和内容站,它带来的速度、安全与零维护优势非常直接;代价只有一个 —— 内容更新要走构建流程。选之前先问自己一句:未来一年会不会每周发内容?

需要按这套架构交付一个站,可以看 静态站与 Cloudflare 部署服务的包含项、完整的静态站部署步骤,或直接对照 AI 静态站三档方案报价。

常见问题

静态网站会影响 SEO 收录吗?

不会。搜索引擎抓取的是最终 HTML,只要内容直接写在 HTML 里、语义标签完整、sitemap 与 canonical 正确,静态站与动态站在收录上没有差别,速度上通常还更有优势。要避免的是内容必须执行 JavaScript 才能出现的纯客户端渲染做法。

Cloudflare Pages 是免费的吗?

Pages 提供较宽松的免费额度,个人与中小展示站通常完全够用,包含全球 CDN、自动 HTTPS 与持续部署。超出额度的带宽或构建次数按官方套餐规则计费,具体以 Cloudflare 当期文档为准。

静态站没有后台,客户怎么更新内容?

三种常见做法:一是改 Markdown/数据文件后重新构建部署;二是接一个 Headless CMS(内容变动触发重新构建);三是把 WordPress 当内容后台,前端静态化输出。内容更新频繁的团队更适合第二或第三种。

部署后页面 404 或样式丢失怎么排查?

最常见三个原因:构建输出目录填错、页面里用了绝对路径导致子目录资源 404、以及目录式 URL 没有对应的 index.html。建议全站使用相对路径,并在部署前本地起静态服务器逐页检查链接。

云序 · 云序建站

提供 WordPress 建站、AI 建站、网站速度优化、站内 SEO 与 GEO 生成式引擎优化服务。全国远程接单,价格与包含项全部公开。了解工作方式 →

有具体项目想聊?

把行业、页面数量和预算发过来,我给你页面清单与明确报价。