Docker主机网络模式下Consul UI端口8500无法访问问题

以主机网络模式运行Consul Docker容器后，无法通过8500端口访问UI界面：

• Docker主机IP：192.168.30.12
• 主机网络接口：ens192
• 运行命令：

docker run -d --net=host -v /home/docker/conf.json:/consul/config/config.json -v /home/docker/data/:/consul/data/ -e CONSUL_BIND_INTERFACE=ens192 -e CONSUL_CLIENT_INTERFACE=ens192 --name=consulserver1 -d consul agent -server -bootstrap-expect=1 -client 0.0.0.0 -bind=192.168.30.12

• 容器日志关键信息：
  • 已识别ens192接口的IP为192.168.30.12，完成bind和client选项配置
  • Client Addr显示为[0.0.0.0]，HTTP端口为8500
  • Consul agent已正常启动，集群最终成功选举出leader

1. 检查主机端口占用 #

确认主机8500端口是否被其他进程占用：

ss -tulpn | grep 8500

若存在占用，停止对应进程或修改Consul的HTTP端口。

2. 验证防火墙规则 #

确保主机防火墙允许8500端口的TCP入站流量：

• 针对ufw防火墙：

ufw allow 8500/tcp
ufw reload

• 针对firewalld防火墙：

firewall-cmd --add-port=8500/tcp --permanent
firewall-cmd --reload

3. 确认访问地址正确性 #

主机网络模式下，直接通过主机IP访问UI（注意默认路径/ui）：

http://192.168.30.12:8500/ui

4. 简化命令测试 #

先使用最简命令启动容器，排除配置文件或挂载目录的干扰：

docker stop consulserver1 && docker rm consulserver1
docker run -d --net=host --name=consul-test consul agent -server -bootstrap -client 0.0.0.0 -bind=192.168.30.12

若此命令能正常访问UI，再逐步加回原参数排查问题点。

5. 检查自定义配置文件 #

若挂载了conf.json，确认配置未覆盖访问设置：

{
  "client_addr": "0.0.0.0",
  "ports": {
    "http": 8500
  }
}

确保配置未限制访问端口或地址范围。

6. 验证容器内端口监听 #

进入容器检查8500端口是否正常监听：

docker exec -it consulserver1 ss -tulpn | grep 8500

若容器内监听正常但主机无法访问，优先排查主机防火墙或网络策略。

内容的提问来源于stack exchange，提问作者Andy Johnson