콘텐츠로 이동
moshpit
KO

문서 · 주제

Mosh

Mosh는 Wi-Fi와 셀룰러 전환, IP 주소 변경, 휴대폰 잠자기, 패킷 손실이 심한 회선에서도 터미널 세션을 살려 둡니다. 연결 양식에서 호스트별로 Mosh 사용을 켜거나, 설정 › 터미널 › 기본으로 Mosh 사용에서 새 연결의 기본값으로 지정할 수 있습니다.

Moshpit은 먼저 SSH로 연결해 호스트에서 mosh-server를 실행한 뒤 세션을 UDP로 전환합니다. 서버의 시스템 패키지 관리자로 mosh 패키지를 설치하세요.

Terminal window
# Debian / Ubuntu
sudo apt install mosh
# Fedora / RHEL
sudo dnf install mosh
# macOS (Homebrew)
brew install mosh

mosh-server가 기본 PATH 밖에 있다면(예: /opt/homebrew/bin/mosh-server) 연결의 고급 › mosh-server 경로에 경로를 지정하세요. 연결 시 mosh-server가 설치되어 있지 않으면 Moshpit이 이를 알리고 대신 SSH로 세션을 엽니다.

Mosh 세션은 서버에서 UDP 포트 하나를 바인딩하며 기본 범위는 60000–61000입니다. 서버 방화벽과 클라우드 보안 그룹에서 해당 범위의 인바운드 UDP를 허용하고, 로컬 네트워크에서 아웃바운드 UDP가 열려 있는지 확인하세요.

모든 연결의 포트 범위를 좁히거나 옮기려면:

  1. 설정 › 터미널 › UDP 포트 범위를 엽니다.
  2. 시작과 끝(1–65535 사이)을 입력합니다.
  3. 저장을 탭합니다.

느린 회선에서 서버가 키 입력을 확인해 줄 때까지 기다리는 동안, Mosh는 입력한 문자를 먼저 표시하고 서버가 확인할 때까지 밑줄이나 잔상으로 표시할 수 있습니다.

기본값은 설정 › 터미널 › 예측 에코에서 설정하고, 특정 호스트만 다르게 두려면 연결 편집의 예측 모드에서 변경하세요.

모드 동작
자동(Adaptive) 왕복 지연 시간(RTT)이 커질 때만 키 입력을 예측합니다.
항상(Always) 지연 시간과 무관하게 모든 Mosh 세션에서 키 입력을 예측합니다.
안 함(Never) 모든 문자가 서버에서 에코될 때까지 기다립니다.

설정 › 터미널의 커서 아래에서 예측 잔상을 켜거나 끌 수도 있습니다.

휴대폰 네트워크가 바뀌거나 잠자기에서 깨어났을 때:

  • Moshpit으로 돌아왔을 때 mosh-server가 여전히 실행 중이고 연결 가능하면 재연결 없이 세션이 바로 이어집니다.
  • 네트워크 전환이 안정화되는 중이고 아직 UDP 응답이 오지 않았을 때는 안내를 표시하면서 입력한 내용을 대기열에 쌓아 두었다가 서버가 응답하는 즉시 전송합니다.
  • 터미널 상단 막대의 MOSH 배지를 길게 누르면 왕복 시간과 패킷 카운터를 확인하거나 화면 다시 그리기를 탭할 수 있습니다.

다음 상황에서는 Mosh 사용을 끄거나 UDP가 통하지 않을 때 SSH로 전환을 탭하세요.

  • 점프 호스트: Mosh는 대상 머신으로의 직접 UDP가 필요합니다. 경유 연결을 사용하는 연결은 모두 SSH로 동작합니다. 자세한 내용은 점프 호스트를 참고하세요.
  • 차단된 UDP: 60000–61000 대역의 모든 UDP 패킷을 버리는 게스트 Wi-Fi나 엄격한 방화벽 환경.
  • 인라인 터미널 그래픽: Mosh는 원시 바이트 스트림 대신 문자 화면 상태를 동기화하므로 kitty, iTerm2, sixel 인라인 이미지는 SSH가 필요합니다. 자세한 내용은 터미널 읽기를 참고하세요.