# 部署文档(腾讯云 · PM2) 联动支付 CRM(Next.js 15 + Prisma + MySQL)生产部署指南。以 **PM2** 为部署方式,应用与数据库部署在**同一地域**,避免跨区延迟。 --- ## 一、服务器准备 | 项 | 要求 | |---|---| | 系统 | 腾讯云 CVM / 轻量应用服务器(CentOS / Ubuntu 均可) | | Node | **18.18+ / 20 LTS**(推荐 20) | | 内存 | ≥ 2G | | 数据库 | MySQL 5.7+(当前自建 `124.223.187.95`),与应用**同地域** | | 端口 | 应用监听 **`0.0.0.0:3100`** | 安装 Node + PM2(以 nvm 为例): ```bash curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 20 && nvm use 20 && nvm alias default 20 npm i -g pm2 node -v && pm2 -v # 确认安装成功 ``` --- ## 二、拉取代码与环境变量 ```bash # 1. 拉代码(示例放到 /var/www/liandong-crm) git clone https://github.com/luishou/liandong-crm.git /var/www/liandong-crm cd /var/www/liandong-crm ``` 在项目根目录建 `.env`(**不要提交到 git**): ```bash # 生产数据库(建议 crm;内网 IP 更快更稳);带连接池参数缓解远程断连 DATABASE_URL="mysql://用户:密码@数据库内网IP:3306/crm?connection_limit=10&pool_timeout=20&connect_timeout=15" # 会话密钥:openssl rand -base64 32 AUTH_SECRET="<生成的随机串>" # 生产站点地址(真实域名或 http://公网IP:3100) AUTH_URL="https://crm.yourdomain.com" ``` > `.env` 由 Next 在 `next start` 时自动加载,PM2 无需重复配置这些变量。 --- ## 三、安装依赖、生成 Prisma、构建 ```bash npm ci # 按 lock 精确安装 npx prisma generate # 生成 Prisma Client npm run build # 生产构建 mkdir -p logs # PM2 日志目录 ``` --- ## 四、用 PM2 启动(监听 0.0.0.0) 仓库已带 `ecosystem.config.js`,其中关键是 `args: "start -H 0.0.0.0 -p 3100"` —— **`-H 0.0.0.0` 让服务监听所有网卡,外部可访问**(不加则可能只绑 localhost,只有本机能连)。 ```bash pm2 start ecosystem.config.js # 启动 pm2 save # 保存进程列表(重启后可恢复) pm2 startup # 生成开机自启命令,按提示复制执行输出的那行 ``` 确认监听地址是 `0.0.0.0:3100`(而不是 `127.0.0.1:3100`): ```bash ss -tlnp | grep 3100 # 期望输出类似: LISTEN 0 511 0.0.0.0:3100 0.0.0.0:* ``` ### PM2 常用运维 ```bash pm2 status # 查看状态 pm2 logs liandong-crm # 实时日志 pm2 logs liandong-crm --lines 200 # 查看最近 200 行 pm2 restart liandong-crm # 重启 pm2 reload liandong-crm # 平滑重载(少停顿) pm2 stop liandong-crm # 停止 pm2 delete liandong-crm # 移除 pm2 monit # 资源监控面板 ``` --- ## 五、放行端口(外部访问的关键) `-H 0.0.0.0` 只是让程序监听所有网卡,**还需在两处放行 3100 端口**,否则外网仍连不上: 1. **腾讯云安全组**(控制台 → 轻量/CVM → 防火墙/安全组):新增入站规则 `TCP:3100`,来源按需(测试可 `0.0.0.0/0`,生产建议限公司出口 IP)。 2. **服务器本机防火墙**: ```bash # CentOS / firewalld firewall-cmd --permanent --add-port=3100/tcp && firewall-cmd --reload # Ubuntu / ufw ufw allow 3100/tcp ``` 放行后浏览器访问 `http://公网IP:3100` 即可。 > ⚠️ 直接暴露 3100 没有 HTTPS。生产建议见第六节用 Nginx 反代,把应用改回只绑 `127.0.0.1`,对外只开 443。 --- ## 六、(推荐)Nginx 反代 + HTTPS 若走 Nginx,更安全的做法是**应用只绑本机**、由 Nginx 对外: - 把 `ecosystem.config.js` 的 `args` 改为 `start -H 127.0.0.1 -p 3100`,`pm2 restart liandong-crm`; - 安全组只开 80/443,不再对外开 3100。 `/etc/nginx/conf.d/crm.conf`: ```nginx server { listen 80; server_name crm.yourdomain.com; client_max_body_size 20m; # 允许 Excel 上传 location / { proxy_pass http://127.0.0.1:3100; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } ``` ```bash nginx -t && nginx -s reload ``` HTTPS 用腾讯云免费证书或 certbot 配 443。 --- ## 七、更新与回滚 ```bash # 更新 cd /var/www/liandong-crm git pull npm ci && npx prisma generate && npm run build pm2 reload liandong-crm # 平滑重载 # 回滚(切到上个提交后重建重载) git checkout <上个commit> npm run build && pm2 reload liandong-crm ``` --- ## 八、数据库准备 生产库结构需与应用一致(`date` 类型的 `birthday`/`report_date`)。若生产 `crm` 仍是旧的 varchar 脏数据,**先按 `sql/prod-date-migration.sql` 迁移**(务必先整库 mysqldump 备份),再启动应用。Prisma 采用映射现有库、不建表: ```bash npx prisma db pull # (可选)校准 schema 与现有库一致 npx prisma generate ``` --- ## 九、常见问题 | 现象 | 原因 / 解决 | |---|---| | 外网连不上、只有本机能访问 | 未加 `-H 0.0.0.0`(用 `ss -tlnp\|grep 3100` 确认);或安全组/防火墙未放行 3100 | | 页面没样式 | 本地误开了 `output: standalone`;用 PM2 + `next start` 不会有此问题 | | 登录报 Configuration / PrismaClientInitializationError | 连不上数据库:检查 `DATABASE_URL`、内网连通、连接池参数 | | 上传 Excel 失败 | Nginx `client_max_body_size` 太小;应用侧已放宽到 10mb | | 老账号登不上 | 无需处理,`$2y$` bcrypt 密码由应用直接校验,原样可登录 | | 退出/跳转到错误地址 | 生产必须设 `AUTH_URL` 为真实域名或 `http://公网IP:3100` | | PM2 重启后进程没了 | 忘了 `pm2 save` + `pm2 startup` |