文章目录
- Nginx 生产环境多组 Upstream 实战方案
- 一、整体架构与规划说明
- 1. 拆分原则
- 2. 目录与配置拆分规范（企业级模块化）
- 二、全局主配置 `nginx.conf`（日志格式+全局参数）
- 日志字段说明
- 三、多组 Upstream 配置 `conf.d/upstream_idc.conf`
- 分组规划
- 四、路由分流 + 日志隔离 + 调试开关 `conf.d/server_main.conf`
- 五、内网状态页 + 运维调试页面 `conf.d/server_internal.conf`
- 六、日志切割、备份适配（多日志文件）
- 6.1 Logrotate 配置 `/etc/logrotate.d/nginx`
- 6.2 日志目录权限校验
- 七、调试与排障实操指南
- 7.1 临时开启全量 Debug 日志（线上排错）
- 7.2 按 IDC/业务 检索日志
- 7.3 查看上游节点转发情况
- 7.4 切换集群流量（主备切换）
- 八、扩展优化与生产规范
- 8.1 长连接优化
- 8.2 限流隔离（按业务限流）
- 8.3 日志对接 ELK/Graylog
- 8.4 配置校验与上线流程
- 九、总结
Nginx 生产环境多组 Upstream 实战方案
按IDC 机房、业务线、服务集群拆分多组upstream，配套分层日志、细粒度日志格式、调试日志、分流规则、故障隔离、运维排错全套生产配置，适配多机房、多业务混合网关场景，配置可直接上线。
一、整体架构与规划说明
1. 拆分原则
- 按 IDC 机房拆分：机房A、机房B、异地灾备机房独立上游池，做机房级流量隔离、故障隔离、灰度切换。
- 按业务线拆分：API 接口、前端静态、后台管理、文件上传、第三方回调等不同业务独立集群。
- 按集群角色拆分：主集群、备用集群、灰度集群、压测集群物理隔离。
- 日志隔离：不同 IDC / 不同业务输出独立日志文件，日志字段携带机房、业务、集群标识，便于检索统计。
- 调试机制：区分线上正常日志、详细调试日志、错误日志，线上默认关闭冗余调试，排障时动态开启。
2. 目录与配置拆分规范（企业级模块化）
/usr/local/nginx/conf/ ├── nginx.conf
