diff --git a/.gitignore b/.gitignore index 1c3dd19..5fc7f20 100644 --- a/.gitignore +++ b/.gitignore @@ -10,3 +10,4 @@ npm-debug.log* next-env.d.ts /prisma/generated tsconfig.tsbuildinfo +/logs diff --git a/DEPLOY.md b/DEPLOY.md index 7cde2cf..0cbbcde 100644 --- a/DEPLOY.md +++ b/DEPLOY.md @@ -1,10 +1,10 @@ -# 部署文档(腾讯云) +# 部署文档(腾讯云 · PM2) -联动支付 CRM(Next.js 15 + Prisma + MySQL)生产部署指南。应用与数据库部署在**同一地域**,避免跨区延迟。 +联动支付 CRM(Next.js 15 + Prisma + MySQL)生产部署指南。以 **PM2** 为部署方式,应用与数据库部署在**同一地域**,避免跨区延迟。 --- -## 一、服务器要求 +## 一、服务器准备 | 项 | 要求 | |---|---| @@ -12,110 +12,114 @@ | Node | **18.18+ / 20 LTS**(推荐 20) | | 内存 | ≥ 2G | | 数据库 | MySQL 5.7+(当前自建 `124.223.187.95`),与应用**同地域** | -| 端口 | 应用监听 `3100`,由 Nginx 反代到 80/443 | +| 端口 | 应用监听 **`0.0.0.0:3100`** | -安装 Node(以 nvm 为例): +安装 Node + PM2(以 nvm 为例): ```bash curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash -nvm install 20 && nvm use 20 +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,不是 crm_dev);带连接池参数缓解远程断连 +# 生产数据库(建议 crm;内网 IP 更快更稳);带连接池参数缓解远程断连 DATABASE_URL="mysql://用户:密码@数据库内网IP:3306/crm?connection_limit=10&pool_timeout=20&connect_timeout=15" # 会话密钥:openssl rand -base64 32 AUTH_SECRET="<生成的随机串>" -# 生产站点地址(必须设为真实域名/IP) +# 生产站点地址(真实域名或 http://公网IP:3100) AUTH_URL="https://crm.yourdomain.com" ``` -> 同地域内网连库(内网 IP)比公网更快更稳。若仍偶发 `server has gone away`,已由上面的连接池参数缓解。 +> `.env` 由 Next 在 `next start` 时自动加载,PM2 无需重复配置这些变量。 --- -## 三、部署方式 A:PM2(推荐,简单) +## 三、安装依赖、生成 Prisma、构建 ```bash -# 1. 拉代码 -git clone <仓库地址> /var/www/crm && cd /var/www/crm - -# 2. 装依赖 + 生成 Prisma Client -npm ci -npx prisma generate - -# 3. 构建 -npm run build - -# 4. 用 PM2 启动(读取 .env,监听 3100) -pm2 start npm --name crm -- start -pm2 save # 保存进程列表 -pm2 startup # 生成开机自启(按提示执行输出的命令) -``` - -常用运维: -```bash -pm2 logs crm # 看日志 -pm2 restart crm # 重启 -pm2 status # 状态 +npm ci # 按 lock 精确安装 +npx prisma generate # 生成 Prisma Client +npm run build # 生产构建 +mkdir -p logs # PM2 日志目录 ``` --- -## 四、部署方式 B:Docker(standalone) +## 四、用 PM2 启动(监听 0.0.0.0) -**先启用 standalone 产物** —— 打开 `next.config.ts`,取消注释: -```ts -output: "standalone", -``` +仓库已带 `ecosystem.config.js`,其中关键是 `args: "start -H 0.0.0.0 -p 3100"` —— **`-H 0.0.0.0` 让服务监听所有网卡,外部可访问**(不加则可能只绑 localhost,只有本机能连)。 -`Dockerfile`: -```dockerfile -FROM node:20-alpine AS deps -WORKDIR /app -COPY package*.json ./ -RUN npm ci -COPY . . -RUN npx prisma generate && npm run build - -FROM node:20-alpine AS runner -WORKDIR /app -ENV NODE_ENV=production -# standalone 产物 + 静态资源(关键:必须拷贝 static 与 public,否则样式丢失) -COPY --from=deps /app/.next/standalone ./ -COPY --from=deps /app/.next/static ./.next/static -COPY --from=deps /app/public ./public -EXPOSE 3100 -ENV PORT=3100 -CMD ["node", "server.js"] -``` - -构建运行: ```bash -docker build -t crm . -docker run -d --name crm -p 3100:3100 --env-file .env crm +pm2 start ecosystem.config.js # 启动 +pm2 save # 保存进程列表(重启后可恢复) +pm2 startup # 生成开机自启命令,按提示复制执行输出的那行 ``` -> ⚠️ standalone 模式必须手动拷贝 `.next/static` 和 `public`,否则页面 HTML 出来但 CSS/JS 404("样式没了")。本地开发不要开 standalone。 +确认监听地址是 `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 # 资源监控面板 +``` --- -## 五、Nginx 反向代理 +## 五、放行端口(外部访问的关键) + +`-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 上传 - + client_max_body_size 20m; # 允许 Excel 上传 location / { proxy_pass http://127.0.0.1:3100; proxy_http_version 1.1; @@ -129,19 +133,7 @@ server { ```bash nginx -t && nginx -s reload ``` -HTTPS 建议用腾讯云免费证书或 certbot 配置 443。 - ---- - -## 六、数据库准备 - -生产库结构与 `crm_dev` 一致(`customers`/`admins`/`roles`/`permissions` 等)。Prisma 采用**映射现有库**、不建表: -```bash -# 首次可校准 schema 与现有库一致(可选) -npx prisma db pull -npx prisma generate -``` -> Prisma 不会改动生产表结构。日期字段清洗(`*_raw`)等历史处理为独立步骤,与部署无关。 +HTTPS 用腾讯云免费证书或 certbot 配 443。 --- @@ -149,24 +141,36 @@ npx prisma generate ```bash # 更新 -cd /var/www/crm +cd /var/www/liandong-crm git pull npm ci && npx prisma generate && npm run build -pm2 restart crm +pm2 reload liandong-crm # 平滑重载 -# 回滚(切到上个提交后重建重启) +# 回滚(切到上个提交后重建重载) git checkout <上个commit> -npm run build && pm2 restart crm +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 +``` + +--- + +## 九、常见问题 | 现象 | 原因 / 解决 | |---|---| -| 页面没样式 | standalone 模式没拷贝 `.next/static` 与 `public`;或本地误开了 `output: standalone` | +| 外网连不上、只有本机能访问 | 未加 `-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` 为真实域名 | +| 退出/跳转到错误地址 | 生产必须设 `AUTH_URL` 为真实域名或 `http://公网IP:3100` | +| PM2 重启后进程没了 | 忘了 `pm2 save` + `pm2 startup` | diff --git a/ecosystem.config.js b/ecosystem.config.js new file mode 100644 index 0000000..b711475 --- /dev/null +++ b/ecosystem.config.js @@ -0,0 +1,30 @@ +// PM2 部署配置 —— 联动支付 CRM +// 启动:pm2 start ecosystem.config.js +// 说明:-H 0.0.0.0 让服务监听所有网卡(外部可访问),而非仅 localhost。 +// DATABASE_URL / AUTH_SECRET / AUTH_URL 由项目根目录 .env 提供(Next 自动加载)。 +module.exports = { + apps: [ + { + name: "liandong-crm", + // 直接调用 next 可执行文件,参数里绑定 0.0.0.0 + script: "node_modules/next/dist/bin/next", + args: "start -H 0.0.0.0 -p 3100", + cwd: __dirname, + instances: 1, + exec_mode: "fork", + autorestart: true, + watch: false, + max_memory_restart: "512M", + env: { + NODE_ENV: "production", + // 如需覆盖也可在此设 PORT/HOSTNAME: + // HOSTNAME: "0.0.0.0", + // PORT: "3100", + }, + error_file: "logs/err.log", + out_file: "logs/out.log", + merge_logs: true, + time: true, + }, + ], +}; diff --git a/package.json b/package.json index 17717b6..5dcdb19 100644 --- a/package.json +++ b/package.json @@ -5,7 +5,7 @@ "scripts": { "dev": "next dev -p 3100", "build": "next build", - "start": "next start -p 3100", + "start": "next start -H 0.0.0.0 -p 3100", "lint": "next lint", "prisma:pull": "prisma db pull", "prisma:generate": "prisma generate",