网络设置

WSL Dashboard 简化了 WSL 2 与宿主机（Windows）之间的网络通信配置，支持端口转发和全局 HTTP 代理。

端口转发 (Port Forwarding)

由于 WSL 2 使用虚拟网络适配器，从局域网其他设备访问 WSL 内部服务通常较为复杂。

• 核心功能: 您可以将 Windows 的特定端口映射到 WSL 实例内部的端口。
• 自动防火墙规则: WSL Dashboard 在创建转发规则时，会自动在 Windows Defender 防火墙中添加必要的入站规则，确保外部流量可以穿透。
• 配置项:
  • 宿主机 IP: 通常为 0.0.0.0 (监听所有网卡) 或 127.0.0.1。
  • 宿主机端口: Windows 侧开放的端口。
  • WSL 端口: 实例内部服务监听的端口。

全局 HTTP 代理 (HTTP Proxy)

在 WSL 内部配置代理（如 git clone 或 apt install 缓慢时）通常需要修改多个配置文件。

• 快速配置: WSL Dashboard 提供了全局代理开关。
• 工作原理: 它会根据您的设置，自动为选中的实例配置代理环境变量或相关服务的代理选项，省去手动获取宿主机 IP 的麻烦。
• 支持协议: 常见的 http:// 和 socks5:// 协议。

网络状态监控

您可以在网络面板中实时查看：

• WSL 宿主机 IP: Windows 虚拟网络适配器的 IP。
• WSL 实例 IP: 实例内部的实际分配地址。
• 活动连接: 监控当前生效的端口转发规则及流量状态。

进阶网络模式 (Mirrored Mode)

对于 Windows 11 用户，WSL 2 支持“镜像”网络模式。

• 优势: 镜像模式允许 WSL 实例直接共享宿主机的网络接口，解决了许多复杂的 VPN 或局域网发现问题。
• 配置建议: 如果您启用了镜像模式，WSL Dashboard 的端口转发功能依然可以工作，但您可能更倾向于直接通过宿主机 IP 访问服务。

提示

在 settings.toml 中配置 auto_shutdown_distros = true 可以确保在关闭 Dashboard 后，后台不留存无用的网络监听任务。

常见问题排查

端口冲突

如果某个端口转发无法生效，请检查：

1. 宿主机端口是否被占用: 使用 netstat -ano | findstr :<端口号> 检查。
2. 管理员权限: 部分端口（如小于 1024 的端口）可能需要管理员权限才能监听。

防火墙拦截

虽然 WSL Dashboard 会尝试自动配置规则，但如果您安装了第三方防火墙（如火绒、360 等），可能需要手动允许 wsldashboard.exe 的网络访问权限。