網路設定

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 的網路存取權限。