Files
liandong-crm/DEPLOY.md
T
luishouandClaude ce41f35f28 fix(auth): 退出登录避免跳转到 0.0.0.0
signOut 改用 redirect:false 后由浏览器同源跳转 /login,并明确生产 AUTH_URL 不得写成监听地址 0.0.0.0。

Co-Authored-By: Claude <noreply@anthropic.com>
2026-07-13 16:21:17 +08:00

6.2 KiB
Raw Blame History

部署文档(腾讯云 · 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 为例):

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   # 确认安装成功

二、拉取代码与环境变量

# 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):

# 生产数据库(建议 crm;内网 IP 更快更稳);带连接池参数缓解远程断连
DATABASE_URL="mysql://用户:密码@数据库内网IP:3306/crm?connection_limit=10&pool_timeout=20&connect_timeout=15"

# 会话密钥:openssl rand -base64 32
AUTH_SECRET="<生成的随机串>"

# 生产站点地址(浏览器访问的真实域名或公网 IP,不要写 0.0.0.0)
# -H 0.0.0.0 只是监听网卡;AUTH_URL 必须是用户打开的那个地址
AUTH_URL="http://124.223.187.95:3100"
# 有域名时改成:
# AUTH_URL="https://crm.yourdomain.com"

.env 由 Next 在 next start 时自动加载,PM2 无需重复配置这些变量。 AUTH_URL 写错成 http://0.0.0.0:3100 会导致退出登录跳到 0.0.0.0。


三、安装依赖、生成 Prisma、构建

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,只有本机能连)。

pm2 start ecosystem.config.js     # 启动
pm2 save                          # 保存进程列表(重启后可恢复)
pm2 startup                       # 生成开机自启命令,按提示复制执行输出的那行

确认监听地址是 0.0.0.0:3100(而不是 127.0.0.1:3100):

ss -tlnp | grep 3100
# 期望输出类似: LISTEN 0 511 0.0.0.0:3100 0.0.0.0:*

PM2 常用运维

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. 服务器本机防火墙:
    # 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:

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;
    }
}
nginx -t && nginx -s reload

HTTPS 用腾讯云免费证书或 certbot 配 443。


七、更新与回滚

# 更新
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 采用映射现有库、不建表:

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 密码由应用直接校验,原样可登录
退出跳到 http://0.0.0.0:3100/login AUTH_URL 未设或写成了监听地址 0.0.0.0。改为 http://公网IP:3100 或真实域名后 pm2 restart liandong-crm;与 -H 0.0.0.0 无关
PM2 重启后进程没了 忘了 pm2 save + pm2 startup