Docker构建动态Nginx集群需实现配置可变、后端可伸缩、调度可感知，核心是自定义网络+健康检查+动态配置（推荐docker-gen+confd方案），宝塔仅作运维辅助。
用 Docker 构建具备动态负载能力的 Nginx 集群，核心在于“配置可变、后端可伸缩、调度可感知”。不是简单起多个 nginx 容器，而是让负载均衡器能自动发现新增后端、剔除异常节点，并根据策略（如连接数、响应时间）实时调整流量分发。宝塔面板可辅助管理，但底层逻辑依赖 Docker 网络、健康检查与 Nginx 动态配置机制。
用 Docker Compose 编排基础集群结构
定义清晰的三层角色：一个负载均衡器（lb），多个可增删的后端服务（upstream1/upstream2/…）。关键点是使用自定义网络和显式服务依赖：
- 创建专用 bridge 网络：
docker network create --subnet=172.18.0.0/16 nginx-lb-net，确保容器间 DNS 可解析服务名 - 在
docker-compose.yml中，所有后端服务不暴露宿主机端口，仅通过内部网络通信 - 负载均衡器通过
depends_on声明依赖，配合healthcheck判断后端是否就绪
让 Nginx 感知后端变化：两种可行路径
纯静态 upstream 在容器启停时无法自动更新。要实现“动态”，需选择以下任一方式：
-
方案 A：用 nginx-upstream-conf + Lua 脚本：在容器内运行轻量服务监听 Docker 事件或 Consul/Etcd，实时重写
/etc/nginx/conf.d/upstream.conf并触发nginx -s reload -
方案 B：用 docker-gen + confd 模板：基于容器标签（如
role=backend）自动生成 upstream 配置。例如：docker run -d --label role=backend -e SERVICE_NAME=api-v2 …，模板自动识别并加入 upstream 块
推荐从方案 B 入手，它无需修改 Nginx 源码，且与宝塔面板兼容——你可在宝塔的「Docker 管理器」中部署 confd 容器，挂载共享配置卷。
启用真实健康检查，避免请求打到宕机节点
Nginx 默认不主动探测后端存活。必须显式配置，否则“动态”只是假象：
- 在 upstream 块中添加
health_check interval=3 fails=2 passes=2;（Nginx Plus 支持，开源版需用nginx-module-vts或反向代理层前置探针） - 更通用做法：为每个后端服务暴露
/healthz接口，在 Nginx 配置中用proxy_pass+proxy_next_upstream组合实现失败转移 - 示例关键配置：
upstream backend {<br> server upstream1:80 max_fails=3 fail_timeout=30s;<br> server upstream2:80 max_fails=3 fail_timeout=30s;<br> keepalive 32;<br> }<br> location / {<br> proxy_pass http://backend;<br> proxy_next_upstream error timeout http_500 http_502 http_503 http_504;<br> }
通过宝塔面板简化运维但不替代逻辑设计
宝塔不是黑盒，它帮你可视化操作，但不能代替你设计动态逻辑：
- 在「软件商店」安装「Docker 管理器」和「Portainer」，用于查看容器状态、日志、网络拓扑
- 把
docker-compose.yml放在宝塔文件管理器可访问路径，用「终端」执行docker-compose up -d启动 - 不要依赖宝塔内置的“Nginx 管理”去改负载配置——它的配置文件与容器内隔离。所有 upstream 修改必须进容器或通过挂载卷更新
- 建议将 nginx.conf 和 upstream 模板放在
/www/wwwroot/nginx-lb/config/，用volumes挂载进 lb 容器
