跳到主要内容

生产环境部署

3.0 推荐:全局 CLI

已在服务器安装 Node ≥ 18 与 Docker(或外部 MySQL)时:

npm i -g @fecommunity/reactpress@3
cd /path/to/your-site # 含 .reactpress/ 的项目目录
reactpress init # 若尚未初始化
reactpress build # 按需构建
reactpress start # 生产模式启动 API + 前台

或使用仓库提供的生产 compose 示例(DB + 前端容器,API 在宿主机):

reactpress build
reactpress start:api # 或 pm2 管理 API
docker compose -f docker-compose.prod.yml up -d

数据库备份:reactpress db backup


Monorepo 自托管部署

环境准备

git clone --depth=1 https://github.com/fecommunity/reactpress.git
cd reactpress
npm i -g pnpm
pnpm install

配置由 pnpm initreactpress init 生成;生产前请确认 .reactpress/config.json.env 中的数据库与 URL。

构建与启动

pnpm run build
pnpm run pm2 # API + 前台
pm2 save
pm2 startup # 可选:开机自启

或使用一键脚本(在仓库根目录):

sh scripts/deploy.sh

代码更新

git pull
pnpm install
pnpm run build
pm2 restart all # 或 pnpm run pm2

进阶:独立包部署

3.0 默认使用 @fecommunity/reactpress 内置 API。仅在需要单独部署前台或连接远程 API 时参考:

场景命令
全栈reactpress start
仅 APIreactpress dev --api-only / reactpress server start
仅前台reactpress dev --client-only@fecommunity/reactpress-client

@fecommunity/reactpress-server 已 deprecated,请勿作为新项目的生产入口。

更多说明见 ReactPress 3.0 平台版Docker 部署