Mac의 “UNABLE_TO_GET_ISSUER_CERT_LOCALLY”

UNABLE_TO_GET_ISSUER_CERT_LOCALLY는 Node.js가 인증서에 서명한 인증 기관을 찾지 못한다는 뜻입니다. TLS를 검사하는 프록시나 사설 인증 기관이 흔한 원인입니다.

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

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

적용 대상: 현재의 모든 macOS 버전의 Node.js, npm 및 Node.js 기반 도구.확인일: 2026년 10월 29일

증상

  • Node.js 도구가 UNABLE_TO_GET_ISSUER_CERT_LOCALLY로 멈춥니다.
  • 메시지에 unable to get local issuer certificate가 나올 수 있습니다.
  • 브라우저에서는 같은 사이트가 열릴 수 있습니다.

가능한 원인

  • TLS를 검사하는 프록시. 회사 프록시가 자체 인증서로 트래픽에 서명합니다. Mac에서 기업 프록시 인증서가 터미널 도구를 깨뜨릴 때를 참고하세요.
  • 사설 인증 기관. 회사 레지스트리나 게이트웨이가 Node.js가 모르는 인증 기관의 인증서를 사용합니다.
  • HTTPS를 검사하는 보안 앱. Node.js가 기본적으로 사용하지 않는 자체 루트를 추가합니다.
  • 누락된 중간 인증서. 서버가 인증서 체인의 일부를 빠뜨렸을 수 있습니다.

확인 방법

  1. 발급자를 확인하세요.

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

    npm config get cafile
  3. Node.js CA 변수를 표시하세요.

    echo $NODE_EXTRA_CA_CERTS
  4. 휴대폰 핫스팟을 사용해 보세요.

해결 방법

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

  2. 이 셸에서 Node.js가 해당 인증서를 신뢰하도록 지정하세요.

    export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
  3. npm에도 같은 파일을 설정하세요.

    npm config set cafile /path/to/ca.pem
  4. NODE_TLS_REJECT_UNAUTHORIZED=0를 설정하지 마세요. 모든 확인이 꺼집니다.

Kilobat 사용

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

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

질문

브라우저에서는 되는 이유는 무엇인가요?

macOS는 관리자가 설치한 인증서를 신뢰합니다. Node.js는 파일을 추가하지 않는 한 자체 목록을 사용합니다.

NODE_TLS_REJECT_UNAUTHORIZED=0으로 설정하면 해결되나요?

아니요. 모든 연결에서 인증서 검증이 꺼집니다. 대신 CA를 추가하세요.

출처

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