cfc/DEPLOYMENT.md

生产环境部署文档

服务器: 172.16.0.4（内网）/ 111.228.6.214（公网） 域名: www.etotem.com.cn / cfc.etotem.com.cn / cf-club.iwintrue.com / ai.etotem.com.cn

---

服务架构

公网 (111.228.6.214)
  └─ Nginx (80 → 443)               — 反向代理 + SSL 终端
       ├─ www.etotem.com.cn          — 公司官网静态站
       │    ├─ /admin/               → /app/pro/cfc/frontend/ (管理端 SPA)
       │    └─ /api/                 → Spring Boot :9082
       ├─ cfc.etotem.com.cn          — 后端 API 主站
       │    ├─ /admin/               → /app/pro/cfc/frontend/ (管理端 SPA)
       │    ├─ /admin/api/           → Spring Boot :9082
       │    ├─ /api/                 → Spring Boot :9082
       │    └─ /                     → Spring Boot :9082
       ├─ cf-club.iwintrue.com       — 俱乐部静态站
       │    └─ /api/                 → Spring Boot :9082
       └─ ai.etotem.com.cn           — AI LangGraph 服务
            └─ /                     → Docker :9000

Spring Boot (cfc-backend) :9082
  ├─ MySQL 127.0.0.1:3306/zxyj      — 主库
  ├─ Redis 127.0.0.1:6379           — 缓存
  └─ Sfms 只读源 (RDS 阿里云)        — 可选

---

后端部署

# 1. 构建
cd /app/cfc/cfc-backend
mvn clean package -Dmaven.test.skip=true -Dmaven.compile.fork=true

# 2. 复制 JAR
cp target/cfc-backend-1.0.0.jar /app/pro/cfc/backend/

# 3. 重启（start.sh 自动 kill 旧进程 + 启动新进程）
bash /app/pro/cfc/backend/start.sh

# 4. 验证
curl -s -o /dev/null -w "%{http_code}" http://localhost:9082/api/
# 预期返回 401（需要 JWT 令牌）

配置文件

路径	说明
/app/pro/cfc/backend/cfc-backend-1.0.0.jar	可执行 JAR
/app/pro/cfc/backend/config/application-prod.yml	生产配置
/app/pro/cfc/backend/config/application.yml	公共配置
/app/pro/cfc/backend/app.pid	进程 PID 文件

启动脚本 (/app/pro/cfc/backend/start.sh)

#!/bin/bash
APP_DIR="/app/pro/cfc/backend"
JAR="$APP_DIR/cfc-backend-1.0.0.jar"
PID_FILE="$APP_DIR/app.pid"
JAVA_OPTS="-Xmx2g -Xms512m -XX:+CrashOnOutOfMemoryError"

# 停止旧进程
if [ -f "$PID_FILE" ]; then kill $(cat "$PID_FILE"); sleep 3; fi
fuser -k 9082/tcp 2>/dev/null; sleep 2

# 启动新进程
nohup java $JAVA_OPTS -jar "$JAR" \
  --spring.profiles.active=prod \
  --spring.config.location="$APP_DIR/config/" \
  > /dev/null 2>&1 &
echo $! > "$PID_FILE"

日志

文件	说明
/app/pro/cfc/backend/cfc-backend.log	应用日志（Logback，自动滚动）
滚动策略	50MB/文件，保留 7 天，总计 ≤500MB
日志级别	com.etotem.cfc: warn，INFO 级仅启动/请求日志

---

前端管理端部署 (cfc-web)

# 1. 构建
cd /app/cfc/cfc-web
npm run build

# 2. 部署
rsync -a --delete dist/ /app/pro/cfc/frontend/

注意: 前端部署后无需重启后端，Nginx 直接读取静态文件。

---

网站静态站部署 (cfc-web 官网部分)

cd /app/cfc/cfc-web
npm run build
rsync -a --delete dist/ /app/cfc/web/

---

数据库

属性	值
主机	127.0.0.1:3306
数据库	zxyj
用户	zxyj
密码	zxyj@123
引擎	MariaDB

迁移

• 唯一入口: DatabaseInitializer.runMigrations()（Spring Boot 启动时自动执行）
• 所有 DDL 幂等: 可重复执行，失败时 WARN 级别记录，不会阻塞启动
• 同步 schema.sql: 每次新表/新列后同步更新 /app/cfc/cfc-backend/src/main/resources/schema.sql

---

Nginx

配置	路径
主配置	/etc/nginx/sites-available/etotem
符号链接	/etc/nginx/sites-enabled/etotem
SSL 证书	/etc/ohttps/certificates/（Let's Encrypt，每日 3:00 cron 自动续期）

# 验证配置
nginx -t

# 重载
nginx -s reload

---

小程序 (cfc-frontend)

• 不在服务器构建
• 本地开发后，用微信开发者工具导入 /app/cfc/cfc-frontend/ 根目录
• 微信开发者工具中上传代码 → 微信公众平台提交审核 → 发布
• API 地址通过 config.js 中 uni.getAccountInfoSync() 自动适配环境

---

重启流程速查

# 一键部署后端
cd /app/cfc/cfc-backend && mvn clean package -Dmaven.test.skip=true -Dmaven.compile.fork=true && \
  cp target/cfc-backend-1.0.0.jar /app/pro/cfc/backend/ && \
  bash /app/pro/cfc/backend/start.sh

# 重载 Nginx（不改配置无需执行）
nginx -s reload

---

关键约束

条目	规则
端口冲突	启动后端前必须释放 9082（fuser -k 9082/tcp）
构建验证	mvn clean compile 通过后才能 package
日志清理	无需手动清理，Logback 自动滚动
SSL 续期	每日 3:00 自动执行 acme.sh --cron
SFMS 只读源	生产环境已禁用（sfms.datasource.enabled: false）