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/zh-hant/guides/npm-self-signed-cert-in-chain.md,並和我一起逐步處理。如果缺少 Kilobat CLI,請安裝:brew install seifip/kilobat/kilobat。請你自己執行指南中的終端機和 kilobat 檢查,並告訴我發現了什麼。列出只有我才能完成的步驟。變更任何設定之前先問我。
症狀
npm install停止並顯示npm error code SELF_SIGNED_CERT_IN_CHAIN。- 訊息顯示
self-signed certificate in certificate chain。 - 在公司網路上,或安裝資安 App 之後開始出現。
可能原因
- 進行 TLS 檢查的代理伺服器。代理伺服器把 registry 的憑證換成它自己的。請參閱 公司代理伺服器的憑證會讓 Mac 上的終端機工具失效。
- 掃描 HTTPS 的資安 App。它可能在流量中加入自己的根憑證。
- npm 太舊。npm 常見錯誤頁面指出,npm 已不再支援它以前的自簽憑證。
- 私有 registry。使用私有機構的 registry 需要該機構的憑證。
如何檢查
讀取 registry 憑證的簽發者。
curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer顯示 npm 使用的 CA 檔案。
npm config get cafile檢查 npm 版本。
npm --version試試手機熱點。如果可以,就是第一個網路在檢查 TLS。
如何修正
向網路管理員取得 PEM 格式的根憑證。
讓 npm 指向它。
npm config set cafile /path/to/ca.pem如果 npm 太舊,請更新。
npm install npm -g請勿把
strict-ssl設為 false。npm 文件建議不要這麼做。
使用 Kilobat
Kilobat 的連線診斷會逐層測試 registry。TLS 層會顯示這部 Mac 不信任的憑證。
kilobat why https://registry.npmjs.org/這些 Kilobat 檢查都是免費的。AI 代理程式可透過 MCP 以
diagnose_connection和diagnose_network執行。請參閱找出某個網站或 API 連不上的原因。
常見問題
npm config set strict-ssl false 安全嗎?
它會關閉憑證檢查。針對代理伺服器錯誤,npm 文件建議不要這麼做。請改為加入代理伺服器的 CA。
為什麼這個錯誤只在公司出現?
檢查 TLS 的代理伺服器會用自己的憑證簽署流量。你的 Mac 不信任它。
資料來源
查核日期:2026 年 10 月 29 日。