SSH 문제 해결

SSH 키를 사용할 때 다음과 같은 문제에 직면할 수 있습니다.

TLS: 서버가 8192비트보다 큰 RSA 키가 포함된 인증서를 보냈습니다.

GitLab 16.3 이상에서는 Go가 RSA 키를 최대 8192비트로 제한합니다.

키의 길이를 확인하려면:

openssl rsa -in <your-key-file> -text -noout | grep "Key:"

8192비트보다 긴 키는 더 짧은 키로 교체하세요.

git clone의 암호 프롬프트

git clone을 실행할 때 다음과 같이 암호를 요청받을 수 있습니다: git@gitlab.example.com's password:.

이는 SSH 설정에 문제가 있음을 나타냅니다.

  • SSH 키 쌍을 올바르게 생성하고 공개 SSH 키를 GitLab 프로필에 추가했는지 확인하세요.

  • ssh-agent를 사용하여 개인 SSH 키를 수동으로 등록해 보세요.

  • ssh -Tv git@example.com을 실행하여 연결을 디버깅해 보세요.

    example.com을 GitLab URL로 교체하세요.

  • Microsoft Windows에서 SSH 사용 안내를 모두 따랐는지 확인하세요.

  • GitLab SSH 소유권 및 권한 확인을 확인하세요. 여러 호스트가 있는 경우 모든 호스트에서 권한이 올바른지 확인하세요.

호스트 이름을 확인할 수 없습니다 오류

다음 오류가 발생할 수 있습니다 연결할 수 있는지 확인할 때:

ssh: Could not resolve hostname gitlab.example.com: nodename nor servname provided, or not known

이 오류가 발생하면 터미널을 재시작하고 명령을 다시 시도하세요.

키 등록 실패: 잘못된 형식 오류

위에 설명한 FIDO2 하드웨어 보안 키에 대한 SSH 키 쌍 생성 시 다음 오류가 발생할 수 있습니다:

Key enrollment failed: invalid format

다음 방법으로 문제를 해결해 보세요:

  • ssh-keygen 명령을 sudo로 실행하세요.

  • FIDO2 하드웨어 보안 키가 제공된 키 유형을 지원하는지 확인하세요.

  • ssh -V를 실행하여 OpenSSH 버전이 8.2 이상인지 확인하세요.

오류: 이 시스템에서 SSH 호스트 키를 사용할 수 없습니다.

GitLab이 호스트 SSH 키에 접근할 수 없는 경우 gitlab.example/help/instance_configuration를 방문하면 SSH 호스트 키 지문 헤더 아래에 인스턴스 SSH 지문 대신 다음 오류 메시지가 표시됩니다:

SSH host keys are not available on this system. Please use ssh-keyscan command or contact your GitLab administrator for more information.

이 오류를 해결하려면:

  • Helm 차트(Kubernetes) 배포 시, values.yaml을 업데이트하여 sshHostKeys.mount를 webservice 섹션 아래에서 true로 설정하세요.

  • GitLab 셀프 관리 설치의 경우 /etc/ssh 디렉토리에서 호스트 키를 확인하세요.