Mac npm의 “SELF_SIGNED_CERT_IN_CHAIN”

SELF_SIGNED_CERT_IN_CHAIN은 인증서 체인에 알려진 인증 기관이 서명하지 않은 인증서가 들어 있다는 뜻입니다. 회사 네트워크에서는 TLS를 검사하는 프록시가 흔한 원인입니다.

에이전트로 해결하기Claude Code, Codex 또는 터미널을 쓸 수 있는 에이전트용 프롬프트를 복사합니다.

제 Mac에 이런 문제가 있습니다: Mac npm의 “SELF_SIGNED_CERT_IN_CHAIN”. https://kilobat.app/ko/guides/npm-self-signed-cert-in-chain.md을(를) 읽고 저와 함께 해결해 주세요. Kilobat CLI가 없으면 설치해 주세요: brew install seifip/kilobat/kilobat. 가이드의 터미널 및 kilobat 점검은 직접 실행하고, 알아낸 내용을 알려 주세요. 저만 할 수 있는 단계는 목록으로 정리해 주세요. 설정을 바꾸기 전에는 먼저 물어봐 주세요.

적용 대상: 현재의 모든 macOS 버전의 npm. 이 오류는 다른 Node.js 도구에서도 나타납니다.확인일: 2026년 10월 29일

증상

  • npm install이(가) npm error code SELF_SIGNED_CERT_IN_CHAIN 메시지와 함께 중단됩니다.
  • 메시지에 self-signed certificate in certificate chain라고 나옵니다.
  • 회사 네트워크에서 시작되거나 보안 앱을 설치한 뒤에 시작됩니다.

가능한 원인

  • TLS를 검사하는 프록시. 프록시가 레지스트리 인증서를 자체 인증서로 바꿉니다. Mac에서 기업 프록시 인증서가 터미널 도구를 깨뜨릴 때를 참고하세요.
  • HTTPS를 검사하는 보안 앱. 트래픽에 자체 루트를 추가할 수 있습니다.
  • 오래된 npm. npm 흔한 오류 페이지에 따르면 npm은 더 이상 이전의 자체 서명 인증서를 지원하지 않습니다.
  • 사설 레지스트리. 사설 인증 기관의 레지스트리에는 해당 기관의 인증서가 필요합니다.

확인 방법

  1. 레지스트리 인증서의 발급자를 확인하세요.

    curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
  2. npm이 사용하는 CA 파일을 표시하세요.

    npm config get cafile
  3. npm 버전을 확인하세요.

    npm --version
  4. 휴대폰 핫스팟을 사용해 보세요. 되면 첫 번째 네트워크가 TLS를 검사하는 것입니다.

해결 방법

  1. 네트워크 관리자에게 PEM 형식의 루트 인증서를 받으세요.

  2. npm이 해당 인증서를 가리키게 하세요.

    npm config set cafile /path/to/ca.pem
  3. npm이 오래되었다면 업데이트하세요.

    npm install npm -g
  4. strict-ssl를 false로 설정하지 마세요. npm 문서는 권장하지 않습니다.

Kilobat 사용

  1. Kilobat의 연결 진단은 레지스트리를 계층별로 테스트합니다. TLS 계층에서 이 Mac이 신뢰하지 않는 인증서를 확인할 수 있습니다.

    kilobat why https://registry.npmjs.org/
  2. 이 Kilobat 검사는 무료입니다. AI 에이전트는 MCP를 통해 diagnose_connection 및 diagnose_network(으)로 실행합니다. 특정 사이트나 API에 연결되지 않는 이유 찾기를 참조하세요.

질문

npm config set strict-ssl false는 안전한가요?

인증서 확인을 끕니다. npm 문서는 프록시 오류에는 권장하지 않습니다. 대신 프록시의 CA를 추가하세요.

왜 회사에서만 오류가 나타나나요?

TLS를 검사하는 프록시가 자체 인증서로 트래픽에 서명합니다. Mac이 이를 신뢰하지 않습니다.

출처

2026년 10월 29일 확인했습니다.