You need to enable JavaScript to run this app. WSL2环境下Docker默认网桥docker0容器无法联网问题求助
优惠活动
大模型
产品
解决方案
定价
更多

WSL2环境下Docker默认网桥docker0容器无法联网问题求助

问题成因

该现象是Docker默认网桥设计特性与WSL2网段分配冲突共同导致的:

  • Docker官方为了向后兼容,默认网桥(docker0)不会启用内置DNS解析服务,连接默认网桥的容器会直接继承宿主机的resolv.conf配置;而用户自定义的网桥默认会启用Docker内置的127.0.0.11 DNS服务器,自动代理解析请求,因此不会出现该问题。
  • 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或容器单独配置:

  1. 停止Docker服务
sudo systemctl stop docker
  1. 编辑Docker配置文件/etc/docker/daemon.json,删除临时添加的dns配置项,新增bip配置指定docker0的网段(可任意选择未被占用的私网网段,示例使用172.20.0.0/16):
{
  "bip": "172.20.0.1/16"
}
  1. 删除旧的docker0网桥
sudo ip link delete docker0
  1. 重启Docker服务,Docker会自动使用新网段重建docker0网桥
sudo systemctl start docker

配置生效后,默认网桥的容器会正常继承WSL2宿主机的DNS配置,且路由无冲突,解析行为与自定义网桥一致。


内容的提问来源于stack exchange,提问作者Lucas Basquerotto

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 18:30:01