# DNS-Neustart aus Home Assistant Container Ziel: `Madzone@192.168.1.230`, SSH-Port 22. Neustart ausschließlich des Synology-Pakets `DNSServer`. Docker-Container: **`HomeAssistant`** (Groß-/Kleinschreibung beachten). ## Geräte und Orte | Ort | Erkennbarer Prompt | Verwendung | | --- | --- | --- | | Docker-Host | `root@Docker:~#` | Container finden, öffnen und neu starten | | HA-Container `HomeAssistant` | `/config #` | SSH-Schlüssel, bekannte Server und HA-Konfiguration | | Synology DS1817+, DSM 7.3.2 | `Madzone@NEW-SYNO:~$` | Gateway, sudo-Regel und öffentlicher Schlüssel | Die Prompt-Zeichen und die bei mehrzeiligen Eingaben angezeigten `>` nicht mitkopieren. Ein alleinstehendes `EOF` beendet den jeweiligen Dateiblock. `exit` verlässt die Container-Shell und führt zum Docker-Host zurück. ## Bereits bestätigter Stand - Gateway-Skript auf DSM installiert, Syntax geprüft; `/usr/local/sbin` und Skript haben Rechte `755`, Eigentümer root. - DSM bindet `/etc/sudoers.d` ein; `visudo` ist nicht vorhanden. Die separate Regel wurde eingerichtet. - Server-Fingerprints auf DSM und im HA-Container stimmen überein. - `check-dns` aus dem HA-Container war erfolgreich, ohne DNS neu zu starten. - HA-Konfigurationsprüfung zeigte nur `Testing configuration at /config`, keine Fehlermeldung. - Ein tatsächlicher DNS-Neustart über den HA-Button wurde im Gespräch noch nicht bestätigt. Für die laufende Einrichtung bei **Schritt 6** fortfahren. Die vorigen Schritte dokumentieren die vollständige Einrichtung und müssen nicht wiederholt werden. Eine erfolgreiche HA-Konfigurationsprüfung allein bestätigt noch nicht, dass das Package geladen wurde. ## 1. Schlüssel im Home-Assistant-Container erstellen Auf dem Docker-Host wurde zuerst der tatsächliche Containername ermittelt: ```sh sudo docker ps --format 'table {{.Names}}\t{{.Image}}' ``` Relevante Ausgabe: ```text NAMES IMAGE HomeAssistant homeassistant/home-assistant:latest ``` Auf deinem Docker-Host (`root@Docker`) den vorhandenen Container öffnen: ```sh docker exec -it HomeAssistant sh ``` Ab jetzt im Container: ```sh command -v ssh command -v ssh-keygen command -v ssh-keyscan mkdir -p /config/ssh chmod 700 /config/ssh ``` Bestätigte Programmpfade: `/usr/bin/ssh`, `/usr/bin/ssh-keygen` und `/usr/bin/ssh-keyscan`. Falls eines der Programme fehlt, hier stoppen; dann muss das Container-Image passend erweitert werden. Keine nur vorübergehende Installation im laufenden Container. Einen neuen, ausschließlich dafür verwendeten Schlüssel erzeugen. Vorhandene Datei nicht überschreiben: ```sh if [ -e /config/ssh/synology_dns_ed25519 ]; then echo 'Schlüssel existiert bereits – wird beibehalten.' else ssh-keygen -t ed25519 -N '' -f /config/ssh/synology_dns_ed25519 -C ha-dns-only fi chmod 600 /config/ssh/synology_dns_ed25519 cat /config/ssh/synology_dns_ed25519.pub ``` Bei dir wurde **„Schlüssel existiert bereits – wird beibehalten.“** ausgegeben. Es wurde kein neuer Schlüssel erzeugt. Dein öffentlicher Schlüssel lautet: ```text ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIDK2Cxy/jmphN3gOaLssWnnhh9hUtCnwblGrUxDwS5ZE ha-dns-only ``` Nur die ausgegebene öffentliche Zeile wird auf DSM benötigt. Der private Schlüssel bleibt in `/config/ssh`; dieser Ordner muss im persistenten HA-Konfigurationsvolume liegen. ## 2. Auf DSM Paket und Rechte vorbereiten Separat als `Madzone` auf DSM anmelden: ```sh ssh Madzone@192.168.1.230 id ls -l /usr/syno/bin/synopkg ls -ld /var/packages/DNSServer ``` `Madzone` muss Administratorrechte besitzen. Wenn Paket oder Programm nicht vorhanden sind, nicht fortfahren. Das Gateway direkt auf DSM erstellen; eine lokale Datei auf deinem Computer liegt nicht automatisch im NAS-Home-Verzeichnis: ```sh cat > "$HOME/ha-dns-gateway.sh" <<'EOF' #!/bin/sh # Install on DSM as root-owned /usr/local/sbin/ha-dns-gateway.sh. # Only used as the forced command of the dedicated Home Assistant SSH key. set -eu case "${SSH_ORIGINAL_COMMAND:-}" in check-dns) test -x /usr/syno/bin/synopkg test -d /var/packages/DNSServer sudo -n -l /usr/syno/bin/synopkg restart DNSServer >/dev/null printf '%s\n' 'DNS-Paket und sudo-Regel vorhanden. Kein Neustart ausgeführt.' ;; restart-dns) test -x /usr/syno/bin/synopkg test -d /var/packages/DNSServer exec sudo -n /usr/syno/bin/synopkg restart DNSServer ;; *) printf '%s\n' 'Nur check-dns oder restart-dns ist erlaubt.' >&2 exit 64 ;; esac EOF sudo mkdir -p /usr/local/sbin sudo cp "$HOME/ha-dns-gateway.sh" /usr/local/sbin/ha-dns-gateway.sh sudo chown root:root /usr/local/sbin/ha-dns-gateway.sh sudo chmod 755 /usr/local/sbin/ha-dns-gateway.sh sudo sh -n /usr/local/sbin/ha-dns-gateway.sh sudo ls -ld /usr /usr/local /usr/local/sbin ``` Auf deinem NAS wurde `/usr/local/sbin` mit `700` angelegt. Deshalb konnte Madzone das Skript trotz dessen `755`-Rechten nicht erreichen. Für dieses neu angelegte Verzeichnis wurde korrigiert: ```sh sudo chmod 755 /usr/local/sbin ls -l /usr/local/sbin/ha-dns-gateway.sh ``` Nicht rekursiv Rechte ändern. Das Verzeichnis und Skript bleiben nur für root schreibbar. ### Separate sudo-Regel ohne visudo Auf deiner DSM ist `visudo` nicht vorhanden. Die Einbindung wurde geprüft: ```sh sudo grep -nE '^[[:space:]]*([#@]include)' /etc/sudoers sudo ls -ld /etc/sudoers.d ``` Bestätigte Ausgabe: `19:#includedir /etc/sudoers.d`. Das `#includedir` ist eine aktive sudo-Direktive, kein gewöhnlicher Kommentar. Folgender Block legt nur die zusätzliche Regel an und überschreibt keine vorhandene Datei. `/etc/sudoers` bleibt unverändert: ```sh sudo sh -c ' set -eu target=/etc/sudoers.d/ha-dns if [ -e "$target" ]; then echo "Datei existiert bereits – nichts geändert." exit 1 fi umask 077 printf "%s\n" \ "Madzone ALL=(root) NOPASSWD: /usr/syno/bin/synopkg restart DNSServer" \ > "$target" chown root:root "$target" chmod 440 "$target" ' ``` Bei bereits vorhandener Datei den Inhalt mit `sudo cat /etc/sudoers.d/ha-dns` prüfen, nicht erneut anhängen. Anschließend als Madzone testen: ```sh SSH_ORIGINAL_COMMAND=check-dns /usr/local/sbin/ha-dns-gateway.sh ``` Erwartet: `DNS-Paket und sudo-Regel vorhanden. Kein Neustart ausgeführt.` Dieser Check prüft die sudo-Regel, führt aber den privilegierten Neustart nicht aus. Er ersetzt keine vollständige Prüfung aller sudo-Regeln durch `visudo`. ## 3. Öffentlichen Schlüssel auf einen festen Befehl beschränken Weiterhin in der DSM-Sitzung von Madzone: ```sh mkdir -p "$HOME/.ssh" chmod 700 "$HOME/.ssh" touch "$HOME/.ssh/authorized_keys" chmod 600 "$HOME/.ssh/authorized_keys" ``` Für deinen vorhandenen Schlüssel wurde folgender Eintrag vorbereitet. Auf DSM als Madzone ausführen, wenn dieser Schlüssel noch nicht eingetragen ist. Bei einem Treffer wird nichts angehängt; den vorhandenen Eintrag auf dieselben Einschränkungen prüfen: ```sh if grep -qF 'AAAAC3NzaC1lZDI1NTE5AAAAIDK2Cxy/jmphN3gOaLssWnnhh9hUtCnwblGrUxDwS5ZE' "$HOME/.ssh/authorized_keys"; then echo "Schlüssel bereits vorhanden – Eintrag vor Änderungen prüfen." else printf '\n%s\n' 'command="/usr/local/sbin/ha-dns-gateway.sh",no-port-forwarding,no-agent-forwarding,no-X11-forwarding,no-pty,no-user-rc ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIDK2Cxy/jmphN3gOaLssWnnhh9hUtCnwblGrUxDwS5ZE ha-dns-only' >> "$HOME/.ssh/authorized_keys" echo "Eingeschränkter Schlüssel eingetragen." fi ``` Bei einem neu erzeugten Schlüssel muss die öffentliche Zeile und der Suchwert entsprechend ersetzt werden. Die Ausgabe dieses Eintragsschritts wurde nicht im Chat gezeigt; der spätere SSH-Test war erfolgreich. Der Schlüssel darf damit nur `check-dns` und `restart-dns` ausführen, keine interaktive Shell oder Weiterleitungen. Der separate sudo-Eintrag erlaubt Madzone nur den angegebenen Paketneustart ohne Passwort; seine sonstigen bestehenden Administratorrechte bleiben bestehen. Bei Problemen mit dem Home-Verzeichnis den DSM-Benutzer-Home-Dienst und Dateieigentümer prüfen, nicht die SSH-Rechte lockern. ## 4. NAS-Identität prüfen und Verbindung ohne Neustart testen In der bereits vertrauenswürdigen DSM-Sitzung den Fingerprint ablesen: ```sh sudo ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub ``` Im HA-Container: ```sh ssh-keyscan -t ed25519 -p 22 192.168.1.230 > /config/ssh/synology_dns_known_hosts.pending ssh-keygen -lf /config/ssh/synology_dns_known_hosts.pending ``` Bei deiner Einrichtung stimmten beide Fingerprints überein: ```text SHA256:tIb+4+U9Ojztyqrj6fh2hqEIbNvshkR4hc7NRnO/zdI ``` Bei einer erneuten Einrichtung die aktuell ausgegebenen Fingerprints wieder miteinander vergleichen; nach einer Neuinstallation kann sich der Server-Schlüssel ändern. Beide SHA256-Fingerprints müssen übereinstimmen. Erst danach die geprüfte Datei übernehmen: ```sh mv /config/ssh/synology_dns_known_hosts.pending /config/ssh/synology_dns_known_hosts chmod 600 /config/ssh/synology_dns_known_hosts ssh -F /dev/null -T -p 22 -i /config/ssh/synology_dns_ed25519 -o BatchMode=yes -o IdentitiesOnly=yes -o StrictHostKeyChecking=yes -o UserKnownHostsFile=/config/ssh/synology_dns_known_hosts -o ConnectTimeout=10 Madzone@192.168.1.230 check-dns ``` Erwartet: `DNS-Paket und sudo-Regel vorhanden. Kein Neustart ausgeführt.` Dieser Test prüft SSH, Programmpfad, Paketverzeichnis und sudo-Freigabe. Er startet DNS nicht neu und bestätigt noch nicht, dass ein späterer Neustart erfolgreich sein wird. Beim erfolgreichen Test erschien zusätzlich die Warnung `connection is not using a post-quantum key exchange algorithm`. Sie verhinderte die Anmeldung und den Test nicht. Die Host-Key-Prüfung bleibt aktiviert; die Warnung wird nicht durch Abschalten von SSH-Schutzoptionen umgangen. ## 5. HA-Konfiguration installieren Im HA-Container bei Bedarf `mkdir -p /config/packages` ausführen. Die mitgelieferte Datei [synology-dns.yaml](synology-dns.yaml) als `/config/packages/synology_dns.yaml` in das HA-Konfigurationsvolume kopieren. Der Quelldateiname enthält einen Bindestrich, der hier gewählte Zieldateiname einen Unterstrich. Nur eine Kopie des Packages installieren. Damit die Anleitung auch ohne separates Kopieren der Datei vollständig ist, hier der komplette Inhalt für `/config/packages/synology_dns.yaml`. Einen eventuell vorhandenen Stand vorher sichern und nicht zusätzlich eine zweite Package-Datei mit denselben Schlüsseln anlegen: ```yaml # Nach /config/packages/synology_dns.yaml kopieren. shell_command: synology_dns_restart: >- ssh -F /dev/null -T -p 22 -i /config/ssh/synology_dns_ed25519 -o BatchMode=yes -o IdentitiesOnly=yes -o StrictHostKeyChecking=yes -o UserKnownHostsFile=/config/ssh/synology_dns_known_hosts -o ConnectTimeout=10 -o ServerAliveInterval=5 -o ServerAliveCountMax=2 Madzone@192.168.1.230 restart-dns script: synology_dns_restart: alias: Synology · DNS Server neu starten icon: mdi:dns mode: single sequence: - action: persistent_notification.create data: notification_id: synology_dns_restart title: Synology DNS Server message: Neustartbefehl wird gesendet … - variables: dns_result: returncode: -1 - action: shell_command.synology_dns_restart response_variable: dns_result continue_on_error: true - choose: - conditions: "{{ dns_result is defined and dns_result is mapping and dns_result.get('returncode', -1) == 0 }}" sequence: - action: persistent_notification.create data: notification_id: synology_dns_restart title: Synology DNS Server message: >- Der DNS-Neustartbefehl wurde erfolgreich ausgeführt. Das NAS wurde nicht neu gestartet. Die DNS-Auflösung wurde nicht separat geprüft. default: - action: persistent_notification.create data: notification_id: synology_dns_restart title: Synology DNS · Neustart nicht bestätigt message: >- SSH oder der Neustartbefehl ist fehlgeschlagen, oder das Zeitlimit wurde erreicht. Prüfe den DNS-Paketstatus in DSM und das Home-Assistant-Protokoll, bevor du einen weiteren Neustart auslöst. - delay: '00:01:00' ``` In `/config/configuration.yaml` Packages einbinden. Falls bereits ein `homeassistant:`-Abschnitt existiert, dort ergänzen; keinen zweiten gleichnamigen Abschnitt anlegen. Vorhandene Packages-Konfiguration nicht ersetzen: ```yaml homeassistant: packages: !include_dir_named packages ``` Konfiguration auf dem Docker-Host prüfen: ```sh docker exec HomeAssistant python -m homeassistant --script check_config --config /config ``` Alternativ direkt in der bereits geöffneten Container-Sitzung: ```sh python -m homeassistant --script check_config --config /config ``` Deine tatsächliche Ausgabe: ```text /config # python -m homeassistant --script check_config --config /config Testing configuration at /config /config # ``` Die Ausgabe enthielt keine Fehlermeldung. Bei Fehlern erst die Konfiguration korrigieren. ## 6. Home Assistant neu starten Wenn du noch am Prompt `/config #` bist, mit `exit` zum Docker-Host zurückkehren. Dort: ```sh docker restart HomeAssistant ``` Das startet nur Home Assistant neu, nicht die Synology oder deren DNS-Paket. Warten, bis HA wieder erreichbar ist. Unter Entwicklerwerkzeuge → Zustände nach `script.synology_dns_restart` suchen. Fehlt es, Package-Pfad, Include-Einbindung und HA-Protokoll prüfen. ## 7. Dashboard aktualisieren und DNS neu starten Den aktualisierten Inhalt von `dashboard.yaml` im Rohkonfigurationseditor deines HOMELAB-Dashboards übernehmen. Auf DSM → **DNS Server neu starten** klicken und die Sicherheitsabfrage bestätigen. Jetzt wird erstmals der tatsächliche DNS-Neustart ausgeführt. Falls du nur die vorhandene DNS-Karte bearbeiten möchtest, lautet deren YAML: ```yaml type: button entity: script.synology_dns_restart name: DNS Server neu starten icon: mdi:dns show_state: true tap_action: action: perform-action perform_action: script.synology_dns_restart confirmation: text: DNS Server auf 192.168.1.230 neu starten? Die Namensauflösung kann kurz ausfallen. hold_action: action: none double_tap_action: action: none ``` Dieser Block ist eine einzelne Karte; die vollständige `dashboard.yaml` gehört dagegen in den Dashboard-Rohkonfigurationseditor. Die bestehende HOMELAB-Startseite mit separater DSM-Unterseite und Graphen bleibt erhalten. Der Button ruft das HA-Skript auf. Es zeigt das Ergebnis als persistente HA-Benachrichtigung an und sperrt weitere Skriptaufrufe während der Ausführung plus 60 Sekunden danach. Ein Erfolg bedeutet, dass der Paketbefehl Exitcode 0 zurückgegeben hat; eine DNS-Abfrage wurde damit nicht geprüft. Bei Fehler oder Zeitüberschreitung zuerst Paketstatus in DSM und HA-Protokoll prüfen. HA beendet Shell-Befehle nach 60 Sekunden; der entfernte Vorgang könnte trotzdem weiterlaufen. Nicht sofort wiederholt starten. Nach DSM-Updates gegebenenfalls sudo-Regel, Gateway-Datei und SSH-Zugang prüfen. Zum Entfernen: HA-Package und Button entfernen, genau den `ha-dns-only`-Schlüsseleintrag aus `authorized_keys` löschen, die ausschließlich hierfür angelegte Datei `/etc/sudoers.d/ha-dns` entfernen (zuvor Inhalt prüfen) und die nur hierfür angelegten Schlüssel-/Gateway-Dateien entfernen. ## Ablaufprotokoll der tatsächlich gezeigten Einrichtung Die folgende Reihenfolge entspricht den Terminalausgaben im Gespräch. Die obige Anleitung ist für eine erneute Einrichtung nach Aufgaben geordnet. | Schritt | Beobachtung / Ergebnis | Lösung oder Folgeschritt | | --- | --- | --- | | Gateway kopieren | `cp: cannot stat '/var/services/homes/Madzone/ha-dns-gateway.sh': No such file or directory` | Skript direkt mit `cat … <<'EOF'` in Madzones Home erstellt. | | Gateway installieren | `mkdir`, `cp`, `chown root:root`, `chmod 755` liefen ohne Fehler. | Datei lag unter `/usr/local/sbin/ha-dns-gateway.sh`. | | Datei als Madzone ansehen | `Permission denied` trotz ausführbarer Datei. | Verzeichnisse mit `sudo ls -ld /usr /usr/local /usr/local/sbin` geprüft. | | Rechte und Syntax prüfen | `/usr/local/sbin` hatte `drwx------`; Datei `-rwxr-xr-x root root`; `sudo sh -n` blieb ohne Ausgabe. | `sudo chmod 755 /usr/local/sbin`; danach konnte Madzone die Datei auflisten. | | sudo-Regel bearbeiten | `sudo: visudo: command not found` | Bekannte Programmpfade geprüft; kein `visudo` gefunden. | | Include-Verzeichnis prüfen | `19:#includedir /etc/sudoers.d`, Verzeichnis vorhanden. | Separate Datei `/etc/sudoers.d/ha-dns` mit der festen Regel vorgesehen. | | Lokaler Gateway-Test | `DNS-Paket und sudo-Regel vorhanden. Kein Neustart ausgeführt.` | Programmpfad, Paketverzeichnis und sudo-Regel erfolgreich geprüft. | | Container ermitteln | `HomeAssistant`, Image `homeassistant/home-assistant:latest`. | `docker exec -it HomeAssistant sh`. | | SSH-Werkzeuge prüfen | Alle drei Programme unter `/usr/bin/` vorhanden. | `/config/ssh` mit `700` angelegt. | | Client-Schlüssel | Schlüssel bereits vorhanden; beibehalten, privater Schlüssel auf `600` gesetzt. | Öffentlichen Schlüssel aus `.pub` abgelesen. | | Schlüssel auf DSM | Eingeschränkter `authorized_keys`-Eintrag bereitgestellt; keine separate Eintragsausgabe gezeigt. | Erfolgreicher nachfolgender SSH-Test bestätigt den Zugang. | | Server-Identität | Beide Fingerprints identisch: `SHA256:tIb+4+U9Ojztyqrj6fh2hqEIbNvshkR4hc7NRnO/zdI`. | Geprüfte `.pending`-Datei nach `synology_dns_known_hosts` verschoben, Rechte `600`. | | SSH-Test aus HA | Post-Quantum-Warnung, danach erfolgreiche `check-dns`-Meldung. | Kein DNS-Neustart durchgeführt. | | HA-Package | Package und Include-Anleitung bereitgestellt; Dateiinhalt auf HA nicht separat ausgegeben. | Anschließend HA-Konfiguration geprüft. | | HA-Konfigurationsprüfung | Nur `Testing configuration at /config`, keine Fehler. | HA-Neustart empfohlen. | | HA-Neustart und DNS-Button | Befehle/Bedienung beschrieben, noch keine Erfolgsausgabe vom Benutzer vorgelegt. | Noch nicht als ausgeführt oder erfolgreich dokumentiert. | ### Befehle zur damaligen Fehlerdiagnose Diese Prüfungen sind hier der Vollständigkeit halber aufgeführt; die Fehler sind bereits behoben: ```sh sudo ls -ld /usr /usr/local /usr/local/sbin sudo ls -l /usr/local/sbin/ha-dns-gateway.sh sudo sh -n /usr/local/sbin/ha-dns-gateway.sh sudo sh -c ' for p in /usr/sbin/visudo /usr/bin/visudo /sbin/visudo /bin/visudo /usr/local/sbin/visudo; do [ ! -x "$p" ] || printf "%s\n" "$p" done grep -nE "^[[:space:]]*([#@]include)" /etc/sudoers ls -ld /etc/sudoers.d ' ``` Offizielle HA-Dokumentation: - https://www.home-assistant.io/integrations/shell_command/ - https://www.home-assistant.io/docs/configuration/packages/ - https://www.home-assistant.io/dashboards/actions/