CFCF Static Export ProDEMO

从 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. 发布一篇文章

新建一篇普通文章,选分类,点发布。插件会在后台做三件事:

  1. 调 Worker 的 /d1-batch 写入文章与分类关系;
  2. 生成静态 HTML(内部模板 → 前台抓取 → 兜底);
  3. 上传 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 的独有设置。

发表评论

邮箱不会被公开。带 * 的为必填项。