如何开启WSL的IPv6功能：完整指南

如何开启WSL的IPv6功能：完整指南

引言

适用于Linux的Windows子系统（WSL）是Windows系统中运行Linux环境的强大工具。随着IPv6网络的普及，在WSL中启用IPv6支持变得越来越重要。本文将详细介绍如何在WSL中启用IPv6功能，解决常见问题，并提供验证方法。

WSL IPv6支持概述

WSL对IPv6的支持程度与您的Windows版本、WSL版本以及采用的网络模式密切相关。微软在较新版本的WSL（例如2.2.2及以上版本）中加强了对IPv6的支持。根据您的需求，可以选择不同的网络模式来启用IPv6。

启用IPv6的几种方法

您可以通过修改WSL的配置文件（%USERPROFILE%.wslconfig）来启用IPv6，具体配置取决于您选择的网络模式。以下是常见的模式及配置：

1. 桥接模式 (Bridged)

适用系统：Windows 10/11

配置示例：

[wsl2]
networkingMode=bridged
vmSwitch=你的虚拟交换机名
ipv6=true

特点与注意事项：

• WSL实例会像独立设备一样连接到您的局域网
• 可能从路由器获取和宿主机同网段的IPv4和IPv6地址
• 需要先在Hyper-V管理器中创建外部虚拟交换机

2. 镜像模式 (Mirrored)

适用系统：Windows 11

配置示例：

[wsl2]
networkingMode=mirrored
autoProxy = true  # 可选

特点与注意事项：

• 一种高级网络模式，WSL实例会共享宿主机的网络特性
• 包括IP地址和端口空间的共享
• 通常能更好地支持IPv6，但需要Windows 11系统

3. NAT模式（默认）

适用系统：Windows 10/11

配置示例：

[wsl2]
# 通常无需额外配置IPv6参数

特点与注意事项：

• WSL实例位于虚拟NAT网络后
• IPv6支持可能不完整或需要额外配置

操作步骤

步骤1：编辑.wslconfig文件

1. 确定您希望使用的网络模式
2. 编辑%USERPROFILE%.wslconfig文件（如果文件不存在，请新建）
3. 根据您选择的模式添加相应配置

例如，使用桥接模式的完整配置可能如下：

[wsl2]
networkingMode=bridged
vmSwitch=virtual switch
ipv6=true

[experimental]
sparseVhd=true

步骤2：应用配置

1. 保存文件后，关闭所有WSL实例
2. 在PowerShell中执行wsl --shutdown以应用更改
3. 重新启动您的WSL发行版

重要前提与检查

在尝试上述配置前，请确保：

1. 主机系统已启用IPv6

WSL2的虚拟网卡需要依赖主机系统的IPv6支持。请确保您Windows主机的网络连接属性中已启用IPv6。

2. Hyper-V与虚拟交换机（桥接模式必需）

若使用桥接模式，需先确保：

• 已安装Hyper-V相关功能
• 在Hyper-V管理器中创建一个外部类型的虚拟交换机
• 虚拟交换机名称与.wslconfig中的vmSwitch参数一致

3. 防火墙设置

检查Windows防火墙和WSL内发行版的自带防火墙（如ufw）是否可能阻止了IPv6连接，测试时可暂时关闭以便排查。

常见问题与解决方案

问题：WSL2实例无法获取全局IPv6地址

可能原因：

• Windows主机上的"vEthernet (virtual switch)"接口的IPv6转发功能被禁用
• WSL2使用桥接网络模式时，虚拟交换机未启用IPv6转发
• WSL2实例只有IPv6链路本地地址，无法访问外部IPv6网络

解决方案：

1. 在Windows主机上启用IPv6转发功能：

   netsh interface ipv6 set interface "vEthernet (virtual switch)" forwarding=enabled
   

2. 重启WSL以应用新的网络配置：

   wsl --shutdown
   

问题：配置后仍无法访问IPv6网络

排查步骤：

1. 检查.wslconfig文件是否正确配置
2. 确认虚拟交换机名称是否正确
3. 验证Windows主机IPv6连接是否正常
4. 检查防火墙设置

配置后检查与测试

完成配置并重启WSL后，建议进行以下检查：

1. 检查IP地址

在WSL终端中执行以下命令，查看eth0接口是否分配了非fe80开头的全球单播IPv6地址（例如240e:...）：

ip addr show eth0

或

ifconfig

注意：fe80开头的是链路本地地址，仅用于本地链路通信。

2. 测试网络连通性

尝试以下命令测试IPv6连接：

ping -6 ipv6-test.com

或

ping6 ipv6-test.com

使用curl测试IPv6连接：

curl -6 https://6.ipshudi.com

3. 验证结果

如果配置成功，您应该看到：

• WSL2实例成功获取全局IPv6地址（例如：240e:b8f:5934:1a00:5cbb:f6ff:fe9e:eefa/64）
• WSL2实例可以成功访问IPv6网络

其他建议

如果主要方法遇到困难，可以尝试：

1. 更新系统组件

确保Windows系统和WSL内核为最新版本。您可以通过以下命令更新WSL：

wsl --update

2. 检查网络代理设置

如果您使用了网络代理，确保其正确配置并支持IPv6流量转发。

3. 查看官方文档

访问Microsoft WSL官方文档获取最新信息和故障排除指南。

总结

启用WSL的IPv6功能可以显著扩展您的网络能力，特别是在IPv6网络日益普及的今天。通过正确配置.wslconfig文件、确保系统前提条件满足以及进行适当的测试验证，您可以在WSL环境中成功启用IPv6支持。

记住，桥接模式通常提供最佳的IPv6支持，但需要更多的初始配置。镜像模式是Windows 11用户的另一个优秀选择，而NAT模式虽然配置简单，但可能需要额外的设置才能完全支持IPv6。

希望本文能帮助您在WSL中成功启用IPv6功能，充分利用现代网络技术的优势！