systemctl edit: как изменить настройки службы и не потерять их при обновлении
Команда sudo systemctl edit имя создаёт файл-дополнение override.conf. В нём пишут только те строки, которые хотят поменять. Главный файл службы остаётся как был, поэтому обновление пакета вашу правку не сотрёт.
Содержание 10
Что сделать прямо сейчас
Пример — включить автоперезапуск у службы myapp. Вместо myapp подставьте имя своей службы, например nginx.
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите, как настроена служба сейчас:
systemctl cat myapp. Выйти — клавиша Q. - Откройте дополнение:
sudo systemctl edit myapp. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Откроется редактор — в Ubuntu это nano. Первая строка показывает, какой файл вы правите:
### Editing /etc/systemd/system/myapp.service.d/override.conf. - Между строками
### Anything between here…и### Edits below this comment will be discardedвпишите раздел и строки, которые хотите поменять:
[Service]
Restart=on-failure
RestartSec=5- Сохраните — Ctrl+O и Enter, выйдите — Ctrl+X. systemctl сам перечитает настройки,
daemon-reloadвыполнять не нужно. - Перезапустите службу, чтобы настройки заработали:
sudo systemctl restart myapp. - Проверьте:
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 myapprevert удаляет папку 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 | службу запретили запускать — как снять запрет |
Источники
- Справка systemctl(1) в Ubuntu 24.04 — на английском: edit и флаги --full, --drop-in=, --runtime, --force; revert; cat.
- Справка systemd.unit(5) в Ubuntu 24.04 — на английском: папки дополнений, порядок чтения, сброс списков пустой строкой, зависимости в дополнениях.
- Исходный код systemd 255: edit-util.c — что редактор показывает при systemctl edit.
- Исходный код systemd 255: systemctl-enable.c — revert сам перечитывает настройки.
- Исходный код systemd 255: service.c — сообщение о нескольких строках ExecStart=.
- Исходный код systemd 255: conf-parser.c — сообщение о строке в чужом разделе.
Справка сверена с systemd 255 — эта версия стоит в Ubuntu 24.04.
Сверено 23 октября 2026 года.
Что почитать дальше
- Restart=автоперезапуск службы после сбоя.
- Environment=переменные окружения для службы.
- Команда systemctlзапуск, остановка, статус.
- Настройки systemdвсе настройки служб.