termux ~ tailssh --install

tailssh 🦋_

테일넷에서 지금 온라인인 기기를 번호로 골라 SSH 접속하는 우리 CLI 툴. 이 가이드는 안드로이드 Termux에 까는 법이야 — 폰에서 PC·노트북·스팀덱으로 바로 접속하기.

먼저 준비할 것

이 둘은 폰에 미리 깔려 있어야 해. 설치가 아니라 앱이라서 복사 대신 링크야.

appTailscale 앱 — 테일넷 연결

폰이 테일넷에 들어가 있어야 기기 이름(MagicDNS)으로 접속돼. Play 스토어에서 Tailscale 설치 → 같은 계정으로 로그인 → VPN 켜기. 한 번 켜두면 백그라운드로 유지돼.

appTermux — 터미널

⚠️ Play 스토어 버전은 낡아서 pkg가 깨져. F-Droid 또는 GitHub 릴리스에서 받아야 해. 설치 후 한 번 열어서 초기화까지 끝내줘.

설치

Termux를 열고 아래 세 줄을 순서대로. 각 줄 오른쪽 ⧉ 를 탭하면 복사돼.

step 1필요한 패키지 설치

git · gh(GitHub CLI) · openssh 세 개. 처음 한 번만.

$ pkg install git gh openssh -y

step 2GitHub 로그인

tailssh는 비공개 저장소라 인증이 필요해. 실행하면 묻는데 — GitHub.com → HTTPS → 브라우저 인증 순으로 고르면 코드 하나 주고, 그걸 폰 브라우저에 넣으면 끝.

$ gh auth login

step 3tailssh 받아서 설치

저장소를 ~/.tailssh에 받고 설치 스크립트까지 한 줄로. Termux는 자동으로 $PREFIX/bin에 링크돼서 PATH 설정도 필요 없어.

$ gh repo clone architectofthoughts/tailssh ~/.tailssh && ~/.tailssh/install.sh

✓

설치 확인. 아래를 치면 테일넷의 온라인 기기 목록이 떠. 뭔가 나오면 성공이야.

$ tailssh -l

쓰는 법

설치가 끝나면 어디서든 tailssh. 명령어를 탭하면 복사돼.

tailssh 번호 메뉴 → 선택 → 접속 (기본)

tailssh laptop-livingroom 이름으로 바로 접속

tailssh -l 목록만 보기 (접속 안 함)

tailssh -u self-update — git pull로 기기 목록까지 동기화

tailssh -h 도움말

ⓘ

Termux는 프로브 모드로 돌아. 폰엔 tailscale CLI가 없어서, hosts.conf에 적힌 기기마다 1초 TCP 프로브를 날려 온라인/오프라인을 판별해. 그래서 목록에 뜨려면 그 기기가 hosts.conf에 등록돼 있어야 하고, 새 기기를 추가했다면 tailssh -u로 받아오면 돼.

이 폰으로 접속받고 싶다면 (선택)

평소엔 폰에서 다른 기기로 나가는 용도지만, 반대로 PC에서 이 폰에 들어오고 싶을 때.

sshdTermux에서 SSH 서버 켜기

openssh는 step 1에서 이미 깔렸어. 서버만 띄우면 돼 — Termux sshd는 포트 8022를 써.

$ sshd

접속 계정 이름은 아래로 확인 (보통 u0_a<숫자> 형태):

$ whoami

⚠

키 등록 + hosts.conf 추가가 필요해. Termux sshd는 비밀번호가 아니라 공개키 인증이라, 접속하는 쪽 공개키를 폰의 ~/.ssh/authorized_keys에 넣어줘야 해. 그리고 다른 기기 목록에 띄우려면 hosts.conf에 mobile-기기이름 <whoami값> 8022 형식으로 한 줄 추가하고 커밋·push. PC쪽 정리는 나한테 시키면 돼 🐰

접속이 안 될 때

위에서부터 하나씩 짚어봐.

Tailscale 앱이 켜져 있나? 폰 알림줄에 VPN 키 아이콘이 떠 있어야 해. 꺼져 있으면 MagicDNS가 안 풀려서 이름 접속이 실패해.
대상 기기가 진짜 온라인인가? tailssh -l에서 offline이면 그 기기 자체가 꺼졌거나 테일넷에서 빠진 거야.
gh 로그인이 풀렸나? gh auth status로 확인. 풀렸으면 tailssh -u(git pull)가 실패해.
기기 목록이 비었나? tailssh -u로 최신 hosts.conf를 받아봐. 그래도 비면 등록 자체가 안 된 기기야.
그래도 막히면 접속 명령을 그대로 캡처해서 나한테 보내줘 — 같이 보면 금방 찾아.