从 WordPress 出发:装插件、配目标、发第一篇文章
这条路线适合谁
- 已经有 WordPress 站,文章、媒体、评论都在里面;
- 不想迁移内容,也不想放弃 WP 的编辑器与插件;
- 想让前台跑在 Cloudflare 上,最好还能省掉源站。
1. 安装插件
把 cf-static-export-pro 目录放进 wp-content/plugins/,在后台启用。
启用后左侧会出现「CF 静态导出」菜单。设置页分成两列:
- 左列:托管目标、CMS 自托管设置(文章导出 / 评论同步 / Worker 端管理)
- 右列:状态面板、静态托管设置、基础配置、最近日志
2. 配置一个 Cloudflare 目标
「🎯 托管目标 → 添加目标」,选 cloudflare,填:
| 字段 | 说明 |
|---|---|
| 账号 ID | Cloudflare 账号 ID(Dashboard 右侧可见) |
| API Token | 需要 D1 编辑 + R2 编辑权限 |
| D1 数据库 ID | Worker 绑定的那个 D1 |
| R2 桶名 | 例如 wordpress |
| 站点 URL | 例如 https://demo.example.com |
| X-Auth-Key | 与 Worker 的 AUTH_KEY 一致 |
填完点「测试连通性」,四项都通过再保存。
如果你只用 WordPress 导出、不用 Worker CMS,也可以把目标换成 S3、GitHub、Netlify、Vercel、FTP、WebDAV 或本地目录。
3. 选择发布行为
「发布行为」里三个开关决定一篇文章保存时做什么:
- 同步 D1:把结构化数据写进 D1(列表页需要);
- 生成静态文件:在本地生成 HTML;
- 上传远端:把 HTML 和媒体传到 R2。
第一次建议全开,先跑通链路。之后可以按需关闭,比如只同步 D1、不生成静态页。
4. 发布一篇文章
新建一篇普通文章,选分类,点发布。插件会在后台做三件事:
- 调 Worker 的
/d1-batch写入文章与分类关系; - 生成静态 HTML(内部模板 → 前台抓取 → 兜底);
- 上传 R2,并清理列表缓存。
然后访问 https://<你的域名>/<slug>/ 验证。
5. 选一套列表页风格
Worker 渲染列表页需要模板。后台 → 模板 → 风格应用,内置风格可以直接选;想自己写的话,一套风格就是一个目录 + tpl.json + style.css,见风格系统。
换风格后列表页立即生效,已生成的单页需要重建。
6. 批量导出旧文章
文章列表页支持勾选 + 批量导出;也可以用 tools/bulk-export-worker.php 走 CLI,适合几千篇的站。
导出过程是分片 + 多进程并发的,单篇失败会记录日志但不阻塞整批。
和独立 CMS 的关系
两条路线不是二选一。常见做法是:
- 继续用 WordPress 写长文;
- 用 Worker CMS 管理分类、媒体与评论;
- 需要时把 Worker 上的改动拉回 WordPress。
数据以 D1 为准,WordPress 侧只做"推送",不会整行覆盖 CMS 的独有设置。