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

systemctl edit: как изменить настройки службы и не потерять их при обновлении

Команда sudo systemctl edit имя создаёт файл-дополнение override.conf. В нём пишут только те строки, которые хотят поменять. Главный файл службы остаётся как был, поэтому обновление пакета вашу правку не сотрёт.

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

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

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите, как настроена служба сейчас: systemctl cat myapp. Выйти — клавиша Q.
  3. Откройте дополнение: sudo systemctl edit myapp. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
  4. Откроется редактор — в Ubuntu это nano. Первая строка показывает, какой файл вы правите: ### Editing /etc/systemd/system/myapp.service.d/override.conf.
  5. Между строками ### Anything between here… и ### Edits below this comment will be discarded впишите раздел и строки, которые хотите поменять:
[Service]
Restart=on-failure
RestartSec=5
  1. Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X. systemctl сам перечитает настройки, daemon-reload выполнять не нужно.
  2. Перезапустите службу, чтобы настройки заработали: sudo systemctl restart myapp.
  3. Проверьте: systemctl cat myapp. В конце появится файл /etc/systemd/system/myapp.service.d/override.conf с вашими строками.

Ниже строки ### Edits below this comment will be discarded редактор показывает настройки службы для справки. Что написать там, не сохранится. Если между строками ничего не вписать, systemctl ничего не создаст.

Почему не править главный файл

Службы из пакетов — nginx, mysql, php8.3-fpm и другие — лежат в папке /usr/lib/systemd/system. Обновление пакета перезапишет такой файл, и ваша правка пропадёт.

Дополнение лежит в /etc/systemd/system/имя.service.d/. systemd читает его после главного файла, и строки из дополнения перекрывают строки главного. Обновление пакета этот файл не трогает. Подробнее о папках — на странице Настройки systemd.

Что писать в дополнении

Что нужноЧто написать
поменять одну настройкураздел и строку с новым значением, например [Service] и Restart=on-failure
заменить команду запускасначала пустую строку ExecStart=, под ней новую — пример ниже
добавить переменную окружения[Service] и Environment=PORT=4000 — она добавится к переменным из главного файла (Environment=)
добавить зависимость[Unit] и After= или Wants= — она добавится к зависимостям из главного файла (After= и Wants=)
убрать зависимостьв дополнении это сделать нельзя — нужна полная копия файла, флаг --full

Каждую строку пишите под своим разделом: Restart= — под [Service], After= — под [Unit]. Если строка окажется не в том разделе, systemd её пропустит и запишет в журнал Unknown key name 'Restart' in section 'Unit', ignoring.

Как заменить ExecStart=

Строку ExecStart= нельзя просто написать заново: systemd добавит её к строке из главного файла, и у службы окажется две команды запуска. Сначала сбросьте старую пустой строкой:

[Service]
ExecStart=
ExecStart=/usr/bin/node /home/ivan/app/server.js --port 4000

Если пустую строку забыть, служба не запустится, а в журнале будет Service has more than one ExecStart= setting, which is only allowed for Type=oneshot services. Refusing.

Так же, пустой строкой, сбрасывают другие настройки-списки: ExecStartPre=, Environment=, EnvironmentFile=.

Флаги systemctl edit

КомандаЧто делает
sudo systemctl edit myappсоздаёт или открывает дополнение override.conf
sudo systemctl edit --drop-in=limits myappсоздаёт дополнение с другим именем — limits.conf вместо override.conf
sudo systemctl edit --full myappоткрывает копию всего файла службы, которая ляжет в /etc/systemd/system/myapp.service и заменит главный файл
sudo systemctl edit --runtime myappкладёт дополнение в /run: после перезагрузки сервера оно пропадёт
sudo systemctl edit --force --full myapp.serviceсоздаёт новую службу, если её ещё нет

С --full вы берёте файл службы на себя: когда пакет обновит свой файл, изменения к вам не придут. Поэтому для служб из пакетов лучше дополнение. Если дополнений несколько, systemd читает их по алфавиту имён.

Новую службу удобнее создать по шаблону — Как создать службу systemd.

Как отменить правку

sudo systemctl revert myapp
sudo systemctl restart myapp

revert удаляет папку myapp.service.d с дополнениями из /etc/systemd/system и /run/systemd/system. Если главный файл пришёл из пакета, revert удаляет и вашу полную копию из /etc/systemd/system, а ещё снимает запрет запуска, который ставит systemctl mask. После этого systemctl сам перечитывает настройки, остаётся перезапустить службу.

Если служба своя и её файл есть только в /etc/systemd/system, сам файл revert не удалит — уберутся только дополнения.

Как проверить

Что проверитьКоманда
все файлы службы и что в нихsystemctl cat myapp
какие дополнения подключеныsystemctl show myapp -p DropInPaths
какое значение действует сейчасsystemctl show myapp -p Restart — вместо Restart любая настройка

systemctl cat показывает файлы на диске. Если вы поправили файл вручную и не выполнили sudo systemctl daemon-reload, systemd ещё работает со старыми настройками.

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

Что видитеЧто делать
Service has more than one ExecStart= setting…добавьте пустую строку ExecStart= перед новой
Unknown key name '…' in section '…', ignoring.перенесите строку в нужный раздел или проверьте, нет ли опечатки в имени
правка не действуетперезапустите службу: sudo systemctl restart myapp; проверьте systemctl show myapp -p DropInPaths
Warning: The unit file, source configuration file or drop-ins of … changed on diskфайл правили вручную — выполните daemon-reload
Unit … is maskedслужбу запретили запускать — как снять запрет

Источники

Справка сверена с systemd 255 — эта версия стоит в Ubuntu 24.04.

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

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

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