Environment= и EnvironmentFile= в systemd: переменные окружения для службы
Служба не видит переменные, которые вы задали командой export в терминале или в файле ~/.bashrc. Переменные для неё задают строкой Environment= в файле службы или кладут в отдельный файл и подключают строкой EnvironmentFile=.
Содержание 9
Что сделать прямо сейчас
Пример — служба myapp, которой нужны порт и пароль от базы. Вместо myapp подставьте имя своей службы.
- Подключитесь к серверу по SSH (как подключиться).
- Создайте файл с переменными:
sudo nano /etc/myapp.env. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Впишите переменные — по одной в строке, без слова export и без пробелов вокруг
=:
PORT=3000
NODE_ENV=production
DB_PASSWORD=ваш-пароль- Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X.
- Закройте файл от других пользователей сервера:
sudo chmod 600 /etc/myapp.env. systemd читает этот файл с правами root, поэтому служба получит переменные, даже если работает от другого пользователя. - Подключите файл к службе:
sudo systemctl edit myapp. Откроется редактор nano. Между строками### Anything between here…и### Edits below this comment will be discardedвпишите:
[Service]
EnvironmentFile=/etc/myapp.env- Сохраните и выйдите, как в шаге 4, и перезапустите службу:
sudo systemctl restart myapp. - Проверьте, что файл подключён:
systemctl show myapp -p EnvironmentFiles. В ответе должен быть путь/etc/myapp.env.
Как служба читает переменные, зависит от языка: в Node.js — process.env.PORT, в Python — os.environ["PORT"], в PHP — getenv("PORT").
Environment= — переменные прямо в файле службы
Строку Environment= пишут в разделе [Service]. Строк может быть несколько.
| Строка | Что получит программа |
|---|---|
Environment=PORT=3000 | переменную PORT со значением 3000 |
Environment=PORT=3000 NODE_ENV=production | две переменные из одной строки |
Environment="GREETING=Добрый день" | значение с пробелом: кавычки ставят вокруг всей записи, а не только вокруг значения |
Environment="DISCOUNT=10%%" | значение со знаком %: в файле службы его пишут дважды, программа получит 10% |
Environment= | пустая строка отменяет все строки Environment= выше неё |
Что ещё важно:
- Знак
$здесь ничего не подставляет.Environment=DIR=$HOME/appдаст программе текст$HOME/appкак есть. Пишите путь целиком:Environment=DIR=/home/ivan/app. - Если одна переменная задана дважды, действует нижняя строка.
- Имя переменной — латинские буквы, цифры и знак
_, и оно не может начинаться с цифры.
EnvironmentFile= — переменные в отдельном файле
Отдельный файл удобен, когда переменных много или среди них пароль. Правила файла:
- одна переменная в строке:
ИМЯ=значение; - пустые строки и строки, которые начинаются с
#или;, systemd пропускает — так пишут пояснения; - значение с пробелами можно взять в кавычки:
GREETING="Добрый день"; - файл в кодировке UTF-8.
Путь в строке EnvironmentFile= — полный, от корня /. Минус перед путем, EnvironmentFile=-/etc/myapp.env, значит: если файла нет, запускать службу без него.
systemd читает файл перед каждым запуском службы. Поменяли значение в файле — хватит sudo systemctl restart myapp, daemon-reload для этого не нужен. Если одна переменная есть и в Environment=, и в файле, действует значение из файла.
Если ваша программа сама читает файл .env из своей папки, например через библиотеку dotenv, строка EnvironmentFile= ей не нужна. Нужна правильная рабочая папка — WorkingDirectory=.
Переменная в строке запуска
Переменную можно подставить в строку ExecStart=:
[Service]
Environment=PORT=8000
ExecStart=/home/ivan/app/venv/bin/gunicorn --bind 127.0.0.1:${PORT} app:app${PORT} заменится значением целиком, даже если в нём есть пробелы. Запись $PORT отдельным словом разбивается по пробелам на несколько частей.
Куда положить пароль
Справка systemd предупреждает: переменные окружения не годятся для паролей и ключей. Значения из строк Environment= любой пользователь сервера увидит командой systemctl show. Поэтому:
- не пишите пароль в строку
Environment=; - положите его в файл с правами 600, как в начале страницы.
systemctl showпокажет только путь к файлу, а не его содержимое; - самый закрытый способ —
LoadCredential=. Пароль лежит в своём файле, и служба получает его как файл, а не как переменную:
[Service]
LoadCredential=dbpass:/etc/myapp/dbpassПрограмма читает пароль из файла dbpass в папке, путь к которой лежит в переменной CREDENTIALS_DIRECTORY. Прочитать этот файл может только пользователь службы и root. Этот способ подходит, если программу можно научить читать пароль из файла.
Как проверить
| Что проверить | Команда |
|---|---|
переменные из строк Environment= | systemctl show myapp -p Environment |
| какие файлы с переменными подключены | systemctl show myapp -p EnvironmentFiles |
Что получила запущенная программа:
- Узнайте номер её процесса:
systemctl show myapp -p MainPID --value. - Выведите её переменные. Вместо 12345 — номер из ответа:
sudo cat /proc/12345/environ | tr '\0' '\n'Команда покажет все переменные программы, в том числе пароли, — не пересылайте её вывод и не показывайте экран посторонним.
Ошибки и как их исправить
| Что видите | Что делать |
|---|---|
| программа не видит переменную | проверьте systemctl show myapp -p Environment; после правки файла службы выполните sudo systemctl daemon-reload и sudo systemctl restart myapp |
Failed to load environment files в журнале, служба не запускается | файла из строки EnvironmentFile= нет или путь написан с ошибкой: ls -l /etc/myapp.env; проверьте, что путь начинается с / |
вместо значения программа получила $HOME/app | $ в Environment= не работает — пишите значение целиком |
| пропал знак % | в строке Environment= пишите %% |
| служба не запускается после правки | Job for … failed — как найти причину |
Источники
- Справка systemd.exec(5) в Ubuntu 24.04 — на английском: Environment=, EnvironmentFile= и формат файла, порядок источников переменных, предупреждение о паролях, LoadCredential=.
- Справка systemd.service(5) в Ubuntu 24.04 — на английском: подстановка ${FOO} и $FOO в ExecStart=.
- Список подстановок с % в systemd 255 — на английском: %% вместо одного знака %.
- Справка systemctl(1) в Ubuntu 24.04 — на английском: команды show и edit.
- Исходный код systemd 255: execute.c — строка Failed to load environment files.
Справка сверена с systemd 255 — эта версия стоит в Ubuntu 24.04.
Сверено 23 октября 2026 года.
Что почитать дальше
- Как создать службу systemdшаблон файла службы.
- systemctl editкак дополнить службу из пакета.
- User= и WorkingDirectory=от чьего имени и в какой папке работает служба.
- Настройки systemdвсе настройки служб.