«UNABLE_TO_GET_ISSUER_CERT_LOCALLY» на Mac

UNABLE_TO_GET_ISSUER_CERT_LOCALLY означает, что Node.js не может найти центр, подписавший сертификат. Обычная причина — прокси с проверкой TLS или частный центр сертификации.

Решите это с помощью агентаКопирует промпт для Claude Code, Codex или любого агента, который умеет работать с Терминалом.

У моего Mac такая проблема: «UNABLE_TO_GET_ISSUER_CERT_LOCALLY» на Mac. Прочитай https://kilobat.app/ru/guides/npm-unable-to-get-issuer-cert-locally.md и разберись с ней вместе со мной. Если Kilobat CLI не установлен, установи его: brew install seifip/kilobat/kilobat. Проверки в Терминале и через kilobat из руководства выполни сам и расскажи, что нашёл. Составь список шагов, которые могу сделать только я. Перед изменением любой настройки спрашивай меня.

Относится к: Node.js, npm и инструментам на Node.js во всех актуальных версиях macOS.Проверено: 29 октября 2026 г.

Симптомы

  • Инструмент Node.js останавливается с UNABLE_TO_GET_ISSUER_CERT_LOCALLY.
  • В сообщении может быть unable to get local issuer certificate.
  • Браузеры могут открывать тот же сайт.

Вероятные причины

  • Прокси с проверкой TLS. Рабочий прокси подписывает трафик собственным сертификатом. Смотрите Сертификаты корпоративного прокси ломают инструменты Терминала на Mac.
  • Частный центр сертификации. Корпоративный реестр или шлюз использует сертификат от центра, которого Node.js не знает.
  • Защитное приложение, которое сканирует HTTPS. Оно добавляет собственный корневой сертификат, который Node.js по умолчанию не использует.
  • Отсутствует промежуточный сертификат. Сервер может не присылать часть цепочки сертификатов.

Как проверить

  1. Прочитайте издателя.

    curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
  2. Покажите файл CA, который использует npm.

    npm config get cafile
  3. Покажите переменную CA для Node.js.

    echo $NODE_EXTRA_CA_CERTS
  4. Попробуйте режим модема на телефоне.

Как исправить

  1. Получите у администратора сети сертификат CA в формате PEM.

  2. Скажите Node.js доверять ему в этой оболочке.

    export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
  3. Для npm задайте тот же файл.

    npm config set cafile /path/to/ca.pem
  4. Не задавайте NODE_TLS_REJECT_UNAUTHORIZED=0. Это отключает все проверки.

С Kilobat

  1. Диагностика подключения в Kilobat проверяет хост уровень за уровнем. На уровне TLS виден сертификат, которому этот Mac не доверяет.

    kilobat why https://registry.npmjs.org/
  2. Эти проверки Kilobat бесплатны. ИИ-агенты запускают их через MCP с помощью diagnose_connection и diagnose_network. См. Почему не подключается один сайт или API.

Вопросы

Почему в браузере всё работает?

macOS доверяет сертификатам, которые установил администратор. Node.js использует собственный список, пока вы не добавите файл.

Решает ли проблему NODE_TLS_REJECT_UNAUTHORIZED=0?

Нет. Это отключает проверку сертификатов для каждого подключения. Лучше добавьте CA.

Источники

Проверено 29 октября 2026 года.