---
title: "Mac 上 npm 中的“SELF_SIGNED_CERT_IN_CHAIN”· Kilobat 指南"
url: "https://kilobat.app/zh-hans/guides/npm-self-signed-cert-in-chain"
description: "Mac 上的 npm 以 SELF_SIGNED_CERT_IN_CHAIN 停止。代理或过滤器用它自己的证书对流量签名。请信任它，不要关闭检查。"
---

# 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-hans/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 的代理。**代理用它自己的证书替换了软件源的证书。参见[企业代理证书会让 Mac 上的终端工具出错](https://kilobat.app/zh-hans/guides/corporate-proxy-certificates)。
- **扫描 HTTPS 的安全类 App。**它可能会给流量加上它自己的根证书。
- **npm 太旧。**npm 常见错误页面说明，npm 不再支持它以前使用的自签名证书。
- **私有软件源。**使用私有机构的软件源需要该机构的证书。

## 如何检查

1. 查看软件源证书的签发者。

   ```
   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 的连接诊断会逐层测试软件源。TLS 层会显示这台 Mac 不信任的证书。

   ```
   kilobat why https://registry.npmjs.org/
   ```
2. Kilobat 的这些检查都是免费的。AI 智能体可以通过 MCP 用 `diagnose_connection` 和 `diagnose_network` 运行它们。请参阅[找出某个网站或 API 连不上的原因](https://kilobat.app/zh-hans/guides/recipes/why-cant-it-connect)。

## 常见问题

**npm config set strict-ssl false 安全吗？**

它会关闭证书检查。对于代理造成的错误，npm 文档不建议这样做。请改为添加代理的 CA。

**为什么这个错误只在工作时出现？**

检查 TLS 的代理用它自己的证书对流量签名，而你的 Mac 不信任它。

## 参考资料

- [npm 文档：常见错误](https://docs.npmjs.com/common-errors)

核查日期：2026 年 10 月 29 日。

## 相关指南

- [Mac 上的“UNABLE_TO_GET_ISSUER_CERT_LOCALLY”](https://kilobat.app/zh-hans/guides/npm-unable-to-get-issuer-cert-locally): UNABLE_TO_GET_ISSUER_CERT_LOCALLY 表示 Node.js 找不到签发某份证书的机构。
- [Mac 上公司代理证书导致“终端”工具出错](https://kilobat.app/zh-hans/guides/corporate-proxy-certificates): 一些公司网络会检查 HTTPS 流量。
- [Mac 上出现“npm error code ECONNRESET”](https://kilobat.app/zh-hans/guides/npm-econnreset): ECONNRESET 表示连接被强制重置。
- [Mac 上的“curl: (60) SSL certificate problem”](https://kilobat.app/zh-hans/guides/curl-60-ssl-certificate-problem): curl 退出码 60 表示某个步骤失败。
