«npm error code ENOTFOUND» на Mac
ENOTFOUND сообщает о неудачном поиске DNS. В документации Node.js он назван «DNS lookup failed», сбоем EAI_NODATA или EAI_NONAME.
У моего Mac такая проблема: «npm error code ENOTFOUND» на Mac. Прочитай https://kilobat.app/ru/guides/npm-enotfound.md и разберись с ней вместе со мной. Если Kilobat CLI не установлен, установи его: brew install seifip/kilobat/kilobat. Проверки в Терминале и через kilobat из руководства выполни сам и расскажи, что нашёл. Составь список шагов, которые могу сделать только я. Перед изменением любой настройки спрашивай меня.
Симптомы
npm installзавершается сnpm error code ENOTFOUND.- Следующая строка называет хост, например
registry.npmjs.org. - Браузеры могут работать.
Вероятные причины
- Нет соединения или DNS. Mac не может связаться с сервером DNS.
- Неверный реестр. В настройке реестра npm указан хост, которого не существует или которому нужен VPN.
- VPN со своим DNS. Корпоративные реестры разрешаются только при включённом VPN.
- Прокси, который npm не использует. В сетях только с прокси npm нужны настройки прокси.
Как проверить
Покажите реестр, который использует npm.
npm config get registryРазрешите имя хоста средствами macOS.
dscacheutil -q host -a name registry.npmjs.orgСпросите реестр напрямую.
npm pingПокажите настройки прокси.
npm config get https-proxy
Как исправить
Если поиск через macOS не удаётся, исправьте DNS. Смотрите DNS не разрешает имена на Mac.
Исправьте реестр.
npm config set registry https://registry.npmjs.org/Для корпоративного реестра подключите VPN.
Очистите кэш DNS. См. Очистка кэша DNS на Mac.
С Kilobat
Диагностика подключения в Kilobat проверяет адрес уровень за уровнем: сеть, прокси, DNS, правила, IPv4, IPv6, TLS и сервер. Она называет уровень, на котором произошёл сбой.
kilobat why https://registry.npmjs.org/Эти проверки Kilobat бесплатны. ИИ-агенты запускают их через MCP с помощью
diagnose_connectionиdiagnose_network. См. Почему не подключается один сайт или API.
Вопросы
ENOTFOUND — то же, что EAI_AGAIN?
Нет. EAI_AGAIN сообщает о временном сбое поиска. Смотрите EAI_AGAIN на Mac.
Неверно ли имя моего пакета?
Редко. ENOTFOUND касается имени хоста, а не имени пакета.
Источники
Проверено 29 октября 2026 года.