Docker Compose 本身不支持服务发现与弹性感知,需集成 Consul 实现:Consul Server 以 host 网络部署并自发现,业务服务通过 Registrator 或代码注册,客户端通过 Consul DNS 或 API 动态发现健康实例,扩缩容时自动注册/剔除。

用 Docker Compose 实现服务发现 + 弹性感知,关键不是靠 Compose 自带功能“自动扩容”,而是把它作为声明式底座,配合 Consul 等外部服务发现组件,让服务实例上线即注册、下线即剔除,集群状态实时可感知。
Consul 作为服务发现中枢接入 Compose
Compose 本身不维护服务健康状态或跨节点服务注册表,需引入 Consul Server 集群作为统一注册中心。推荐用 host 网络模式部署 Consul Server(避免容器网络地址漂移),并通过 -retry-join 参数实现多节点自发现:
- 在 docker-compose.yml 中定义 3 个 consul-server 实例,全部使用
network_mode: host - 每个实例启动命令加入
consul agent -server -bootstrap-expect=3 -retry-join=host.docker.internal:8301(或写死其他节点 IP) - 挂载独立数据卷(如
./consul-data-01:/consul/data)保证重启后 Raft 日志不丢失 - 暴露端口 8500(UI/API)、8300–8302(RPC/Gossip)、8600(DNS)并确保宿主机防火墙放行
业务服务自动注册到 Consul
服务容器启动时,需向本地或远程 Consul Agent 注册自身。有两类常用方式:
-
嵌入注册逻辑:在应用代码中调用 Consul HTTP API(如 Go 的
consulapi库),启动时 POST 服务定义 JSON,含 name、port、check 健康探针 -
用 Registrator 辅助注册:在 Compose 中添加
registrator容器,监听 Docker daemon 事件,自动为带特定标签(如consul.register=true)的服务生成注册项 - 注册信息应包含唯一 ID、服务名、IP(建议用
host.docker.internal或宿主机真实 IP)、端口、tags 和健康检查路径(如/health)
服务间通信走 Consul DNS 或 HTTP API
业务容器不再依赖 Compose 默认 DNS 的静态解析,而是通过 Consul 提供的动态服务发现能力访问其他服务:
- 启用 Consul DNS(默认端口 8600),在容器内配置
nameserver 127.0.0.1并查询service.web.service.consul获取可用实例列表 - 应用直接调用 Consul HTTP API:
http://consul:8500/v1/health/service/user-service?passing拉取健康实例 IP+端口 - 前端 Nginx 或 Envoy 可集成 Consul template,监听服务变更,自动生成 upstream 配置并热重载
弹性伸缩后状态自动同步
用 docker compose up --scale web=5 -d 扩容时,新容器会触发 Registrator 或应用自身完成注册;缩容时,Consul 通过健康检查自动标记失败实例,5 分钟未响应即从服务列表剔除:
- 确保每个服务容器暴露一致的健康检查端点(如
/health返回 200) - Consul Agent 配置
check { http = "..."; interval = "10s"; timeout = "2s" } - 业务客户端应实现服务列表缓存 + 定期刷新(如每 30 秒轮询一次 Consul API),避免单点失效
- 缩容后旧容器退出前,Consul 会在下次检查失败后将其从 DNS 和 API 结果中移除,下游流量自然绕过


















