와이파이 ADB 연결 방법: 케이블 없이 안드로이드에 adb 연결하기

와이파이로 ADB를 쓰려면 폰을 USB로 한 번 연결하고 adb tcpip 5555를 실행한 뒤, 케이블을 뽑고 adb connect <폰 IP>:5555를 실행하면 돼요. 컴퓨터와 폰은 같은 네트워크에 있어야 해요. 안드로이드 11 이상에는 페어링 코드를 쓰는 무선 디버깅(Wireless debugging)이 기본으로 들어 있어서 케이블이 아예 필요 없어요.

시작하기 전에

• 폰에서 USB 디버깅이 켜져 있어야 해요. 아직이라면 USB 디버깅 켜는 법을 보세요.
• 컴퓨터와 폰이 같은 로컬 네트워크에 있어야 해요. 게스트 네트워크나 일부 공용 와이파이는 기기 간 통신을 막아요.
• 명령줄로 하려면 컴퓨터에 Android platform tools(adb)가 있어야 해요.

방법 1: 기존 방식 (adb tcpip)

USB 디버깅만 되면 모든 안드로이드 버전에서 쓸 수 있어요.

1. USB 케이블로 폰을 연결하고 승인됐는지 확인하세요.

adb devices

1. 기기의 ADB 데몬을 5555 포트의 TCP/IP 모드로 바꿉니다.

adb tcpip 5555

restarting in TCP mode port: 5555가 표시돼야 해요.

1. 폰의 IP 주소를 확인하세요(다음 섹션 참고).
2. 케이블을 뽑고 네트워크로 연결합니다.

adb connect 192.168.1.42:5555

주소는 내 폰의 주소로 바꾸세요. 성공하면 connected to 192.168.1.42:5555가 출력돼요.

1. 확인해 보세요.

adb devices

이제 기기가 192.168.1.42:5555로 표시돼요. 케이블로 연결했을 때처럼 모든 명령이 동작해요.

연결을 끊으려면 adb disconnect 192.168.1.42:5555를 실행하세요. TCP 모드는 영구적이지 않고 폰을 재부팅하면 초기화돼요.

폰 IP 주소 찾기

• 갤럭시: 설정 › 휴대전화 정보 › 상태 정보에서 IP 주소를 확인하세요. 픽셀 등 기본 안드로이드는 설정 › 휴대전화 정보의 IP 주소 항목이나 설정 › 네트워크 및 인터넷 › 인터넷에서 연결된 와이파이의 세부 정보를 열어 보면 돼요.
• 폰이 USB로 연결된 상태라면 컴퓨터에서 확인할 수도 있어요.

adb shell ip route

wlan0 줄에서 src 뒤의 주소가 폰의 IP예요.

메뉴 이름은 제조사마다 다르지만 IP 주소는 항상 와이파이 네트워크 세부 정보나 휴대전화 상태 화면 어딘가에 있어요.

방법 2: 무선 디버깅 (안드로이드 11 이상)

안드로이드 11부터는 케이블이 필요 없는 페어링 방식이 추가됐어요.

1. 설정 › 개발자 옵션(픽셀은 설정 › 시스템 › 개발자 옵션)을 열고 무선 디버깅을 켜세요(폰이 와이파이에 연결되어 있어야 해요).
2. 무선 디버깅을 탭하고 페어링 코드로 기기 페어링을 누르세요. 화면에 IP 주소, 포트, 6자리 코드가 나와요.
3. 컴퓨터에서 그 페어링 포트로 페어링합니다.

adb pair 192.168.1.42:37123

물어보면 6자리 코드를 입력하세요.

1. 무선 디버깅 메인 화면으로 돌아가서 거기 보이는 IP 주소와 포트를 확인하고 연결하세요(페어링 포트와 다른 포트예요).

adb connect 192.168.1.42:41567

포트는 바뀌기 때문에 설정을 껐다 켤 때마다 다시 확인해야 할 수 있어요.

보안: 켜 두기 전에 꼭 읽어 주세요

주의: TCP로 열린 ADB 포트는 같은 네트워크의 누구나 접근할 수 있고, 공격자가 접근하면 폰과 통신을 시도할 수 있어요. 집이나 사무실처럼 믿을 수 있는 네트워크에서만 쓰고, 공용 와이파이에서는 절대 쓰지 마세요.

안드로이드는 컴퓨터가 처음 연결될 때 여전히 RSA 키 승인을 요구해요. 이것도 보호 장치지만 이것만 믿어서는 안 돼요. 작업이 끝나면:

adb usb

이 명령으로 기기를 USB 모드로 되돌릴 수 있어요. 폰을 재부팅해도 기존 TCP 모드는 초기화되고, 개발자 옵션에서 무선 디버깅을 끌 수도 있어요.

ADBKit에서 와이파이 ADB 쓰기

웹 브라우저는 원시 TCP 연결을 열 수 없어서 혼자서는 5555 포트에 닿을 수 없어요. ADBKit은 내 컴퓨터에서 실행되며 트래픽을 중계하는 작은 프로그램인 ADBKit 에이전트로 이 문제를 해결해요. 전체 설정, 옵션, 문제 해결은 ADBKit 에이전트 안내에 있어요.

1. 한 줄 설치 명령으로 에이전트를 실행하세요. 맥과 리눅스는 curl -fsSL https://adbkit.com/install.sh | sh, 윈도우 PowerShell은 irm https://adbkit.com/install.ps1 | iex예요. Node.js가 이미 있다면 adbkit-bridge.mjs를 받아서 node adbkit-bridge.mjs로 실행해도 돼요.

1. ADBKit 작업 공간에서 폰을 USB로 연결하고 Wi-Fi 창을 엽니다.
2. Turn on Wi-Fi debugging을 누르세요. ADBKit이 adb tcpip 5555를 대신 실행하고 폰 주소를 보여 줘요.
3. IP 주소(포트 5555)를 입력해서 연결하거나 Scan network로 기기를 찾으세요.

에이전트는 127.0.0.1에서만 대기하고, ADBKit 페이지에만 응답하며, 사설 네트워크 주소로만 연결해요. 그래서 누구나 쓸 수 있는 열린 프록시가 아니에요.

참고: ADBKit은 두 방식을 모두 지원해요. 기존 adb tcpip 5555 방식은 두 에이전트 버전 모두에서 동작해요. 안드로이드 11 이상의 무선 디버깅 페어링 코드 방식(adb pair)은 설치 명령이 설치하는 Go 에이전트에서 지원돼요. Node 버전은 페어링할 수 없어요. 자세한 단계는 브라우저에서 무선 디버깅으로 안드로이드 연결하기를, 방식 선택은 adb tcpip vs 무선 디버깅을 보세요.

문제 해결

• failed to connect 또는 타임아웃. 두 기기가 같은 네트워크에 있는지, IP 주소가 최신인지 확인하세요. 공유기가 IP를 바꿀 수 있어요. 일부 네트워크는 기기끼리 서로 격리해요.
• 연결 후 unauthorized. 폰 잠금을 풀고 디버깅 허용 창을 수락하세요. 그래도 안 되면 개발자 옵션에서 USB 디버깅 권한 승인 취소를 누르고 다시 시도하세요.
• 연결이 끊김. 와이파이 절전 설정이나 약한 신호 때문에 끊길 수 있어요. adb connect로 다시 연결하세요.
• 기기가 사용 중(busy). 한 번에 한 프로그램만 연결을 쓸 수 있어요. ADB device busy, unauthorized 오류 해결을 보세요.

USB는 바로 되는데 TCP에는 왜 브라우저가 도우미 프로그램을 써야 하는지 궁금하다면 WebADB란 무엇인가를 읽어 보세요.