WSL2如何通过固定服务器名反向访问Windows主机的本地服务
WSL2 固定服务器名反向访问Windows本地服务实现方案
核心逻辑说明:WSL2基于NAT虚拟网络模式运行,与Windows主机处于同一内网段,Windows主机作为WSL2虚拟机的默认网关,之前出现IP随机变动、无法稳定反向访问的问题,本质是WSL2默认的DHCP动态分配网关IP、加上系统默认仅开启「Windows主机访问WSL2服务」的单向localhost转发,不存在网络层面的不可达障碍,只需要简单配置就能实现固定域名访问。
方案1:使用WSL内置固定域名(优先推荐,零手动维护)
- WSL 0.67.6及后续正式版本,系统内置了永久指向Windows主机的固定域名
host.windows.internal,该域名不会随WSL重启、网络环境变化出现解析IP变动,完全不需要手动修改hosts文件。 - 验证方式:在WSL终端执行
ping host.windows.internal,返回的连通地址即为当前Windows主机的网关IP,解析结果全程稳定。 - 服务连接适配:连接Windows主机上的MySQL、本地Web服务器等服务时,直接将服务地址填写为
host.windows.internal即可,例如连接WAMP/LocalWP搭建的本地站点、3306端口的MySQL实例,无需再单独查询动态IP。 - 前置校验:需确保Windows端运行的本地服务未绑定仅环回口(127.0.0.1)监听,需将服务监听地址调整为0.0.0.0,同时开放对应端口的Windows防火墙入站规则,否则会出现连接拒绝。
方案2:旧版WSL自动hosts配置(适配0.67.6之前的WSL版本)
对于版本较低、没有内置固定域名的WSL环境,可以通过启动时自动更新hosts的方式,将动态网关IP绑定到自定义的固定服务器名,全程无需手动维护:
- 核心依据:WSL2环境下,Windows主机的地址永远是虚拟网络的默认网关IP,可通过命令实时获取:
ip route | grep default | awk '{print $3}',该IP随WSL启动动态变化,但始终是Windows主机的有效访问地址。 - 配置方法:将以下逻辑追加到WSL终端的启动配置文件(如
~/.bashrc、~/.zshrc)末尾,每次打开终端时自动刷新解析关系:
# 自动绑定Windows主机固定域名 WIN_GATEWAY_IP=$(ip route | grep default | awk '{print $3}') # 清除旧的解析条目避免冲突 sudo sed -i '/windows.local/d' /etc/hosts # 写入当前有效解析关系 echo "$WIN_GATEWAY_IP windows.local" | sudo tee -a /etc/hosts
- 配置完成后,WSL内的
windows.local会永远指向当前Windows主机,IP动态变化的问题会被自动处理,无需每次重启WSL手动修改hosts。
常见问题排查
- 不要尝试用WSL内的
localhost反向连接Windows主机服务:WSL的localhost转发是单向的,仅实现Windows端通过localhost访问WSL内的服务,WSL内的localhost指向WSL自身的环回口,不关联Windows主机。 - 不要手动修改WSL虚拟网络的静态IP配置:强制设置静态网关会破坏WSL内置的localhost转发功能,反而导致Windows端无法正常访问WSL内的服务。
- 遇到连接拒绝时优先排查服务配置:例如MySQL需调整
my.ini中的bind-address为0.0.0.0,同时给数据库账号开放WSL对应网段的访问权限,不要仅允许账号从127.0.0.1登录。
内容的提问来源于stack exchange,提问作者Tim
相关产品推荐
相关产品推荐

