从零到部署，一个 CLI 搞定全部

很多前端开发者都会有这样的经历：想在业余时间搭个个人博客或技术专栏，但被复杂的环境配置劝退了。先搞定 MySQL，再配置 .env，然后分别启动前端服务端，最后还得处理各种依赖和版本冲突——整个过程下来，一两个小时就搭进去了。

ReactPress 3.0 的出现，就是为了终结这种烦恼。它的核心理念简单而直接：一个 CLI，一个入口，一分钟启动。

关于 ReactPress

ReactPress 是一个现代化的全栈发布平台，基于 React 18、Next.js 14、NestJS 10 和 TypeScript 5 构建。它同时具备以下几个身份：

• 一个开箱即用的博客系统
• 一个功能完备的内容管理系统（CMS）
• 一个支持自定义开发的全栈应用框架

开箱即用的功能包括：文章管理（内置 Markdown 编辑器）、分类目录、标签系统、评论管理、页面自定义、媒体管理、多语言支持（中英文）以及黑白主题切换。无论是个人博客、团队站点，还是内容驱动的产品，ReactPress 都能胜任。

CLI 核心命令

安装方式：npm i -g @fecommunity/reactpress@3

1. reactpress — 交互式菜单

如果不确定下一步该做什么，直接输入 reactpress 即可呼出一个交互式菜单（内置 init, dev, Docker, status, publish 等选项），让开发者无需记忆子命令即可流畅操作。

2. reactpress init — 零配置项目初始化

执行 reactpress init 命令后，CLI 会在当前目录下完成以下配置：

• 创建 .reactpress/config.json 配置文件
• 同步 .env 环境变量（你不需要手动修改）
• 启动嵌入式 Docker MySQL 容器（3.0 版本的重大改进，自带开箱即用的本地数据库服务）
• 等待数据库就绪后自动运行数据库迁移

至此，一个可运行的 ReactPress 开发环境就准备就绪了。相较于版本 2.x 中用户经常困惑“到底该安装哪个包”“要不要先配置 MySQL”，3.0 在零配置方面下足了功夫：开发者只需一条 reactpress init 即可完成全套初始化，无需手写 .env，无需提前安装 MySQL，也无需面对多个独立安装包的“选择困难症”。

3. reactpress dev — 一键启动完整开发环境

reactpress dev 是日常开发中最常用的命令。它一次性启动三个核心服务：

• 前端站点（基于 Next.js 14，用户端界面）
• 管理后台（基于 Ant Design，内容管理界面）
• REST API（基于 NestJS 10，提供数据接口）

终端会直接输出可访问的 URL，无需手动寻找端口或启动多个进程。

如果需要将 ReactPress 作为纯 Headless CMS 使用，只需运行 reactpress dev --api-only，此时仅启动 API 后端，前端全部交由开发者自行构建。

4. reactpress doctor — 环境健康检查

当遇到问题不知道从何查起时，reactpress doctor 是最合适的起点。该命令会全面检查开发环境：

• Node.js 版本是否满足要求
• Docker 是否已安装并可运行
• 端口是否被占用
• 数据库连接是否正常

检查完成后，CLI 会逐一列出通过或失败的项目，并给出具体的修复建议。

5. reactpress status — 运行时状态一览

reactpress status 命令以单页汇总方式呈现当前运行环境的关键信息：服务是否在运行、运行在哪个端口、数据库连接状态如何、构建产物是否存在等。

6. reactpress build / reactpress start — 生产环境构建与运行

• reactpress build：执行前端和后端的生产环境构建，生成优化的静态资源和部署包
• reactpress start：以生产模式启动完整的 ReactPress 应用

对于生产部署，还提供了 PM2 支持（--pm2 选项），方便进行进程管理和持续运行。

核心能力总结

能力维度	具体体现
零配置启动	无需手写 .env，无需提前安装 MySQL，一套命令完成初始化
交互式体验	无需记忆子命令，纯命令行交互式菜单引导操作
环境健壮	doctor 与 status 双重保障，快速定位问题
Headless 优先	--api-only 模式支持纯后端运行，适用于微前端和多端适配
生产就绪	原生支持 PM2，便捷的生产部署体验

适用场景

个人技术博客：ReactPress 包含内置的 Markdown 编辑器、分类标签和评论管理，非常适合技术作者快速搭建专栏。

企业内容站点：多语言支持（中英文切换）、黑白主题、媒体管理（本地 + OSS 上传）等能力，使其可用于企业官网、文档站点等场景。

Headless CMS：通过 reactpress dev --api-only 获取纯 API 后端，再搭配 @fecommunity/reactpress-toolkit 自动生成的 SDK，前端开发者可以使用熟悉的 React 技术栈自由构建。

敏捷原型项目：非技术背景的产品经理或设计师可借助 reactpress init 和 reactpress dev 快速搭建数据驱动的演示系统，无需深入后端实现。

小结

ReactPress CLI 的真正价值在于，它将一个复杂的全栈 CMS 系统封装到了极致。开发者不再需要关心 MySQL 配置、不再需要分别管理前端和后端的启动脚本，不再需要为“哪个包先装”而纠结。

一行命令安装，一行命令初始化，一行命令开发。 这就是 ReactPress CLI 的全部。

如果你的技术栈恰好是 React + TypeScript，又正在寻找一个开箱即用的 CMS 方案，不妨试试 ReactPress——直接从 CLI 开始。

官方 GitHub：fecommunity/reactpress