Ошибки EADDRINUSE на портах 3000, 5173 или 8080 — частая проблема при локальной разработке нескольких сервисов. Ручная связка команд lsof, ps и kill требует поиска PID и не показывает контекста запущенного окружения.
CLI-утилита port-whisperer (команда ports) опрашивает сетевые порты за 0,2 секунды через пакетные вызовы lsof и ps, связывая их с контейнерами через docker ps. Инструмент определяет проект и фреймворк по файлам конфигурации (Next.js, Vite, Express, Django, FastAPI, PostgreSQL, Redis).
По официальной документации проекта, утилита ставится через npm install -g port-whisperer либо запускается разово через npx port-whisperer.
Основные команды:
- Аудит:
portsвыводит сводную таблицу,ports 3000инспектирует конкретный порт, аports --allотображает системные службы. - Очистка:
ports kill 3000отправляет мягкий сигнал SIGTERM, аports kill 3000-3010освобождает диапазон портов. Принудительный флагports kill -f(SIGKILL) нужен только для зависших процессов. - Логи:
ports logs 3000 -fтранслирует поток вывода приложения прямо в консоль.
Перед удалением процесса утилита позволяет сверить PID и каталог запуска, исключая случайную остановку системных служб.
