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

Environment= и EnvironmentFile= в systemd: переменные окружения для службы

Служба не видит переменные, которые вы задали командой export в терминале или в файле ~/.bashrc. Переменные для неё задают строкой Environment= в файле службы или кладут в отдельный файл и подключают строкой EnvironmentFile=.

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

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

Пример — служба myapp, которой нужны порт и пароль от базы. Вместо myapp подставьте имя своей службы.

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Создайте файл с переменными: sudo nano /etc/myapp.env. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
  3. Впишите переменные — по одной в строке, без слова export и без пробелов вокруг =:
PORT=3000
NODE_ENV=production
DB_PASSWORD=ваш-пароль
  1. Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X.
  2. Закройте файл от других пользователей сервера: sudo chmod 600 /etc/myapp.env. systemd читает этот файл с правами root, поэтому служба получит переменные, даже если работает от другого пользователя.
  3. Подключите файл к службе: sudo systemctl edit myapp. Откроется редактор nano. Между строками ### Anything between here… и ### Edits below this comment will be discarded впишите:
[Service]
EnvironmentFile=/etc/myapp.env
  1. Сохраните и выйдите, как в шаге 4, и перезапустите службу: sudo systemctl restart myapp.
  2. Проверьте, что файл подключён: 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

Что получила запущенная программа:

  1. Узнайте номер её процесса: systemctl show myapp -p MainPID --value.
  2. Выведите её переменные. Вместо 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 255 — эта версия стоит в Ubuntu 24.04.

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

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

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