ReactPress 3.0 ：一分钟拥有自己的 CMS & 博客

如果你曾为了搭一个博客或内容站，在 MySQL、env、前后端仓库和六个 npm 包之间来回折腾------ReactPress 3.0 想把这些步骤收成 两条命令。

ReactPress 是一套基于 React、Next.js 和 NestJS 的现代化全栈发布平台：前台站点、管理后台、REST API 一次到位。3.0 代号 Platform，核心承诺只有一句：

装一个包，敲一条命令，一分钟拥有自己的 CMS。

• 项目地址：https://github.com/fecommunity/reactpress
• npm 主包：https://www.npmjs.com/package/@fecommunity/reactpress
• 在线演示：https://blog.gaoredu.com

3.0 解决了什么？

2.x 时代能力已经齐全，但新用户常常卡在「该装哪个包」「.env 怎么写」「数据库要不要先建好」。3.0 把产品叙事收敛为三个关键词：

重点	用户感知	3.0 交付
零配置	不用手写 .env、不用先装六个包	reactpress init + reactpress dev，默认 Docker MySQL
唯一入口	只记一个包名、一个命令	npm i -g @fecommunity/reactpress@3，全程 reactpress
极致 DX	少查文档、状态一眼可见	交互菜单、doctor、status、dev 成功后的链接提示

和「再写一个静态站生成器」不同，ReactPress 的定位是 可运营的 CMS：文章、页面、分类、标签、评论、媒体库、安装向导、亮/暗主题、中英文界面------适合个人博客、团队官网和内容驱动产品。

---

一分钟能做什么？

在本机已完成全局安装的前提下，任意空目录执行：

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

片刻之后，终端会提示可访问地址：

服务	地址
前台站点	http://localhost:3001
管理后台	http://localhost:3001/admin
API	http://localhost:3002/api
健康检查	http://localhost:3002/api/health

init 会自动生成 .reactpress/config.json、同步 .env、拉起嵌入式 Docker MySQL，并等待数据库就绪后完成迁移。一般不需要手改配置文件就能跑起来。

不想记子命令？直接运行 reactpress，会进入交互式菜单（初始化、开发、Docker、状态、发布等）。

说明 ：「一分钟」指二次冷启动（init + dev 合计约 60 秒内可访问）；首次拉取 Docker 镜像可能更久，属于正常现象。

和 WordPress、静态站生成器比，差在哪？

维度	传统 CMS	静态站工具	ReactPress 3.0
上手成本	服务器、插件、手工配置	每个站一个仓库 + 构建流水线	一条 CLI，约 1 分钟看到完整 CMS
内容工作流	后台强、主题耦合	Markdown 进 Git	后台创作 + 可选代码/Headless
扩展方式	插件生态	构建时定型	一套内容中枢，前台可替换
技术栈	PHP 等	任意 SSG	React 17 + Next.js 12 + NestJS 6 + MySQL

你既可以把它当作「自己的 WordPress 替代品」快速建站，也可以在进阶场景里只跑 API，用 @fecommunity/reactpress-toolkit 自建前台------一个后端，多种呈现。

---

常用命令一览

reactpress              # 交互式菜单
reactpress init         # 零配置初始化项目
reactpress dev          # 全栈开发（前台 + 管理端 + API）
reactpress dev --api-only      # 仅 API（Headless）
reactpress doctor       # 环境诊断：Node、Docker、端口、数据库
reactpress status       # 运行状态一页汇总
reactpress build        # 生产构建
reactpress start        # 生产启动

环境异常时，优先 reactpress doctor 和 reactpress status，比翻长篇文档更快定位问题。

---

3.0 还带来了哪些平台能力？

在「小白一分钟起站」之外，3.0 延续了面向团队和自动化的能力：

• 健康检查 ：GET /api/health，方便接入监控与 CI
• API Key + Headless 列表 ：管理端创建 Key，请求头 X-API-Key 访问文章接口
• Webhook ：article.published、comment.created，支持签名校验
• 定时发布 、文章修订历史与回滚
• 数据库备份 ：reactpress db backup
• 生产部署 ：支持 Vercel、PM2、docker-compose.prod.yml 等路径

适合「先快速上线，再逐步 Headless 化」的团队，而不必一开始就把架构拆得很碎。

生产环境怎么部署？

本地验证通过后，同一套 CLI 覆盖构建与启动：

reactpress build
reactpress start

自托管可选用 PM2，或使用仓库提供的 docker-compose.prod.yml。也支持通过 Vercel 一键部署前台（详见官方文档）。

贡献者与深度定制仍可在 monorepo 中使用 pnpm install + pnpm dev，底层与全局 reactpress dev 一致。

---

写在最后

ReactPress 3.0 不是要 reinvent 轮子，而是把 「我想有一个自己能管的发布站」 从一下午的配置，压缩到 装一个包、敲两条命令。

• 个人博主：专注写作，而不是折腾环境
• 小团队：统一内容后台，前台可按需定制
• 前端开发者：熟悉的 React 技术栈 + 可选 Headless

如果你正在找一套 开源、可自托管、带完整后台 的 CMS，不妨给 3.0 一次机会：

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

欢迎 Star、提 Issue 或 PR：https://github.com/fecommunity/reactpress