11.1 部署 Checklist

概述

生产上线前逐项核对。本章各页是展开说明，本页是可打印的检查清单。

上线前

[ ] 生产数据库已初始化（种子脚本或 migrator 搬迁），账号最小权限
[ ] Redis 就绪且设置了密码（生产禁用空密码）
[ ] app.prod=true（触发启动红线校验）
[ ] JWT 密钥已更换且长度足够（非默认值）
[ ] generator.enable=false（生成器关闭）
[ ] captcha.bypassCode 为空（无万能码）
[ ] api.docs=false（或网关封锁 /swagger、/api.json）
[ ] api.metrics 按需关闭或内网保护
[ ] cors.allowOrigin 收敛到实际前端域名
[ ] api.proxyIps 与真实反代拓扑一致（未配 0.0.0.0/0）
[ ] file.domainUrl 为 https 域名且 nginx 已配置直供
[ ] 上传目录、日志目录磁盘容量评估完成
[ ] 日志保留天数（job.logRetentionDays）符合合规要求
[ ] make check 通过（fmt + vet + test-short + check-config）
[ ] 前端 pnpm build 产物部署、history 回退配置完成
[ ] HTTPS 证书就绪（Nginx 终止 TLS）
[ ] 备份策略就绪（数据库 + upload 目录，见 11.9）

上线后

[ ] curl /api/health 返回正常
[ ] 登录 → 菜单 → 核心页面冒烟通过
[ ] 错误日志无启动告警（WireCheck / Redis 降级）
[ ] 监控接入（/metrics 抓取或应用内监控页）
[ ] 操作日志正常落库
[ ] 定时任务调度器运行（任务管理页 DaemonStatus）

回滚预案

[ ] 上一版本二进制/镜像可回滚
[ ] 数据库变更（如有）有回滚脚本
[ ] 回滚演练完成

相关