문서

빠른 시작 + 부분별, 기기별 기능 설명 (계속 업데이트 중)

안드로이드 Termux(유휴 폰을 서버로)

유휴 안드로이드 폰을 24시간 온라인 상태의 원격 Linux 서버로 바꿔, 패널로 원격 모니터링(CPU / 메모리 / 배터리 / 온도)하고 터미널과 파일을 관리합니다.

기능 소개

  • 진입점: 패널 오른쪽 위 「📱 안드로이드 Termux」 버튼으로, 모든 폰 기기의 정보와 조작이 이곳에 모여 있습니다.
  • 자동 그룹: 모든 Termux 기기가 자동으로 「안드로이드 Termux」 그룹에 들어가 일반 서버 카드와 연동됩니다.
  • 폰 전용 모니터링: 일반적인 CPU / 메모리 / 디스크 외에 배터리 잔량과 기기 온도를 추가로 표시합니다.
  • SIM 카드 유무 구분: SIM 카드가 없으면 터널링(안정적), 있으면 IPv6 직접 연결(실험적)을 선택할 수 있습니다.

적용 시나리오

  • 오래된 폰 / 예비 폰이 놀고 있어 다시 활용하고 싶을 때.
  • 저전력으로 24시간 온라인 상태인 상시 소형 서버가 필요할 때(스크립트 실행, 상주, 테스트 머신).
  • 폰에는 배터리(천연 UPS)가 있어 정전에도 걱정이 없습니다.

사용 방법

전체 단계별 튜토리얼(각 기종의 전원 설정, 스크린샷식 설명 포함)은 패널의 「튜토리얼 설명」 탭을 클릭하세요. 총 5단계입니다. 여기서는 핵심 흐름과 미러 다운로드를 간단히 설명합니다.

Termux 설치 패키지 미러 다운로드(국내 사용자)

국내 사용자가 GitHub / F-Droid에 접근할 수 없을 때 공식 사이트에서 직접 다운로드할 수 있습니다(HTTPS, 더 빠르고 안정적):

파일프로젝트 미러공식 소스설명
Termux 본체https://ssheverywhere.com/download/termux/com.termux_1022.apkf-droid.org약 109MB, Android 7.0+
Termux:Boothttps://ssheverywhere.com/download/termux/com.termux.boot_1000.apkf-droid.org부팅 자동 시작 플러그인(선택)
Termux:APIhttps://ssheverywhere.com/download/termux/com.termux.api_1002.apkf-droid.org배터리/센서 데이터(선택)

1. 오른쪽 위 「📱 안드로이드 Termux」 버튼을 클릭합니다.

2. 「기기 추가」에서 폰 유형을 선택합니다:

  • SIM 카드 없음(WiFi / 유휴 폰) → 터널링 운영(권장, 가장 안정적).
  • SIM 카드 있음(모바일 데이터) → 터널링(권장) + IPv6 직접 연결(실험적).

3. 패널이 생성한 「터널링 설치 명령」을 복사해 폰 Termux에 붙여넣고 실행합니다.

4. 설치 스크립트가 자동으로: openssh + python 설치 → sshd 설정(포트 8022) → Agent 배포 → 부팅 자동 시작 등록.

5. 안내에 따라 SSH 비밀번호(passwd)를 설정하면, 완료 후 기기가 「안드로이드 Termux」 그룹에 자동으로 나타납니다.

주의 사항

  • Termux 설치: F-Droid 공식 사이트에서 다운로드하세요(Google Play의 구버전을 쓰지 마세요. 업데이트가 중단되었고 많은 기능을 쓸 수 없습니다).
  • SSH 포트는 8022: Android 일반 사용자는 1024 이하 포트를 수신할 수 없으므로, Termux의 SSH 기본 포트는 22가 아니라 8022입니다.
  • 백그라운드 상주(강제 종료 방지, 가장 중요): 스크립트가 termux-services로 Agent가 Termux와 함께 시작되게 하고 termux-wake-lock을 자동 실행해 절전을 막습니다. 다만 각 기종의 시스템 설정에서도 허용해줘야 하며, 그렇지 않으면 폰 화면이 잠긴 뒤 Android가 Termux를 종료해 연결이 끊깁니다:
  • 샤오미/Redmi: 앱 관리 → Termux → 절전 정책 「무제한」 + 자동 시작 관리 「허용」 + 최근 작업 카드 길게 눌러 잠금.
  • 화웨이/아너: 앱 시작 관리 → Termux → 수동 관리(자동 시작/연관 시작/백그라운드 활동 체크) + 배터리 설정에서 절전 해제.
  • OPPO/원플러스: 배터리 → 앱 전력 소모 관리 → Termux 「백그라운드 실행 허용」 + 자동 시작 관리 「허용」.
  • vivo/iQOO: 배터리 → 백그라운드 전력 소모 관리 → Termux 「백그라운드 고전력 소모 허용」 + 권한 관리 자동 시작 「허용」.
  • 삼성: 배터리 → 백그라운드 사용 제한 → Termux 「제한 없음」 + 앱 배터리 「제한 없음」.
  • 공통: 개발자 옵션 → 백그라운드 프로세스 제한 → 「표준 제한」(「백그라운드 프로세스 없음」으로 설정하지 마세요).
  • 저장 공간 권한: 폰 저장 공간(/sdcard)에 접근하려면 Termux에서 termux-setup-storage를 실행하세요.
  • 국내 미러 변경: 국내 폰은 먼저 termux-change-repo를 실행해 칭화/알리 미러로 바꾸는 것을 권장합니다. 그렇지 않으면 pkg 업데이트가 느립니다. 참고: 패널의 「미러 변경」 기능은 Termux에 적용되지 않습니다(Termux는 apt/dnf가 아니라 pkg 미러를 사용). 폰에서 직접 바꿔야 합니다.
  • 앱 설치: 폰 CPU는 ARM 아키텍처이므로 앱 설치는 pkg로 진행하며(apt-get이 아님), 앱 모음이 이미 자동으로 대응합니다.
  • 서드파티 앱 스캔: Termux는 아직 「서드파티 앱」 검색을 지원하지 않습니다. 이유: Termux에는 시스템 수준 /opt가 없고 systemd도 없으며(systemctl이 존재하지 않음), pkg로 설치한 실행 파일이 모두 $PREFIX/bin에 모여 있어 「서드파티 앱」을 안정적으로 구분하기 어렵고, 억지로 나열하면 수백 개의 pkg 시스템 명령이 표시되어 사용자를 오도합니다. 패널에서 Termux 기기의 「서드파티 앱」을 누르면 「아직 지원하지 않음」 안내가 표시되며, 일반 Linux는 정상적으로 스캔합니다(/usr/local/bin, /opt, systemd 서비스). 설치된 앱을 확인하려면 「시스템 패키지」 탭(dpkg -l)을 사용하세요.

SIM 카드가 있는 IPv6 직접 연결(실험적)

모바일 데이터(4G/5G)는 보통 IPv6 주소를 할당하지만 인바운드 연결은 통신사에 달려 있습니다:

통신사실측 상황
차이나텔레콤 4G일부 지역에서 인바운드 가능
차이나유니콤 4G대부분 ping은 되지만 TCP가 거부됨
차이나모바일 4G대부분 불통
5G SA기본적으로 불통

또한 IPv6 주소는 변동됩니다(오늘 되던 것이 내일 바뀜). 따라서 직접 연결은 안정성을 보장하지 않으며, 통신사가 인바운드를 허용하는 것을 확인하지 않는 한 터널링 사용을 권장합니다.

자주 묻는 질문

  • 기기가 끊겼습니다: 폰이 절전 상태인지(배터리 화이트리스트 등록), Termux가 시스템에 의해 종료되었는지, 네트워크가 전환되었는지(WiFi↔모바일 데이터) 확인하세요.
  • SSH에 연결되지 않습니다: 포트가 8022인지, SSH 비밀번호를 설정했는지(passwd) 확인하세요.
  • 폰에 Termux를 재설치했습니다: 설치 스크립트를 다시 실행하면 됩니다(기존 token을 자동으로 인식해 기기 기록을 유지).