“SELF_SIGNED_CERT_IN_CHAIN” no npm do Mac
SELF_SIGNED_CERT_IN_CHAIN significa que a cadeia de certificados tem um certificado que nenhuma autoridade conhecida assinou. Em uma rede de trabalho, a origem usual é um proxy que inspeciona TLS.
Meu Mac está com este problema: “SELF_SIGNED_CERT_IN_CHAIN” no npm do Mac. Leia https://kilobat.app/pt/guides/npm-self-signed-cert-in-chain.md e resolva comigo. Instale a CLI do Kilobat se ela estiver faltando: brew install seifip/kilobat/kilobat. Execute você mesmo as verificações do Terminal e do kilobat do guia e me diga o que encontrar. Liste os passos que só eu posso fazer. Pergunte antes de alterar qualquer ajuste.
Sintomas
npm installpara comnpm error code SELF_SIGNED_CERT_IN_CHAIN.- A mensagem diz
self-signed certificate in certificate chain. - Começa em uma rede de empresa ou depois que um app de segurança é instalado.
Possíveis causas
- Um proxy que inspeciona TLS. O proxy substitui o certificado do registro pelo próprio. Veja Certificados de proxy corporativo quebram ferramentas do Terminal no Mac.
- Um app de segurança que examina HTTPS. Ele pode adicionar a própria raiz ao tráfego.
- Um npm antigo. A página de erros comuns do npm diz que o npm não aceita mais seus antigos certificados autoassinados.
- Um registro privado. Um registro com uma autoridade privada precisa do certificado dessa autoridade.
Como verificar
Leia o emissor do certificado do registro.
curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuerMostre o arquivo de CA que o npm usa.
npm config get cafileVerifique a versão do npm.
npm --versionTente o acesso pessoal de um celular. Se funcionar, a primeira rede inspeciona TLS.
Como corrigir
Peça o certificado raiz ao administrador da rede, em formato PEM.
Aponte o npm para ele.
npm config set cafile /path/to/ca.pemAtualize o npm se ele for antigo.
npm install npm -gNão defina
strict-sslcomo false. A documentação do npm desaconselha.
Com o Kilobat
O diagnóstico de conexão do Kilobat testa o registro camada por camada. A camada TLS mostra um certificado em que este Mac não confia.
kilobat why https://registry.npmjs.org/Essas verificações do Kilobat são gratuitas. Agentes de IA as executam pelo MCP com
diagnose_connectionediagnose_network. Consulte Descubra por que um site ou API não conecta.
Perguntas
npm config set strict-ssl false é seguro?
Ele desativa a verificação de certificado. A documentação do npm desaconselha isso para erros de proxy. Adicione a CA do proxy.
Por que o erro aparece só no trabalho?
Um proxy que inspeciona TLS assina o tráfego com um certificado próprio. Seu Mac não confia nele.
Fontes
Verificado em 29 de outubro de 2026.