Node.js LinuxWindowsNode.js

Node.js: Сервер Node.js запускается локально, но не слушает внешний интерфейс

  • Обновлено
  • Чтение ≈ 3 минуты

Краткий ответ

Сервер Node.js отвечает по адресу 127.0.0.1 на самом компьютере, но недоступен с другого устройства. Нужно отличить привязку сокета к loopback от сетевых ограничений, обратного прокси и правил брандмауэра.

В этой статье
  1. Как проявляется неисправность
  2. Причины и отличительные признаки
  3. Пошаговая диагностика и исправление
  4. Проверка результата

#Как проявляется неисправность

Сервер Node.js отвечает по адресу 127.0.0.1 на самом компьютере, но недоступен с другого устройства. Нужно отличить привязку сокета к loopback от сетевых ограничений, обратного прокси и правил брандмауэра.

#Причины и отличительные признаки

Возможная причинаКак узнатьЧто делать
Приложение слушает только 127.0.0.1Loopback доступен лишь с самого компьютера.ss показывает 127.0.0.1:портПри необходимости выбрать нужный внешний интерфейс и защитить его.
Брандмауэр или сеть блокирует портПравило ОС или сети запрещает входящее соединение.На сервере доступно по LAN IP, с другого ПК нетТочно настроить разрешённый порт/источник.
Порт опубликован через обратный проксиNginx/балансировщик обращается не к тому адресу или порту.Сервис отвечает локально, публичный домен нетСверить upstream и журналы.

#Пошаговая диагностика и исправление

  1. Проверьте фактическую точку входаЗапишите порт и адрес, указанный в логах приложения. На сервере откройте браузер или curl и проверьте локальный URL, например http://127.0.0.1:3000/health, только если приложение действительно содержит маршрут /health. При 404 сервер может работать — проверьте существующий URL.
  1. Посмотрите, какой адрес слушает процессНа Linux выполните ss -ltnp и найдите требуемый порт. 127.0.0.1:3000 означает только локальный IPv4; 0.0.0.0:3000 — все IPv4-интерфейсы. Для просмотра владельца процесса иногда нужны права администратора, но наличие слушающего адреса видно и без них.
  2. Linux; порт 3000 пример
    Linux · Терминал (Bash)Команда
    Linux; порт 3000 пример. Windows: Get-NetTCPConnection -LocalPort 3000 -State Listen в PowerShell.
    ss -ltn | grep :3000
  1. Проверьте код запуска Node.jsВ исходном коде найдите server.listen(port, host) или app.listen(port, host) для Express. Указанный 127.0.0.1 намеренно ограничивает доступ; если нужен внешний доступ из разрешённой сети, допустим 0.0.0.0, но он открывает службу на всех IPv4-интерфейсах. Убедитесь, что приложение имеет авторизацию и защищённый сетевой контур.
  1. Сначала проверьте адрес самого сервераУзнайте IP сетевого интерфейса через настройки ОС или ip -4 addr. С самого сервера попробуйте запрос по этому IP и текущему порту. Если он не проходит, проблема скорее в привязке слушателя или локальном файрволе, а не в маршруте между двумя машинами.
  2. Linux, только чтение
    Linux · Терминал (Bash)Команда
    Linux, только чтение. Не используйте случайный внешний IP; выбирайте адрес той сети, где ожидаются подключения.
    ip -4 addr
  1. Проверьте с другого устройстваС компьютера в той же разрешённой сети попробуйте curl -v http://IP_СЕРВЕРА:3000/, заменив IP и путь. Если есть таймаут, проверьте маршрутизацию и правила брандмауэра на конкретный порт. Если соединение отвергнуто, проверьте слушатель и активность процесса.
    Linux · Терминал (Bash)Команда
    IP 192.0.2.10 — документальный пример, замените реальным адресом; без прав администратора.
    curl -v http://192.0.2.10:3000/
  1. Для публичного сайта предпочтите обратный проксиЕсли Node работает на одном сервере с Nginx, допустимо оставить Node привязанным к 127.0.0.1 и принимать публичные HTTPS-запросы через Nginx. Проверьте proxy_pass и сертификат прокси, вместо открытия прямого порта Node в интернет.
  1. Сделайте проверку безопасности после исправленияПодтвердите доступ лишь с согласованных адресов, работу HTTPS через прокси и отсутствие случайного публичного доступа к административным маршрутам. Если открыли слишком широкий интерфейс, откатите настройку и ограничьте доступ на уровне прокси/брандмауэра.

#Проверка результата

Запрос с разрешённого клиента проходит, с неразрешённого — блокируется; локальный слушатель и сетевой маршрут соответствуют архитектуре.

При повторной ошибке сравните фактическую команду запуска, журнал приложения и параметры окружения. Если изменения затронули службу, верните предыдущую конфигурацию из сохранённой копии и разберите исходное сообщение об ошибке.

Так эту ошибку тоже называют

Node.js: Error: listen EADDRINUSE :::3000 — причины и решение Остановите процесс, занявший порт, или смените порт. Программирование и базы данных Node.js LinuxWindowsmacOS Node.js: JavaScript heap out of memory — причины и решение Увеличьте --max-old-space-size и найдите утечку. Программирование и базы данных Node.js LinuxWindowsmacOS Node.js: Cannot use import statement outside a module — причины и решение Ошибка возникает при использовании import в CommonJS-файле. Укажите "type": "module" в package.json или переименуйте файл в .mjs. Программирование и базы данных Node.js LinuxWindowsmacOS Node.js: FATAL ERROR: JavaScript heap out of memory — причины и решение «FATAL ERROR: JavaScript heap out of memory» в Node.js возникает, когда процесс исчерпал лимит памяти V8. Увеличьте --max-old-space-size, найдите утечку, обрабатывайте д… Программирование и базы данных Node.js LinuxWindowsmacOS Node.js: The engine "node" is incompatible with this module — причины и решение Проект требует другую версию Node.js, чем установлена. Ниже — причины и порядок действий от простого к сложному. Программирование и базы данных Node.js WindowsLinux

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.