PHP-FPM: unable to bind listening socket — адрес из listen уже занят
При запуске PHP-FPM занимает адрес из настройки listen — порт, например 127.0.0.1:9000, или файл сокета, например /run/php/php8.3-fpm.sock. Если адрес уже занят — другим PHP-FPM, вторым пулом или другой программой, — PHP-FPM пишет эту ошибку и не запускается. Найдите, кто занял адрес, и остановите эту программу или дайте пулу свой адрес.
Содержание 15
- Что сделать прямо сейчас
- Как выглядит ошибка
- Что значит число в скобках
- Кто занял адрес
- Если пишет Another FPM instance seems to already listen on
- Если запущены два PHP-FPM разных версий
- Если у двух пулов один адрес
- Если путь к сокету слишком длинный
- Если такого адреса нет на сервере
- Если нет папки для сокета
- Если в listen только порт
- Как поменять listen
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Посмотрите адрес в кавычках в сообщении — это значение
listenиз настроек пула. - Узнайте, кто его занял:
sudo ss -tlnp | grep ':9000'для порта илиsudo ss -xlp | grep php8.3-fpm.sockдля сокета — подробнее. - Остановите лишнюю программу или поменяйте
listenи запустите PHP-FPM:sudo systemctl restart php8.3-fpm.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Команды — для PHP 8.3 из Ubuntu 24.04. В Ubuntu 26.04 стоит PHP 8.5: в путях и командах вместо 8.3 пишите 8.5. Какая версия у вас, покажет ls /etc/php/.
Как выглядит ошибка
PHP-FPM не запускается. Причину покажут команды sudo systemctl status php8.3-fpm и sudo journalctl -u php8.3-fpm -n 30:
[13-Nov-2026 10:00:00] ERROR: unable to bind listening socket for address '127.0.0.1:9000': … (98)
[13-Nov-2026 10:00:00] ERROR: FPM initialization failedПервая строка — «не удалось занять адрес 127.0.0.1:9000». В кавычках — адрес из listen. На месте многоточия — пояснение системы на английском, число в скобках — код ошибки. Вторая строка — PHP-FPM не запустился: FPM initialization failed.
Проверка настроек sudo php-fpm8.3 -t эту ошибку не находит: она проверяет запись настроек, а адрес не занимает. Ответ test is successful не значит, что адрес свободен.
Что значит число в скобках
| Число | Что случилось | Что делать |
|---|---|---|
| 98 | адрес уже занят другой программой | найдите, кто занял |
| 99 | такого IP-адреса нет на сервере | проверьте адрес |
| 2 | нет папки, в которой должен лежать файл сокета | проверьте папку |
Кто занял адрес
Если в listen порт, например 127.0.0.1:9000:
sudo ss -tlnp | grep ':9000'Если в listen файл сокета:
sudo ss -xlp | grep php8.3-fpm.sockВ конце строки ответа — users: и в скобках имя программы и pid= — номер её процесса. Если ответ пустой, адрес свободен: запустите PHP-FPM снова.
Какие процессы PHP-FPM запущены, покажет команда:
pgrep -a php-fpmУ главного процесса в строке — master process и в скобках путь к файлу настроек. По пути видно версию: /etc/php/8.3/… — PHP 8.3.
| Кто занял адрес | Что сделать |
|---|---|
| PHP-FPM другой версии, например 8.2 | разберите два PHP-FPM |
PHP-FPM, который запустили вручную, без systemctl | остановите его главный процесс: sudo kill 12345 — вместо 12345 номер из строки master process, затем sudo systemctl start php8.3-fpm |
| другая программа | дайте пулу другой порт или сокет — как поменять listen |
Если пишет Another FPM instance seems to already listen on
ERROR: Another FPM instance seems to already listen on /run/php/php8.3-fpm.sock«Похоже, другой PHP-FPM уже слушает этот сокет». Перед запуском PHP-FPM проверяет файл сокета: если к нему можно подключиться, его уже кто-то обслуживает. Найдите, кто, — командой ss -xlp.
Если файл сокета остался от прошлого запуска, а подключиться к нему нельзя, PHP-FPM сам удаляет его и создаёт новый. Удалять файл вручную не нужно.
Если запущены два PHP-FPM разных версий
На одном сервере могут стоять PHP 8.2 и PHP 8.3 — у каждой версии своя служба PHP-FPM. Какие запущены:
systemctl list-units --type=service | grep fpmВ Ubuntu у каждой версии свой сокет: /run/php/php8.2-fpm.sock, /run/php/php8.3-fpm.sock. Две версии мешают друг другу, только если в их пулах один и тот же listen — например, обе на 127.0.0.1:9000.
- Если старая версия не нужна, остановите её и выключите запуск при загрузке:
sudo systemctl disable --now php8.2-fpm. - Если нужны обе, дайте им разные адреса: например,
127.0.0.1:9000и127.0.0.1:9001— и поменяйте адрес в настройках сайта в nginx.
Если у двух пулов один адрес
ERROR: [pool site1] unable to set listen address as it's already used in another pool 'www'«Не удалось задать адрес: он уже занят другим пулом». В сообщении — оба пула: имя в квадратных скобках и имя в кавычках в конце. Так бывает, если скопировать www.conf в новый файл пула и поменять только имя в квадратных скобках.
Дайте каждому пулу свой сокет — в его файле в /etc/php/8.3/fpm/pool.d/:
listen = /run/php/php8.3-fpm-site1.sockИ направьте сайт на новый сокет в nginx — как это сделать. Эту ошибку sudo php-fpm8.3 -t находит до перезапуска.
Если путь к сокету слишком длинный
WARNING: [pool site1] cannot bind to UNIX socket '…' as path is too long (found length: …, maximal length: …), trying cut socket path instead '…'«Путь к сокету слишком длинный: найдена длина … , наибольшая — …; пробую обрезанный путь». PHP-FPM запускается, но создаёт сокет с обрезанным именем — оно в последних кавычках. nginx ищет сокет по полному пути, не находит его, и сайт отвечает 502 Bad Gateway.
Возьмите короткий путь в папке /run/php/, например /run/php/php8.3-fpm-site1.sock, — в listen и в настройках nginx.
Если такого адреса нет на сервере
Код 99 — в listen IP-адрес, которого у сервера нет: например, адрес другого сервера или старый адрес после переезда. Какие адреса есть у сервера:
ip -br addrЕсли nginx и PHP-FPM на одном сервере, пишите listen = 127.0.0.1:9000 или файл сокета.
Если нет папки для сокета
Код 2 — в listen файл сокета в папке, которой нет: например, /run/php-fpm/site1.sock. Папка /run очищается при перезагрузке, а /run/php создаёт сам пакет PHP-FPM. Держите сокеты в /run/php/.
Если в listen только порт
Если в listen только число, например listen = 9000, PHP-FPM слушает этот порт на всех адресах сервера. Если адреса IPv6 на сервере нет, в журнале будет NOTICE: Failed implicitly binding to ::, retrying with 0.0.0.0 — «не вышло занять все адреса IPv6, пробую все адреса IPv4». Это не ошибка.
listen = 127.0.0.1:9000 — или берите файл сокета.Как поменять listen
- Откройте файл пула:
sudo nano /etc/php/8.3/fpm/pool.d/www.conf— вместоwww.confфайл вашего пула. - Найдите строку
listen =: Ctrl+W, наберитеlisten =, Enter. Поменяйте адрес. - Сохраните и выйдите: Ctrl+O, Enter, Ctrl+X (редактор nano).
- Поменяйте адрес и в настройках сайта в nginx — в строке
fastcgi_pass. Для сокета:fastcgi_pass unix:/run/php/php8.3-fpm-site1.sock;. Проверьте nginx:sudo nginx -t. - Проверьте PHP-FPM:
sudo php-fpm8.3 -t— в ответе должно бытьtest is successful. - Перезапустите обе службы:
sudo systemctl restart php8.3-fpmиsudo systemctl reload nginx.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
unable to bind listening socket for address '…': … (98) | адрес занят | найдите, кто занял |
unable to bind listening socket for address '…': … (99) | такого IP нет на сервере | проверьте адрес |
unable to bind listening socket for address '…': … (2) | нет папки для сокета | держите сокеты в /run/php |
Another FPM instance seems to already listen on | сокет обслуживает другой PHP-FPM | найдите его |
unable to set listen address as it's already used in another pool | у двух пулов один адрес | дайте пулам разные сокеты |
as path is too long … trying cut socket path instead | слишком длинный путь к сокету | возьмите короткий путь |
Failed implicitly binding to ::, retrying with 0.0.0.0 | в listen только порт | пишите адрес целиком |
FPM initialization failed | PHP-FPM не запустился | смотрите строку выше — разбор |
Тексты сообщений сверены по исходному коду PHP 8.3.6 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код PHP-FPM в PHP 8.3.6 — на английском: занятие адреса в fpm_sockets.c, проверка адресов пулов в fpm_conf.c.
- Образец настроек пула www.conf — на английском: настройка listen и какие адреса она принимает.
- Настройка PHP-FPM в документации PHP — на английском: все настройки пула.
- Пакет php8.3-fpm в Ubuntu 24.04 — версия PHP-FPM и файлы пакета.
Сверено 13 ноября 2026 года.
Что почитать дальше
- 502 Bad Gatewayесли nginx не достучался до PHP-FPM.
- Настройки PHP для одного сайтаотдельный пул со своим сокетом.
- Ошибки PHP-FPMвсе ошибки PHP-FPM на одной странице.