Поиск
Ошибки

Python: OSError: [Errno 98] Address already in use — порт занят

Приложение на Python хочет принимать запросы на порту, который уже держит другая программа. Это может быть вторая копия того же приложения, другой сайт или nginx.

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

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

Если приложение открывает порт само, через модуль socket, сообщение такое:

Traceback (most recent call last):
  …
OSError: [Errno 98] Address already in use

gunicorn пишет об этом в свой журнал — в квадратных скобках дата, номер процесса и уровень сообщения:

[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. Подставьте свои.

Как запущеноКак это понятьЧто сделать
служба systemdsudo systemctl status myapp пишет active (running)приложение уже работает, запускать его вручную не нужно; перезапуск — sudo systemctl restart myapp
вручную в окне SSHв другом окне терминала работает python3 app.py или gunicornперейдите в то окно и нажмите Ctrl+C
вручную, окно уже закрытослужба не запущена, а процесс есть в pskill 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 значит, что приложение отвечает.

Источники

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

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

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