Сервер не запускается и пишет Address already in use, EADDRINUSE или «port is already allocated»? Это значит, что нужный порт уже занят другой программой — часто вашей же, запущенной раньше и не закрытой до конца.

Ниже — как быстро найти и завершить процесс, который держит порт, в Linux, macOS и Windows, а также что делать, если порт занимает Docker, системная служба или «зависший» сервер.

Коротко
  • Linux: sudo fuser -k 8080/tcp или найти PID через sudo ss -tulpn | grep :8080 и выполнить kill PID.
  • macOS: kill $(lsof -ti tcp:8080).
  • Windows: netstat -ano | findstr :8080, затем taskkill /PID номер /F.
  • Если порт держит Docker, остановите контейнер командой docker stop.
  • Если процесс нужен, проще запустить свой сервер на другом порту.

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

Текст зависит от программы, но смысл один — «порт занят»:

  • Node.js: Error: listen EADDRINUSE: address already in use :::3000;
  • Python: OSError: [Errno 98] Address already in use (в macOS — [Errno 48], в Windows — [WinError 10048]);
  • nginx: bind() to 0.0.0.0:80 failed (98: Address already in use);
  • Docker: Bind for 0.0.0.0:8080 failed: port is already allocated.

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

Частая причина: сервер «повис» в фоне

Прежде чем искать виновника, проверьте самое простое:

  • не открыт ли сервер в другой вкладке терминала или в терминале редактора кода;
  • не остановили ли вы его сочетанием Ctrl + Z вместо Ctrl + C. Ctrl + Z не завершает программу, а только приостанавливает её, и порт остаётся занятым. Наберите jobs — если там есть процесс, верните его командой fg и завершите через Ctrl + C.

Linux

Самый короткий способ — команда fuser с ключом -k: она находит процесс на порту и сразу завершает его.

sudo fuser -k 8080/tcp

Если хотите сначала посмотреть, кого вы останавливаете (это разумно), найдите процесс, а затем завершите его по номеру PID:

sudo ss -tulpn | grep :8080
sudo kill 48213

Команда kill просит программу корректно завершиться. Если через несколько секунд порт всё ещё занят, используйте принудительное завершение sudo kill -9 48213. Подробно о том, как читать вывод ss, lsof и netstat, — в статье как посмотреть, какой процесс занимает порт.

Ошибка EADDRINUSE address already in use и освобождение порта командой kill в терминале

Если порт занят системной службой

Если порт держит служба (nginx, Apache, PostgreSQL), kill не поможет: systemd может запустить её заново. Остановите службу штатно:

sudo systemctl stop nginx
sudo systemctl disable nginx   # если она не нужна при загрузке

macOS

В macOS нет ss, зато есть lsof. Ключ -t выводит только PID, поэтому команды удобно объединить:

lsof -ti tcp:3000
kill $(lsof -ti tcp:3000)

Первая команда покажет номер процесса, вторая — завершит его. Если процесс не реагирует, замените kill на kill -9. Для процессов другого пользователя или системных добавьте sudo.

Особый случай — порты 5000 и 7000. На современных macOS их занимает «Приёмник AirPlay» (процесс ControlCenter), и завершать его бессмысленно. Отключите его в «Системных настройках» → «Основные» → «AirDrop и Handoff» или запускайте свой сервер на другом порту.

Windows

Откройте командную строку или терминал от имени администратора и найдите PID процесса:

netstat -ano | findstr :8080

Номер процесса — в последней колонке строки со статусом LISTENING. Чтобы узнать, что это за программа, выполните tasklist /FI "PID eq 6120". Затем завершите её:

taskkill /PID 6120 /F

То же самое в PowerShell одной командой:

Get-NetTCPConnection -LocalPort 8080 -State Listen | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force }

Без командной строки: откройте «Диспетчер задач» (Ctrl + Shift + Esc) → вкладка «Подробности», отсортируйте по столбцу «ИД процесса», найдите нужный номер и нажмите «Снять задачу».

Поиск процесса на порту командой netstat -ano и завершение через taskkill в Windows

Если в выводе netstat PID равен 4, порт занимает сама система (процесс System) — обычно это служба IIS, общий доступ или другая системная служба. Её не завершают через taskkill, а отключают в «Службах» или выбирают другой порт.

Если порт занят Docker

Когда порт пробросил контейнер, в списке процессов вы увидите docker-proxy или com.docker.backend. Найдите контейнер и остановите его:

docker ps --format "table {{.Names}}\t{{.Ports}}"
docker stop имя_контейнера

Если проект запущен через Compose, выполните в его папке docker compose down.

Если процесс завершать нельзя

Иногда порт занят нужной программой. Тогда проще запустить свой сервер на другом порту. Большинство инструментов это позволяют:

  • Node.js и многие фреймворки читают переменную окружения PORT: PORT=3001 npm start (в Windows PowerShell — $env:PORT=3001; npm start);
  • Python: python3 -m http.server 8001;
  • Docker: поменяйте левую часть проброса, например -p 8081:80 вместо -p 8080:80.

Частые вопросы

Процесс завершён, а ошибка всё равно появляется

Возможно, программу сразу перезапускает менеджер процессов (systemd, pm2, nodemon, Docker с политикой перезапуска). Остановите её через этот менеджер. Также после закрытия соединений порт может несколько секунд оставаться в состоянии TIME_WAIT — подождите немного и запустите сервер снова.

Ничего не найдено, но порт занят

Запустите команды с sudo (в Windows — от имени администратора): без прав процессы других пользователей не видны. Также проверьте, что ищете правильный протокол — TCP или UDP.

Безопасно ли использовать kill -9?

Для зависшего dev-сервера — да. Но принудительное завершение не даёт программе сохранить данные, поэтому базы данных и важные службы останавливайте штатно, через systemctl stop или их собственные команды.

© kak2.ru