使用Python Docker SDK连接宿主机失败的问题排查

首先注意到你提供的Python代码里有个语法错误——'network': self.data.run.network这一行末尾缺少逗号，会导致容器创建时参数解析失败，extra_hosts可能根本没被正确应用，先把这个逗号补上：

container_config = {
    'image': self.data.build.tag,
    'ports': self.data.run.ports,
    'network': self.data.run.network,  # 补上缺失的逗号
    'extra_hosts': {'host.docker.internal': 'host-gateway'},
    'detach': True,
}

可能的原因及对应解决方案 #

1. 宿主机服务仅绑定本地回环地址 #

如果你的宿主机8000端口服务只绑定了127.0.0.1，容器内的请求（不管用host.docker.internal还是网关IP）都无法访问——因为127.0.0.1是宿主机的本地回环，容器的127.0.0.1指向自身网络栈。

解决方法：
把宿主机的服务改成绑定0.0.0.0，让服务监听所有可用网卡：

• Flask示例：app.run(host='0.0.0.0', port=8000)
• Django示例：python manage.py runserver 0.0.0.0:8000
• 其他服务：修改配置文件中的监听地址为0.0.0.0

2. 自定义网络的网关并非172.17.0.1 #

默认Docker桥接网络的网关是172.17.0.1，但自定义网络的网关地址可能不同。

解决方法：

1. 查看自定义网络的实际网关：

docker network inspect <你的自定义网络名称>

在输出的IPAM.Config下找到Gateway字段，比如172.18.0.1
2. 在容器内用这个网关IP访问宿主机8000端口，验证连通性

3. 验证extra_hosts是否生效 #

即使代码里配置了extra_hosts，也可能因为语法错误（比如你代码里的逗号缺失）导致未生效。

验证方法：
进入容器查看/etc/hosts文件：

docker exec -it <容器ID/名称> cat /etc/hosts

如果看到host.docker.internal指向正确的宿主机IP（比如172.18.0.1），说明配置生效；如果没有，修复代码语法错误后重新创建容器。

4. 防火墙拦截了容器的请求 #

宿主机的防火墙可能阻止了Docker自定义网络段的IP访问8000端口。

解决方法：
允许自定义网络的IP段访问8000端口：

• Ubuntu（ufw）：

sudo ufw allow from <自定义网络CIDR> to any port 8000
# 示例：自定义网络CIDR为172.18.0.0/16
sudo ufw allow from 172.18.0.0/16 to any port 8000

• CentOS/RHEL（firewalld）：

sudo firewall-cmd --add-rich-rule='rule family="ipv4" source address="<自定义网络CIDR>" port port="8000" protocol="tcp" accept' --permanent
sudo firewall-cmd --reload

5. 直接使用宿主机物理IP访问 #

如果以上方法都不方便，可以直接用宿主机的物理IP（比如192.168.1.100）在容器内访问8000端口，前提是容器网络能连通宿主机物理网卡。

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