문제 해결 및 자주 묻는 질문

PhanTerm을 사용하는 동안 문제가 발생한 경우 다음의 일반적인 문제 해결 가이드를 참조하십시오.

1. 터미널 렌더링 또는 텍스트 겹침 문제

증상: 터미널에 들어간 후 일부 복잡한 명령줄 응용 프로그램(예: 자동 줄 바꿈이 포함된 긴 명령, 다중 색상의 Git 로그)에서 디스플레이 엇갈림, 잔상 또는 잘못된 커서 위치가 나타납니다.

해결 방법: 이는 일반적으로 운영 체제가 감지한 터미널의 가로 및 세로 크기가 동기화되지 않아 발생합니다. 창 크기를 수동으로 드래그하여 조정해 보십시오. PhanTerm의 수신 계층은 창 크기 변경(Resize) 이벤트를 수신한 후 원격 PTY에 올바른 크기 재설정을 강제로 실행하며, 이로써 화면 표시 문제의 90% 이상을 해결할 수 있습니다.

2. 서버에 연결할 수 없음 (Connection Timed Out)

증상: 회전하는 Connecting... 애니메이션이 계속 표시되다가 이후 시간 초과 또는 네트워크 도달 불가능 프롬프트가 표시됩니다.

해결 방법:

1. 입력한 IP와 포트(특히 22번이 아닌 사용자 지정 포트)가 올바른지 확인하십시오.
2. 원격 머신의 방화벽이나 클라우드 서비스 제공자의 보안 그룹이 로컬 공인 IP의 접근을 허용하고 있는지 확인하십시오.
3. 대상 서버가 내부망 환경에 있는 경우, 통과를 위해 연결 설정에서 **점프 서버 (ProxyJump)**를 구성해야 할 수도 있습니다.

3. SSH 키 인증 거부 (Permission Denied)

증상: 키 인증을 구성했지만 여전히 비밀번호를 요구하거나 연결에 실패합니다.

해결 방법:

1. 경로 확인: 입력한 IdentityFile 경로가 존재하고 유효한지 확인하십시오.
2. 형식 확인: 제공한 파일이 .pub 확장자를 가진 공개 키 파일이 아니라 개인 키 파일(예: id_rsa 또는 id_ed25519)인지 확인하십시오.
3. 시스템 Agent: 관리를 위해 시스템의 ssh-agent 또는 Pageant에 의존하도록 선택한 경우, 이러한 백그라운드 서비스가 실행 중이고 귀하의 키가 ssh-add를 통해 시스템에 올바르게 로드되었는지 확인하십시오.

4. 호스트 키 지문 불일치 붉은색 경고

증상: 연결 시 호스트 키 서명이 올바르지 않다는 강력한 붉은색 경고 팝업이 표시됩니다.

해결 방법: 절대로 가볍게 승인하지 마십시오! 먼저 서버 관리자에게 문의하십시오. 이 상황이 정상적이라고 간주할 수 있는 경우는 다음 두 가지뿐입니다:

1. 운영 체제가 방금 새로 설치되었습니다.
2. 관리자가 SSH 보안 인증서를 방금 교체했다고 알려왔습니다.

안전이 확인된 경우 로컬 구성 디렉터리(구성 참조 참고)로 이동하여 known_hosts.yaml에서 충돌하는 해당 레코드 줄을 수동으로 삭제한 후 다시 시도할 수 있습니다.