chore: 部署改为 PM2,服务监听 0.0.0.0
- 新增 ecosystem.config.js(next start -H 0.0.0.0 -p 3100) - package.json start 脚本绑定 0.0.0.0 - DEPLOY.md 重写为 PM2 详细部署,含端口放行/防火墙/Nginx 反代/更新回滚 - .gitignore 忽略 logs/ Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -10,3 +10,4 @@ npm-debug.log*
|
|||||||
next-env.d.ts
|
next-env.d.ts
|
||||||
/prisma/generated
|
/prisma/generated
|
||||||
tsconfig.tsbuildinfo
|
tsconfig.tsbuildinfo
|
||||||
|
/logs
|
||||||
|
|||||||
@@ -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) |
|
| Node | **18.18+ / 20 LTS**(推荐 20) |
|
||||||
| 内存 | ≥ 2G |
|
| 内存 | ≥ 2G |
|
||||||
| 数据库 | MySQL 5.7+(当前自建 `124.223.187.95`),与应用**同地域** |
|
| 数据库 | MySQL 5.7+(当前自建 `124.223.187.95`),与应用**同地域** |
|
||||||
| 端口 | 应用监听 `3100`,由 Nginx 反代到 80/443 |
|
| 端口 | 应用监听 **`0.0.0.0:3100`** |
|
||||||
|
|
||||||
安装 Node(以 nvm 为例):
|
安装 Node + PM2(以 nvm 为例):
|
||||||
```bash
|
```bash
|
||||||
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | 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
|
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**):
|
在项目根目录建 `.env`(**不要提交到 git**):
|
||||||
```bash
|
```bash
|
||||||
# 生产数据库(建议 crm,不是 crm_dev);带连接池参数缓解远程断连
|
# 生产数据库(建议 crm;内网 IP 更快更稳);带连接池参数缓解远程断连
|
||||||
DATABASE_URL="mysql://用户:密码@数据库内网IP:3306/crm?connection_limit=10&pool_timeout=20&connect_timeout=15"
|
DATABASE_URL="mysql://用户:密码@数据库内网IP:3306/crm?connection_limit=10&pool_timeout=20&connect_timeout=15"
|
||||||
|
|
||||||
# 会话密钥:openssl rand -base64 32
|
# 会话密钥:openssl rand -base64 32
|
||||||
AUTH_SECRET="<生成的随机串>"
|
AUTH_SECRET="<生成的随机串>"
|
||||||
|
|
||||||
# 生产站点地址(必须设为真实域名/IP)
|
# 生产站点地址(真实域名或 http://公网IP:3100)
|
||||||
AUTH_URL="https://crm.yourdomain.com"
|
AUTH_URL="https://crm.yourdomain.com"
|
||||||
```
|
```
|
||||||
> 同地域内网连库(内网 IP)比公网更快更稳。若仍偶发 `server has gone away`,已由上面的连接池参数缓解。
|
> `.env` 由 Next 在 `next start` 时自动加载,PM2 无需重复配置这些变量。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 三、部署方式 A:PM2(推荐,简单)
|
## 三、安装依赖、生成 Prisma、构建
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 1. 拉代码
|
npm ci # 按 lock 精确安装
|
||||||
git clone <仓库地址> /var/www/crm && cd /var/www/crm
|
npx prisma generate # 生成 Prisma Client
|
||||||
|
npm run build # 生产构建
|
||||||
# 2. 装依赖 + 生成 Prisma Client
|
mkdir -p logs # PM2 日志目录
|
||||||
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 # 状态
|
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 四、部署方式 B:Docker(standalone)
|
## 四、用 PM2 启动(监听 0.0.0.0)
|
||||||
|
|
||||||
**先启用 standalone 产物** —— 打开 `next.config.ts`,取消注释:
|
仓库已带 `ecosystem.config.js`,其中关键是 `args: "start -H 0.0.0.0 -p 3100"` —— **`-H 0.0.0.0` 让服务监听所有网卡,外部可访问**(不加则可能只绑 localhost,只有本机能连)。
|
||||||
```ts
|
|
||||||
output: "standalone",
|
|
||||||
```
|
|
||||||
|
|
||||||
`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
|
```bash
|
||||||
docker build -t crm .
|
pm2 start ecosystem.config.js # 启动
|
||||||
docker run -d --name crm -p 3100:3100 --env-file .env crm
|
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`:
|
`/etc/nginx/conf.d/crm.conf`:
|
||||||
```nginx
|
```nginx
|
||||||
server {
|
server {
|
||||||
listen 80;
|
listen 80;
|
||||||
server_name crm.yourdomain.com;
|
server_name crm.yourdomain.com;
|
||||||
|
|
||||||
client_max_body_size 20m; # 允许 Excel 上传
|
client_max_body_size 20m; # 允许 Excel 上传
|
||||||
|
|
||||||
location / {
|
location / {
|
||||||
proxy_pass http://127.0.0.1:3100;
|
proxy_pass http://127.0.0.1:3100;
|
||||||
proxy_http_version 1.1;
|
proxy_http_version 1.1;
|
||||||
@@ -129,19 +133,7 @@ server {
|
|||||||
```bash
|
```bash
|
||||||
nginx -t && nginx -s reload
|
nginx -t && nginx -s reload
|
||||||
```
|
```
|
||||||
HTTPS 建议用腾讯云免费证书或 certbot 配置 443。
|
HTTPS 用腾讯云免费证书或 certbot 配 443。
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 六、数据库准备
|
|
||||||
|
|
||||||
生产库结构与 `crm_dev` 一致(`customers`/`admins`/`roles`/`permissions` 等)。Prisma 采用**映射现有库**、不建表:
|
|
||||||
```bash
|
|
||||||
# 首次可校准 schema 与现有库一致(可选)
|
|
||||||
npx prisma db pull
|
|
||||||
npx prisma generate
|
|
||||||
```
|
|
||||||
> Prisma 不会改动生产表结构。日期字段清洗(`*_raw`)等历史处理为独立步骤,与部署无关。
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -149,24 +141,36 @@ npx prisma generate
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 更新
|
# 更新
|
||||||
cd /var/www/crm
|
cd /var/www/liandong-crm
|
||||||
git pull
|
git pull
|
||||||
npm ci && npx prisma generate && npm run build
|
npm ci && npx prisma generate && npm run build
|
||||||
pm2 restart crm
|
pm2 reload liandong-crm # 平滑重载
|
||||||
|
|
||||||
# 回滚(切到上个提交后重建重启)
|
# 回滚(切到上个提交后重建重载)
|
||||||
git checkout <上个commit>
|
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`、内网连通、连接池参数 |
|
| 登录报 Configuration / PrismaClientInitializationError | 连不上数据库:检查 `DATABASE_URL`、内网连通、连接池参数 |
|
||||||
| 上传 Excel 失败 | Nginx `client_max_body_size` 太小;应用侧已放宽到 10mb |
|
| 上传 Excel 失败 | Nginx `client_max_body_size` 太小;应用侧已放宽到 10mb |
|
||||||
| 老账号登不上 | 无需处理,`$2y$` bcrypt 密码由应用直接校验,原样可登录 |
|
| 老账号登不上 | 无需处理,`$2y$` bcrypt 密码由应用直接校验,原样可登录 |
|
||||||
| 退出/跳转到错误端口 | 生产必须设 `AUTH_URL` 为真实域名 |
|
| 退出/跳转到错误地址 | 生产必须设 `AUTH_URL` 为真实域名或 `http://公网IP:3100` |
|
||||||
|
| PM2 重启后进程没了 | 忘了 `pm2 save` + `pm2 startup` |
|
||||||
|
|||||||
@@ -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,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
+1
-1
@@ -5,7 +5,7 @@
|
|||||||
"scripts": {
|
"scripts": {
|
||||||
"dev": "next dev -p 3100",
|
"dev": "next dev -p 3100",
|
||||||
"build": "next build",
|
"build": "next build",
|
||||||
"start": "next start -p 3100",
|
"start": "next start -H 0.0.0.0 -p 3100",
|
||||||
"lint": "next lint",
|
"lint": "next lint",
|
||||||
"prisma:pull": "prisma db pull",
|
"prisma:pull": "prisma db pull",
|
||||||
"prisma:generate": "prisma generate",
|
"prisma:generate": "prisma generate",
|
||||||
|
|||||||
Reference in New Issue
Block a user