網路設定

WSL Dashboard 支援連接埠轉發和全域 HTTP 代理，簡化 WSL 2 與主機（Windows）之間的網路通訊設定。

連接埠轉發 (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 的網路存取權限。