curl: (35) OpenSSL SSL_connect: Connection reset by peer 오류 해결 방법 – 원인과 대처법

낯선 장소에서 와이파이를 잡아 수행할 경우 해당 와이파이가 raw.githubusercontent.com접근을 허용하지 않는 경우 입니다. 

가끔 병원 같이 보안이 강한 곳에서 발생할 수 있습니다. 아쉽지만 장소를 옮겨야 할 것같습니다.

curl: (35) OpenSSL SSL_connect: Connection reset by peer 오류 해결 방법 – 원인과 대처법

📌 오류 메시지 설명

터미널 또는 명령어 실행 중 다음과 같은 오류 메시지를 만난 적이 있으신가요?

curl: (35) OpenSSL SSL_connect: Connection reset by peer in connection to raw.githubusercontent.com:443

이 오류는 보통 curl 명령어로 raw.githubusercontent.com에 연결을 시도할 때, SSL 연결이 중단되며 발생합니다. 특히 GitHub에서 스크립트를 다운로드하거나 설치할 때 자주 나타나는 문제입니다.

 

🔍 주요 원인: 공공 와이파이 또는 제한된 네트워크 환경

이 오류는 주로 보안이 강화된 네트워크 환경에서 발생합니다. 예를 들어:

병원, 학교, 공공기관 등에서 제공하는 와이파이

공공 와이파이 또는 인증이 필요한 네트워크

특정 외부 도메인을 차단하는 방화벽이 설치된 환경

 

이러한 장소에서는 raw.githubusercontent.com과 같은 외부 호스트에 대한 SSL 연결을 차단하거나 제한할 수 있습니다. 그 결과 curl 명령이 실패하게 됩니다.

 

✅ 해결 방법

네트워크 환경 변경하기

가장 확실한 해결책은 **다른 네트워크(예: 개인 핫스팟, 가정용 와이파이)**로 전환하여 다시 시도하는 것입니다. 대부분의 경우, 보다 개방적인 네트워크에서는 해당 오류가 발생하지 않습니다.

 

VPN 사용 고려

특정 네트워크가 해외 트래픽을 차단하는 경우, VPN을 이용해 우회 연결을 시도해볼 수 있습니다.

 

방화벽 및 보안 설정 확인

개인 PC에서 방화벽이 curl의 SSL 연결을 차단하고 있는지 확인하세요. 때로는 보안 소프트웨어가 이를 방해할 수 있습니다.

 

curl: (35) OpenSSL SSL_connect: Connection reset by peer 오류는 일반적인 네트워크 문제이며, 접속 중인 장소의 인터넷 환경에 따라 발생할 수 있는 일시적인 현상입니다. 공공장소나 보안이 강화된 환경에서는 GitHub와 같은 외부 리소스에 연결이 차단될 수 있으니, 가능한 한 개인 네트워크에서 작업하시길 권장합니다.