[WSL2] WSL2로 USB 디바이스 연결하기 (usbipd-win 가이드)

usbipd-win이란?#

Windows에서 USB 디바이스를 USB/IP 방식으로 공유하고, WSL2가 그 장치를 네트워크로 “붙여서” 쓰게 해주는 도구입니다.

(WSL 관련 프로젝트도 함께 참고하면 좋습니다.)

목표#

• Windows 11 + WSL2 환경에서 USB 디바이스를 WSL2로 패스스루
• usbipd list → (관리자) bind → attach → (WSL에서 확인) → detach 흐름으로 끝내기

준비#

1
# (선택) WSL이 꼬였을 때는 먼저 완전 종료
2
wsl --shutdown
3

4
# 커널/WSL 업데이트
5
wsl --update
6
wsl --version

1
uname -r

1
wsl uname -r

1. usbipd-win 설치 (Windows)#

두 가지 중 편한 방법으로 설치합니다. (1번 권장)

1
winget install --interactive --exact dorssel.usbipd-win

1
usbipd --version

2. 연결할 USB 디바이스 확인 (Windows)#

PowerShell에서 현재 연결된 장치를 나열합니다.

1
usbipd list

예시 출력:

1
BUSID  VID:PID    DEVICE                                    STATE
2
2-1    0483:3748  ST-LINK/V2-1                              Not shared
3
2-2    10c4:ea60  Silicon Labs CP210x USB to UART Bridge    Not shared

여기서 BUSID(예: 2-2)를 기억합니다.

TIP

예전 글/예전 버전에서는 usbipd wsl list 같은 하위 명령이 보일 수 있는데, 최근 가이드는 usbipd list를 기본으로 사용합니다.

3. (중요) 디바이스 공유하기: bind (Windows 관리자)#

WSL에 붙이기 전에 먼저 공유(share) 해야 합니다.
이 단계는 관리자 권한이 필요합니다.

1
usbipd bind --busid 2-2

다시 확인:

1
usbipd list

STATE가 Shared로 바뀌면 정상입니다.

TIP

bind는 영구(persistent) 입니다. 재부팅해도 유지되며, 보통 디바이스당 한 번만 해두면 됩니다.

4. WSL2로 붙이기: attach#

IMPORTANT

attach 전에 WSL 터미널을 미리 열어두세요.
WSL2이 살아 있어야 attach가 안정적으로 됩니다.

이제 attach:

1
usbipd attach --wsl --busid 2-2

확인:

1
usbipd list

STATE가 Attached로 나오면 성공입니다.

WARNING

디바이스가 WSL에 붙어 있는 동안 Windows에서는 해당 USB를 사용할 수 없습니다.
(Windows 쪽 앱/드라이버가 잡고 있으면 attach가 실패할 수 있습니다.)

5. WSL(Ubuntu)에서 인식 확인#

WSL로 돌아가서 확인합니다.

1
sudo apt update
2
sudo apt install -y usbutils

1
lsusb

1
ls -l /dev/ttyUSB* /dev/ttyACM* 2>/dev/null

6. 연결 해제: detach (Windows)#

작업이 끝났으면 detach로 Windows에 돌려줍니다.

1
usbipd detach --busid 2-2

NOTE

attach는 비영구(non-persistent) 입니다.
재부팅/WSL 재시작/USB 재연결/보드 리셋 시에는 다시 attach가 필요할 수 있습니다.

7. (선택) 공유 해제: unbind (Windows 관리자)#

bind는 “공유 상태를 유지”하므로, 공유 자체를 끄고 싶다면 unbind를 사용합니다.
이 단계도 관리자 권한이 필요합니다.

1
usbipd unbind --busid 2-2

8. 자주 겪는 문제 (Troubleshooting)#

1
# 관리자 PowerShell
2
usbipd bind --busid <BUSID>

1
# 예시: VID:PID 기반 자동 재-attach (실행 중인 동안 루프로 동작)
2
usbipd attach --wsl --auto-attach --hardware-id 10c4:ea60

요약#

• Windows에서: usbipd list → (관리자) usbipd bind → usbipd attach
• WSL에서: lsusb / /dev/ttyUSB* 확인 후 사용
• 끝나면: usbipd detach
• 공유까지 끄고 싶으면: (관리자) usbipd unbind

참고 자료#

• Microsoft 공식 가이드: Connect USB devices (WSL)
  https://learn.microsoft.com/windows/wsl/connect-usb
• usbipd-win WSL 지원 위키
  https://github.com/dorssel/usbipd-win/wiki/WSL-support
• usbipd-win GitHub 저장소
  https://github.com/dorssel/usbipd-win