3.1 KiB
3.1 KiB
Soul 项目宝塔配置检查说明
用于排查 soul.quwanzhi.com 在宝塔上的 Nginx / PM2 / 端口 配置问题。
一、已发现并修复的问题
1. 应用端口与 Nginx 不一致（已修复）
- 现象：部署脚本用
pm2 start server.js --name soul启动，未指定端口。Next.js standalone 默认监听 3000。 - 宝塔约定：根据
开发文档/服务器管理/references/端口配置表.md，soul 使用端口 3006，Nginx 反代到127.0.0.1:3006。 - 结果：应用实际在 3000 监听，Nginx 请求 3006 → 无进程 → 502 Bad Gateway。
- 修复：
scripts/deploy_baota.py已改为启动时设置PORT=3006（可通过环境变量DEPLOY_APP_PORT覆盖），保证与 Nginx 一致。
二、宝塔侧需自检的配置
1. Nginx 反向代理
- 域名：soul.quwanzhi.com
- 要求：
proxy_pass http://127.0.0.1:3006;（与端口配置表一致） - 检查：宝塔 → 网站 → soul.quwanzhi.com → 设置 → 反向代理 / 配置文件，确认
proxy_pass指向127.0.0.1:3006。 - SSL：若走 HTTPS，确认已配置 443 与证书（端口配置表注明使用通配符证书）。
2. PM2 与部署脚本一致
- 项目名：soul（与
deploy_baota.py中DEPLOY_PM2_APP一致） - 启动方式：必须用
node server.js，工作目录/www/wwwroot/soul，环境变量PORT=3006。 - 不要用：
npm start/next start。standalone 部署后没有完整 node_modules，也没有next命令，会报next: command not found。 - 宝塔 PM2 管理器：启动文件填
server.js，启动命令填node server.js（或选「Node 项目」后只填server.js），环境变量添加PORT=3006。也可用pm2 start ecosystem.config.cjs（项目根目录已提供该文件）。 - 注意：若同时在宝塔「PM2 管理器」里添加了同名项目，可能产生 root 与 www 用户冲突，建议只保留一种方式（要么只用脚本部署 + 命令行 PM2，要么只用宝塔 PM2 界面）。
3. 项目目录与端口
- 项目路径：
/www/wwwroot/soul（与DEPLOY_PROJECT_PATH一致） - 应用端口：3006（与端口配置表、Nginx、部署脚本中的
PORT一致）
三、快速检查命令（SSH 到服务器后执行）
# 1. 应用是否在 3006 监听
ss -tlnp | grep 3006
# 2. PM2 列表（是否有 soul，状态 online）
pm2 list
# 3. Nginx 配置是否包含 soul 且 proxy_pass 为 3006
grep -r "soul\|3006" /www/server/panel/vhost/nginx/
# 4. Nginx 语法
nginx -t
四、环境变量（可选）
部署时若需改端口，可在本机执行脚本前设置：
set DEPLOY_APP_PORT=3006
python scripts/deploy_baota.py
或修改 scripts/deploy_baota.py 中 CFG['app_port'] 的默认值（当前为 3006）。
五、参考文档
- 端口与域名：
开发文档/服务器管理/references/端口配置表.md - 常见问题：
开发文档/服务器管理/references/常见问题手册.md - 部署步骤：
DEPLOYMENT.md（宝塔部署章节）