Поиск
Справочник

User= и WorkingDirectory= в systemd: от чьего имени и в какой папке работает служба

Без строки User= служба работает от root, а без WorkingDirectory= — в корневой папке /. Из-за второго программа не находит свои файлы, если ищет их рядом с собой: .env, шаблоны, папку data.

≈ 5 мин чтения
Содержание 9

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

Пример — служба myapp, программа лежит в /home/ivan/app, работать она должна от пользователя ivan. Подставьте свои имена.

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Проверьте, что пользователь есть: id ivan. Ответ начинается с uid= — пользователь есть.
  3. Проверьте, что он может открыть папку программы: sudo -u ivan ls /home/ivan/app. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. Должен появиться список файлов.
  4. Откройте дополнение к службе: sudo systemctl edit myapp. Откроется редактор nano. Между строками ### Anything between here… и ### Edits below this comment will be discarded впишите:
[Service]
User=ivan
WorkingDirectory=/home/ivan/app
  1. Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X.
  2. Перезапустите службу: sudo systemctl restart myapp.
  3. Проверьте: 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/USERsystemd не нашёл пользователя или группу из 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 255 — эта версия стоит в Ubuntu 24.04.

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

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

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