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 環境變數中。