콘텐츠로 이동
moshpit
KO

문서 · 주제

문제 해결

SSH나 점프 호스트 연결 자체에서 오류가 난다면 연결되지 않을 때를 먼저 확인하세요. 로그인 이후 발생하는 문제는 아래에서 증상별로 찾을 수 있습니다.

  1. iOS 권한과 Moshpit 스위치 확인: Moshpit의 설정 › 알림을 여세요. iOS 자체에서 Moshpit 알림이 꺼져 있다면 화면 맨 위 배너가 바로 알려 줍니다. 에이전트가 기다리면 알림이 켜져 있는지 확인하세요.
  2. 페어링 확인 및 테스트 전송: 해당 연결의 호스트 설정을 열어 서버에 openssl과 curl이 모두 설치되어 있고 아웃바운드 HTTPS가 푸시 릴레이에 닿는지 확인한 뒤, 그 화면을 포그라운드에 띄워 둔 채 테스트 알림 보내기를 탭하세요.
  3. 30초 유예 시간 확인: “대기 중” 푸시는 책상에서 바로 답한 프롬프트가 휴대폰을 울리지 않도록 30초를 기다린 뒤 전송됩니다. 또한 입력 줄에 유휴 상태로 멈춰 있는 에이전트는 “대기 중” 푸시를 보내지 않습니다.

Codex가 상태를 보고하지 않거나 푸시를 보내지 않을 때

Section titled “Codex가 상태를 보고하지 않거나 푸시를 보내지 않을 때”

Codex는 ~/.codex/config.toml에 새로 추가된 훅을 Codex 내부에서 직접 승인하기 전까지 무시합니다. 호스트에서 codex를 열고 /hooks를 실행해 Moshpit 항목 4개를 신뢰함으로 표시하세요. 자세한 내용은 호스트 설정을 참고하세요.

홈 화면에 에이전트 상태가 나타나지 않을 때

Section titled “홈 화면에 에이전트 상태가 나타나지 않을 때”
  • tmux 환경: 홈 화면은 ~/.moshpit/moshpit-stamp.sh가 패널에 기록한 @moshpit_* 옵션을 읽습니다. 호스트 설정으로 훅을 설치한 뒤 에이전트에 새 프롬프트를 한 번 보내 훅 이벤트가 실행되게 하세요. 또한 tmux 세션이 -L이나 -S로 지정한 사용자 소켓이 아니라 기본 tmux 소켓에서 실행 중인지 확인하세요.
  • herdr 환경: herdr는 상태를 네이티브로 보고합니다. PATH의 herdr와 herdr server 버전이 다르다는 배너가 보인다면 오래된 쪽을 업데이트해 프로토콜을 맞추세요.

“완료” 푸시에 에이전트가 답변한 내용이 빠질 때

Section titled ““완료” 푸시에 에이전트가 답변한 내용이 빠질 때”

호스트에 jq를 설치하세요(sudo apt install jq, sudo dnf install jq 또는 brew install jq). jq가 없어도 ~/.moshpit/moshpit-stamp.sh가 완료 푸시와 소요 시간은 보내지만 프롬프트 텍스트는 추출하지 못합니다.

데스크톱 터미널과 tmux를 함께 붙였을 때 화면 줄바꿈이 이상할 때

Section titled “데스크톱 터미널과 tmux를 함께 붙였을 때 화면 줄바꿈이 이상할 때”
  • 데스크톱과 휴대폰이 서로 창을 바꿀 때: 서버의 tmux를 3.8 이상으로 업그레이드하세요. tmux 3.8+에서는 Moshpit이 그룹 세션을 사용해 휴대폰에서 창을 바꿔도 노트북 터미널의 창이 움직이지 않습니다.
  • Moshpit 기기 두 대가 같은 창을 볼 때: 창에 이 창은 … 크기로 맞춰져 있습니다가 표시되면 이 기기 크기 사용을 탭해 지금 손에 든 기기에 맞게 크기를 조정하세요.
  • 일시적인 화면 깨짐: Mosh에서는 상단 막대의 MOSH 배지를 길게 누르고 화면 다시 그리기를 탭하세요.

Mosh가 SSH로 연결된 뒤 빈 화면에서 멈출 때

Section titled “Mosh가 SSH로 연결된 뒤 빈 화면에서 멈출 때”

SSH는 성공해 mosh-server를 띄웠지만 휴대폰과 호스트 사이에서 UDP 60000–61000 패킷이 왕복하지 못하는 상태입니다. 서버 방화벽과 클라우드 보안 그룹에서 인바운드 UDP 60000–61000을 열거나, 현재 Wi-Fi 네트워크가 UDP를 버린다면 연결 편집에서 Mosh 사용을 끄세요. 자세한 내용은 Mosh를 참고하세요.