Docker默认桥接网络子网与宿主机局域网重叠会导致容器外网访问异常、端口映射失败等问题，解决方法是修改daemon.json配置bip参数避开冲突网段（如设为10.200.0.1/16），重启Docker并清理旧容器与网络残留。
当Docker默认桥接网络（docker0）的子网（如 172.17.0.0/16）与宿主机所在局域网或其他已用网段重叠时，容器无法正常访问外网，或宿主机/局域网设备无法访问容器服务，典型表现为 ping 不通、端口映射失败、DNS 解析异常等。解决核心是**避开冲突网段，自定义 Docker 的默认桥接子网**。
确认当前冲突来源
先排查是否真存在重叠：
- 查宿主机所在局域网段：
ip route | grep '^default\|^[0-9]' | awk '{print $1}' | grep '\.' | head -1（或直接看网关所在网段，如192.168.3.1→ 网段通常是192.168.3.0/24） - 查 Docker 默认网段：
ip addr show docker0 | grep 'inet '（常见为172.17.0.1/16） - 对比两者：若宿主机网段是
172.17.100.0/24或172.16.0.0/12内任意子网，就属于重叠（CIDR 包含关系）
修改 Docker 默认桥接网络子网
通过 Docker daemon 配置指定非冲突网段（推荐使用 172.20.0.0/16、10.200.0.0/16 或 192.168.123.0/24 等冷门但安全的私有地址段）：
- 编辑 daemon 配置文件：
sudo nano /etc/docker/daemon.json - 写入（以
10.200.0.0/16为例）：
{
"bip": "10.200.0.1/16",
"fixed-cidr": "10.200.0.0/24"
}
-
bip指定docker0网桥 IP 和子网（必须是单个 CIDR，且该 IP 将作为网桥地址） -
fixed-cidr（可选）限制容器分配的 IP 范围（避免和后续自定义网络冲突） - 保存后重启 Docker：
sudo systemctl restart docker - 验证：
ip addr show docker0应显示新 IP，docker network inspect bridge查看Subnet是否已更新
清理旧容器与网络残留
重启 Docker 后，原有容器会停止，但旧 docker0 配置可能残留，导致新网桥未生效或路由混乱：
- 删除所有容器（若无重要数据）：
docker rm -f $(docker ps -aq) - 删除所有自定义网络（除
bridge外）：docker network prune - 手动清除旧
docker0（谨慎）：sudo ip link delete docker0（Docker 重启时会自动重建） - 检查路由表：
ip route确保只有一条10.200.0.0/16 dev docker0类似条目，无重复或冲突路由
补充建议：避免未来冲突
长期运维中可进一步加固：
- 在
/etc/docker/daemon.json中固定default-address-pools，统一管理后续自定义网络的地址池 - 若企业环境使用固定网段（如
10.100.0.0/16），建议提前规划并文档化 Docker 所有网络子网 - 避免在脚本中硬编码
172.17.x.x类地址，改用host.docker.internal或容器间 DNS 名称通信 - 使用
docker network create --subnet=...显式创建业务网络，不依赖默认 bridge
