연결 문제 해결
SSH 연결 문제를 진단하고 해결하세요
연결 거부
Connection refused 에러
가능한 원인
- •SSH 서버가 실행 중이지 않음
- •잘못된 호스트 또는 포트
- •방화벽에서 차단
해결 방법
- 서버에서 SSH 서비스가 실행 중인지 확인: sudo systemctl status sshd
- 호스트 주소와 포트 번호가 올바른지 확인
- 방화벽 설정 확인: sudo ufw status 또는 sudo iptables -L
- 다른 네트워크에서 시도해 보기
연결 시간 초과
Connection timed out 에러
가능한 원인
- •서버가 오프라인
- •네트워크 문제
- •방화벽에서 패킷 드롭
- •잘못된 IP 주소
해결 방법
- 서버가 온라인인지 확인 (ping 또는 웹 콘솔)
- 네트워크 연결 상태 확인
- VPN이 필요한 경우 VPN 연결 확인
- IP 주소가 올바른지 다시 확인
💡 팁
연결 시간 제한을 늘리려면 연결 설정 > 고급에서 'Connect Timeout'을 조절하세요.
호스트 키 검증 실패
호스트 키가 이전에 저장된 것과 다를 때 발생합니다.
이 오류의 의미
SSH는 서버의 신원을 호스트 키로 확인합니다. 이 키가 변경되었다는 것은 서버가 재설치되었거나, 중간자 공격이 발생했을 수 있음을 의미합니다.
해결 방법
- 서버가 최근에 재설치되었는지 확인
- 관리자에게 호스트 키 변경 여부 확인
- 안전하다고 확인되면 HejShell에서 '키 업데이트' 선택
- 의심스러우면 연결하지 마세요
⚠️ 보안 경고
호스트 키 변경을 무시하면 보안 위험이 있습니다. 항상 서버 관리자에게 확인하세요.
연결 끊김
연결이 자주 끊어지는 문제
가능한 원인
- •불안정한 네트워크
- •서버 측 타임아웃 설정
- •NAT/방화벽 타임아웃
- •서버 과부하
해결 방법
- 연결 설정에서 Keep-alive 활성화
- Keep-alive 간격을 30-60초로 설정
- 안정적인 네트워크로 변경
- 서버 관리자에게 ClientAliveInterval 설정 요청
느린 연결
연결이 느리거나 지연되는 문제
가능한 원인
- •네트워크 대역폭 부족
- •서버 과부하
- •높은 네트워크 지연 (latency)
- •DNS 조회 지연
해결 방법
- 다른 네트워크에서 시도
- 연결 설정에서 압축 활성화
- DNS 대신 IP 주소로 직접 연결 시도
- 서버 관리자에게 서버 상태 확인 요청
DNS 해석 실패
호스트명을 IP 주소로 변환할 수 없을 때 발생합니다.
해결 방법
- 호스트명 철자 확인
- IP 주소로 직접 연결 시도
- DNS 서버 변경 (예: 8.8.8.8)
- 네트워크 설정 확인
진단 단계
연결 문제를 체계적으로 진단하려면 다음 단계를 따르세요.
- 설정 > 진단에서 '연결 테스트' 실행
- 로그 확인 (설정 > 로그)
- 다른 SSH 클라이언트로 동일 서버 연결 테스트
- 문제가 지속되면 로그를 첨부하여 지원팀에 연락
여전히 문제가 있으신가요?
위 방법으로 해결되지 않으면 연결 로그를 첨부하여 연락해 주세요. dev@hej.ai.kr