安装与环境要求
ReactPress 4.0 面向终端用户与仓库贡献者提供两条路径。大多数建站场景只需全局 CLI，一条命令即可运行完整发布栈。
系统要求
| 项目 | 要求 |
|---|---|
| Node.js | 20 或更高（推荐 LTS） |
| 操作系统 | macOS 12+、Windows 10+、主流 Linux |
| 包管理器 | npm / pnpm / yarn 均可安装全局 CLI |
| 数据库（默认） | 嵌入式 SQLite — 无需 Docker 或 MySQL |
| 磁盘空间 | 首次安装约 200–400 MB（含 bundled API 运行时） |
验证 Node 版本
node -v # 应显示 v20.x 或更高
安装 CLI（推荐）
npm install -g @fecommunity/reactpress@beta
npm
@beta标签为 4.x 预发布；@latest仍为 3.x。不存在@4dist-tag。
首次 npm install -g 会触发 postinstall，下载 bundled server 运行时依赖，约需 1–2 分钟。
验证安装
reactpress --version
reactpress --help
4.0 CLI 命令一览
4.0 面向终端用户精简为四个核心命令；主题、插件等高级操作在 Admin 后台完成。
| 命令 | 说 明 |
|---|---|
reactpress init [目录] | 初始化站点并自动启动 API + Admin + 主题 |
reactpress init --force | 强制重新初始化（会重置本地数据，慎用） |
reactpress doctor | 诊断 Node、端口、数据库、服务状态 |
reactpress logs | 查看 API 日志（支持 --follow、--grep） |
reactpress stop | 停止当前站点的 API 与主题进程 |
关于
reactpress dev4.0 起 init 即包含启动：执行 reactpress init 后服务会自动运行，无需再执行 dev。Monorepo 贡献者仍使用 pnpm dev，见 Monorepo 开发。
端口与防火墙
默认端口如下，部署前请确保未被占用：
| 服务 | 端口 | 说明 |
|---|---|---|
Admin（reactpress init 默认） | 3001 /admin/ | 挂载在访客主题同端口 |
| 访客主题 | 3001 | Next.js SSR |
| API | 3002 | NestJS REST |
| 主题预览 | 3003 | Admin iframe 预览 |
| Admin（Monorepo 开发） | 3000 | 独立 Vite dev server |
修改端口见 项目配置项。
可选：MySQL / Docker
默认 SQLite 适合本地试用与小规模自托管。生产环境如需 MySQL：
- 在
.reactpress/config.json中配置database.mode - 执行
reactpress config --apply（Monorepo / 旧版 CLI） - 运行
reactpress doctor确认连接
桌面客户端（可选）
无需 CLI 也可使用 桌面客户端 进行离线写作：
- 下载：GitHub Releases
- 本地 SQLite 模式，默认账号
admin/admin