문서 · 주제
문제 해결
SSH나 점프 호스트 연결 자체에서 오류가 난다면 연결되지 않을 때를 먼저 확인하세요. 로그인 이후 발생하는 문제는 아래에서 증상별로 찾을 수 있습니다.
잠금 화면 푸시가 오지 않을 때
Section titled “잠금 화면 푸시가 오지 않을 때”- iOS 권한과 Moshpit 스위치 확인: Moshpit의 설정 › 알림을 여세요. iOS 자체에서 Moshpit 알림이 꺼져 있다면 화면 맨 위 배너가 바로 알려 줍니다. 에이전트가 기다리면 알림이 켜져 있는지 확인하세요.
- 페어링 확인 및 테스트 전송: 해당 연결의 호스트 설정을 열어 서버에
openssl과curl이 모두 설치되어 있고 아웃바운드 HTTPS가 푸시 릴레이에 닿는지 확인한 뒤, 그 화면을 포그라운드에 띄워 둔 채 테스트 알림 보내기를 탭하세요. - 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를 참고하세요.