# 11.1 部署 Checklist

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

## 上线前

- [ ] 生产数据库已初始化（种子脚本或 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](/zh/deploy/backup.html)）

## 上线后

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

## 回滚预案

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

## 相关

- [11.4 后端部署](/zh/deploy/backend.html)
- [11.6 Docker 生产部署](/zh/deploy/docker.html)
- [11.8 安全加固清单](/zh/deploy/security.html)