WSL2环境下Docker默认网桥docker0容器无法联网问题求助
问题成因
该现象是Docker默认网桥设计特性与WSL2网段分配冲突共同导致的:
- Docker官方为了向后兼容,默认网桥(docker0)不会启用内置DNS解析服务,连接默认网桥的容器会直接继承宿主机的
resolv.conf配置;而用户自定义的网桥默认会启用Docker内置的127.0.0.11DNS服务器,自动代理解析请求,因此不会出现该问题。 - WSL2自动生成的
resolv.conf中,nameserver地址为172.17.176.1,刚好落在docker0默认的172.17.0.0/16子网范围内。此时容器发往该DNS地址的请求会被路由到docker0网关172.17.0.1,而非真实的WSL2虚拟网关,导致DNS解析失败。 - 此前运行正常是因为当时WSL2分配的虚拟网关网段未与docker0默认网段重叠,后续WSL2重启/更新后网段发生变化触发了冲突。
解决方案(非hack标准配置方案)
通过修改Docker默认网桥的IP段,避开WSL2的网段范围即可解决,无需修改宿主机DNS或容器单独配置:
- 停止Docker服务
sudo systemctl stop docker
- 编辑Docker配置文件
/etc/docker/daemon.json,删除临时添加的dns配置项,新增bip配置指定docker0的网段(可任意选择未被占用的私网网段,示例使用172.20.0.0/16):
{ "bip": "172.20.0.1/16" }
- 删除旧的docker0网桥
sudo ip link delete docker0
- 重启Docker服务,Docker会自动使用新网段重建docker0网桥
sudo systemctl start docker
配置生效后,默认网桥的容器会正常继承WSL2宿主机的DNS配置,且路由无冲突,解析行为与自定义网桥一致。
内容的提问来源于stack exchange,提问作者Lucas Basquerotto
相关产品推荐
相关产品推荐

