5.4 KiB

Raw Permalink Blame History Unescape Escape

查价中台 — 服务器部署指南

将本项目整个目录上传到 Linux 服务器后，按下列步骤操作。

一、服务器要求

项	建议
系统	Ubuntu 22.04 / Debian 12
CPU	2 核+
内存	4GB+（RPA 浏览器占内存）
磁盘	20GB+
软件	Docker 24+、Docker Compose V2
网络	可访问 `www.mothership.com`

# 安装 Docker（如未安装）
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker "$USER"
# 重新登录后生效

二、上传与配置（人工填写）

cd /opt/chajia          # 你的项目目录

# 1. 复制环境变量模板
cp deploy/.env.production.example .env

# 2. 编辑 .env — 必须修改以下项（搜索 CHANGE_ME）：
nano .env

必须人工填写的项

变量	说明
`MYSQL_ROOT_PASSWORD`	数据库强密码
`JWT_SECRET`	随机密钥，例：`openssl rand -base64 32`
`PUBLIC_DOMAIN`	对外域名，如 `quote.yourcompany.com`
`HOST_SERVICE_TOKENS`	给外部系统的 API Token（JSON 单行）
`CUSTOMER_REGISTRY`	客户 ID，与 token 中 `customerId` 一致
`MOTHERSHIP_EMAIL` / `MOTHERSHIP_PASSWORD`	仅当 Mothership 要求登录时填写

可选修改

变量	说明
`APP_PORT`	默认 3000，仅本机监听
`RPA_SELECTOR_*`	Mothership 页面改版时需更新

三、一键部署

chmod +x deploy/install.sh
bash deploy/install.sh

脚本将自动：构建镜像 → 启动 MySQL/Redis/Web/Worker/Scheduler → 数据库迁移 → 种子数据。

配置 Nginx 反代（对外提供 HTTPS API）

仅 HTTP（内网或临时测试）：

# 先改 deploy/nginx/chajia.http.conf 里的 server_name，或设置 .env 的 PUBLIC_DOMAIN
bash deploy/install.sh --nginx-http

HTTPS（生产推荐）：

# 1. 安装 nginx、certbot
sudo apt install -y nginx certbot python3-certbot-nginx

# 2. 先 HTTP 部署拿到证书
bash deploy/install.sh --nginx-http
sudo certbot certonly --nginx -d quote.yourcompany.com

# 3. 切换 HTTPS 配置（install 会按 PUBLIC_DOMAIN 替换域名）
bash deploy/install.sh --nginx-ssl

或手动复制并修改：

deploy/nginx/chajia.http.conf → /etc/nginx/sites-available/chajia
deploy/nginx/chajia.ssl.conf → 有证书后使用

四、部署后检查清单（人工）

docker compose -f deploy/docker-compose.yml ps 五个服务均为 Up
curl -I http://127.0.0.1:3000 返回 200/307
浏览器打开 https://你的域名/admin/alerts 能进管理端
修改默认管理员密码（seed 默认：admin_demo / Demo@123）
用外部 Token 调 POST /api/addresses/mothership-candidates 返回 code: 0
完整询价：POST /api/quotes → 轮询 GET /api/quotes/{id} 得到 4 档报价
防火墙：只开放 80/443，不要暴露 3306/6379/3000

五、给外部系统的调用说明

Base URL： https://你的域名

请求头：

Authorization: Bearer <HOST_SERVICE_TOKENS 里的 token>
X-Customer-Id: CUST_001
Content-Type: application/json

流程：

POST /api/addresses/mothership-candidates — 地址联想
POST /api/quotes — 提交询价
GET /api/quotes/{quote_id} — 每 2 秒轮询，最长约 30 秒

详细字段见 docs/查价系统-PRD.md 第 4、5 章，或 deploy/API.md。
第三方完整对接文档： deploy/第三方对接指南.md（含自测脚本 scripts/test-host-api.ps1 / .sh）。

六、常用运维命令

# 查看日志
docker compose -f deploy/docker-compose.yml logs -f next-app
docker compose -f deploy/docker-compose.yml logs -f rpa-worker

# 重启
docker compose -f deploy/docker-compose.yml restart

# 停止
docker compose -f deploy/docker-compose.yml down

# 更新代码后重新部署
git pull
bash deploy/install.sh

七、目录说明

deploy/
├── .env.production.example   # 生产环境变量模板 → 复制为项目根 .env
├── docker-compose.yml        # 生产 Compose（MySQL/Redis 不对外暴露）
├── install.sh                # 一键部署脚本
├── nginx/
│   ├── chajia.http.conf      # HTTP 反代
│   └── chajia.ssl.conf       # HTTPS 反代
└── README.md                 # 本文件

八、故障排查

现象	处理
询价一直 `processing`	查 `rpa-worker` 日志；确认 `RPA_MOCK_MODE=false` 且 Worker 在运行
地址联想 503	Worker 未就绪或 Mothership 不可达
RPA 登录失败	填写 `MOTHERSHIP_EMAIL/PASSWORD`；或检查 `.rpa` 卷内 storageState
迁移失败	`docker compose -f deploy/docker-compose.yml run --rm rpa-worker npx prisma migrate deploy`

九、安全提醒

勿将 .env 提交到 Git
每个外部系统使用独立 Service Token
生产环境 RPA_MOCK_MODE 必须为 false
定期备份 mysql_data 卷：docker volume inspect chajia-prod_mysql_data

十、使用宝塔 / 已有 MySQL（不用 Docker 内置库）

若数据库已在宝塔创建（库名 chajia，字符集 utf8mb4）：

上传并导入 deploy/database/chajia.sql（或 chajia.sql.gz）
详见 deploy/database/README.md
在 .env 设置 DATABASE_URL 指向宝塔 MySQL，并调整 compose 去掉 mysql 服务或勿启动它

5.4 KiB Raw Permalink Blame History Unescape Escape