WSL2固定IP终极方案：用VBS脚本实现开机自启+SSH服务（附避坑指南）

WSL2固定IP实战：从脚本自动化到生产级稳定部署

每次重启电脑，WSL2的IP地址就像抽盲盒一样随机变化，这对于依赖稳定网络连接的开发者来说简直是噩梦。想象一下，你精心配置的SSH连接、Docker容器网络、本地开发环境，因为一个IP变动全部失效，那种挫败感我深有体会。更不用说在团队协作中，如果每个人都用动态IP，配置文件就得频繁修改，效率低下不说，还容易出错。

网上确实有很多解决方案，从修改/etc/hosts到调整WSL配置文件，但大多数要么步骤繁琐，要么稳定性欠佳。我在实际项目中尝试过多种方法，最终发现通过脚本自动化配置是最可靠、最灵活的方式。今天分享的这套方案，不仅解决了IP固定的问题，还融入了开机自启、服务管理、异常处理等生产环境必需的要素。

这套方案的核心思路很清晰：在Windows启动时自动执行脚本，为WSL2的虚拟网卡和Windows宿主机的对应网卡分别设置固定IP，形成一个稳定的内部局域网。这样无论系统重启多少次，WSL2的IP地址都保持不变，所有依赖IP的服务都能稳定运行。

1. 理解WSL2网络架构与IP动态分配的根源

要彻底解决IP变动问题，首先得明白WSL2的网络工作原理。WSL2本质上是一个轻量级虚拟机，它使用Hyper-V的虚拟化技术。每次启动WSL2时，系统会创建一个虚拟网络交换机，并为WSL2分配一个随机的内部IP地址。

1.1 WSL2网络模型解析

WSL2的网络架构采用NAT（网络地址转换）模式。Windows主机充当路由器角色，WSL2实例则位于一个私有子网中。这个设计带来了两个关键特性：

• 动态IP分配：每次WSL2启动时，Hyper-V会从预定义的地址池中随机分配IP
• 双向网络访问：WSL2可以访问外部网络，外部也可以通过localhost访问WSL2服务

但问题在于，这个"随机分配"的机制对于需要固定IP的场景很不友好。比如：

• SSH远程连接配置
• Docker容器端口映射
• 本地开发环境域名绑定
• 微服务间的固定通信地址

1.2 为什么传统静态IP配置会失败

很多开发者尝试在WSL2内部配置静态IP，比如修改/etc/netplan或/etc/network/interfaces，但重启后配置就失效了。原因在于WSL2每次启动都会重新初始化网络栈，覆盖已有的网络配置。

注意：直接在WSL2内部配置静态IP是徒劳的，因为WSL2的网络控制权完全掌握在Windows宿主机的Hyper-V组件手中。

1.3 可行的解决方案思路

经过多次实践验证，真正有效的方案需要满足以下条件：

1. 在Windows层面操作：因为网络控制权在Windows
2. 开机自动执行：确保每次重启后配置都能恢复
3. 非侵入式修改：不破坏WSL2原有的网络功能
4. 容错机制：避免重复配置导致的冲突

下面这个表格对比了不同方案的优缺点：

2. 核心脚本设计与实现细节

脚本方案的核心在于两个关键操作：为WSL2的eth0网卡添加辅助IP，以及为Windows的虚拟网卡配置对应IP。下面我详细拆解每个步骤。

2.1 VBS脚本：优雅的后台执行方案

VBScript（Visual Basic Script）是Windows自带的脚本语言，最大的优势是可以在后台静默运行，不会弹出命令窗口。这对于开机启动场景特别重要。

' WSL2固定IP配置脚本 - 后台静默版
Set ws = WScript.CreateObject("WScript.Shell")

' 启动WSL2中的SSH服务
ws.run "wsl -d Ubuntu-22.04 -u root service ssh start", 0

' 为WSL2的eth0网卡添加固定IP
ws.run "wsl -d Ubuntu-22.04 -u root ip addr add 192.168.50.100/24 broadcast 192.168.50.255 dev eth0 label eth0:1", 0

' 为Windows虚拟网卡添加对应IP
ws.run "netsh interface ip add address ""vEthernet (WSL)"" 192.168.50.1 255.255.255.0", 0

这个脚本有几个关键点需要注意：

1. WSL发行版名称：Ubuntu-22.04需要替换为你实际的发行版名称，可以通过wsl -l -v命令查看
2. IP地址规划：我选择了192.168.50.0/24网段，这是私有地址范围，不会与公网冲突
3. 网卡标签：eth0:1表示这是eth0的一个别名（alias），不会影响原有的主IP

2.2 BAT脚本：带错误检查的增强版

如果你需要更详细的执行反馈和错误处理，BAT脚本是更好的选择。下面是我在实际项目中使用的增强版本：

@echo off
setlocal enabledelayedexpansion

:: 检查是否以管理员权限运行
net session >nul 2>&1
if %errorlevel% neq 0 (
    echo 请以管理员身份运行此脚本
    pause
    exit /b 1
)

:: 配置参数
set WSL_DISTRO=Ubuntu-22.04
set WSL_IP=192.168.50.100
set WSL_BROADCAST=192.168.50.255
set WSL_NETMASK=255.255.255.0
set WIN_IP=192.168.50.1
set VIRTUAL_ADAPTER="vEthernet (WSL)"

echo [INFO] 开始配置WSL2固定IP...

:: 步骤1：检查并启动WSL实例
wsl -l | findstr "%WSL_DISTRO%" >nul
if errorlevel 1 (
    echo [ERROR] 未找到WSL发行版: %WSL_DISTRO%
    exit /b 1
)

:: 步骤2：检查WSL是否已运行，如果没有则启动
wsl -d %WSL_DISTRO% -- echo "WSL已启动" >nul 2>&1
if errorlevel 1 (
    echo [INFO] 启动WSL实例...
    wsl -d %WSL_DISTRO%
)

:: 步骤3：配置WSL2固定IP
echo [INFO] 配置WSL2 IP: %WSL_IP%
wsl -d %WSL_DISTRO% -u root ip addr show eth0 | findstr "%WSL_IP%" >nul
if errorlevel 1 (
    wsl -d %WSL_DISTRO% -u root ip addr add %WSL_IP%/24 broadcast %WSL_BROADCAST% dev eth0 label eth0:1
    if !errorlevel! equ 0 (
        echo [SUCCESS] WSL2 IP配置成功
    ) else (
        echo [ERROR] WSL2 IP配置失败
        exit /b 1
    )
) else (
    echo [INFO] WSL2 IP已存在，跳过配置
)

:: 步骤4：配置Windows虚拟网卡IP
echo [INFO] 配置Windows虚拟网卡IP: %WIN_IP%
ipconfig | findstr "%WIN_IP%" >nul
if errorlevel 1 (
    netsh interface ip add address %VIRTUAL_ADAPTER% %WIN_IP% %WSL_NETMASK%
    if !errorlevel! equ 0 (
        echo [SUCCESS] Windows IP配置成功
    ) else (
        echo [ERROR] Windows IP配置失败
        exit /b 1
    )
) else (
    ech