Skip to content

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 환경 변수에 추가되었는지 확인하세요.