Systemd-Service-Datei-Generator
Gib Befehl, Benutzer und Neustart-Richtlinie ein und erhalte eine einsatzbereite systemd-Unit-Datei mit Installationsbefehlen zum Kopieren. Optionen für Umgebungsvariablen, Startreihenfolge, Ressourcenlimits und Sandboxing sind enthalten, und typische Fehler wie relative Pfade oder Shell-Syntax in ExecStart werden markiert.
Zuletzt aktualisiert:
Erzeugte Unit-Datei
Anleitung: Systemd-Service-Datei-Generator
- Wähle ein Beispiel, das deinem Programm ähnelt, und klicke auf Beispiel laden, oder bearbeite direkt die Standard-Unit für Node.js.
- Gib Unit-Name, Beschreibung und den ExecStart-Befehl mit absolutem Pfad ein, dazu das Arbeitsverzeichnis und den Benutzer, der ihn ausführen soll.
- Wähle die Neustart-Richtlinie und füge die Units hinzu, nach denen gestartet werden soll, sowie Umgebungsvariablen und Log-Namen.
- Wende eine Härtung an mit dem Preset Basis oder Streng und passe dann einzelne Optionen an.
- Kopiere die Unit-Datei oder öffne Installationsbefehle, füge sie in ein Terminal ein und prüfe den Service mit
systemctl status.
Aufbau einer Unit-Datei
Eine Service-Unit ist eine einfache Textdatei mit drei Abschnitten. Direktiven unterscheiden Groß- und Kleinschreibung, und jede gehört zu einem Abschnitt:
| Abschnitt | Direktive | Was sie bewirkt |
|---|---|---|
[Unit] | Description= | Lesbarer Name, der von systemctl status angezeigt wird. |
After= / Wants= | Startreihenfolge und schwache Abhängigkeit. After allein zieht keine Unit nach. | |
Requires= | Starke Abhängigkeit: Wenn die benötigte Unit stoppt, stoppt auch diese. | |
StartLimitIntervalSec=, StartLimitBurst= | Nach zu vielen Neustarts in einem Zeitfenster aufgeben. | |
[Service] | Type= | Woran systemd erkennt, dass der Service gestartet ist (simple, exec, forking, notify, oneshot, idle). |
ExecStart= | Der auszuführende Befehl. Keine Shell: keine Pipes oder Umleitungen. | |
User= / Group= | Konto, unter dem der Prozess läuft (root, wenn bei System-Services weggelassen). | |
WorkingDirectory= | Aktuelles Verzeichnis des Prozesses. | |
Restart= / RestartSec= | Wann automatisch neu gestartet wird und wie lange vorher gewartet wird (Standard 100 ms). | |
Environment= / EnvironmentFile= | Variablen für den Prozess; ein vorangestelltes - beim Dateipfad macht die Datei optional. | |
[Install] | WantedBy= | Ziel, das den Service beim Aktivieren nachzieht, meist multi-user.target. |
Alltägliche systemctl- und journalctl-Befehle
| Befehl | Zweck |
|---|---|
sudo systemctl daemon-reload | Unit-Dateien nach dem Anlegen oder Bearbeiten neu laden. |
sudo systemctl enable --now app | Beim Booten starten und sofort starten. |
sudo systemctl restart app / reload app | Prozess neu starten oder ExecReload ausführen (Konfiguration ohne Ausfallzeit neu laden). |
systemctl status app | Zustand, Haupt-PID, Speicher und die letzten Logzeilen. |
journalctl -u app -f | Dem Service-Log live folgen; füge --since "1 hour ago" zum Filtern hinzu. |
sudo systemctl edit app | Ein Drop-in-Override anlegen, statt die Originaldatei zu ändern. |
systemd-analyze verify app.service | Eine Unit-Datei auf unbekannte Direktiven und fehlende Dateien prüfen. |
systemd-analyze security app | Den Exposure-Score des Sandboxings anzeigen und welche Optionen ihn verbessern würden. |
Tipps
- Sonderzeichen maskieren. In Unit-Dateien leitet
%einen Platzhalter ein (zum Beispiel ist%nder Unit-Name), schreibe also%%für ein echtes Prozentzeichen.$VARund${VAR}in ExecStart werden aus Environment ersetzt, und$$ist ein echtes Dollarzeichen. - Auf stdout loggen. Alles, was das Programm ausgibt, landet automatisch im Journal; Logdateien sind nur nötig, wenn du sie willst.
- Schrittweise härten. Beginne mit Basis, starte den Service neu und prüfe seine Logs, dann probier Streng. Wenn die App irgendwo schreiben muss, füge diesen Ordner zu
ReadWritePathshinzu. - Auf systemd-Hosts Timer statt cron bevorzugen. Ein oneshot-Service plus eine
.timer-Unit bekommt Logging, Abhängigkeiten und das Nachholen verpasster Läufe gratis.
Häufige Fragen
Wo lege ich eine systemd-Service-Datei ab?
Selbst erstellte System-Services gehören nach /etc/systemd/system/name.service. Benutzer-Services gehören nach ~/.config/systemd/user/name.service. Führe nach dem Hinzufügen oder Ändern einer Datei systemctl daemon-reload (oder systemctl --user daemon-reload) aus, damit systemd sie einliest.
Wie starte ich einen Service beim Booten?
Der Abschnitt [Install] mit WantedBy=multi-user.target teilt systemd mit, wo der Service eingehängt wird. Führe sudo systemctl enable --now name.service aus, um diese Verknüpfung anzulegen und ihn sofort zu starten. Benutzer-Services verwenden WantedBy=default.target, und loginctl enable-linger hält sie am Laufen, wenn du abgemeldet bist.
Was ist der Unterschied zwischen Restart=always und Restart=on-failure?
on-failure startet den Service nur neu, wenn er mit einem Code ungleich null endet, durch ein Signal beendet wird, in ein Timeout läuft oder den Watchdog auslöst. always startet ihn auch nach einem sauberen Ende neu. Keine der beiden Optionen startet einen Service neu, den du mit systemctl stop anhältst. Wenn Neustarts häufiger als StartLimitBurst-mal innerhalb von StartLimitIntervalSec passieren (standardmäßig 5 in 10 Sekunden), gibt systemd auf.
Warum schlägt mein ExecStart-Befehl fehl, obwohl er im Terminal funktioniert?
systemd führt den Befehl direkt aus, ohne Shell und ohne deine Login-Umgebung. Verwende absolute Pfade, vermeide Pipes, Umleitungen, && und ~, setze WorkingDirectory und Environment explizit oder verpacke den Befehl in /bin/sh -c '...'. Sieh mit journalctl -u name.service nach dem genauen Fehler.
Welchen Type sollte ich wählen?
Verwende simple (oder exec) für Programme, die im Vordergrund bleiben – das deckt die meisten modernen Apps ab. Verwende forking nur für alte Daemons, die sich in den Hintergrund forken, idealerweise mit PIDFile. notify ist für Programme, die sd_notify aufrufen, sobald sie bereit sind, und oneshot für Skripte, die einmal laufen und sich beenden, oft mit RemainAfterExit=yes.
Wie übergebe ich Umgebungsvariablen oder Geheimnisse?
Nutze Environment=KEY=value-Zeilen (setze die ganze Zuweisung in Anführungszeichen, wenn der Wert Leerzeichen enthält) für normale Einstellungen. Für Passwörter und Tokens nutze EnvironmentFile=/etc/name/env mit Rechten 600, denn Unit-Dateien sind für jeden Benutzer des Systems lesbar.
Was bewirken die Härtungsoptionen?
Sie sperren den Service in eine Sandbox: NoNewPrivileges verhindert Rechteausweitung, PrivateTmp gibt ihm ein eigenes /tmp, ProtectSystem und ProtectHome machen Systemordner schreibgeschützt oder unsichtbar, und die Protect-/Restrict-Optionen blockieren Kernel-Tuning, das Laden von Modulen und ähnliche Aktionen. Führe systemd-analyze security name.service aus, um einen Exposure-Score zu sehen, und teste den Service nach jeder Änderung.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.