Android 무선 디버깅, adb pair·connect와 네트워크 문제를 나누는 법

AI를 활용하여 생성한 이미지입니다.

Android 무선 디버깅은 USB 케이블을 치우는 기능이라기보다, 개발용 컴퓨터와 기기를 신뢰 관계로 묶고 네트워크 경로를 유지하는 작업이에요. 페어링은 됐는데 adb devices에 안 나오거나, 같은 Wi-Fi인데 연결이 끊기는 문제는 adb pair와 adb connect를 한 단계로 생각할 때 자주 생깁니다.

무선 디버깅의 전제 조건

Android 공식 문서는 Android 11(API 30) 이상에서 무선 디버깅을 지원하고, 스마트폰과 워크스테이션이 같은 무선 네트워크에 있어야 한다고 안내해요.[1] Android Studio와 SDK Platform-Tools도 최신 상태로 맞추는 것이 먼저입니다. 회사나 공용 Wi-Fi처럼 클라이언트 간 통신을 막는 네트워크에서는 같은 SSID에 연결되어도 기기가 서로 보이지 않을 수 있어요.

adb pair는 최초 신뢰 설정이에요

기기에서 개발자 옵션을 연 뒤 무선 디버깅을 켜고, Pair using pairing code를 선택하세요. 화면에 표시된 IP 주소와 페어링 포트, 일회성 코드를 사용해 컴퓨터에서 다음처럼 입력합니다.

adb pair 192.168.0.24:37123

공식 절차에서도 페어링 코드는 기기에 표시된 값을 사용하고, 페어링이 끝난 뒤 연결 상태를 별도로 확인해요.[1] 페어링 포트와 실제 연결 포트가 다를 수 있다는 점이 중요합니다. 화면에서 페어링을 완료했는데도 바로 기기가 나타나지 않는다면, 페어링 포트를 adb connect에 재사용하지 말고 무선 디버깅 화면의 연결 주소를 다시 보세요.

한 번 페어링한 워크스테이션은 기기에서 잊도록 처리하거나 디버깅 승인을 취소하기 전까지 페어링 상태가 남을 수 있어요.[1] 공용 컴퓨터에서 작업했다면 작업이 끝난 뒤 Paired devices에서 해당 워크스테이션을 Forget 하거나 승인 취소를 실행하는 편이 안전합니다.

adb connect는 실제 연결 단계예요

페어링 뒤에는 기기 무선 디버깅 화면에 표시된 연결 주소와 포트로 연결합니다.

adb connect 192.168.0.24:41217
adb devices -l

adb devices -l 결과가 device면 명령을 실행할 준비가 된 상태예요. unauthorized가 나오면 기기 화면의 RSA 승인 대화상자를 확인해야 하고, offline이면 연결은 보이지만 통신이 정상적으로 이어지지 않는 상태로 보고 다시 연결하는 편이 낫습니다. Android 공식 문서도 adb devices로 연결된 기기를 조회하는 방법을 설명해요.[1]

연결이 꼬였을 때는 무작정 포트를 여러 개 시도하지 말고 다음 순서로 상태를 정리하세요.

1. adb disconnect 192.168.0.24:41217로 기존 연결을 끊어요.
2. 기기에서 무선 디버깅을 껐다가 다시 켜고 연결 주소가 바뀌었는지 확인해요.
3. adb kill-server 뒤 adb start-server로 로컬 adb 서버를 다시 시작해요.
4. 새 주소로 adb connect하고 adb devices -l을 다시 읽어요.

같은 Wi-Fi인데도 안 될 때

무선 디버깅은 IP 주소와 포트를 사용하므로, 공유기의 무선 클라이언트 격리나 방화벽이 원인이 될 수 있어요. 먼저 컴퓨터에서 기기의 IP가 바뀌지 않았는지, VPN이 다른 경로를 만들고 있지 않은지, 공용·게스트 네트워크가 기기 간 연결을 차단하지 않는지 확인하세요. 개발용 컴퓨터와 기기가 서로 다른 밴드에 있어도 보통 라우터가 브리지하면 통신할 수 있지만, 일부 AP는 2.4GHz와 5GHz 클라이언트를 분리합니다.

자동 검색이 실패해도 페어링 기록이 곧바로 사라진 것은 아니에요. Android 문서는 무선 디버깅에서 mDNS를 사용해 adb 서버와 기기를 자동 연결한다고 설명해요.[1] 자동 연결이 안 되면 기기 화면의 주소를 직접 사용해 adb connect를 시도하고, 네트워크가 멀티캐스트를 차단하는지 관리자에게 확인하는 편이 빠릅니다.

Platform-Tools와 보안 관리

Platform-Tools는 adb가 포함된 공식 도구 묶음이고, Android Developers는 릴리스 페이지에서 최신 버전을 제공합니다.[2] 여러 SDK가 설치된 개발 환경에서는 터미널의 adb가 예상한 경로의 파일인지 which adb와 adb version으로 확인하세요. 오래된 adb가 먼저 실행되면 페어링이나 mDNS 동작이 달라질 수 있습니다.

무선 디버깅은 신뢰 네트워크에서만 켜고, 작업이 끝나면 끄는 것이 좋아요. 특히 카페나 회사 게스트망에서 켜 둔 채 자리를 옮기면, 기기 화면을 보지 않고도 연결이 남아 있다고 착각할 수 있습니다. 작업 종료 후에는 adb devices에서 기기가 사라졌는지 확인하고, 필요하면 기기에서 승인 취소까지 실행하세요.

개발팀에서 여러 기기를 돌려 쓰는 경우에는 기기 이름과 IP 주소를 함께 기록하지 않는 편이 좋아요. 주소는 DHCP 임대가 바뀔 수 있고, 같은 네트워크에 다른 기기가 들어오면 예전 연결 대상을 헷갈릴 수 있습니다. 작업할 때마다 adb devices -l 결과를 확인하고, 필요하지 않은 기기의 무선 디버깅을 끄세요.

페어링이 계속 실패하면 여러 번 반복해서 코드를 입력하기보다, 기기에서 이전 페어링 항목을 지우고 새 코드를 발급하는 편이 빠릅니다. 실패한 주소를 메모해 두면 다음 시도에서 오래된 포트와 새 포트를 혼동하지 않아요.

출처

1. Android Developers: Android Debug Bridge
2. Android Developers: SDK Platform-Tools release notes