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/ja/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_CERTSiPhoneのテザリングを試します。
解決方法
ネットワーク管理者から、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で実行します。1つのサイトやAPIに接続できない原因を見つけるを参照してください。
よくある質問
ブラウザでは動くのはなぜですか?
macOSは、管理者がインストールした証明書を信頼します。Node.jsは、ファイルを追加しない限り、独自の一覧を使います。
NODE_TLS_REJECT_UNAUTHORIZED=0を設定すれば解決しますか?
いいえ。すべての接続で証明書の検証がオフになります。代わりに、CAを追加してください。
出典
2026年10月29日に確認。