WSL2环境下如何从Docker容器内部访问局域网LAN设备

这是WSL2默认NAT网络架构的典型问题，和Docker本身配置无关。
WSL2默认会创建独立的虚拟NAT网段，和Windows主机所在的物理局域网不在同一个二层网络，Docker运行在WSL2内部时网络栈是嵌套状态，会触发两个典型异常：

• bridge模式下容器流量经过两次NAT转换（Docker bridge转WSL虚拟网卡，再转Windows物理网卡），大量局域网设备会丢弃非本网段的异常入站包，直接导致连接挂起无响应
• host模式下容器直接复用WSL2的虚拟网卡IP，该IP属于WSL自建的172.x私有段，和192.168.0.0/24物理网段不直连，ping请求走到路由器后会被直接转发到网关IP，就会出现ping目标设备返回路由器IP的现象

方案1：开启WSL2镜像网络（最稳定，Win11 22H2及以上、WSL 2.0.0及以上版本支持） #

这是官方推出的专门解决WSL2跨网段访问问题的功能，开启后WSL2会直接复用Windows主机所在局域网的网络栈，和局域网设备实现二层直连，Docker无论使用bridge还是host模式都可以正常访问局域网设备。
操作步骤：

1. 关闭所有运行中的WSL实例，在Windows PowerShell中执行：
   wsl --shutdown
2. 打开Windows个人用户目录（路径为C:\Users\你的Windows登录用户名\），新建名为.wslconfig的文件，写入以下配置：

[wsl2]
networkingMode=mirrored
dnsTunneling=true
firewall=true
autoProxy=true

*注意：文件名必须是.wslconfig，不要带.txt后缀，保存时选择文件类型为「所有文件」，避免系统自动追加文本后缀导致配置不生效。
3. 保存文件后重新启动WSL和Docker服务，直接启动容器访问192.168.0.141即可正常连通。

方案2：手动添加静态路由（适配Win10等不支持镜像模式的环境） #

如果无法升级WSL版本，可以手动配置路由规则打通WSL和物理局域网的链路：

1. 进入WSL终端执行ip a，查询eth0网卡的IP地址，一般为172.26.x.x格式的私有地址
2. 以管理员权限打开Windows PowerShell，执行命令添加静态路由：

route add 192.168.0.141 mask 255.255.255.255 <上一步查到的WSL eth0 IP> metric 1

3. 放开Windows防火墙中对应WSL虚拟网卡的入站、出站访问规则，避免流量被拦截。
   *该路由规则在Windows重启后会失效，如需长期生效可以将命令保存为开机自动执行的PowerShell脚本。

临时调试方案 #

如果只是单次调试不想修改全局配置，可以在启动容器时手动指定Windows侧的虚拟网关：

1. 进入WSL终端执行ip route | grep default，查询输出的网关地址，一般为WSL网段的.1地址（比如WSL网卡IP是172.26.12.3，对应网关就是172.26.12.1）
2. 启动容器时追加网关参数：
   docker run -it --rm -v tvdata:/home/developer --net=my-net --gateway=<上一步查到的网关IP> vitalets/tizen-webos-sdk bash
   进入容器后即可正常访问192.168.0.141，该配置仅对当前启动的容器生效，容器删除后配置自动失效。

• 不要用Docker默认bridge网络运行需要访问局域网设备的服务，默认bridge的iptables规则会额外做一次源地址转换，大幅提升丢包概率，建议使用自建的bridge网络
• 修改.wslconfig文件后必须执行wsl --shutdown完全关闭WSL进程再重启，否则配置不会加载
• 如果安装了第三方安全软件、防火墙，记得手动放开WSL虚拟网卡、Docker 172.x网段的访问权限，避免跨网段流量被安全软件拦截

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