Поиск
Ошибки

Node.js: Error: listen EADDRINUSE: address already in use — порт занят

Приложение на Node.js хочет принимать запросы на порту, который уже держит другая программа. Это может быть вторая копия того же приложения: служба systemd, PM2 или запуск в другом окне. Ниже — как найти, кто занял порт, и освободить его.

≈ 5 мин чтения3 шага
Содержание 7

Как выглядит ошибка

Приложение завершается сразу после запуска, а в выводе или в журнале службы есть строки:

Error: listen EADDRINUSE: address already in use :::3000
    …
  code: 'EADDRINUSE',
  errno: -98,
  syscall: 'listen',
  address: '::',
  port: 3000
}

:::3000 — это адрес :: и порт 3000 через двоеточие. Адрес :: значит «все адреса сервера»: так Node.js открывает порт, если в коде указан только номер, например app.listen(3000). Если в коде указан и адрес, он будет в сообщении — например 127.0.0.1:3000.

Один порт может слушать только одна программа. Пока первая его держит, вторая получает EADDRINUSE.

Шаг 1. Узнайте, кто занял порт

Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.

sudo ss -ltnp | grep :3000

Вместо 3000 — порт из сообщения. Ответ выглядит так:

LISTEN 0      511                *:3000            *:*    users:(("node",pid=1234,fd=18))

В конце строки — имя программы и её номер pid: здесь порт держит программа node, её номер — 1234, а звёздочка перед :3000 — то же, что :: в сообщении об ошибке, все адреса сервера. Что именно запущено под этим номером, покажет команда:

ps -o pid,user,cmd -p 1234

В колонке USER — пользователь, от которого работает программа, в колонке CMD — команда запуска, например node app.js. Если вместо node стоит docker-proxy, порт отдан контейнеру — разбор на странице Docker: port is already allocated.

Если ss ничего не вывела, порт уже свободен: программа, которая его держала, завершилась. Запустите приложение снова.

Шаг 2. Остановите лишнюю копию

Если порт держит то же приложение, значит, его запустили второй раз. Как остановить первую копию, зависит от того, как её запускали. Если приложение запущено как служба systemd, имя службы в примерах — myapp, папка — /home/ivan/myapp. Подставьте свои.

Как запущеноКак это понятьЧто сделать
служба systemdsudo systemctl status myapp пишет active (running)приложение уже работает, вручную его запускать не нужно. После правки кода — sudo systemctl restart myapp
PM2в pm2 list у приложения статус onlineперезапуск — pm2 restart myapp, остановка — pm2 stop myapp
вручную в окне SSHв другом окне терминала работает node app.jsперейдите в то окно и нажмите Ctrl+C

Если окно уже закрыто, а программа осталась работать, завершите её по номеру из шага 1:

kill 1234

Если программа работает от другого пользователя, нужна команда sudo kill 1234. Приложения под systemd и PM2 останавливайте их собственными командами из таблицы: так менеджер знает, что остановка намеренная.

Шаг 3. Или переведите приложение на другой порт

Если порт занят нужной программой, дайте приложению другой, например 3001: порт задан в коде, в примере ниже он берётся из переменной PORT, а если её нет — 3000:

const port = process.env.PORT || 3000;
app.listen(port);

Если в коде есть process.env.PORT, порт можно задать в службе без правки кода. Откройте файл службы в редакторе nano:

sudo nano /etc/systemd/system/myapp.service

И добавьте в раздел [Service] строку:

Environment=PORT=3001

Сохраните файл и перезапустите службу:

sudo systemctl daemon-reload
sudo systemctl restart myapp

Если в коде стоит число, например app.listen(3000), поменяйте число в коде и перезапустите приложение.

Если перед приложением стоит nginx, поменяйте порт и в его настройках: в файле сайта в папке /etc/nginx/sites-available строка станет proxy_pass http://127.0.0.1:3001; (как это устроено). Проверьте настройки и примените их:

sudo nginx -t
sudo systemctl reload nginx

Если порт в nginx не поменять, сайт покажет 502 Bad Gateway.

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

sudo ss -ltnp | grep node

В ответе должна быть строка с портом вашего приложения. Отвечает ли оно на запросы, покажет команда — вместо 3000 подставьте свой порт:

curl -I http://127.0.0.1:3000

Первая строка вида HTTP/1.1 200 OK значит, что приложение отвечает. Другой код в этой строке, например 404, — тоже ответ приложения: порт работает, просто по адресу / у него нет страницы.

Тексты ошибок сверены с исходным кодом Node.js 18.19.1 — он ставится из пакетов Ubuntu 24.04 — и Node.js 22.22.1 из пакетов Ubuntu 26.04.

Источники

Сверено 22 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше