# 11.2 环境规划

:::tip 概述
推荐三套环境（开发/测试/生产）+ 环境差异经 GF_ 环境变量覆盖（不改配置文件）。本节给出环境矩阵、资源配置参考与拓扑。
:::

## 环境矩阵

| 环境 | 用途 | 后端 | 数据库 | Redis |
|------|------|------|--------|-------|
| 开发 dev | 本地开发 | go run / bin | 本地 MySQL | 本地 Redis |
| 测试 test | 联调/冒烟 | 独立部署 | 独立库 | 独立实例/db |
| 生产 prod | 对外服务 | 多实例可选 | 主从/云 RDS | 集群/云 Redis |

## 部署拓扑

```text
                 ┌──────────────────────────────────────────┐
                 │              生产网络（内网）              │
  用户 ──443──▶  │  nginx/前置代理（HTTPS 终止 + 静态 + 反代） │
                 │    │                                       │
                 │    ├── admin-server ×N（:8000，优雅重启）   │
                 │    ├── MySQL 主从（或云 RDS）               │
                 │    └── Redis（集群/云，密码强记）           │
                 └──────────────────────────────────────────┘
  文件：uploadDir 独立持久卷/共享存储（多实例需共享或对象存储改造）
  归属地：manifest/data/ip2region.xdb 随二进制分发
```

## 环境差异管理（GF_ 覆盖）

```sh
# 容器/进程管理器注入环境变量，不改配置文件
GF_DATABASE_DEFAULT_LINK="mysql:user:secret@tcp(db:3306)/easygoadmin?charset=utf8mb4&parseTime=true"
GF_REDIS_DEFAULT_ADDRESS="redis:6379"
GF_JWT_SECRET="prod-only-random-secret"
GF_APP_ERRORMSG="false"
```

原则：**同份二进制 + 不同环境变量 = 不同环境**；密钥类只走环境变量（不进配置文件/镜像层）。

## 资源配置参考

| 环境 | CPU | 内存 | 磁盘 | 说明 |
|------|-----|------|------|------|
| 开发 | 2 核 | 4 GB | 50 GB | 本机 MySQL/Redis 共享 |
| 测试 | 2 核 | 4 GB | 100 GB | 独立服务 |
| 生产（中小） | 4 核 | 8 GB | 200 GB+ | 单实例 + 数据库独立 |
| 生产（多实例） | 2 核 × N | 4 GB × N | — | Redis 必须可用（限流/锁共享） |

## 多实例注意事项

```text
必须共享 Redis（否则以下能力退化单机语义）：
  限流计数 / 任务执行锁（job:lock）/ JWT 黑名单 / 在线用户 / 验证码 / 字典缓存

上传目录：多实例需共享存储（NFS/OSS 改造）——两段式 Rename 在共享卷语义下正常
定时任务：策略 2/3 经 Redis 锁互斥（各实例都会 tick，抢锁失败放弃）
数据库连接池：按实例数 × pool 配置核算数据库 max_connections
```

## 时区与时间

```text
app.timezone: "Asia/Shanghai"    应用时区
数据库连接 loc=Local / 服务器时区保持一致
定时任务 cron 按应用时区调度——跨时区部署注意
```