SSH 개발자 매뉴얼

Mobile VPS · 파워유저 전용 기술 문서

이 문서는 개발자·파워유저가 ADB 포워딩을 통해 앱 안의 Ubuntu 환경에 SSH로 접속하는 방법을 설명합니다. 일반 사용자 대상 기능이 아니며, 스토어 안내에는 포함되지 않습니다.

접속 절차

  1. 1

    비밀번호 확인

    앱 대시보드 하단의 Developer SSH 카드에서 비밀번호를 확인합니다. 비밀번호는 앱 설치 시 무작위로 생성되며, 재설치하면 새로 발급됩니다.

  2. 2

    폰을 PC에 연결

    USB 케이블로 폰을 PC에 연결하고 개발자 옵션 > USB 디버깅을 켭니다. 무선 디버깅을 사용해도 됩니다.

  3. 3

    연결 확인

    터미널에서 `adb devices` 를 실행해 기기가 보이는지 확인합니다. 처음 연결하면 폰 화면의 USB 디버깅 허용 팝업을 수락해야 합니다.

  4. 4

    포트 포워딩

    `adb forward tcp:2222 tcp:2222` 를 실행해 PC의 2222 포트를 폰 안의 Linux 환경으로 연결합니다.

  5. 5

    SSH 접속

    `ssh root@127.0.0.1 -p 2222` 를 실행하고, 대시보드에서 확인한 비밀번호를 입력합니다. 일부 Windows 환경에서는 `localhost`가 IPv6로 해석되어 접속이 거부될 수 있으므로 `127.0.0.1`을 사용하세요.

명령 요약

adb forward tcp:2222 tcp:2222
ssh root@127.0.0.1 -p 2222

종료: 접속 셸에서 exit 입력 후 adb forward --remove tcp:2222

주의사항

로컬 전용 접속

SSH 서버는 폰 내부(127.0.0.1)에서만 수신합니다. ADB 포워딩을 경유하는 PC에서만 접속되며, 외부 네트워크에서 직접 접속할 수 없습니다.

비밀번호 관리

비밀번호는 설치 시 무작위 12자로 생성됩니다. 재설치하면 변경되므로 대시보드에서 항상 최신 값을 확인하세요.

포워딩 유지

폰 재부팅·USB 분리 후에는 포워딩이 해제됩니다. 다시 연결하려면 `adb forward` 부터 재실행하세요.

사용 후 정리

사용을 마치면 `adb forward --remove tcp:2222` 로 포워딩을 제거하는 것을 권장합니다.