ADB 케이블 없이 쓰는 방법: 무선 디버깅과 adb tcpip
USB 케이블 없이 ADB를 쓰는 방법을 정리했어요. 안드로이드 11 이상은 무선 디버깅, 이전 버전은 adb tcpip, 그리고 브라우저에서 와이파이로 폰을 제어하는 방법까지 다룹니다.
ADB는 USB 케이블 없이도 쓸 수 있어요. 안드로이드 11 이상에서는 무선 디버깅(Wireless debugging)으로 컴퓨터와 폰을 와이파이로 페어링하기 때문에 케이블이 아예 필요 없습니다. 안드로이드 10 이하에서는 adb tcpip로 폰을 네트워크 모드로 바꿀 때 한 번만 케이블을 연결하고, 그 뒤에는 뽑아도 돼요. 이 글에서는 두 방법과 함께 ADBKit으로 브라우저에서 연결하는 방법도 설명합니다.
내 폰에 맞는 방법
| 기기 | 케이블 필요 여부 | 방법 |
|---|---|---|
| 안드로이드 11 이상 | 필요 없음 | 무선 디버깅 (페어링 코드 또는 QR 코드) |
| 안드로이드 10 이하 | 재부팅할 때마다 한 번 | adb tcpip 5555 후 adb connect |
| Android TV, Google TV, Fire TV | 대부분 필요 없음 | ADB 디버깅을 켜면 네트워크 ADB가 기본 제공 |
안드로이드 버전은 갤럭시에서는 설정 › 휴대전화 정보 › 소프트웨어 정보 › 안드로이드 버전, 픽셀에서는 설정 › 휴대전화 정보 › Android 버전에서 확인할 수 있어요. 두 방법의 자세한 비교는 adb tcpip vs 무선 디버깅에 있습니다.
시작하기 전에
- 개발자 옵션을 켜고(휴대전화 정보에서 빌드번호를 일곱 번 탭) USB 디버깅을 켜 주세요. 자세한 방법은 USB 디버깅 켜는 법을 참고하세요.
- 폰과 컴퓨터를 같은 와이파이 또는 같은 로컬 네트워크에 연결하세요. 게스트 와이파이나 "AP 격리"가 켜진 네트워크에서는 기기끼리 서로 보이지 않아요.
adb pair를 쓰려면 Android SDK platform-tools 30 이상이 필요해요. 아니면 Chrome이나 Edge에서 ADBKit을 쓰면 됩니다.
방법 1: 무선 디버깅 (안드로이드 11 이상, 케이블 불필요)
- 폰에서 개발자 옵션 › 무선 디버깅(Wireless debugging)을 열고 켭니다.
- 페어링 코드로 기기 페어링(Pair device with pairing code)을 탭해요. 화면에 IP 주소, 포트, 6자리 코드가 나타납니다.
- 컴퓨터에서 다음을 실행하세요.
adb pair 192.168.1.20:37011- 6자리 코드를 입력하면
Successfully paired가 표시돼요. - 무선 디버깅 화면으로 돌아가서 상단의 IP 주소 및 포트(IP address & Port)를 확인하고 연결합니다. 이 포트는 페어링 포트와 달라요.
adb connect 192.168.1.20:41237
adb devices페어링은 컴퓨터마다 한 번만 하면 됩니다. 다음부터는 무선 디버깅을 켜고 새 포트로 adb connect만 실행하세요. 포트는 켤 때마다 바뀌어요.
방법 2: adb tcpip (안드로이드 10 이하)
예전 폰은 와이파이로 페어링할 수 없어서 케이블을 한 번 연결해야 해요.
adb tcpip 5555케이블을 뽑고 설정 › Wi-Fi › 연결된 네트워크에서 폰의 IP 주소를 확인한 다음 연결합니다.
adb connect 192.168.1.20:5555폰에 "USB 디버깅을 허용하시겠습니까?" 창이 뜨면 허용을 눌러 주세요. 이 네트워크 모드는 폰을 재부팅할 때까지만 유지돼요. 재부팅 후에는 Connection refused가 나오고 케이블을 다시 한 번 연결해야 합니다. 이 오류는 adb connect Connection refused 해결에서 자세히 설명해요.
방법 3: ADBKit으로 브라우저에서 연결
웹페이지는 스스로 폰에 네트워크 연결을 열 수 없어요. 그래서 ADBKit은 내 컴퓨터에서 실행되는 작은 에이전트를 사용합니다. 에이전트는 내 컴퓨터 안에서만 연결을 받아 중계하고, ADBKit 서버로는 아무것도 보내지 않아요.
- Chrome이나 Edge에서 ADBKit을 열고 Network: Wireless debugging(안드로이드 11 이상) 또는 Network: TCP/IP(예전 폰)를 고릅니다.
- 안내에 따라 한 줄 설치 명령으로 에이전트를 실행하세요. 에이전트의 소스 코드는 공개되어 있어요.
- 무선 디버깅은 6자리 코드나 폰으로 QR 코드를 스캔해서 페어링합니다. TCP/IP는 폰을 USB로 한 번 연결하면 ADBKit이 네트워크 모드를 대신 켜 줘요.
이렇게 연결하면 와이파이로 실시간 화면, 키보드 입력, logcat, 셸, 파일, APK 설치를 모두 쓸 수 있어요. 에이전트 설정은 ADBKit 에이전트 안내에 정리되어 있습니다.
자주 생기는 문제
failed to connect ... Connection refused: 폰이 그 포트에서 연결을 받지 않고 있어요. 안드로이드 10 이하라면 마지막 재부팅 때 네트워크 모드가 꺼진 거예요. 안드로이드 11 이상이라면 무선 디버깅이 꺼졌거나 포트가 바뀐 경우입니다.failed to connect ... timed out: IP 주소가 틀렸거나 폰과 컴퓨터가 서로 다른 네트워크에 있어요.- 페어링 실패: 코드가 만료됐거나 페어링 화면을 닫은 경우예요. 화면을 다시 열고 새 코드를 쓰세요.
- 화면이 꺼지면 연결이 끊김: 일부 폰은 전력을 아끼려고 와이파이를 멈춰요. 작업하는 동안 폰을 충전기에 꽂아 두고 개발자 옵션에서 화면 켜짐 상태 유지(Stay awake)를 켜 주세요.
무선 ADB는 안전할까?
믿을 수 있는 네트워크에서만 쓰세요. 무선 디버깅은 연결을 암호화하고 페어링된 컴퓨터만 받아들여요. 반면 기존 방식인 adb tcpip는 암호화되지 않고 폰을 재부팅할 때까지 5555 포트가 열려 있어서 공용 와이파이에서는 피하는 게 좋아요. 작업이 끝나면 무선 ADB를 꺼 주세요.