VPN/프록시 환경에서 패키지 설치 안 될 때 체크리스트
회사 네트워크 환경에서 npm, pip, maven 설치가 막혀서 답답하신가요? 프록시 설정법을 정리해 드립니다.
1. npm/yarn 프록시 및 SSL 설정
증상: npm install 시 'network timeout' 또는 'self-signed certificate in certificate chain' 에러 발생
해결: 사내 프록시 주소를 등록하거나, SSL 검증을 일시적으로 해제하세요.
# 프록시 설정
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
# SSL 인증서 에러(self-signed certificate) 해결
npm config set strict-ssl false
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
# SSL 인증서 에러(self-signed certificate) 해결
npm config set strict-ssl false
※ strict-ssl false 설정 후에도 문제가 지속되면 환경 변수를 설정해 보세요:
# Windows (PowerShell)
$env:NODE_TLS_REJECT_UNAUTHORIZED = "0"
# macOS/Linux
export NODE_TLS_REJECT_UNAUTHORIZED=0
$env:NODE_TLS_REJECT_UNAUTHORIZED = "0"
# macOS/Linux
export NODE_TLS_REJECT_UNAUTHORIZED=0
2. Git 프록시 및 SSL 검증 해제
증상: git clone 시 SSL certificate 관련 에러 발생
원인: 사내 보안 장비가 SSL 패킷을 가로채서 발생하는 문제입니다.
해결: 임시로 SSL 검증을 끄거나 프록시를 설정하세요. (보안 정책 확인 필수)
git config --global http.sslVerify false
git config --global http.proxy http://proxy.company.com:8080
git config --global http.proxy http://proxy.company.com:8080
3. 자바(Maven/Gradle) 프록시
해결: ~/.m2/settings.xml 또는 gradle.properties 파일에 프록시 정보를 추가해야 합니다.
1분 확인 방법
터미널에서 curl -I https://www.google.com을 실행하여 외부망 연결 여부를 먼저 확인하세요.