Win11下WSL2怎么配置与宿主机共享同一个局域网IP以供外部访问

云杰同学_6066

云杰同学_6066

2026-10-03

463人浏览

原创

WSL2需与宿主机共享局域网IP以实现无缝网络访问,推荐启用mirrored模式:确保Win11 23H2+、创建.wslconfig配置networkingMode=mirrored并重启WSL;若不生效需检查文件路径与扩展名;桥接模式需Hyper-V配合静态IP配置。

win11下wsl2怎么配置与宿主机共享同一个局域网ip以供外部访问

在Windows 11上调试本地API、部署测试Web服务或让同事用手机直连WSL2里的开发环境时,必须让WSL2拥有和宿主机完全一致的局域网IP,否则每次都要手动查IP、配端口转发、改hosts,甚至连不上NAS或打印机——这问题根源在于WSL2默认活在NAT隔离的私有子网里。

确认系统与功能支持

打开PowerShell,运行winver,确保版本号≥23H2(即内部版本22631或更高)。低于此版本不支持networkingMode=mirrored,强行配置将被忽略。

执行wsl --list --verbose,确认当前发行版状态为Running。若为Stopped,先运行wsl启动一次再继续。

启用镜像网络模式(推荐首选)

这是微软原生支持、无需Hyper-V管理器操作、零额外权限的方案,适用于95%的日常开发场景。

在Windows用户目录(如C:\Users\YourName)下新建纯文本文件,命名为.wslconfig(注意开头是英文点号,无扩展名)。

用记事本或VS Code打开该文件,写入以下内容:

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

保存后,以管理员身份打开PowerShell,执行:wsl --shutdown → 等待终端返回提示符 → 再输入wsl重新启动实例。

进入WSL2终端,运行ip addr show eth0 | grep "inet ",输出的IPv4地址必须与Windows宿主机ipconfig中无线网卡/有线网卡的IPv4地址完全一致(例如都是192.168.1.10)。若仍显示172.x.x.x,说明.wslconfig未被读取——检查文件是否藏在OneDrive同步文件夹内(会因路径重定向失效),或文件名误存为.wslconfig.txt。

桥接模式(需Hyper-V且适用特殊网络环境)

当镜像模式不可用(如企业域控策略禁用)、或需WSL2获得独立MAC地址参与DHCP续租时,才启用此模式。

方法一:创建外部虚拟交换机

① 以管理员身份打开「Hyper-V 管理器」→ 左侧选中本机名 → 右侧点击「虚拟交换机管理器」→ 「新建虚拟网络交换机」→ 类型选「外部」→ 点击「创建虚拟交换机」。

② 名称填wsl-bridge(后续配置强依赖此名称,大小写敏感)→ 外部网络下拉框选择你正在上网的物理网卡(Wi-Fi或以太网)→ 勾选「允许管理操作系统共享此网络适配器」→ 点击「确定」。

KroWork
KroWork

一款AI工具,主要用于Kuaishou 推出的桌面端 AI 智能体,适合需要提升相关任务效率的用户。

下载

方法二:配置.wslconfig启用桥接

编辑C:\Users\YourName\.wslconfig,替换为以下内容:

[wsl2]
networkingMode=bridged
vmSwitch=wsl-bridge
dhcp=false

【vmSwitch名称必须与Hyper-V中创建的完全一致】,否则WSL启动失败并报错VmSwitch not found。

保存后执行wsl --shutdown → 重启WSL → 在WSL中运行sudo nano /etc/wsl.conf,添加:

[network]
generateHosts = true
generateResolvConf = true

然后执行sudo nano /etc/netplan/01-network-manager-all.yaml,写入静态IP配置(IP、网关、DNS需严格匹配宿主机所在局域网段):

network:
  version: 2
  renderer: NetworkManager
  ethernets:
    eth0:
      dhcp4: false
      addresses: [192.168.1.110/24]
      gateway4: 192.168.1.1
      nameservers:
        addresses: [192.168.1.1, 8.8.8.8]

最后运行sudo netplan apply生效。此时ip addr应显示你指定的静态IP,且能ping通宿主机和同网段其他设备。

验证外部可访问性

在WSL2中启动一个最简HTTP服务:python3 -m http.server 8000。

在Windows宿主机浏览器访问http://localhost:8000,确认可打开。

在局域网另一台设备(如手机)浏览器中输入宿主机IP加端口,例如http://192.168.1.10:8000,页面成功加载即表示配置完成。

若失败,检查Windows防火墙是否放行TCP 8000端口:「控制面板→系统和安全→Windows Defender 防火墙→高级设置→入站规则→新建规则→端口→TCP 8000→允许连接」。

相关专题

更多
Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

80

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

140

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

120

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

120

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

100

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

120

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习