Mac의 “UNABLE_TO_GET_ISSUER_CERT_LOCALLY”
UNABLE_TO_GET_ISSUER_CERT_LOCALLY는 Node.js가 인증서에 서명한 인증 기관을 찾지 못한다는 뜻입니다. TLS를 검사하는 프록시나 사설 인증 기관이 흔한 원인입니다.
제 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 점검은 직접 실행하고, 알아낸 내용을 알려 주세요. 저만 할 수 있는 단계는 목록으로 정리해 주세요. 설정을 바꾸기 전에는 먼저 물어봐 주세요.
증상
- Node.js 도구가
UNABLE_TO_GET_ISSUER_CERT_LOCALLY로 멈춥니다. - 메시지에
unable to get local issuer certificate가 나올 수 있습니다. - 브라우저에서는 같은 사이트가 열릴 수 있습니다.
가능한 원인
- TLS를 검사하는 프록시. 회사 프록시가 자체 인증서로 트래픽에 서명합니다. Mac에서 기업 프록시 인증서가 터미널 도구를 깨뜨릴 때를 참고하세요.
- 사설 인증 기관. 회사 레지스트리나 게이트웨이가 Node.js가 모르는 인증 기관의 인증서를 사용합니다.
- HTTPS를 검사하는 보안 앱. Node.js가 기본적으로 사용하지 않는 자체 루트를 추가합니다.
- 누락된 중간 인증서. 서버가 인증서 체인의 일부를 빠뜨렸을 수 있습니다.
확인 방법
발급자를 확인하세요.
curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuernpm이 사용하는 CA 파일을 표시하세요.
npm config get cafileNode.js CA 변수를 표시하세요.
echo $NODE_EXTRA_CA_CERTS휴대폰 핫스팟을 사용해 보세요.
해결 방법
네트워크 관리자에게 PEM 형식의 CA 인증서를 받으세요.
이 셸에서 Node.js가 해당 인증서를 신뢰하도록 지정하세요.
export NODE_EXTRA_CA_CERTS=/path/to/ca.pemnpm에도 같은 파일을 설정하세요.
npm config set cafile /path/to/ca.pemNODE_TLS_REJECT_UNAUTHORIZED=0를 설정하지 마세요. 모든 확인이 꺼집니다.
Kilobat 사용
Kilobat의 연결 진단은 호스트를 계층별로 테스트합니다. TLS 계층에서 이 Mac이 신뢰하지 않는 인증서를 확인할 수 있습니다.
kilobat why https://registry.npmjs.org/이 Kilobat 검사는 무료입니다. AI 에이전트는 MCP를 통해
diagnose_connection및diagnose_network(으)로 실행합니다. 특정 사이트나 API에 연결되지 않는 이유 찾기를 참조하세요.
질문
브라우저에서는 되는 이유는 무엇인가요?
macOS는 관리자가 설치한 인증서를 신뢰합니다. Node.js는 파일을 추가하지 않는 한 자체 목록을 사용합니다.
NODE_TLS_REJECT_UNAUTHORIZED=0으로 설정하면 해결되나요?
아니요. 모든 연결에서 인증서 검증이 꺼집니다. 대신 CA를 추가하세요.
출처
2026년 10월 29일 확인했습니다.