Различия

Показаны различия между двумя версиями страницы.

--- flip:linux:systemd [2025/03/26 19:06] – flip
+++ flip:linux:systemd [2025/03/31 15:17] (текущий) – flip
@@ Строка 5: / Строка 5: @@
 Каталог с конфигурациями: ''/etc/systemd/system/'' \\
 Пример: ''myservice.service''
+===== Проверить синтаксис =====
+<code>
+systemd-analyze verify /etc/systemd/system/myservice.service
+</code>
@@ Строка 20: / Строка 27: @@
 </code>
-Отключить
+==== Отключить ====
 <code>
@@ Строка 27: / Строка 35: @@
-===== Параметры =====
+===== Настройка =====
-==== Тело конфигурации ====
+==== Основные параметры [Unit] ====
-----
+(Общие для всех типов unit-файлов)
-**[Unit]** \\
+<code>
-**Description** – описание юнита для большего понимания \\
+[Unit]
-**Documentation** – документация по процессу sshd \\
+Description=Описание сервиса
-**After** – зависимость, т.е. в данном случае запускать юнит только после запуска network.target и sshd-keygen.target \\
+Documentation=URL или man-страница
-**Requires**=nginx.service - для запуска службы обязательно необходим сервис ngnix (указать любой другой) \\
+After=network.target           # Запускать после этих юнитов
-**Wants** – еще одна зависимость, означает желательно. В примере Wants=sshd-keygen.target, т.е. желательно чтобы было запущено sshd-keygen.target . Желательно но не обязательно.
+Before=some.target             # Запускать перед этими юнитами
+Requires=postgresql.service    # Жёсткая зависимость (если postgresql не запустится, этот сервис тоже не запустится)
+Wants=redis.service            # Мягкая зависимость (сервис попытается запустить redis, но не зависит от его успеха)
+Conflicts=old_service.service  # Сервис не может работать одновременно с old_service
+</code>
-**[Service]** \\
-**Type** – типы запуска служб \\
-**User** - от имени какого пользователя выполняется сервис \\
-**Group** - группа, от которой выполнять сервис \\
-**WorkingDirectory** - рабочая директория службы \\
-**EnvironmentFile** – файлы переменного окружения \\
-**ExecStart** – полный путь к исполняемому файлу программы с параметрами запуска \\
-**ExecReload** – полный пусть к исполняемому файлу программы с параметрами перезапуска программы \\
-**KillMode** – указывается как будет завершен процесс. В данному случае параметр process говорит о том что будет закрыт только главный процесс \\
-**Restart** – перезагрузка процесса, параметр on-failure указывает на автоматическую перезагрузку в случает отказа процесса \\
-**RestartSec** – время ожидания через которое процесс должен перезагрузиться \\
-**TimeoutSec**=200 - время, сколько ждать перед запуском/остановкой сервиса \\
-**OOMScoreAdjust**=-100 - запрет на отключение сервиса, в случае нехватки памяти
-**[Install]** \\
+==== Параметры [Service] ====
-**WantedBy** – указывает на каком урове запуска стартует сервис, параметр multi-user.target указывает на запуск в многопользовательском режиме без графики
-----
+(Специфичные для сервисов)
-==== Типы запуска служб ====
+=== Тип сервиса ===
-  * **simple** (по умолчанию) – происходит незамедлительный запуск этой службы, с учетом того что процесс не разветвляется (fork). Не используйте simple если пользуетесь очередностью запуска. Одно исключение это активация сокета.
+<code>
-  * **forking** – служба считается запущенной после того, после разветвления процесса с завершением родительского процесса. Используется для запуска классических демонов исключая случаи, когда в таком поведении процесса нет необходимости. Также желательно указать PIDFile=, чтобы systemd мог отслеживать основной процесс.
+Type=simple           # Простой запуск (по умолчанию). systemd считает сервис активным сразу после fork.
-  * **oneshot** – удобен для скриптов, которые выполняют одно задание и завершаются. При необходимости можно задать параметр RemainAfterExit=yes, чтобы systemd считал процесс активным даже после его завершения.
+Type=forking          # Для демонов, которые сами форкаются (нужен PIDFile=)
-  * **notify** – идентичен параметру simple, но с оговоркой, что демон пошлет systemd сигнал о своей готовности. Эталонная реализация данного уведомления представлена в libsystemd-daemon.so.
+Type=oneshot          # Для скриптов, которые завершаются (с Optional ExecStop=)
-  * **dbus** – служба считается находящейся в состоянии готовности, когда указанный параметр BusName появляется в системной шине DBus.
+Type=notify           # Сервис уведомит systemd о готовности (через sd_notify)
-  * **idle** – откладывается выполнение двоичного файла службы до момента выполнения всех остальных задач. В остальном поведение аналогично simple.
+Type=idle             # Запустится, когда система простаивает
+Type=dbus             # Активируется при появлении D-Bus имени
+Type=exec             # Как simple, но ждёт завершения ExecStart= перед запуском других юнитов
+</code>
+=== Команды ===
-==== Ключи времени ====
+<code>
+ExecStart=/path/to/bin arg1 arg2  # Основная команда
+ExecStartPre=/bin/pre-script.sh   # Подготовка перед ExecStart
+ExecStartPost=/bin/after-start.sh # Действия после успешного старта
+ExecReload=/bin/reload-script     # Команда для systemctl reload
+ExecStop=/bin/cleanup.sh          # Команда для остановки
+ExecStopPost=/bin/after-stop.sh   # Действия после остановки
+</code>
-  * **Wants** - Ожидает
+=== Управление процессом ===
-  * **Requires** - Требует
-  * **Before** - Перед
-  * **After** - После
-  * **WantedBy** - Ожидается цель/служба
-  * **RequiresBy** - Требуется цель/служба
+<code>
+User=nobody                       # От имени какого пользователя запускать
+Group=nogroup                     # Группа процесса
+WorkingDirectory=/path/to/dir     # Рабочая директория
+Environment="VAR1=value"          # Переменные окружения
+EnvironmentFile=/etc/conf.d/myenv # Файл с переменными (как source в bash)
+PIDFile=/run/service.pid          # Для Type=forking (указывает на файл с PID)
+UMask=0022                        # Маска прав для файлов
+Nice=-10                          # Приоритет процесса (от -20 до 19)
+OOMScoreAdjust=-500               # Защита от OOM-killer (меньше – реже убивается)
+</code>
-==== Параметры перезапуска службы ====
+=== Рестарт и таймауты ===
-  * **no** - никогда
+<code>
-  * **always** - всегда
+Restart=no              # Не перезапускать (по умолчанию)
-  * **on-success** - успешно
+Restart=on-success      # Только при успешном завершении (код 0)
-  * **on-failure** - не успешно
+Restart=on-failure      # При ошибке (ненулевой код или сигнал)
-  * **on-abnormal** - не нормальный
+Restart=on-abnormal     # При нестандартном завершении (сигнал)
-  * **on-abort** - при прирывании
+Restart=on-watchdog     # При зависании (по watchdog)
-  * **on-watchdog** - Сторожевой таймер (Watchdog timer) — аппаратно реализованная схема контроля над зависанием системы. Представляет собой таймер, который периодически сбрасывается контролируемой системой. Если сброса не произошло в течение некоторого интервала времени, происходит принудительная перезагрузка системы.
+Restart=always          # Перезапускать всегда, даже при ручном stop
+RestartSec=5s           # Пауза перед рестартом (по умолчанию 100ms)
+TimeoutStartSec=30s     # Максимальное время запуска
+TimeoutStopSec=10s      # Максимальное время остановки
+TimeoutSec=30s          # Общий таймаут для старта/останова
+RuntimeMaxSec=1h        # Максимальное время работы сервиса
+</code>
-^ Restart settings/Exit causes ^ no ^ always ^ on-success ^ on-failure ^ on-abnormal ^ on-abort ^ on-watchdog ^
+=== Лимиты ===
-| Clean exit code or signal \\ Корректый код выхода или сигнал |  | X | X |  |  |  |  |
-| Unclean exit code \\ Неккоректный код выхода	 |  | X |  | X |  |  |  |
-| Unclean signal \\ Некорректный сигнал |  | X |  | X | X | X |  |
-| Timeout |  | X |  | X | X |  |  |
-| Watchdog \\ Сторожевой таймер |  | X |  | X | X |  | X |
+<code>
+LimitNOFILE=65536       # Макс. число открытых файлов
+LimitNPROC=512          # Макс. число процессов
+LimitCORE=infinity      # Макс. размер core-файла
+MemoryLimit=2G          # Лимит оперативной памяти
+CPUQuota=150%           # Лимит CPU (может быть >100% для многопоточности)
+</code>
-==== Список целей ====
+=== Дополнительно ===
-  * **default.target** - модуль по-умолчанию
+<code>
-  * **graphical.target** - запуск графической подсистемы
+StandardOutput=journal  # Куда писать stdout (journal, syslog, file:/path)
-  * **multi-user.target** - запуск консоли
+StandardError=inherit   # Куда писать stderr (inherit – как stdout)
-  * **network-online.target** - ожидание подключенной сети (используется в Wants)
+SyslogIdentifier=myapp  # Метка в журнале (по умолчанию – имя сервиса)
-  * **network.target** - сеть
+KillMode=process        # Что убивать при остановке (process, mixed, control-group)
-  * **network-pre.target** - запуск до настройки сети (используется в Requires)
+RemainAfterExit=yes     # Считать сервис активным после завершения (для oneshot)
-  * **boot-complete.target** - успешная загрузка
+SuccessExitStatus=143   # Какие коды считать успешными (помимо 0)
+</code>
+==== Секция [Install] ====
+(Для ''systemctl enable'')
+<code>
+[Install]
+WantedBy=multi-user.target  # В какой target добавить сервис
+Alias=myservice.alias       # Альтернативное имя для сервиса
+RequiredBy=other.target     # Обратная зависимость
+Also=other.service          # Дополнительные юниты для включения/выключения
+</code>
@@ Строка 132: / Строка 169: @@
 # здесь используется ключи времени с указанием цели или другой службы
 WantedBy=graphical.target
+</code>
+===== Создание пользовательской службы =====
+  * Пользовательские сервисы работают с ключом ''<nowiki>--user</nowiki>''
+  * Они выполняются с правами текущего пользователя
+  * Для некоторых операций (например, работы с сетью) могут потребоваться дополнительные разрешения
+  * Логи можно просматривать через ''<nowiki>journalctl --user -u myservice.service</nowiki>''
+==== Создание структуры каталогов ====
+Сначала создайте необходимые каталоги в вашей домашней директории
+<code>
+mkdir -p ~/.config/systemd/user/
+</code>
+==== Создание unit-файла ====
+Создайте файл сервиса в этом каталоге, например ''myservice.service''
+<code>
+nano ~/.config/systemd/user/myservice.service
+</code>
+==== Активация пользовательского менеджера systemd ====
+Перед использованием убедитесь, что пользовательский менеджер systemd запущен
+<code>
+systemctl --user enable --now dbus.service
+</code>
+==== Управление сервисом ====
+<code>
+# Перечитать конфигурации
+systemctl --user daemon-reload
+# Включить автозагрузку сервиса
+systemctl --user enable myservice.service
+# Запустить сервис
+systemctl --user start myservice.service
+# Проверить статус
+systemctl --user status myservice.service
+# Остановить сервис
+systemctl --user stop myservice.service
+# Отключить автозагрузку
+systemctl --user disable myservice.service
+</code>
+==== Автозапуск при входе пользователя ====
+По умолчанию пользовательские сервисы не запускаются при загрузке системы, а только при входе пользователя.
+Для включения постоянной работы
+<code>
+sudo loginctl enable-linger username
 </code>