가이드

어디서나 내 머신에 연결하기

에이전트가 돌아가는 머신은 대개 NAT 뒤에 있습니다. 집 공유기, 사무실 네트워크, 책상 위 노트북처럼요. SSH를 공인 인터넷에 열지 않고도 휴대폰에서 접속하는 방법을 정리했습니다.

이 문제를 푸는 방법은 두 가지입니다. 하나는 공유기에서 포트를 포워딩하는 것이고, 다른 하나는 두 기기를 프라이빗 메시 네트워크에 올려 공인 인터넷에는 아무 포트도 열지 않은 채 휴대폰에서 안정적인 주소로 접속하는 것입니다. 이 가이드는 두 번째 방법을 다룹니다. 첫 번째 방법은 서버를 털리는 가장 흔한 지름길이기 때문입니다.

1 서버를 메시에 올리기

Tailscale, NetBird, headscale, 직접 구성한 WireGuard 모두 바닥은 WireGuard 메시입니다. 서버에서 명령 하나만 실행하면 내 기기들만 라우팅할 수 있는 고정 주소가 생깁니다.

Tailscale은 100.64.0.0/10 대역 주소와 m1-pro.your-tailnet.ts.net 같은 이름을 부여합니다.

2 휴대폰도 같은 메시에 연결

해당 서비스의 iOS 앱을 설치하고 로그인하면 VPN 프로필이 등록됩니다. 이 단계에는 Moshpit이 전혀 관여하지 않습니다.

iOS는 한 번에 VPN 터널을 하나만 유지하므로 회사 VPN과 메시 VPN은 대개 동시에 켤 수 없습니다.

3 Moshpit에 연결 추가

호스트 = 메시 이름 또는 주소. 포트 = 바꾸지 않았다면 22. 사용자 이름, 그리고 인증에서 SSH 키를 선택합니다.

Moshpit은 입력한 주소에 그대로 연결합니다. 그것이 연동의 전부입니다.

Moshpit에는 어떤 종류의 VPN도, Tailscale 연동도 들어 있지 않습니다. 별도로 다이얼하거나 라우팅하거나 기기를 탐색하지 않습니다. 양식에 적은 호스트 문자열로 TCP 연결을 열고, Mosh일 때는 같은 주소로 UDP를 보냅니다. 휴대폰이 그 주소에 닿을 수 있다면 Moshpit도 그대로 닿습니다.

저장된 연결 모델에 useTailscale 필드가 있긴 하지만 앱의 어디에서도 읽지 않으며 입력 양식에도 없습니다. 남아 있는 흔적일 뿐이니 설정 토글을 찾아 헤매지 마세요.

먼저, 하지 말아야 할 일

암호 인증을 켠 채 22번 포트를 포워딩하지 마세요.

외부에 새로 열린 SSH 포트는 몇 분 안에 스캐너에 포착됩니다. 암호 인증을 열어 두면 하루 종일 암호만 대입하는 봇들에게 무제한 추측 게임을 내주는 셈입니다. 메시 네트워크는 표적을 방어하는 대신 아예 표적 자체를 없앱니다.

정말로 다른 대안이 없다면

네트워크 환경상 메시를 쓸 수 없어 부득이하게 SSH를 외부에 열어야 한다면, 키 전용 인증이 최소한의 하한선입니다. 이것은 권장이 아니라 최소 조건입니다.

# /etc/ssh/sshd_config.d/moshpit.conf
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
AuthenticationMethods publickey
# 구문 확인 후 리로드: sudo sshd -t && sudo systemctl reload ssh

이를 전제로 구성하기 전에 알아 두어야 할 Moshpit의 세 가지 제약:

  • 인증 방식은 두 가지뿐입니다. 암호와 공개 키만 지원합니다. keyboard-interactive는 지원하지 않으므로 TOTP 프롬프트를 띄우도록 설정된 sshd에는 Moshpit으로 로그인할 수 없습니다.
  • ProxyJump, 배스천, 에이전트 포워딩 미지원(초기 버전 기준). “점프 박스로 먼저 SSH”하는 구성을 피할 수 있게 해 주는 것이 메시 네트워크의 장점 중 하나입니다. 참고로 1.1.0부터 단일 홉 점프 호스트는 지원하며, forwardAgent 에이전트 포워딩은 여전히 지원하지 않습니다.
  • 암호문구(passphrase)가 걸린 개인 키는 직접 사용할 수 없습니다. 복호화 키 없이 로드되므로 암호화된 PEM은 인증에 실패합니다. 대신 Moshpit 안에서 키를 생성 (설정 → SSH 키 → +)하고 공개 키를 서버에 등록하세요. Secure Enclave 보관과 Face ID 잠금을 사용할 수 있습니다.

UDP가 중요한 이유

UDP는 서로 다른 이유로 두 번 등장합니다.

아래쪽에서는 WireGuard가 UDP 프로토콜이라서, 위쪽에서는 Mosh가 UDP라서입니다. 실패 양상이 서로 다르므로 머릿속에서 구분해 두는 편이 좋습니다.

아래쪽의 메시

wireguard · udp

  • Tailscale은 두 머신 사이에 직접 UDP 경로를 만들려 시도합니다. 기본 수신 포트는 41641이며 양쪽에서 아웃바운드로 나갑니다
  • 직접 뚫지 못하면 트래픽을 릴레이합니다. 동작은 하지만 지연 시간이 늘어납니다
  • 양쪽에서 tailscale status를 실행하면 direct인지 릴레이인지 확인할 수 있습니다
  • 여기에는 공유기 인바운드 포트가 하나도 필요 없습니다

위쪽의 Mosh

터널 내부

  • Mosh는 종단간 UDP이며, 메시 위에서는 터널 안쪽의 UDP로 흐르므로 공유기는 이를 전혀 보지 못합니다
  • mosh-server는 설정된 범위(기본값 60000–61000)에서 세션당 포트 하나를 바인딩합니다
  • Moshpit은 양식에 입력한 바로 그 호스트 문자열의 보고된 포트로 데이터그램을 보냅니다
  • Mosh는 먼저 SSH 로그인이 성공해야 부트스트랩할 수 있습니다. UDP보다 TCP가 먼저 통해야 합니다
정확한 부트스트랩 과정

SSH가 시작만 해 주고 빠집니다

Moshpit은 인증된 SSH 세션에서 명령 하나를 실행해 출력된 한 줄을 읽은 뒤 SSH를 닫습니다. 그 이후의 통신은 전부 UDP입니다.

그래서 연결 후 SSH를 막아도 Mosh 세션은 죽지 않지만, UDP를 막으면 죽습니다. TCP는 잘 나르는데 UDP 릴레이 품질이 나쁜 메시에서는 Mosh가 일반 SSH보다 오히려 답답하게 느껴지는 이유도 같습니다.

PATH="$PATH:/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/local/sbin:$HOME/.local/bin" \
  mosh-server new -s -c 256 -p 60000:61000 -l LANG=en_US.UTF-8

MOSH CONNECT 60001 <22자 base64 = 16바이트 AES-128 키>

어디에 무엇이 열려 있어야 하는지

대상포트방향이유
SSHTCP 22 (또는 지정 포트) 서버 인바운드 Mosh는 단독 모드가 없음 — SSH가 mosh-server를 띄우고 키를 받아 옴
Mosh 세션UDP 60000–61000 서버 인바운드, 휴대폰 아웃바운드 mosh-server가 이 범위에서 세션당 포트 하나를 선택
메시 직접 경로UDP 41641 양쪽 아웃바운드 Tailscale 기본값. 막혀도 릴레이로 동작하며 끊기진 않음
공유기없음 — 포트포워딩 불필요. 이 방식을 쓰는 핵심 이유

메시 환경에서 “서버 인바운드”는 메시 인터페이스 기준을 뜻합니다. 호스트 방화벽은 거기에도 적용됩니다. ufw, firewalld, 클라우드 보안 그룹 모두 터널과 mosh-server 사이에 서 있습니다. tailscale0에서 포트 범위를 여는 것은 전 세계에 여는 것과 다르며, 사람들이 가장 자주 빠뜨리는 단계이기도 합니다.

범위는 설정 → MOSH · 로밍 → UDP 포트 범위에서 바꿀 수 있습니다 (시작 / 끝, 1–65535 및 시작 ≤ 끝 검증). 연결 양식에는 같은 범위가 읽기 전용으로 표시됩니다. 시작 포트가 범위를 벗어나면 -p 옵션 자체가 빠져 mosh-server 기본값을 쓰게 되고, 끝 포트가 유효하지 않으면 단일 시작 포트에 고정됩니다.

자주 빠지는 함정

주소를 하나로 정해 어디서나 그 주소만 쓰세요.

가장 버그처럼 보이지만 버그가 아닌 증상입니다. 저녁 한 나절을 통째로 날리기 쉬워 따로 절을 뺐습니다.

Moshpit은 mosh-server new -s로 실행합니다. 이 플래그는 mosh 1.4 이후 업스트림 기본값인 --bind-server=ssh와 같습니다. 즉, 서버는 SSH 연결이 들어온 바로 그 주소에만 바인딩합니다. 로그인한 경로와 같은 경로로 데이터그램이 오가게 하려는 의도적인 설계입니다.

그 결과는 다음과 같습니다.

  • 집에서 192.168.1.30으로 시작한 세션의 mosh-server는 192.168.1.30에 바인딩됩니다. 밖에서 메시를 타고 들어오면 그 서버에 닿을 수 없습니다.
  • 메시로 시작한 세션은 메시 주소에 바인딩되므로 LAN 주소로는 닿을 수 없습니다.
  • 둘 다 Moshpit의 잘못이 아닙니다. --bind-server=ssh의 정확한 동작입니다.

따라서 연결은 메시 이름으로 저장하고 집에서도 그 주소를 그대로 쓰세요. 같은 LAN 안에서는 메시 트래픽도 어차피 로컬 직접 경로를 탑니다. 주소 하나, 저장된 연결 하나면 건물 밖으로 걸어 나가도 놀랄 일이 없습니다.

남겨진 mosh-server 프로세스가 쌓이는 문제

연결할 때마다 새 mosh-server가 뜹니다. 회선이 끊어져도 이전 프로세스는 종료되지 않고 UDP 포트를 쥔 채 남아 있습니다. 몇 주간 재연결을 거듭하면 프로세스가 쌓이게 됩니다. Moshpit이 이를 자동으로 정리하지 않는 것은 설계 의도가 아니라 실제 부족한 부분입니다.

pgrep -fl mosh-server                 # 아직 실행 중인 프로세스 확인
lsof -nP -iUDP | grep mosh-server     # 각 프로세스가 바인딩한 주소 확인
pkill -f mosh-server                  # 단순 정리(활성 세션도 함께 종료됨)

두 번째 명령이 보여 주는 바인딩 주소는 진단 도구로도 유용합니다. 각 세션이 어느 네트워크에서 만들어졌는지 알 수 있어, 특정 세션이 왜 응답을 멈췄는지 단번에 설명해 줍니다.

iOS

로컬 네트워크 권한과 거부 시 나타나는 증상

iOS는 로컬 네트워크 주소 접근을 단 한 번 뜨는 권한 팝업으로 제어합니다. 몇 달 전 다른 화면에서 무심코 거부했다면 바로 이런 증상을 겪게 됩니다.

팝업

단 한 번 표시됩니다

LAN 주소에 처음 연결할 때 나타납니다. Moshpit의 안내 문구는 “Moshpit은 SSH와 mosh(UDP)로 로컬 네트워크의 서버에 연결합니다. 이 권한이 없으면 192.168.x.x 같은 내부 호스트에 연결할 수 없습니다.”입니다.

거부됨

SSH는 붙는데 Mosh는 검은 화면

iOS가 LAN 주소로 향하는 UDP를 아무 알림 없이 버립니다. TCP는 영향을 받지 않으므로 SSH는 멀쩡히 되는데 Mosh만 커서가 살아 있는 검은 화면에서 멈춥니다.

해결

설정 → Moshpit → 로컬 네트워크

팝업은 저절로 다시 뜨지 않습니다. iOS 설정에서 직접 켠 뒤 세션을 다시 연결하세요.

적용 범위를 분명히 하자면, 이 권한은 192.168.x.x나 10.x.x.x 같은 LAN 주소를 제어합니다. 메시 주소로 가는 트래픽은 VPN 터널 인터페이스로 나갑니다. 그래도 LAN 주소로 접속할 가능성이 조금이라도 있다면 미리 허용해 두세요. 권한 거부로 생기는 증상은 방화벽 문제와 겉보기가 완전히 똑같아 엉뚱한 곳을 파느라 저녁을 허비하기 쉽습니다.

검증

이 순서대로 여섯 가지를 확인하세요

각 단계가 그 아래 계층의 문제를 걸러냅니다. 건너뛰지 마세요. 원인은 거의 항상 1단계나 2단계에서 나옵니다.

1 · 피어가 온라인이고 직접 연결(direct) 상태인가요?

tailscale status          # 피어 줄 끝에 "direct" 또는 릴레이 이름이 표시됨
tailscale ip -4           # 호스트 입력란에 넣을 주소

릴레이로 연결되어도 동작은 합니다. 다만 느려지며, 회선 상태가 나쁜 날에는 쓸 만한 터미널과 못 쓸 터미널을 가르는 차이가 됩니다.

2 · 같은 메시 위의 노트북에서 일반 SSH가 되나요?

ssh -v user@m1-pro.your-tailnet.ts.net

여기서 실패하면 멈추세요. 그 위 계층은 아무것도 동작할 수 없습니다. Mosh에는 단독 모드가 없고, Moshpit은 무엇보다 SSH 클라이언트이기 때문입니다.

3 · UDP가 실제로 왕복하나요?

아무도 안 해 보지만 정작 문제를 딱 잡아내는 검사입니다. 포트 범위 안의 포트 하나를 골라 서버에서 수신 대기하고, 휴대폰과 같은 네트워크의 머신에서 보내 보세요.

# 서버에서
echo REPLY | nc -u -l 60005 > /tmp/udp-in

# 휴대폰과 같은 Wi-Fi의 노트북에서
echo PING | nc -u -w3 m1-pro.your-tailnet.ts.net 60005

양쪽 모두 상대방의 단어를 받아야 합니다. 서버는 PING을 받았는데 클라이언트가 REPLY를 못 받는다면 돌아오는 경로가 막힌 것이며, 그것이 바로 Mosh 검은 화면의 정체입니다. 앱 문제가 아니라 네트워크 문제입니다.

4 · 트래픽이 들어오는 인터페이스에 포트 범위가 열려 있나요?

sudo ufw status verbose                       # Debian / Ubuntu
sudo firewall-cmd --list-all                  # Fedora / RHEL
sudo ufw allow in on tailscale0 to any port 60000:61000 proto udp

클라우드 보안 그룹이 있다면 그것도 따로 확인하세요. 그리고 Moshpit에 설정된 범위와 같은 범위인지 확인하세요. 기본값은 60000–61000이지만 변경할 수 있습니다.

5 · 앱이 실제로 무엇을 받고 있는지 확인하세요

Mosh 세션에서 터미널 상단 막대의 전송 방식 배지를 길게 누르면 MOSH 진단(MOSH DIAGNOSTICS)이 열립니다: datagrams, applied, parse fails, gaps. 가장 중요한 줄은 숫자가 아닌 이 문구입니다.

MOSH 진단
   받은 데이터그램이 없습니다.

문자 그대로 아무것도 돌아오지 않았다는 뜻입니다. 이 카운터는 복호화나 파싱 전에 증가하므로 돌아오는 경로가 끊겼다는 증거입니다. Moshpit 디버깅을 멈추고 3단계로 돌아가세요.

6 · 비상 탈출구 사용하기

네트워크가 UDP를 삼켜 버렸고 지금 당장 터미널이 필요하다면 배너의 SSH로 전환을 탭하거나 상단 막대의 MOSH 배지를 탭해 “SSH(으)로 전환할까요?”를 확인하세요. SSH는 UDP 데이터그램이 버려진 바로 그 경로를 TCP로 통과합니다. 배너는 닫을 수 있고 터미널 입력을 막지 않습니다. 사실 그동안 키 입력은 서버로 계속 전달되고 있었고, 화면 갱신만 돌아오지 못한 상태였습니다.

⚠  Mosh가 데이터를 받지 못합니다. 네트워크가 UDP를
   막고 있을 수 있습니다(VPN, 프록시, 방화벽).

   SSH로 전환                                       ×

약속이 아닌 실측 데이터 하나

집계 통계는 아직 없지만, 개발 중에 직접 테스트하는 호스트가 하나 있습니다. 형용사보다 실측 숫자가 훨씬 쓸모 있습니다.

중국 모바일 회선을 경유해 Tailscale 직접 경로로 연결한 Mac: RTT 433–640ms, 패킷 손실 약 13%. 이 회선에서 SSH 핸드셰이크는 5.8–9초가 걸립니다. Mosh는 동작합니다. 순수 Mosh 세션의 첫 화면은 약 10초 만에 뜨고, Mosh + tmux는 SSH 핸드셰이크가 두 번 필요해 네이티브 상단 경로 표시가 채워지기까지 20–25초가 걸립니다.

우리가 보유한 하드웨어에서 한 번 측정한 단일 회선 결과입니다. 벤치마크가 아니며 실제 환경은 다를 수 있습니다. “패킷 손실을 견딘다” 같은 주장에는 숫자가 따라붙어야 하기에 여기에 적어 둡니다.

이 회선에서 얻은 교훈이자 미리 예상해 두어야 할 두 가지: 잠자기에 들어간 노트북은 메시에서 완전히 떨어져 나가며(direct → relayed → offline), 무거운 플러그인 설정을 얹은 tmux 서버는 첫 실행 시 데드락에 걸릴 수 있습니다. 둘 다 네트워크 장애가 아니지만 겉보기에는 네트워크 장애와 똑같습니다.

의존하기 전에 알아 둘 한계

호스트에 연결된 뒤에도 여전히 되지 않는 것들.

백그라운드에서 앱이 일시 중단됩니다 iOS는 Moshpit과 12초 keepalive 타이머, 폴링을 모두 일시 중단합니다. 앱으로 돌아오기 전까지 실시간 에이전트 상태 갱신은 멈추고 복귀 시 따라잡습니다. 다만 에이전트 알림은 호스트가 직접 종단간 암호화해 푸시하므로 계속 도착합니다. 20초 이상 자리를 비웠다 돌아오면 반열림(half-open) 소켓에서 오탐을 낼 수 있는 생존 확인을 믿지 않고 새로 재연결합니다.

Mosh 위에서는 tmux와 herdr가 자체 TUI로 동작합니다 Mosh는 원시 줄 단위 바이트 파이프가 아니라 렌더링된 화면 차분을 전송하므로 tmux -CC와 herdr 프레임 프로토콜을 실어 나를 수 없습니다. 둘 다 Mosh 셸 안에서 자체 전체 화면 인터페이스로 전환됩니다. 네이티브 목록 시트는 옆에 함께 여는 가벼운 보조 SSH 연결로 채워지므로, UDP는 통하는데 SSH가 막혀 있다면 네이티브 목록 없이 tmux만 쓰게 됩니다.

herdr의 직접 연결은 패널당 단독 점유입니다 Moshpit은 --takeover로 연결합니다. 같은 herdr 패널을 두 Moshpit 클라이언트가 동시에 열면 약 2초마다 서로 소유권을 빼앗습니다. herdr 단독 연결의 구조적 특성이라 클라이언트에서 덮을 수 없습니다. 데스크톱 herdr TUI는 attach 소유자를 잡지 않으므로 안전할 것으로 보이나, 직접 검증하지는 않았습니다.

herdr 0.7.3은 패널 명령을 보고하지 않습니다 현재 Homebrew 안정 버전은 스냅샷에 패널 실행 명령을 담지 않아 상단 경로 표시가 패널 N으로 표시됩니다. 보기상의 차이일 뿐이지만 패널 선택 시트로 들어가는 유일한 입구이므로 알아 두면 좋습니다.

신뢰한 호스트 키는 목록 조회나 삭제가 불가능합니다 최초 연결 시 지문과 대조용 ssh-keygen 명령을 보여 줍니다. 그 이후 신뢰한 호스트를 보거나 “이 호스트 잊기”를 하는 화면은 없으며, 연결을 삭제해도 지문은 남습니다. 정상적인 키 교체는 경고 대화 상자에서 변경을 수락해 처리하며, 기본 버튼은 연결 해제, 수락 버튼은 의도적으로 위험 동작 스타일로 표시됩니다.

질문

원격 머신 연결에 관해 자주 묻는 질문.

꼭 Tailscale을 써야 하나요?

아니요. Moshpit은 입력된 주소에 연결할 뿐이며, 그 주소에 도달하게 만드는 방법은 전적으로 사용자의 선택입니다. NetBird, headscale, 순수 WireGuard, ZeroTier, 회사 VPN, 공인 IP 서버 모두 앱 입장에서는 완전히 똑같이 동작합니다. 아무것도 없는 상태에서 가장 빠르게 되는 경로라서 Tailscale을 예로 들었을 뿐입니다.

Moshpit이 점프 호스트를 거쳐 연결할 수 있나요?

1.1.0부터 단일 홉 점프 호스트를 지원합니다. 점프 호스트를 일반 연결로 저장한 뒤 대상 연결의 경유 연결에서 선택하면 ssh -J처럼 SSH로 연결됩니다(에이전트 포워딩이나 다중 홉 체인은 미지원). 자세한 방법은 점프 호스트 문서를 참고하세요. 메시 네트워크는 점프 호스트 없이도 Mosh UDP까지 직접 연결할 수 있어 여전히 가장 간단한 선택지입니다.

5G에서는 되는데 사무실 Wi-Fi에서는 왜 안 되나요?

거의 항상 아웃바운드 UDP는 통과시키면서 돌아오는 인바운드 응답을 버리는 네트워크 때문입니다. 분할 터널 VPN 프로필, 프록시, 사내 방화벽이 대표적입니다. SSH는 같은 경로를 TCP로 타기 때문에 계속 잘 됩니다. 해당 네트워크에서 위의 nc -u 검사를 돌려 보세요. 거기서 응답이 안 오고 셀룰러에서는 온다면 원인이 확정됩니다.

회사 VPN과 메시 네트워크를 동시에 켤 수 있나요?

iOS는 한 번에 VPN 터널 하나만 실행하므로 일반적으로 불가능합니다. 회사 VPN을 켜야만 한다면 메시는 내려가며 회사 네트워크가 허용하는 경로만 쓰게 됩니다. 앱이 우회할 수 없는 iOS 제약입니다.

Moshpit이 내 메시 네트워크나 다른 머신들을 볼 수 있나요?

아니요. 네트워크 탐색 기능도 계정도 없습니다. 사용자가 직접 입력한 연결만 알고, 터미널 트래픽은 오직 그 서버들로만 향합니다. Moshpit이 운영하는 유일한 구성 요소는 알림 푸시 릴레이로, 읽을 수 없는 암호화된 에이전트 알림만 전달하며 메시나 세션에는 절대 관여하지 않습니다. 로컬 네트워크 권한 역시 무언가를 스캔하기 위해서가 아니라 iOS가 LAN 대상 UDP를 버리지 않게 하기 위한 용도뿐입니다.

집에 돌아오자마자 Mosh 세션이 끊겼습니다. 왜 그런가요?

대부분 주소 때문입니다. mosh-server는 SSH 로그인이 들어온 주소에만 바인딩하므로 메시로 만든 세션은 LAN 주소로 닿지 않고, 반대도 마찬가지입니다. 연결을 메시 이름으로 저장하고 집에서도 그 주소를 그대로 쓰세요. 위의 주소를 하나로 정하기 절을 참고하세요.

이어서 보기: iPhone에서 Claude Code 실행하기 · 가이드 목록으로