User= и WorkingDirectory= в systemd: от чьего имени и в какой папке работает служба
Без строки User= служба работает от root, а без WorkingDirectory= — в корневой папке /. Из-за второго программа не находит свои файлы, если ищет их рядом с собой: .env, шаблоны, папку data.
Содержание 9
Что сделать прямо сейчас
Пример — служба myapp, программа лежит в /home/ivan/app, работать она должна от пользователя ivan. Подставьте свои имена.
- Подключитесь к серверу по SSH (как подключиться).
- Проверьте, что пользователь есть:
id ivan. Ответ начинается сuid=— пользователь есть. - Проверьте, что он может открыть папку программы:
sudo -u ivan ls /home/ivan/app. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. Должен появиться список файлов. - Откройте дополнение к службе:
sudo systemctl edit myapp. Откроется редактор nano. Между строками### Anything between here…и### Edits below this comment will be discardedвпишите:
[Service]
User=ivan
WorkingDirectory=/home/ivan/app- Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X.
- Перезапустите службу:
sudo systemctl restart myapp. - Проверьте:
systemctl show myapp -p User -p WorkingDirectory. В ответеUser=ivanиWorkingDirectory=/home/ivan/app.
Если служба своя и файл лежит в /etc/systemd/system/myapp.service, эти строки можно вписать прямо в раздел [Service] этого файла, а потом выполнить sudo systemctl daemon-reload и sudo systemctl restart myapp. Как устроен файл службы — на странице Как создать службу systemd.
Зачем запускать не от root
Программа от root может изменить и удалить любой файл на сервере. Если в ней найдут ошибку или взломают сайт, под угрозой окажется весь сервер. Программа от отдельного пользователя может портить только то, к чему у этого пользователя есть доступ.
User=, Group= и SupplementaryGroups=
| Строка | Что значит |
|---|---|
User=ivan | программа работает от пользователя ivan, группа — основная группа ivan |
Group=www-data | группа www-data вместо основной группы пользователя |
SupplementaryGroups=www-data | основная группа остаётся, www-data добавляется к ней — например, чтобы читать файлы сайта |
Правила:
- Пользователь и группа должны уже быть на сервере к моменту запуска службы.
- Имя — латинские буквы, цифры,
_и-, первым знаком — буква или_, длиной до 31 знака. - С
User=systemd задаёт программе переменные HOME, LOGNAME и SHELL этого пользователя. Переменные из его~/.bashrcпрограмма не получает — свои переменные задают строкой Environment=.
Отдельный пользователь для службы
Для программы можно завести пользователя, под которым нельзя войти на сервер. Пример — для программы в папке /opt/myapp:
sudo useradd --system --user-group --no-create-home --shell /usr/sbin/nologin myapp
sudo chown -R myapp:myapp /opt/myappПервая команда создаёт пользователя myapp и группу с тем же именем, вторая отдаёт ему папку программы. В файле службы пишут User=myapp и WorkingDirectory=/opt/myapp.
Если программе нужно только читать свои файлы, а писать — в одну папку, отдайте ей только эту папку: sudo chown -R myapp:myapp /opt/myapp/data.
WorkingDirectory= — рабочая папка
| Строка | Что значит |
|---|---|
| строки нет | рабочая папка — корень / |
WorkingDirectory=/home/ivan/app | папка /home/ivan/app — путь пишут полностью, от / |
WorkingDirectory=~ | домашняя папка пользователя из строки User= |
WorkingDirectory=-/home/ivan/app | если папки нет, служба всё равно запустится |
Рабочая папка нужна программам, которые открывают файлы по короткому пути: .env, config.json, ./data. Без неё программа ищет их в / и не находит.
Программу в строке ExecStart= рабочая папка искать не помогает: там всё равно нужен полный путь, например ExecStart=/home/ivan/app/venv/bin/python app.py. Путь ./run.sh в ExecStart= не сработает.
Как проверить
| Что проверить | Команда |
|---|---|
| какие пользователь и папка заданы | systemctl show myapp -p User -p Group -p WorkingDirectory |
| от кого работает программа сейчас | узнайте номер процесса: systemctl show myapp -p MainPID --value, затем ps -o user,pid,cmd -p 12345, где 12345 — этот номер |
| может ли пользователь открыть файл | sudo -u ivan cat /home/ivan/app/config.json |
| может ли пользователь писать в папку | sudo -u ivan touch /home/ivan/app/data/test — если ошибки нет, удалите файл: rm /home/ivan/app/data/test |
Ошибки и как их исправить
В systemctl status myapp код сбоя виден в строке Main PID: или Process:, например (code=exited, status=217/USER).
| Что видите | Что значит и что делать |
|---|---|
status=217/USER | systemd не нашёл пользователя или группу из User= или Group=: проверьте имя командой id ivan, нет ли опечатки |
status=200/CHDIR | папки из WorkingDirectory= нет или у пользователя нет к ней доступа: sudo -u ivan ls /home/ivan/app |
status=203/EXEC | программа из ExecStart= не найдена или её нельзя запустить — как создать службу |
программа пишет, что не находит .env или другой свой файл | задайте WorkingDirectory= — папку, где лежит программа |
| программа не может записать файл | отдайте пользователю службы нужную папку: sudo chown -R ivan:ivan /home/ivan/app/data (команда chown) |
| служба не запускается после правки | Job for … failed — как найти причину |
Источники
- Справка systemd.exec(5) в Ubuntu 24.04 — на английском: User=, Group=, SupplementaryGroups=, правила имён, WorkingDirectory= и значение ~, переменные HOME, LOGNAME, SHELL, коды 200 и 217.
- Исходный код systemd 255: exit-status.c — названия кодов USER, CHDIR, EXEC.
- Справка useradd(8) в Ubuntu 24.04 — на английском: флаги --system, --user-group, --no-create-home, --shell.
Справка сверена с systemd 255 — эта версия стоит в Ubuntu 24.04.
Сверено 23 октября 2026 года.
Что почитать дальше
- Как создать службу systemdшаблон файла службы.
- Environment=переменные окружения для службы.
- Команда chownкак сменить владельца файла или папки.
- Настройки systemdвсе настройки служб.