Remote ADB using SSH Tunneling

Remote Server에 연결된 Android Device를 Local 개발 환경에서 디버깅하거나 제어해야 할 때가 있습니다.
이때 SSH Tunneling을 이용하면 마치 내 PC에 Device가 연결된 것처럼 adb를 사용할 수 있습니다.

How it works

ADB(Android Debug Bridge)는 클라이언트와 서버 구조로 동작하며, 기본적으로 localhost:5037 포트를 통해 통신합니다.
SSH의 Local Port Forwarding 기능을 사용하여 내 Local의 5037 포트로 들어오는 요청을 Remote PC의 5037 포트로 전달하면, 내 PC의 ADB 클라이언트가 Remote PC ADB 서버와 통신하게 됩니다.

SSH Tunneling

만약 Local에서 이미 ADB Server가 실행 중이라면, 5037 포트를 이미 사용 중이기 때문에 SSH가 포트를 점유할 수 없어 에러가 발생합니다.

text

그래서 kill-server 후 Tunneling을 해야 합니다.

Kill local ADB server and SSH Tunneling (in local)
shell

ssh 터미널을 유지한 상태에서 새로운 터미널에서 adb를 실행하면 remote 에 있는 adb의 device에 접근이 가능해집니다.

New terminal session (in local)
shell