USB 裝置管理

WSL Dashboard 透過與 usbipd-win 的整合，使您能透過 GUI 介面輕鬆將本機 USB 裝置連接到 WSL 執行個體。

前置準備

使用此功能前，請確認：

1. Windows 已安裝 usbipd-win。
2. WSL 核心支援 USB（最新的 WSL 2 標準核心通常支援）。

使用步驟

1. 掃描裝置

存取「USB」標籤頁時，應用程式會自動列出目前連接至 Windows 的所有 USB 裝置（如集線器、滑鼠、儲存裝置等）。

2. 綁定裝置 (Bind)

在將裝置連接到特定 WSL 執行個體前，您需要先「綁定」裝置。綁定操作需要管理員權限，WSL Dashboard 會自動處理權限提升請求。

綁定後，裝置即準備好與 WSL 共用。

3. 連接至執行個體 (Attach)

選擇執行中的 WSL 執行個體，點擊「連接 (Attach)」。

• 連接成功後，USB 裝置將從 Windows 中消失，並出現在選定的 WSL 執行個體中。
• 可在 WSL 內使用 lsusb 指令確認。

4. 中斷連接 (Detach)

操作完成後，點擊「中斷連接 (Detach)」，裝置將回到 Windows 的控制下。

常見問題

• 找不到裝置？: 更新清單或確認裝置是否正確連接至主機。
• 連接失敗？: 確認目標 WSL 執行個體正在執行，且具備足夠的存取權限。
• 找不到 usbipd 指令？: 確認已安裝 usbipd-win 並已加入系統的 PATH 環境變數。