Поиск
Ошибки

PHP-FPM: cannot get uid for user — в пуле указан пользователь, которого нет

В каждом пуле PHP-FPM указано, от какого пользователя работают его процессы и кому принадлежит сокет. Если такого пользователя или группы на сервере нет, PHP-FPM пишет cannot get uid for user или cannot get gid for group и не запускается. Создайте пользователя или поправьте имя в файле пула.

≈ 8 мин чтения
Содержание 14

Что сделать прямо сейчас

  1. Посмотрите имя в кавычках в сообщении и в квадратных скобках — имя пула.
  2. Проверьте, есть ли такой пользователь: id site1 — вместо site1 имя из сообщения. Группу проверит getent group site1.
  3. Если пользователя нет — создайте его или поправьте имя в файле пула. Затем sudo php-fpm8.3 -t и 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/.

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

[13-Nov-2026 10:00:00] ERROR: [pool site1] cannot get uid for user 'site1'
[13-Nov-2026 10:00:00] ERROR: FPM initialization failed

«Пул site1: не удалось получить номер пользователя site1». У каждого пользователя в Linux есть номер — uid. Если номера нет, значит, нет и пользователя. Для группы сообщение cannot get gid for group '…' — «не удалось получить номер группы».

Если ошибка про listen.owner или listen.group, в конце строки — двоеточие, пояснение системы и число в скобках:

ERROR: [pool site1] cannot get uid for user 'nginx': … (…)

Эти строки видны в sudo systemctl status php8.3-fpm, sudo journalctl -u php8.3-fpm -n 30 и sudo php-fpm8.3 -t — проверка находит эту ошибку до перезапуска.

Какие строки в пуле задают пользователя

Файл пула — в /etc/php/8.3/fpm/pool.d/, например www.conf:

СтрокаЧто задаёт
user = www-dataот какого пользователя работают процессы PHP этого пула
group = www-dataих группа; если строки нет — основная группа пользователя из user
listen.owner = www-dataвладелец файла сокета
listen.group = www-dataгруппа файла сокета

В Ubuntu и PHP-FPM, и nginx работают от пользователя www-data. Имя в сообщении ищите в этих строках:

grep -n '^user\|^group\|^listen.owner\|^listen.group' /etc/php/8.3/fpm/pool.d/*.conf

Как проверить пользователя и группу

id site1

Если пользователь есть, в ответе его номер uid=, группа gid= и список групп groups=. Если нет — ответ, что такого пользователя нет.

getent group site1

Если группа есть, ответ — строка с её именем и номером. Если нет — пустой ответ.

Если имя взято из чужой инструкции

В инструкциях для других систем пишут listen.owner = nginx или user = apache. В Ubuntu таких пользователей нет: nginx работает от www-data. Замените имя на www-data:

listen.owner = www-data
listen.group = www-data

Как создать пользователя для пула

Если пул нужен для одного сайта и его процессы должны работать от своего пользователя, создайте системного пользователя и группу с тем же именем:

sudo adduser --system --group --no-create-home site1

Вместо site1 — имя из файла пула. Такой пользователь не может войти на сервер: он нужен только для процессов PHP. Как завести пользователя, который входит на сервер, — как добавить пользователя.

Файлы сайта должны быть доступны этому пользователю — права на файлы сайта. А сокет должен быть доступен nginx: оставьте в пуле listen.owner = www-data и listen.group = www-data. Как настроить пул для одного сайта — отдельный пул PHP-FPM.

Если пишет please specify user and group other than root

ERROR: [pool www] please specify user and group other than root

«Укажите пользователя и группу, отличные от root». В пуле user = root. Процессы PHP выполняют код сайта: если они работают от root, ошибка в коде или взлом сайта дают доступ ко всему серверу. Поэтому PHP-FPM отказывается так запускаться. Верните user = www-data и group = www-data или возьмите пользователя сайта.

Если в пуле нет строки user, а PHP-FPM запущен от root, сообщение другое:

ALERT: [pool www] user has not been defined

«Не задан пользователь». Допишите в пул user = www-data и group = www-data.

Если пишет 'user' directive is ignored

NOTICE: [pool www] 'user' directive is ignored when FPM is not running as root

«Строка user не действует, потому что PHP-FPM запущен не от root». Это не ошибка. Сменить пользователя процессов может только PHP-FPM, запущенный от root. Служба php8.3-fpm запускается от root — там эта строка действует. Такая запись бывает, если запустить php-fpm8.3 вручную без sudo. Так же PHP-FPM пишет и про 'group', 'chroot' и 'process.priority'.

Если пишет failed to chown() the socket

ERROR: [pool www] failed to chown() the socket '/run/php/php8.3-fpm.sock': … (…)

«Не удалось сменить владельца сокета». PHP-FPM создал сокет, но не смог отдать его пользователю из listen.owner и группе из listen.group. Так бывает, если PHP-FPM запущен не от root. Запускайте его службой: sudo systemctl restart php8.3-fpm.

Права на сокет задаёт listen.mode, по умолчанию 0660: читать и писать могут владелец и группа. Если nginx не может подключиться к сокету, сайт отвечает 502 — нет прав на сокет.

Если пишет ACL set, listen.owner is ignored

WARNING: [pool www] ACL set, listen.owner = 'www-data' is ignored

«Задан список доступа ACL, поэтому listen.owner не действует». В пуле есть строки listen.acl_users или listen.acl_groups — они дают доступ к сокету по списку пользователей и групп. Тогда listen.owner и listen.group не нужны. Оставьте что-то одно: для одного nginx хватит listen.owner и listen.group.

Если пишет failed to setuid или failed to setgid

ERROR: [pool site1] failed to setuid(…): … (…)

«Не удалось переключиться на пользователя пула». Процесс PHP не смог сменить пользователя, на месте многоточия в скобках — номер пользователя. Проверьте, что PHP-FPM запущен службой от root, а пользователь из пула есть на сервере — id site1. Похожие строки — failed to setgid(…) для группы и failed to initgroups(…) для списка групп.

Эти записи пишет сам процесс PHP, поэтому в журнале PHP-FPM они видны, только если в пуле включено catch_workers_output = yes — тогда они внутри записи child … said into stderr (как включить). Без этой настройки в журнале видно только, что процессы завершаются сразу после запуска: exited with code 70, и следом запускаются новые.

Ошибки и как их исправить

Что видитеПричинаЧто делать
cannot get uid for user '…'нет такого пользователяпроверьте имя или создайте пользователя
cannot get gid for group '…'нет такой группыпроверьте группу
cannot get uid for user 'nginx'имя из инструкции для другой системызамените на www-data
please specify user and group other than rootпул настроен на rootверните www-data
user has not been definedв пуле нет строки userдопишите user и group
'user' directive is ignored when FPM is not running as rootPHP-FPM запущен не от rootзапускайте службой
failed to chown() the socketне удалось сменить владельца сокетазапускайте службой
ACL set, listen.owner = '…' is ignoredзаданы и ACL, и listen.ownerоставьте что-то одно
failed to setuid, failed to setgidне удалось сменить пользователяпроверьте пользователя

Тексты сообщений сверены по исходному коду PHP 8.3.6 — эта версия стоит в Ubuntu 24.04.

Источники

Сверено 13 ноября 2026 года.

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

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