Python: OSError: [Errno 98] Address already in use — порт занят
Приложение на Python хочет принимать запросы на порту, который уже держит другая программа. Это может быть вторая копия того же приложения, другой сайт или nginx.
Содержание 8
Как выглядит ошибка
Если приложение открывает порт само, через модуль socket, сообщение такое:
Traceback (most recent call last):
…
OSError: [Errno 98] Address already in usegunicorn пишет об этом в свой журнал — в квадратных скобках дата, номер процесса и уровень сообщения:
[2026-10-22 10:15:03 +0300] [1234] [ERROR] Connection in use: ('127.0.0.1', 8000)gunicorn 20.1.0 из Ubuntu 24.04 после этого пишет Retrying in 1 second., пробует открыть порт ещё раз, а после пяти попыток сдаётся со строкой Can't connect to ('127.0.0.1', 8000). gunicorn 25.1.0 из Ubuntu 26.04 добавляет строку connection to ('127.0.0.1', 8000) failed: [Errno 98] Address already in use.
В программах на asyncio, например в uvicorn, в тексте есть те же Errno 98 и адрес:
[Errno 98] error while attempting to bind on address ('127.0.0.1', 8000): address already in useВ скобках — адрес и порт: здесь 127.0.0.1 и 8000, а один порт на одном адресе может слушать только одна программа. Тексты ошибок сверены с исходным кодом Python 3.12.3 — эта версия стоит в Ubuntu 24.04 — и Python 3.14.4 из пакета python3.14 в Ubuntu 26.04. Тексты сверены с исходным кодом gunicorn 20.1.0 и 25.1.0 — эти версии ставятся из пакетов Ubuntu 24.04 и 26.04. Если gunicorn поставлен через pip в окружение venv, версия может быть другой.
Шаг 1. Узнайте, кто занял порт
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
sudo ss -ltnp | grep :8000Вместо 8000 — порт из сообщения. В ответе будет строка с LISTEN, в её конце — имя программы и её номер pid:
LISTEN 0 … 127.0.0.1:8000 … users:(("python3",pid=1234,fd=3))Здесь порт держит программа python3 с номером 1234, а что именно запущено под этим номером, покажет команда:
ps -o pid,user,cmd -p 1234В колонке USER — пользователь, в колонке CMD — команда запуска, например python3 app.py. Если вместо python3 стоит nginx, порт занят nginx — дайте приложению другой порт (шаг 3). Если ss ничего не вывела — раздел ниже.
У gunicorn в строке будет несколько номеров: главный процесс и его рабочие процессы. Главный — тот, чей номер стоит в колонке PPID у остальных:
ps -o pid,ppid,cmd -C gunicornШаг 2. Остановите лишнюю копию
Если порт держит то же приложение, значит, его запустили второй раз. Если приложение запущено как служба systemd, имя службы в примерах — myapp, папка — /home/ivan/myapp. Подставьте свои.
| Как запущено | Как это понять | Что сделать |
|---|---|---|
| служба systemd | sudo systemctl status myapp пишет active (running) | приложение уже работает, запускать его вручную не нужно; перезапуск — sudo systemctl restart myapp |
| вручную в окне SSH | в другом окне терминала работает python3 app.py или gunicorn | перейдите в то окно и нажмите Ctrl+C |
| вручную, окно уже закрыто | служба не запущена, а процесс есть в ps | kill 1234 — номер из шага 1, у gunicorn — номер главного процесса |
Если процесс работает от другого пользователя, нужна команда sudo kill 1234. Службу останавливайте командой sudo systemctl stop myapp, а не kill: с Restart=on-failure или Restart=always systemd может запустить её заново.
Шаг 3. Или дайте приложению другой порт
Если порт нужен той программе, которая его держит, переведите приложение на другой, например на 8001: у gunicorn порт задаётся ключом --bind в строке ExecStart файла службы. Откройте файл в редакторе nano:
sudo nano /etc/systemd/system/myapp.serviceСтрока станет такой — путь и имя приложения оставьте свои:
ExecStart=/home/ivan/myapp/venv/bin/gunicorn --bind 127.0.0.1:8001 app:appСохраните файл и перезапустите службу:
sudo systemctl daemon-reload
sudo systemctl restart myappЕсли порт записан в коде приложения, поменяйте число в коде. Если перед приложением стоит nginx, поменяйте порт и в строке proxy_pass его настроек (как это устроено), затем примените их:
sudo nginx -t
sudo systemctl reload nginxЕсли порт в nginx не поменять, сайт покажет 502 Bad Gateway.
Если ss ничего не нашла
Порт никто не слушает, а ошибка повторяется сразу после перезапуска приложения. Посмотрите все соединения с этим портом:
ss -tan | grep :8000Если в ответе строки с TIME-WAIT, это следы недавних соединений: ядро держит их ещё около минуты после закрытия. Приложение, которое открывает порт само, через socket, должно включить перед bind() настройку SO_REUSEADDR — тогда такие следы не мешают:
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)У socketserver.TCPServer то же включает атрибут allow_reuse_address = True в классе сервера. gunicorn включает SO_REUSEADDR сам.
Как проверить
sudo ss -ltnp | grep :8000В ответе должна быть строка с вашим приложением. Отвечает ли оно, покажет команда — вместо 8000 подставьте свой порт:
curl -I http://127.0.0.1:8000Первая строка ответа вида HTTP/1.1 200 OK значит, что приложение отвечает.
Источники
- Исходный код Python 3.12.3: Objects/exceptions.c — вид
[Errno номер] текст. - Исходный код glibc 2.39: errlist.h — текст Address already in use для кода 98.
- Исходный код Python 3.12.3: asyncio/base_events.py — строка error while attempting to bind.
- Исходный код Python 3.12.3: socketserver.py — allow_reuse_address.
- Исходный код gunicorn 20.1.0: sock.py — Connection in use, Retrying in 1 second и пять попыток.
- Исходный код gunicorn 25.1.0: sock.py — строка connection to … failed.
- Документация Python: модуль socket — SO_REUSEADDR и TIME_WAIT.
- Исходный код Linux 6.8: include/net/tcp.h — TCP_TIMEWAIT_LEN, 60 секунд.
Сверено 22 октября 2026 года.
Что почитать дальше
- Как узнать, какая программа занимает порт.
- nginx: Address already in useкогда порт не может занять nginx.
- Node.js: EADDRINUSEто же для приложений на Node.js.
- Все ошибки Python и pipтаблица по тексту сообщения.
- Restart= в systemdесли служба перезапускается и занимает порт.