Files
liandong-crm/DEPLOY.md
T
luishouandClaude Opus 4.8 5d46afe439 feat: 联动支付 CRM 后台(Next.js + TS + Prisma 重构)
从旧 Laravel 5.7 重构为现代技术栈,对接现有 MySQL。

- 技术栈: Next.js 15 App Router + TypeScript + Prisma + Auth.js + Tailwind v4
- 认证: 复用旧库 admins 的 bcrypt 密码,Auth.js Credentials
- 客户管理: 列表(搜索/报单区间/分页)、增改删、Excel 导入导出
- 生日提醒: 阴阳历(lunar-typescript),口径对齐旧 overtrue 库
- RBAC: 管理员/角色/权限(菜单树) 完整 CRUD + 分配
- 控制台: 统计卡 + 月度新增报单柱状图
- 个人中心: 改昵称/改密码
- 现代 CMS 界面 + 联动支付品牌(logo/登录/底部/icon)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-08 15:02:03 +08:00

4.6 KiB
Raw Blame History

部署文档(腾讯云)

联动支付 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 为例):

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

# 生产数据库(建议 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(推荐,简单)

# 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         # 生成开机自启(按提示执行输出的命令)

常用运维:

pm2 logs crm        # 看日志
pm2 restart crm     # 重启
pm2 status          # 状态

四、部署方式 B:Docker(standalone)

先启用 standalone 产物 —— 打开 next.config.ts,取消注释:

output: "standalone",

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"]

构建运行:

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:

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。


六、数据库准备

生产库结构与 crm_dev 一致(customers/admins/roles/permissions 等)。Prisma 采用映射现有库、不建表:

# 首次可校准 schema 与现有库一致(可选)
npx prisma db pull
npx prisma generate

Prisma 不会改动生产表结构。日期字段清洗(*_raw)等历史处理为独立步骤,与部署无关。


七、更新与回滚

# 更新
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 为真实域名