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 檢查,並告訴我發現了什麼。列出只有我才能完成的步驟。變更任何設定之前先問我。

適用於:所有目前 macOS 版本上的 npm。這個錯誤也會出現在其他 Node.js 工具中。檢查日期:2026年10月29日

症狀

  • 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 需要該機構的憑證。

如何檢查

  1. 讀取 registry 憑證的簽發者。

    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 的連線診斷會逐層測試 registry。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 日。