Node.js: Error: listen EADDRINUSE: address already in use — порт занят
Приложение на Node.js хочет принимать запросы на порту, который уже держит другая программа. Это может быть вторая копия того же приложения: служба systemd, PM2 или запуск в другом окне. Ниже — как найти, кто занял порт, и освободить его.
Содержание 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. Подставьте свои.
| Как запущено | Как это понять | Что сделать |
|---|---|---|
| служба systemd | sudo 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.
Источники
- Исходный код Node.js 18.19.1: lib/net.js — если адрес не указан, порт открывается сначала на
::, а при отказе — на0.0.0.0. - Исходный код Node.js 18.19.1: lib/internal/errors.js — вид сообщения
listen КОД: текст адрес:порти свойства code, errno, syscall, address, port. - Документация Node.js 22: server.listen() — адрес по умолчанию
::или0.0.0.0. - Исходный код программы ss из iproute2 6.1.0 — звёздочка на месте адреса
::и видusers:(("node",pid=…,fd=…)). - Справка systemd.exec для Ubuntu 24.04 — строка Environment= в файле службы.
Сверено 22 октября 2026 года.
Что почитать дальше
- Как узнать, какая программа занимает портss для любого порта.
- nginx: Address already in useкогда порт не может занять nginx.
- Docker: port is already allocatedпорт для контейнера.
- Все ошибки Node.js и npmтаблица по тексту сообщения.