用 Docker 部署 Consul 实现服务发现的核心是启动 Consul Server 节点（开发环境单节点即可）、注册业务服务，并通过 DNS 或 HTTP API 动态查询服务地址；全程无需 Kubernetes 或 Swarm，仅用 docker pull 与 docker run 命令即可完成。
用 Docker 部署 Consul 实现服务发现，核心是跑起一个 Consul Server 节点（开发环境单节点即可），再把业务服务注册进去，最后让调用方通过 HTTP 或 DNS 查找服务地址。整个过程不依赖 Kubernetes 或 Swarm，纯 Docker 命令就能完成。
启动 Consul Server 容器
这是服务发现的“大脑”，所有服务注册信息都存在这里。开发测试推荐单节点快速验证：
- 拉取官方镜像：docker pull consul
- 运行 Server 容器：
docker run -d --name consul-server -p 8500:8500 -p 8600:8600/udp -e CONSUL_BIND_INTERFACE=eth0 consul agent -server -bootstrap-expect=1 -client=0.0.0.0 -ui - 关键说明：
• -server 表示以服务端模式运行
• -bootstrap-expect=1 允许自己选举为 leader
• -client=0.0.0.0 开放 HTTP（8500）和 DNS（8600/udp）接口
• -ui 启用 Web 控制台，打开 http://localhost:8500 即可查看服务列表与健康状态
注册业务服务到 Consul
服务注册就是告诉 Consul：“我叫什么、在哪、怎么检查我是否活着”。有两种常用方式：
-
手动注册（适合调试）：
先确保你的业务容器已运行（例如 Nginx、Flask 应用），获取其 IP（如 172.17.0.3）和端口（如 80）；
然后用 curl 提交 JSON 注册配置：
curl -X PUT http://localhost:8500/v1/agent/service/register --data '{"ID":"web-01","Name":"web","Address":"172.17.0.3","Port":80,"Check":{"HTTP":"http://172.17.0.3:80/health","Interval":"10s"}}' -
自动注册（适合生产）：
运行 registrator 容器监听 Docker 事件：
docker run -d --name registrator --volume=/var/run/docker.sock:/tmp/docker.sock gliderlabs/registrator:latest consul://host.docker.internal:8500
启动业务容器时加 label：
docker run -d --label "consul.service=api" --label "consul.port=3000" my-api-app
服务发现：应用如何查到其他服务
调用方不需要硬编码目标服务的 IP 和端口，而是向 Consul 查询动态获取：
-
DNS 查询（最轻量，推荐）：
Consul 内置 DNS 服务，默认监听 8600/udp；
在能访问 Consul 的容器里执行：
nslookup api.service.consul 127.0.0.1（假设服务名为 api）
返回结果即为当前健康的实例 IP+端口 -
HTTP API 查询（更灵活）：
直接请求：
curl http://localhost:8500/v1/health/service/api?passing
返回 JSON 列表，含所有健康实例的地址、端口、标签等元数据
小贴士：几个关键注意点
- 宿主机网络互通：Docker 容器默认无法直接用 localhost 访问宿主服务，注册时 Address 填 host.docker.internal（Mac/Windows）或宿主机真实内网 IP（Linux）
- 健康检查路径要真实可用：比如 /health 必须在业务容器中返回 200，否则 Consul 会标记为不可用并剔除
- 端口映射别漏 UDP：DNS 查询依赖 8600/udp，启动时必须显式加上 /udp，否则 nslookup 会超时
- 生产环境建议至少 3 个 Server 节点，避免单点故障；单机部署仅限开发验证
