173 lines
4.6 KiB
Markdown
173 lines
4.6 KiB
Markdown
# 部署文档(腾讯云)
|
||||
|
|
|
|||
|
|
联动支付 CRM(Next.js 15 + Prisma + MySQL)生产部署指南。应用与数据库部署在**同一地域**,避免跨区延迟。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 一、服务器要求
|
|||
|
|
|
|||
|
|
| 项 | 要求 |
|
|||
|
|
|---|---|
|
|||
|
|
| 系统 | 腾讯云 CVM / 轻量应用服务器(CentOS / Ubuntu 均可) |
|
|||
|
|
| Node | **18.18+ / 20 LTS**(推荐 20) |
|
|||
|
|
| 内存 | ≥ 2G |
|
|||
|
|
| 数据库 | MySQL 5.7+(当前自建 `124.223.187.95`),与应用**同地域** |
|
|||
|
|
| 端口 | 应用监听 `3100`,由 Nginx 反代到 80/443 |
|
|||
|
|
|
|||
|
|
安装 Node(以 nvm 为例):
|
|||
|
|
```bash
|
|||
|
|
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
|
|||
|
|
nvm install 20 && nvm use 20
|
|||
|
|
npm i -g pm2
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 二、环境变量
|
|||
|
|
|
|||
|
|
在项目根目录建 `.env`(**不要提交到 git**):
|
|||
|
|
```bash
|
|||
|
|
# 生产数据库(建议 crm,不是 crm_dev);带连接池参数缓解远程断连
|
|||
|
|
DATABASE_URL="mysql://用户:密码@数据库内网IP:3306/crm?connection_limit=10&pool_timeout=20&connect_timeout=15"
|
|||
|
|
|
|||
|
|
# 会话密钥:openssl rand -base64 32
|
|||
|
|
AUTH_SECRET="<生成的随机串>"
|
|||
|
|
|
|||
|
|
# 生产站点地址(必须设为真实域名/IP)
|
|||
|
|
AUTH_URL="https://crm.yourdomain.com"
|
|||
|
|
```
|
|||
|
|
> 同地域内网连库(内网 IP)比公网更快更稳。若仍偶发 `server has gone away`,已由上面的连接池参数缓解。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 三、部署方式 A:PM2(推荐,简单)
|
|||
|
|
|
|||
|
|
```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 # 状态
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 四、部署方式 B:Docker(standalone)
|
|||
|
|
|
|||
|
|
**先启用 standalone 产物** —— 打开 `next.config.ts`,取消注释:
|
|||
|
|
```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
|
|||
|
|
docker build -t crm .
|
|||
|
|
docker run -d --name crm -p 3100:3100 --env-file .env crm
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
> ⚠️ standalone 模式必须手动拷贝 `.next/static` 和 `public`,否则页面 HTML 出来但 CSS/JS 404("样式没了")。本地开发不要开 standalone。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 五、Nginx 反向代理
|
|||
|
|
|
|||
|
|
`/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。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 六、数据库准备
|
|||
|
|
|
|||
|
|
生产库结构与 `crm_dev` 一致(`customers`/`admins`/`roles`/`permissions` 等)。Prisma 采用**映射现有库**、不建表:
|
|||
|
|
```bash
|
|||
|
|
# 首次可校准 schema 与现有库一致(可选)
|
|||
|
|
npx prisma db pull
|
|||
|
|
npx prisma generate
|
|||
|
|
```
|
|||
|
|
> Prisma 不会改动生产表结构。日期字段清洗(`*_raw`)等历史处理为独立步骤,与部署无关。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 七、更新与回滚
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 更新
|
|||
|
|
cd /var/www/crm
|
|||
|
|
git pull
|
|||
|
|
npm ci && npx prisma generate && npm run build
|
|||
|
|
pm2 restart crm
|
|||
|
|
|
|||
|
|
# 回滚(切到上个提交后重建重启)
|
|||
|
|
git checkout <上个commit>
|
|||
|
|
npm run build && pm2 restart crm
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 八、常见问题
|
|||
|
|
|
|||
|
|
| 现象 | 原因 / 解决 |
|
|||
|
|
|---|---|
|
|||
|
|
| 页面没样式 | standalone 模式没拷贝 `.next/static` 与 `public`;或本地误开了 `output: standalone` |
|
|||
|
|
| 登录报 Configuration / PrismaClientInitializationError | 连不上数据库:检查 `DATABASE_URL`、内网连通、连接池参数 |
|
|||
|
|
| 上传 Excel 失败 | Nginx `client_max_body_size` 太小;应用侧已放宽到 10mb |
|
|||
|
|
| 老账号登不上 | 无需处理,`$2y$` bcrypt 密码由应用直接校验,原样可登录 |
|
|||
|
|
| 退出/跳转到错误端口 | 生产必须设 `AUTH_URL` 为真实域名 |
|