Files
syno-scripts/HOMELAB/home-assistant/DNS-SETUP.md
T
2026-10-15 12:21:26 +02:00

406 lines
19 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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/