Files
2026-10-15 12:21:26 +02:00

19 KiB
Raw Permalink Blame History

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:

sudo docker ps --format 'table {{.Names}}\t{{.Image}}'

Relevante Ausgabe:

NAMES            IMAGE
HomeAssistant    homeassistant/home-assistant:latest

Auf deinem Docker-Host (root@Docker) den vorhandenen Container öffnen:

docker exec -it HomeAssistant sh

Ab jetzt im Container:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

sudo ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

Im HA-Container:

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:

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:

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 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:

# 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:

homeassistant:
  packages: !include_dir_named packages

Konfiguration auf dem Docker-Host prüfen:

docker exec HomeAssistant python -m homeassistant --script check_config --config /config

Alternativ direkt in der bereits geöffneten Container-Sitzung:

python -m homeassistant --script check_config --config /config

Deine tatsächliche Ausgabe:

/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:

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:

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:

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: