[Q&A] 권한이 있는 private repository에서 SSH 방식으로 git clone 실패

김재훈·2023년 5월 17일
0

문제

부트캠프의 GitHub private repository들은 모두 SSH 방식으로만 clone할 수 있게 설정되어 있었는데요. 일부 사용자들은 SSH key 등록 이후에도 git clone이 안 되는 문제가 발생했습니다.

단서 얻기

clone이 실패하는 사람들은 공통적으로 명령 실행 시 ssh: connect to host github.com port 22: Operation timed out 오류가 발생했습니다.

통신을 시도 했을 때 방화벽에 닫혀 통신이 실패하는 경우 time out 오류가 발생하기 때문에, 해당 키워드를 활용하여 구글에 검색을 시도한 결과 GitHub 공식 문서를 찾을 수 있었습니다.
https://docs.github.com/en/authentication/troubleshooting-ssh/using-ssh-over-the-https-port

원인 및 해결방법

문서의 내용을 요약하면 22번 포트가 차단된 경우 HTTPS의 포트인 443번을 통해 SSH를 연결해야 합니다.

아래 절차대로 진행하여 SSH 연결을 HTTPS 포트로 변경할 수 있습니다.
1. 터미널을 실행합니다.
2. 터미널에서 code ~/.ssh/config 명령어를 실행합니다.
3. VS Code 창에 config이라는 이름으로 빈 파일이 열리면 아래 내용을 적어줍니다.

Host github.com
    Hostname ssh.github.com
    Port 443
  1. 내용을 다 적었으면 저장하고 파일을 닫은 뒤 다시 클론을 시도합니다.
  2. SSH 특성상 처음 연결을 시도하면 서로의 키를 주고받은 뒤 정말로 연결할 거냐고 다시 한 번 묻습니다. 선택지로는 (yes|no|) 형태로 표시되며, yes를 해주세요.
    5-1. 한 번 yes해주시면 다시 묻지 않습니다.
profile
개발하면서 새롭게 배운 내용, 시행착오한 내용들을 잊지 않기 위해 기록합니다.

0개의 댓글