Next.js 博客能排上去，也可能因为第一天就忘了默认项而消失：纯客户端文章页、缺少 sitemap、稀薄 meta、臃肿图片。这份 2026 SEO 清单面向带着真实 CMS 发 Next.js 博客的团队，并说明 ReactPress 如何盖住那些无聊但关键的基础，让你专注内容。

相关文档： 站点设置与 SEO · 60 秒搭博客 · 主题开发

1. 为爬虫渲染 HTML（SSR / ISR）​

要做： 文章与页面模板服务端渲染（或带 revalidate 的 ISR）。
别做： 只在 useEffect 里拉文章，首屏空壳。

ReactPress 官方主题对访客路由使用 Next.js SSR/ISR。若你 fork 主题，请保持文章页在服务端路径上。

2. 每个 URL 唯一的 title 与 meta description​

清单：

• <title> 唯一，约 50–60 字符，自然包含主关键词
• Meta description 约 150–160 字符，匹配搜索意图
• 分页 / 标签归档无重复标题

在 ReactPress Admin 启用 SEO 插件，设置单篇 title/description/slug。主题 SSR 应输出这些字段。

3. Canonical URL​

• 每个可索引页有绝对 canonical
• 预发 / 预览主机 noindex
• 尾斜杠策略一致

上线前在生产配置写好公网站点 URL：配置说明。

4. Sitemap 与 robots.txt​

• /sitemap.xml 列出文章与页面（多语言则含 hreflang）
• robots.txt 允许抓取，并指向 sitemap
• 在 Google Search Console / Bing 提交 sitemap

ReactPress starter 主题提供 sitemap/robots 模式 — 启用主题后请核验。见 SEO 设置。

5. Open Graph 与 Twitter Card​

• og:title、og:description、og:url、og:image
• 图片 ≥ 1200×630，并压缩
• 上线后用各平台调试工具验证

6. 结构化数据​

博客/CMS 常用类型：

用 Google Rich Results 测试验证。ReactPress 文档站自身的 JSON-LD 模式可在主题中借鉴。

7. Core Web Vitals 与媒体​

• LCP：头图/文章图尺寸正确并优先加载
• CLS：图片/嵌入指定尺寸
• INP：文章页避免沉重第三方脚本
• 尽量 WebP/AVIF

ReactPress image-optimizer 插件可辅助批量 WebP — 再配合主题里合理的 next/image。

8. 信息架构与内链​

• 清晰的枢纽页（是什么 / 对比 / 快速开始）
• 文章链到支柱文档；文档链回文章
• 锚文本有语义 — 不要「点击这里」

建议每篇 SEO 文都链到：

• ReactPress 是什么？
• 对比 WordPress
• 自托管 CMS

9. CMS 主题的性能预算​

主题指引：外观与主题 · 主题开发。

10. 上线核验​

1. curl -I 生产 URL — 200、缓存头正确
2. 查看源代码 — 不跑 JS 也能看到 title/meta
3. Search Console 覆盖率 — 修被 robots 排除的意外
4. 对比预发与生产的 canonical 主机

ReactPress 对 SEO 有帮助的默认项​

npm i -g @fecommunity/reactpress
mkdir my-blog && cd my-blog
reactpress init

更多：自托管 Next.js CMS 指南 · 面向 React 的 WordPress 替代。

常见问题​

App Router 会改变这份清单吗？
不会 — 爬虫仍需要有意义的 HTML 与 metadata API（如 generateMetadata）。

Headless CMS 对 SEO 够用吗？
只有当你的 Next 应用实现了清单才够。CMS 本身不会排名。

ReactPress SEO 在哪配置？
站点设置与 SEO。

English

WordPress 仍占据很大份额。但对 React 开发者来说，痛点很熟悉：PHP 主题、插件体积、以及与产品其他部分不一致的前端栈。

本指南梳理 2026 年面向 React 团队的务实 WordPress 替代方案 — 各自真正交付什么，以及何时 ReactPress 是更好的默认选择。

相关： ReactPress vs WordPress · ReactPress 是什么？ · 长文：为什么 React 还没有自己的 WordPress

React 团队通常想从 WP 替代里得到什么​

1. 熟悉的发布体验 — 文章、页面、媒体、角色
2. 现代交付 — React / Next.js SSR，而不是 PHP 模板
3. 可选 Headless — 给应用 API，同时保留 Admin
4. 自托管或清晰许可 — MIT/开源，少突袭式锁定
5. 上线时间 — 小时级，而不是一个季度

很少有工具五项全中。下面看常见选项如何得分。

1. ReactPress — 面向 React 的发布平台​

最适合： 要 WordPress 式工作流、又要 React 技术栈的团队。

npm i -g @fecommunity/reactpress
mkdir my-site && cd my-site
reactpress init

试用教程：用 Next.js 60 秒搭建博客。

代价： 插件市场相对 WordPress 仍年轻。能用 JavaScript 扩展时，你会赢。

2. Headless CMS（Strapi、Payload、Sanity、Contentful）​

最适合： 多端内容 API，且 Next.js 站点是独立产品。

代价： 仍需自建访客站、SEO 管道，常还有预览。见 ReactPress vs Strapi vs Payload。

3. Next.js + MDX / Contentlayer / Velite​

最适合： Git 即 CMS、每位作者都是开发者的文档与博客。

代价： 非技术编辑吃力；媒体库/评论需另接服务。

4. Headless WordPress + Next.js 前端​

最适合： 保留 Gutenberg/编辑插件，同时用 React 重建公开站。

代价： 要运维 两套复杂系统（WP + Next），同步/预览故事并不轻松。

5. Ghost、Hashnode、Beehiiv 等​

最适合： 邮件通讯与纯博客、偏托管便利。

代价： 作为文档 + 营销 + 定制应用的通用 React CMS 不够理想；托管与数据控制因产品而异。

对比快照​

何时继续留在 WordPress​

• 编辑强依赖 WooCommerce、页面构建器或小众 WP 插件
• 主题/插件迁移成本高于继续用 PHP 的痛苦
• 需要一键式托管 WordPress

否则，若公司其余部分都是 React，仅为营销站保留 PHP 通常是技术债。

迁移草图（WordPress → ReactPress）​

1. 导出文章（XML/API），经脚本或 Headless API 映射到 ReactPress
2. 用 Next.js 重建主题（或从 theme-starter 开始）
3. 旧固定链接 301 到新路由
4. 复查 sitemap、canonical 与 Core Web Vitals

FAQ：能否从 WordPress 迁移？

结论​

对 2026 年的 React 开发者，最佳 WordPress 替代取决于你要的是内容 API还是发布平台。

• 只要 API → Strapi / Payload
• 只要 Git 文档 → MDX
• 想像 WordPress 一样发布、用 Next.js 交付 → ReactPress

从这里开始：ReactPress vs WordPress（2026）。

English

「我们要一个自托管的 Next.js 博客」听起来简单。实操上往往会拆成三个项目：CMS、Admin、主题 — 外加备份、SEO 与鉴权。本指南给出一条务实的 2026 路径：数据留在自有基础设施上，体验仍像产品，而不是周末硬拼。

一句话： 用已经接好 Admin + API + Next.js 主题的发布平台。ReactPress 的 reactpress init 约 60 秒拉起本地栈，默认 SQLite（无需 Docker）。

相关文档： 面向 React 的自托管 CMS · 60 秒 Next.js 博客 · 生产部署

「自托管 Next.js CMS」应包含什么​

少任何一层，你又回到 Strapi + create-next-app + 自研上传路由。

方案 A — DIY（灵活，慢）​

典型栈：

1. Strapi / Payload / 仓库里的 MDX
2. 自建 Next.js App Router 站点
3. 预览模式、Webhook 重建、图片流水线
4. 自研鉴权与角色

优点： 控制力最大。缺点： 编辑能安全发文前可能要数周；每个 CVE 与升级都归你。

DIY 适合平台团队，对公司博客往往过贵。

方案 B — ReactPress（产品化自托管）​

ReactPress 是面向 React 开发者的开源发布系统：

• NestJS API（默认 Headless REST）
• Vite Admin（文章、页面、媒体、评论、主题、插件）
• 带 SSR SEO 的 Next.js 主题
• Hook 插件（SEO、摘要、图片优化等）
• 可选 Electron 桌面端离线写作

npm i -g @fecommunity/reactpress
mkdir my-blog && cd my-blog
reactpress init

默认账号：请立即修改 admin / admin。

自托管的数据库选择​

务必备份数据库 + uploads/。配置说明：配置项。

自托管 Next.js 博客 SEO 清单​

1. 启用 SEO 插件并填写单篇 meta
2. 确认主题 /sitemap.xml 与 robots.txt
3. 生产环境写好公网站点 URL
4. 使用 SSR/ISR — 避免纯客户端文章页
5. 压缩图片（内置 image-optimizer 可辅助）

详情：站点设置与 SEO。

生产环境提纲​

1. VPS 或 Node 主机 + 反代（Caddy/Nginx）
2. 进程管理或 Docker 跑 API + 主题
3. TLS、限制 Admin 暴露、轮换密钥
4. 定时备份 DB + uploads
5. 部署后跑 reactpress doctor

完整指南：生产环境部署。

自托管 vs SaaS​

要零运维选 SaaS；要数据主权与 React 栈统一选自托管。

常见问题​

需要 Kubernetes 吗？
不需要。很多博客跑在单台 VM 上。

能保留自己的 Next.js 应用吗？
可以 — Headless API + API Key。见 Headless API。

4.0 能上生产吗？
4.0.0 稳定版；从 3.x 升级请先预发。FAQ · 3→4 迁移。

从这里开始​

npm i -g @fecommunity/reactpress
mkdir my-blog && cd my-blog
reactpress init

接着阅读 ReactPress 是什么？ 与 面向 React 的自托管 CMS。

English

如果团队以 React / Next.js 为主栈，内容基础设施候选往往是：Strapi、Payload，再加上 Contentful 或 Sanity — 然后有人问：「博客本身放哪？」

这个问题暴露了品类缺口。Headless CMS 擅长内容 API 与后台建模，但不会把访客向 Next.js 站点、WordPress 式发布流程、主题 catalog 与 SEO 流水线作为同一个产品交付。

ReactPress 站在缺口另一侧：面向 React 开发者的发布系统 — Admin + NestJS API + Next.js 主题 + 插件 + 桌面端 — 同时默认提供 Headless REST。

本文对比 ReactPress vs Strapi vs Payload，帮你选对系统形态，而不是只追最潮的 API。

相关文档： ReactPress 是什么？ · Headless API · 对比 WordPress

快速对比​

Headless CMS 擅长什么​

Strapi、Payload（及同类）在这些场景很强：

• 多端（Web、App、终端）共享一套内容 API
• 设计系统 / Next 应用本身就是产品
• 编辑只需结构化字段 — 不需要主题市场
• 你愿意自建 SSR、sitemap、OG、预览与部署胶水

若这就是现状，Headless CMS 常常是正确选择。ReactPress 并不想取代每一个 Strapi 部署。

Headless 留下的空洞​

营销站与工程博客仍需要：

1. 能排名的公开站点（SSR/ISR、Core Web Vitals）
2. 接近「写作 → 发布 → 立刻可见」的编辑体验
3. 媒体、评论、SEO meta，以及常要的桌面/离线路径
4. 不必重写 CMS 就能换的主题

用 Strapi/Payload 时你要自己拼这些层。很多团队低估拼装成本 — 最后变成三个仓库，连 sitemap 都没有。

ReactPress 用一条 CLI 把这些层接好：

npm i -g @fecommunity/reactpress
mkdir my-site && cd my-site
reactpress init

• 访客站（Next.js）：http://localhost:3001
• Admin：http://localhost:3001/admin/
• API：http://localhost:3002/api/health

教程：用 Next.js 60 秒搭建博客。

ReactPress：包含 Headless，但不只是 Headless​

ReactPress 具备 Headless 能力：

• 文章、页面、分类等 REST 端点
• API Key 与 Webhook
• @fecommunity/reactpress-toolkit 类型化客户端

但产品承诺更广：Admin 管内容 · 主题管呈现 · 插件管逻辑 · API 管数据。

用官方主题快速上线；需要定制前端时 fork reactpress-theme-starter — 不必丢掉 Admin。

选型指南​

选 Strapi 或 Payload： 你已有（或将自建）访客应用，CMS 应保持为纯内容后端。

选 ReactPress： 你需要自托管的 React 发布栈 — 博客/文档/营销站 — 带 SSR SEO 与可选 Headless，又不想重做 Admin + 主题 + SEO。

仍在用 WordPress？ 见 ReactPress vs WordPress（2026） 与长文 为什么 React 还没有自己的 WordPress。

常见问题​

ReactPress 是 Strapi 竞品吗？
部分重叠在内容 API。ReactPress 更像「WordPress + 现代前端」的对手，而不是纯 API CMS。

可以只当 API 用吗？
可以。任意 React 应用对接 Headless API，忽略默认主题即可。

Payload 比 ReactPress「更 Next.js」吗？
Payload 的 Admin 是 Next 原生；ReactPress 的访客主题是 Next.js，Admin 是 Vite SPA。切分不同，都对 React 友好。

许可？
ReactPress 为 MIT。请自行核对 Strapi/Payload 版本与托管条款。

下一步​

• ReactPress 是什么？
• 面向 React 的自托管 CMS
• Headless API 指南
• 主题开发

English

如果你是一名前端工程师，大概率经历过这样的循环：

1. 团队决定用 React / Next.js 做官网或博客；
2. 你评估 Strapi、Payload、Contentful、Sanity……各自都不错，但没有一个是「装完就能写、写完就能发」的完整发布平台；
3. 你 fork Next.js 博客模板，接上 Headless 后端，再自己搭媒体库、评论、SEO、部署脚本；
4. 三个月后博客还没上线，你却维护了五个仓库。

与此同时，WordPress 依然占据全球 40%+ 的网站份额。PHP 被嘲笑「过时」，Gutenberg 被吐槽，可它仍是无数站长、内容团队、中小企业的默认选择。

React 已经统治前端十年，为什么仍然没有自己的 WordPress？

这不是技术能力问题，而是产品形态问题。过去三年我们反复听到同一个需求：「能不能像 WordPress 一样管内容，但前台用 Next.js？」现有方案要么只给 API，要么把 Admin 和主题焊死，要么需要 Docker + MySQL + 六个 npm 包才能写下第一段文字。

于是我们做了 ReactPress 4.0——面向 React 时代的开源发布平台（Open Source CMS / React Publishing Platform），而不是又一个需要你自己拼装的 Headless 后端。

SEO 关键词： React CMS · Next.js CMS · WordPress alternative · React publishing platform · Open source CMS

目录​

1. 一句话总结
2. 行业问题
3. WordPress 为什么成功
4. React 生态缺失
5. ReactPress 理念
6. 系统架构
7. 眼见为实
8. Admin 写作界面
9. 主题系统
10. 插件系统
11. 桌面客户端
12. Headless API
13. SEO 与性能
14. 安全模型
15. 部署模式
16. 迁移路径
17. 适用场景
18. 路线图
19. 常见问题
20. 快速开始
21. 结语

关于本文： 中文完整版 · 与英文版结构对应 · 最后更新 2026-07-12 · English version

一句话总结​

npm i -g @fecommunity/reactpress
mkdir my-site && cd my-site
reactpress init

一、行业问题​

现代内容系统逼你在编辑体验、前端自由度、开箱即用之间做取舍。

1.1 不可能三角​

WordPress 式 CMS：会写，但跑不快​

内容、主题、插件焊在 PHP 运行时里。对非技术用户友好，但 React 团队难以复用组件库，Headless 是后补路径，性能常依赖缓存插件。

静态站点生成器：快，但没有真 CMS​

内容变更 = 开发者改 Markdown + CI 构建。运营无法独立发稿。

Headless CMS：灵活，但要自己组装整机​

Strapi、Payload 等把 API 做得很好，但通常不交付访客站和日常写作 UI。典型路径：选型 → 配 Schema → 写 Next.js 前台 → 做 SEO → 配媒体 → 写部署脚本——对「这周就要上线的博客」过重。

1.2 前端负责人的真实一周​

周一 产品要博客+SEO+运营发稿。周二 选定 Strapi，搭 Docker。周三 写 Next.js 前台。周四 做 sitemap/OG/评论。周五 部署四套 CI。 下周一 产品问：「什么时候能发文？」

问题不是某个工具差，而是没有人交付完整的发布闭环。ReactPress 要结束这个循环。

1.3 为什么「再做一个 Headless CMS」不够​

行业不缺 Headless，缺的是：

1. 默认就有的生产级访客站
2. 运营愿意每天打开的 Admin
3. 装插件而非 fork core 的扩展点
4. doctor 一条命令的诊断入口

二、WordPress 为什么成功​

2.1 唯一入口，零决策疲劳​

下载 → 数据库 → /wp-admin/。一条路径。ReactPress 学习这一点：reactpress init 约 60 秒得整机。

2.2 Core / Theme / Plugin 边界​

2.3 插件生态即生命力​

WordPress 60,000+ 插件。ReactPress 4.0 用 plugin.json + Hook 让扩展成为平台一等公民。

2.4 我们学习的与拒绝的​

学习： 唯一入口、清晰边界、作者优先、数据可迁移。
拒绝： PHP 主题焊死 Admin、用插件数量掩盖架构债、默认绑定臃肿 Docker 栈。

Same editing workflow, modern Next.js delivery.

三、React 生态缺失​

                    编辑者友好
                        ↑
          WordPress     |     ReactPress（目标位）
                        |
    Headless ───────────┼─────────── 全栈框架
                        ↓
                    开发者友好

缺口在右上角： 编辑者与开发者都满意，技术栈统一在 React/Next.js。

3.1 主流方案对比​

搜索 「Next.js CMS」 多半是如何接入 Headless 的教程，而非一条命令装完整 CMS——这就是产品缺口。

3.2 社区里反复出现的话​

• 「我们已经在用 Next.js，不想为博客再上 PHP WordPress。」
• 「Strapi 能用，但前台花了两个周末。」
• 「有没有自托管开源方案，而不是又一个组装套件？」

ReactPress 4.0 的每一项能力——bundled CLI、SQLite 默认、npm 主题、Hook 插件、Electron 桌面——都对应真实用户故事。

3.3 ReactPress 迭代脉络​

四、ReactPress 理念​

Admin 管内容 · 主题管呈现 · 插件管逻辑 · API 管数据 · Toolkit 管契约

4.1 与 Headless CMS 的差异​

4.2 架构红线​

1. Admin 不服务访客页；主题不服务 /admin/
2. 所有前端仅通过 Toolkit 访问 API
3. Server 不依赖任何前端包
4. 主题禁止直连数据库

4.3 三十秒上手​

npm i -g @fecommunity/reactpress
mkdir my-site && cd my-site
reactpress init

默认 SQLite，无需 Docker。reactpress doctor 诊断环境问题。

4.4 两类用户​

4.5 与可视化建站器的边界​

Webflow、Framer 适合营销落地页；ReactPress 服务把代码当资产的团队——主题在 Git、内容在 CMS。

五、系统架构​

5.1 创作到交付​

1. 作者在 Admin / Desktop 创建内容
2. 请求经 Toolkit 到 NestJS API
3. Plugin 在 Hook 点处理 SEO、摘要等
4. 写入 SQLite / MySQL
5. Next.js 主题 SSR/ISR 渲染给访客

5.2 包职责​

5.3 目录结构​

my-site/
├── .reactpress/
│   ├── config.json
│   ├── runtime/{theme-id}/
│   ├── plugins/{plugin-id}/
│   └── reactpress.db
├── .env
└── uploads/

备份：tar czf backup.tar.gz .reactpress uploads

5.4 技术选型​

5.5 端口​

六、眼见为实​

6.1 CLI：约 60 秒从安装到上线​

6.2 访客站：搜索、评论、知识库、深色模式​

在线演示：reactpress-theme-starter.vercel.app

6.3 Lighthouse​

官方主题 Demo 可达 Performance 95 / SEO 100（生产环境因托管与内容而异）。

6.4 在线 Demo​

七、Admin 写作界面​

7.1 文章编辑器​

Markdown 编辑、草稿发布、分类标签、知识库与页面类型。

7.2 媒体库​

7.3 插件管理​

7.4 外观与设置​

八、主题系统​

主题 = 呈现。 访客看到的是可替换的 Next.js 应用。

8.1 官方主题​

reactpress theme add @fecommunity/reactpress-theme-starter@1.0.0-beta.0

8.2 主题内拉取数据​

import { createThemeApi } from '@fecommunity/reactpress-toolkit/theme';

const api = createThemeApi({ baseURL: process.env.NEXT_PUBLIC_API_URL });
const { data } = await api.article.list({ status: 'publish', page: 1 });

8.3 SEO 分工​

Admin + SEO 插件写元数据；主题 SSR 渲染 title、OG、JSON-LD、sitemap。

详见 主题开发。

九、插件系统​

主题 = 呈现 · 插件 = 逻辑

9.1 生命周期​

发现 → 安装 → 启用 → 配置 → （可选）卸载

9.2 Hook 示例​

export function register(hooks: PluginContext['hooks']) {
  hooks.addFilter('article.beforePublish', async (article) => {
    if (!article.summary) {
      article.summary = article.content.slice(0, 160);
    }
    return article;
  });
}

9.3 与 WordPress 插件的诚实对比​

WordPress 有海量即装插件；ReactPress 机制就绪、内置 SEO/摘要/图片优化，更适合能写代码的团队按需扩展。

详见 插件开发。

十、桌面客户端​

WordPress 没有原生的离线本地写作对等物。ReactPress Desktop = Electron 壳 + 同一套 Admin SPA。

安装包：GitHub Releases · 桌面客户端文档

十一、Headless API​

curl -H "X-API-Key: YOUR_KEY" \
  "http://localhost:3002/api/article/headless/list?status=publish&page=1&pageSize=10"

Swagger：http://localhost:3002/api

详见 Headless API 指南。

十二、SEO 与性能​

对比 ReactPress vs WordPress。

十三、安全模型​

3.7+ 重点：

• SQL 注入：公开列表 API 列名白名单
• 存储型 XSS：评论 HTML 消毒、JWT、Helmet CSP
• 报告：SECURITY.md

生产清单：改默认密码、HTTPS、定期备份 .reactpress/ 与 uploads/。

十四、部署模式​

详见 生产部署、Docker 部署。

十五、迁移路径​

十六、适用场景​

自测： 若 ≥3 条成立值得试用——主栈 React/Next、非开发者需发稿、要自托管开源、厌倦五仓库拼装、不想引入 PHP、关心 SSR SEO。

客观对比：ReactPress vs WordPress。

16.1 三个用户故事​

独立开发者 Alice — reactpress init，周日下午发文，Lighthouse 跑绿，不需要 Strapi 或 PHP。

开源维护者 — 文档走知识库 API，changelog 走文章 API，贡献者用 Admin 发稿。

营销 + 前端并行 — 运营在 Admin 排期；前端 fork 主题做品牌动效；插件 Hook 通知 Slack。

16.2 何时仍选 WordPress​

• 依赖海量现成插件（电商、会员、复杂表单）
• 已有大量 PHP 主题/插件投资
• 团队完全非技术、不愿碰 JavaScript

十七、路线图​

近期（4.x）​

• 插件 npm catalog、reactpress plugin create
• Desktop 自动更新、托盘、快捷键
• reactpress theme create
• 主题/插件市场

长期愿景​

让「React 技术栈的默认发布方式」像 WordPress 一样被脱口而出：

npm i -g @fecommunity/reactpress
reactpress init

十八、常见问题​

免费吗？ MIT 开源，可商用。

4.0 能上生产吗？ 核心路径已大量验证；staging 验证后升级，见 迁移指南。

必须 Docker 吗？ 默认 SQLite，不必须。

能用自己的前台吗？ Headless REST + API Key + Toolkit。

和 Strapi 怎么选？ 它们主要交付 API；ReactPress 交付完整发布平台。

能从 WordPress 迁移吗？ 内容可以；主题需重写。

更多：FAQ

18.1 扩展问答​

Windows 能用吗？ CLI 与 Desktop 均支持 Windows 10+。

能跑多个站点吗？ 可以，不同目录 + 不同 config.json 端口。

必须用官方主题吗？ 否，Headless API + 自研 Next 即可。

GraphQL？ 标准交付为 REST；GraphQL 需自建网关或插件。

桌面端必须装吗？ 否，Web Admin 已完整；桌面端面向离线场景。

Node 版本？ 当前推荐 Node.js 20+。

附录：对比速查​

A. ReactPress vs WordPress（2026）​

B. ReactPress vs Headless 拼装​

C. 发布流水线（概念）​

作者点击发布
  → Toolkit 请求 API
  → Hook: article.beforePublish（插件改 SEO、摘要）
  → 持久化
  → Hook: article.afterPublish
  → Webhook 通知外部系统
  → 主题 SSR/ISR 拉取新内容

D. 运维极简清单​

• 每日： 扫一眼评论审核队列
• 每周： 看 reactpress logs、检查磁盘
• 每月： 测试备份恢复、轮换 API Key

十九、快速开始​

npm i -g @fecommunity/reactpress
mkdir my-blog && cd my-blog
reactpress init

1. 打开 http://localhost:3001/admin/（默认 admin / admin）
2. 写第一篇文章，启用 seo 插件
3. 在 http://localhost:3001 查看 SSR 结果

下一步：5 分钟创建第一个站点、ReactPress 4.0 指南、系统架构。

二十、结语​

React 改变了我们如何构建界面，却没有同等改变我们如何发布内容。WordPress 告诉我们：赢家靠唯一入口、清晰边界、作者优先、可扩展生态、可迁移数据。

ReactPress 4.0 把这些原则翻译到 React 时代：

若你在搜索 React CMS、Next.js CMS、WordPress alternative、open source CMS——从这里开始：

npm i -g @fecommunity/reactpress
mkdir my-blog && cd my-blog
reactpress init

Build. Manage. Extend.

相关链接​

• GitHub 仓库
• 在线 Demo
• 英文版长文
• ReactPress 4.0 指南
• ReactPress vs WordPress
• 更新日志

ReactPress 由 fecommunity 开发，MIT 许可证发布。

ReactPress 4.0.0 稳定版 — npm @latest（#88）。安装：npm i -g @fecommunity/reactpress。

亮点​

• 发布：4.x 从 @beta 提升为 @latest
• 文档 / README / Admin：默认安装路径为稳定版 4.0.0
• 发布 CLI：支持 promote to stable；resolveNpmTag 将 4.0.0 映射到 latest

4.0.0-beta.18 (2026-07-12)​

ReactPress 4.0 beta.18 — 当时 npm @beta 标签。安装：npm i -g @fecommunity/reactpress@beta。

亮点​

• CLI：零依赖捆绑运行时、主题安装/代理改进、doctor 与日志体验优化
• 桌面端：跨平台安装包构建工作流；发布时自动上传至 GitHub Releases
• 文档：Algolia DocSearch、changelog 版本侧栏、首页版本标签；README 与演示素材更新
• 资源：star history 图表迁移至 public/star-history/

4.0.0-beta.0 (2026-06-27)​

ReactPress 4.0 扩展版（beta） — 插件、桌面客户端、主题 catalog。安装：npm i -g @fecommunity/reactpress@beta。

新特性​

• 插件系统 (#69)：Hook + plugin.json manifest + Admin 插槽；内置 hello-world（自动摘要）、seo（SEO 增强）、image-optimizer（历史图片 WebP 批量优化）
• 桌面客户端 (#70)：Electron + SQLite 本地模式；远程 API 与内容同步
• 主题系统 (#71)：npm catalog（theme-starter）、theme add/list、预览池；hello-world 文档与结构对齐
• 迁移指南：3.x → 4.0

3.7.0 (2026-06-23)​

安全修复 — SQL 注入与存储型 XSS 修复。

新特性​

• SQL 注入：公开列表 API findAll() 中过滤字段名白名单校验
• 存储型 XSS：Markdown 解析后 HTML 消毒；POST /comment 需 JWT；Helmet CSP 响应头
• 致谢：lsr365400

3.6.0 (2026-06-14)​

文档 CI/CD 与部署 — 自动化文档流水线，Vercel 配置迁移。

新特性​

• 文档部署：GitHub Actions CI/CD 自动部署文档站点
• Vercel：配置迁移至仓库根目录；文档链接更新为新部署地址
• CI：移除已弃用的 deploy workflow；MySQL 镜像改用 AWS ECR 公共镜像，加速 GHA 构建
• 配置：改进部署配置中 DOCS_SITE_URL 的处理

3.5.0 (2026-06-14)​

主题目录 — 基于 npm 的主题发现与管理。

新特性​

• 新增 theme.catalog.schema.json 与 themes/package.json

3.4.0 (2026-06-12)​

社区 — 更清晰的 Issue 反馈体验。

新特性​

• 优化 Bug 报告、功能请求与配置类 Issue 模板

3.3.0 (2026-06-07)​

社区与安全 — 行为准则与漏洞报告机制。

新特性​

• 新增 CODE_OF_CONDUCT.md 与 SECURITY.md

3.2.0 (2026-06-07)​

主题开发 — 面向主题作者的 Next.js 工具链。

新特性​

• 新增 Next.js 配置与 node helpers，完善主题开发工作流

3.1.1 (2026-06-07)​

Bug Fixes​

• 修正 theme.manifest.schema.json 的 $id URL

3.1.0 (2026-06-07)​

Toolkit 主题化重构 — 模块化导出，主题开发一等公民。

新特性​

• Toolkit 3.1：拆分为 theme / ui / app / plugin 子模块；主题 manifest 解析、外观配置（Formily）、SSR bootstrap、站点设置与预览
• CLI 3.0.3：reactpress nginx 反向代理；db backup 支持 Docker 内 mysqldump；build 目标选择与分步日志；交互体验优化
• 品牌资产：public/brand/ 集中管理 + pnpm export:brand 一键同步至各目录
• 文档：README 新增官方主题章节与 Lighthouse 性能指标

Bug Fixes​

• 增强 monorepo 根目录检测；主题 manifest schema URL 更新为 reactpress-docs.vercel.app

3.0.0 (2026-05-17)​

ReactPress 3.0 平台版 — 装一个包，敲一条命令，一分钟拥有自己的 CMS。

三大重点​

• 零配置：reactpress init + reactpress dev，自动生成 .reactpress/config.json、.env 与嵌入式 Docker MySQL
• 唯一入口：npm i -g @fecommunity/reactpress@3，命令统一为 reactpress
• 极致 DX：交互菜单、reactpress doctor、reactpress status、dev 成功后的链接提示

新特性​

• CLI：主包 @fecommunity/reactpress；内置 API；reactpress-cli bin deprecated
• Headless：GET /api/health；API Key；Webhook（HMAC 签名）
• 内容：定时发布；文章修订历史与回滚
• 运维：生产 compose 示例；reactpress db backup

Breaking Changes​

• @fecommunity/reactpress-cli → @fecommunity/reactpress@3
• @fecommunity/reactpress-server deprecated
• 迁移指南：2.x → 3.0

2.0.1 (2025-09-26)​

Bug Fixes​

• 修正 HttpClient 文件名大小写 (7dd892a)

Features​

• 新增 toolkit 包配置 (0ed839d)

2.0.0 (2025-09-21)​

Bug Fixes​

• 修复 server 加载问题 (a6f759b)
• 类型定义修复 (d6491d5)

Features​

• 新增 hello-world 模板 (7e2c948)
• 新增 reactpress toolkit (58f9312)
• 新增 swagger v2 UI (ef9fdc1)
• 新增 twentytwentyfive 主题 (715281f)
• 支持 npx 安装 server (e7f7b97)
• 支持快速安装 (96c1d0a)

1.10.0 (2025-08-03)​

Features​

• 新增 config 类型定义 (d8a6fed)

1.9.0 (2025-05-21)​

1.8.0 (2025-03-22)​

Features​

• upgrade next version (64cac4d)

1.0.0 (2024-09-28)​

Features​

• init easy-blog project (a6b73a1)