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

181 lines
6.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 部署文档(腾讯云 · 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="<生成的随机串>"
# 生产站点地址(浏览器访问的真实域名或公网 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、构建
```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 密码由应用直接校验,原样可登录 |
| 退出跳到 `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` |