script/bind
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add script 'switch-resolver-to-bind9.sh'.

Browse Source
This commit is contained in:
chris
2026-10-27 12:52:44 +01:00
parent fc1de89b2b
commit bf7dca0ced
2 changed files with 366 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README-bind9-direct-resolver.md
+163
View File
@@ -0,0 +1,163 @@
# Debian 13: Systemresolver von systemd-resolved auf lokalen BIND9 umstellen
**Stand:** 27. Oktober 2026
**Beispielsystem:** `lists.mx` (produktiver Mail-/Listenserver, Debian 13)
**Skript:** `switch-resolver-to-bind9.sh`
## 1. Ziel und Hintergrund
Auf dem Host läuft bereits ein rekursiver BIND9 auf `127.0.0.1:53` und `[::1]:53`, einschließlich eigener DNSSEC-Validierung (`dnssec-validation auto;`). Bislang nutzten Programme `/etc/resolv.conf -> /run/systemd/resolve/stub-resolv.conf` und damit `127.0.0.53` (`systemd-resolved`), der wiederum an BIND9 weiterleitete.
Beobachtetes Problem: Die IPv6-PTR-Abfrage für `2607:f8b0:4864:20::72e` ergab über `127.0.0.53` `SERVFAIL` mit `DNSSEC validation failed: failed-auxiliary`, über `127.0.0.1` jedoch korrekt `mail-qk1-x72e.google.com.`. Mit `DNSSEC=no` in `systemd-resolved` funktionierte die PTR-Auflösung, aber Anfragen für die absichtlich DNSSEC-fehlerhafte Zone `www.dnssec-failed.org` liefen über `127.0.0.53` weiterhin in einen Timeout. Ein Loopback-Mitschnitt zeigte vielfach wiederholte Abfragen trotz `SERVFAIL`-Antworten von BIND9. Der DNS-Proxy auf `127.0.0.54` übergab dagegen `SERVFAIL` korrekt.
**Ziel:** BIND9 direkt über die glibc-/NSS-DNS-Auflösung nutzen; `systemd-resolved` nach erfolgreichem Test stoppen und deaktivieren. **Keine Änderung** an Maildiensten, BIND-Konfiguration, Interfaces, Firewall oder Routing.
## 2. Zielkonfiguration
`/etc/nsswitch.conf`:
```text
hosts: files myhostname dns
```
`/etc/resolv.conf` (reguläre Datei statt Symlink):
```text
# Local BIND9 recursive resolver; DNSSEC validated by BIND9.
nameserver 127.0.0.1
options edns0 trust-ad
search warenform.de
```
`search warenform.de` ist **systemspezifisch**. Das Skript übernimmt eine bereits vorhandene `search`-Zeile aus der bestehenden Konfiguration; es erfindet keine Suchdomäne. Bei `lists.mx` ist sie bereits gesetzt. `trust-ad` bedeutet **nicht**, dass glibc selbst DNSSEC prüft. Das validierende Glied ist BIND9. Programme mit eigenen Resolver-Bibliotheken können eine abweichende DNS-Konfiguration haben; dies ggf. anwendungsspezifisch prüfen.
Die lokale DNS-Auflösung setzt die Verfügbarkeit von BIND9 voraus. Mit nur `127.0.0.1` gibt es bewusst **keinen externen Fallback**, der lokale DNSSEC-Validierung umgehen könnte.
## 3. Voraussetzungen
- Debian 13, Root-Shell; BIND9 ist installiert, gestartet und lauscht auf IPv4-Loopback `127.0.0.1:53`.
- `dig`, `getent`, `systemctl`, die üblichen Coreutils sowie Bash sind verfügbar.
- BIND9 kann rekursiv auflösen und validiert DNSSEC unabhängig von `systemd-resolved`.
- Änderungen werden in einem Wartungsfenster bzw. mit vorhandener administrativer Konsole vorgenommen. Keine Netzwerkdienste oder Interfaces neu starten.
- Vorhandene dynamische DNS-Konfiguration (DHCP, VPN, Split-DNS, interne Domains) prüfen; das Skript bildet **keine** `systemd-resolved`-Link-Konfiguration nach.
- Eventuelle lokale Abhängigkeiten von `systemd-resolved`, `resolvectl`, LLMNR/mDNS und DNS-Stub-Adressen `127.0.0.53`/`127.0.0.54` vor dem Abschalten ausschließen.
**Achtung:** Auf `lists.mx` wurde `networking.service` zuvor als `failed` gemeldet. Das ist ein **separates** Thema und wird von diesem Skript ausdrücklich nicht behandelt. Insbesondere kein `systemctl restart networking` ausführen.
## 4. DNSSEC-Vorabprüfung
```bash
dig @127.0.0.1 cloudflare.com A +dnssec +adflag
dig @127.0.0.1 www.dnssec-failed.org A +time=5 +tries=1
dig @127.0.0.1 -x 2607:f8b0:4864:20::72e
```
Erwartung: `cloudflare.com` → `NOERROR` und Flag `ad`, `www.dnssec-failed.org` → `SERVFAIL` (nicht Timeout), PTR → `mail-qk1-x72e.google.com.` (Stand des beobachteten Beispiels; DNS-Daten können sich ändern). Das Skript führt einen Positiv- und Negativ-DNSSEC-Test zusätzlich selbst aus. Die Testdomain ist absichtlich fehlerhaft signiert.
## 5. Skriptinstallation und Verwendung
Datei an einen geeigneten Ort kopieren, beispielsweise:
```bash
install -o root -g root -m 0755 switch-resolver-to-bind9.sh \
/usr/local/sbin/switch-resolver-to-bind9.sh
bash -n /usr/local/sbin/switch-resolver-to-bind9.sh
# Nur lesen und prüfen (Standard):
/usr/local/sbin/switch-resolver-to-bind9.sh --check
# Umstellung mit interaktiver Bestätigung (exakt 'yes'):
/usr/local/sbin/switch-resolver-to-bind9.sh --apply
# Rückbau des durch dieses Skript vorgenommenen Zustands:
/usr/local/sbin/switch-resolver-to-bind9.sh --rollback
```
Statusausgaben verwenden die bekannten Muster `[ Info ]`, `[ ok ]`, `[ failed ]`, `[ skipped ]`. Keine automatische Paketinstallation und kein Reboot. Die Änderung erfolgt **nicht** schon beim Aufruf ohne Parameter.
### Was `--apply` tut
1. Prüft Root-Rechte, benötigte Kommandos und BIND9; DNSSEC-Positiv- und Negativtest.
2. Zeigt den geplanten Eingriff und verlangt `Einverstanden [yes/no, default: no]?`.
3. Legt eine Sicherung von **Datei bzw. Symlink** `/etc/resolv.conf`, `/etc/nsswitch.conf` und dem bisherigen `systemd-resolved`-Dienststatus unter `/var/backups/oopen-bind9-direct-resolver/run-.../` an (Verzeichnis nur für Root).
4. Ändert, soweit erforderlich, die `hosts:`-NSS-Zeile und erstellt `/etc/resolv.conf` mit `nameserver 127.0.0.1`. Eine vorhandene `search`-Zeile wird übernommen.
5. Prüft normale Vorwärts- und Reverse-Auflösung.
6. Stoppt und deaktiviert `systemd-resolved` und prüft BIND9/DNSSEC erneut.
7. Bei einem Fehler versucht das Skript automatisch einen Rückbau der gesicherten Dateien und des gespeicherten Dienstzustands. Ein automatischer Rückbau ist eine Schutzmaßnahme, **keine Garantie** bei Stromausfall oder hartem Prozessabbruch.
Bereits vollständig umgestellte Systeme werden ohne Änderungen mit `[ skipped ]` erkannt. Existiert noch ein offener, vom Skript angelegter Rückbauzustand, bricht ein weiterer `--apply`-Lauf ab. So wird verhindert, dass die ursprüngliche Sicherung unbemerkt überschrieben wird.
### Besonderheit bei `lists.mx` (bereits manuell umgestellt)
Auf `lists.mx` wurden `/etc/nsswitch.conf` und `/etc/resolv.conf` am 27.10.2026 bereits manuell auf direkten BIND9 umgestellt. Das Skript erkennt dies und kann bei `--apply` den Dienst `systemd-resolved` noch stoppen und deaktivieren, sofern dies noch nicht erfolgt ist. **Der Skript-Rollback stellt dann den Zustand unmittelbar vor diesem Skriptlauf wieder her, nicht automatisch den historischen systemd-resolved-Zustand vom Morgen.**
Die zuvor manuell erstellte Sicherung liegt unter:
```text
/root/dns-resolver-backup-20261027-120829
```
Dort ist `resolv.conf` ein relativer Symlink. Er muss bei manueller Wiederherstellung an seinem **ursprünglichen Ort** `/etc/resolv.conf` wieder angelegt werden. Der historische Zustand lässt sich mit gesichertem `nsswitch.conf` und dem ursprünglichen Symlink wiederherstellen; dafür `systemd-resolved` zuerst wieder aktivieren.
## 6. Abschließende Prüfungen
```bash
cat /etc/resolv.conf
grep '^hosts:' /etc/nsswitch.conf
systemctl is-active bind9
systemctl is-active systemd-resolved
systemctl is-enabled systemd-resolved
getent ahostsv4 oopen.de
getent hosts 2607:f8b0:4864:20::72e
dig cloudflare.com A +dnssec +adflag
dig www.dnssec-failed.org A +time=5 +tries=1
```
Erwartung: BIND9 `active`, `systemd-resolved` `inactive` und `disabled`, erfolgreiche normale Auflösung, DNSSEC-Positivtest `ad`, Negativtest `SERVFAIL`. Bei `dig` muss `SERVER: 127.0.0.1#53` erscheinen. Zusätzlich Mail-Logs und anwendungsspezifische Namensauflösung kontrollieren. Änderungen bestehen über einen Neustart fort, **sofern** kein anderer Netzwerkdienst `/etc/resolv.conf` ersetzt und BIND9 beim Boot zuverlässig startet; einen Neustart des Produktivservers führt das Skript nicht aus.
## 7. Rollback
Falls `--apply` dieses Skripts zuvor erfolgreich gelaufen ist:
```bash
/usr/local/sbin/switch-resolver-to-bind9.sh --rollback
```
Das stellt die bei **diesem Skriptlauf** gesicherten Dateien und den Dienststatus nach Bestätigung wieder her. Die Sicherungsdateien bleiben archiviert. Falls die Dateien **vor dem ersten Skriptlauf** schon direkt BIND9 benutzten, bringt dieser Rollback folgerichtig nicht den ursprünglichen systemd-Stub zurück.
**Manueller Rückbau auf `lists.mx` in den früheren Zustand** (nur bei gezieltem Bedarf und mit konsistenter DNS-Prüfung):
```bash
# Ursprünglichen NSS-Zustand wiederherstellen:
cp -a /root/dns-resolver-backup-20261027-120829/nsswitch.conf /etc/nsswitch.conf
# Dienst starten, Stub-Datei prüfen:
systemctl enable --now systemd-resolved
test -f /run/systemd/resolve/stub-resolv.conf
# Ziel-Symlink atomar am ursprünglichen Ort wiederherstellen:
ln -s /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf.rollback-link
mv -Tf /etc/resolv.conf.rollback-link /etc/resolv.conf
# Ergebnis prüfen:
getent ahostsv4 oopen.de
dig -x 2607:f8b0:4864:20::72e
```
Die frühere Einstellung `DNSSEC=no` in `/etc/systemd/resolved.conf.d/90-local-bind9.conf` bleibt bei diesem manuellen Rückbau erhalten, solange sie nicht separat geändert wird. DNSSEC bleibt dann bei BIND9 aktiv.
## 8. Grenzen und Sicherheit
- Das Skript setzt einen bereits gesunden lokalen BIND9 voraus und ist **kein** BIND9-Installationsskript.
- Kein automatisches Umschalten auf öffentliche Resolver; bei BIND-Ausfall würde lokale DNS-Auflösung ausfallen.
- Ein vereinfachter `hosts:`-Eintrag `files myhostname dns` ist auf diesem Server geprüft. Systeme mit weiteren NSS-Modulen wie `mymachines`, `mdns` oder LDAP benötigen eine angepasste Variante.
- `systemd-resolved` kann von speziellen Diensten per D-Bus oder `resolvectl` verwendet werden. Das muss vor dem Deaktivieren separat berücksichtigt werden.
- `systemd-resolved` wird nur gestoppt/deaktiviert, **nicht deinstalliert oder maskiert**.
- Bei fehlgeschlagenem Rollback nicht mehrfach blind ausführen: Ausgabe und gesichertes Backup-Verzeichnis überprüfen.
## 9. Quellen
- [systemd-resolved – Modes für /etc/resolv.conf](https://www.freedesktop.org/software/systemd/man/latest/systemd-resolved.service.html)
- [nss-resolve – NSS-Reihenfolge und systemd-resolved](https://www.freedesktop.org/software/systemd/man/latest/nss-resolve.html)
- [Debian: resolvconf-Kompatibilitätsmodus von resolvectl](https://manpages.debian.org/trixie/systemd-resolved/resolvconf.1.en.html)
switch-resolver-to-bind9.sh
Executable
+203
View File
@@ -0,0 +1,203 @@
#!/usr/bin/env bash
# Debian 13: switch system name resolution from systemd-resolved to local BIND9.
# No package installation, BIND configuration or networking changes.
set -Eeuo pipefail
umask 077
readonly STATE_DIR=/var/backups/oopen-bind9-direct-resolver
readonly CURRENT_FILE="$STATE_DIR/current"
readonly RESOLV=/etc/resolv.conf
readonly NSS=/etc/nsswitch.conf
readonly EXPECTED_NSS='hosts: files myhostname dns'
MODE="${1:---check}"
case "$MODE" in --check|--apply|--rollback|--help) ;; *) echo "Usage: $0 [--check|--apply|--rollback|--help]" >&2; exit 2;; esac
info() { printf '[ Info ] %s\n' "$*"; }
ok() { printf '[ ok ] %s\n' "$*"; }
skipped() { printf '[ skipped ] %s\n' "$*"; }
failed() { printf '[ failed ] %s\n' "$*" >&2; }
fatal() { failed "$*"; exit 1; }
echononl(){ printf '%-56s' "$*"; }
require_root(){ [[ "${EUID}" -eq 0 ]] || fatal 'Please run as root.'; }
need(){ command -v "$1" >/dev/null 2>&1 || fatal "Missing command: $1"; }
confirm(){ local answer; read -r -p 'Einverstanden [yes/no, default: no]? ' answer || true; [[ "$answer" == yes ]]; }
# Only this script's state file controls rollback. Older manual backups are untouched.
# Each run's backup retains the exact file or symlink, along with active/enabled state.
state_dir_from_marker(){
[[ -f "$CURRENT_FILE" ]] || return 1
local p
IFS= read -r p < "$CURRENT_FILE" || true
[[ "$p" == "$STATE_DIR"/run-* && -d "$p" && -f "$p/metadata" ]] || fatal 'Invalid resolver rollback marker.'
printf '%s\n' "$p"
}
is_direct(){
[[ -f "$RESOLV" && ! -L "$RESOLV" ]] &&
[[ "$(awk '$1=="nameserver" {print $2}' "$RESOLV")" == '127.0.0.1' ]] &&
grep -Eq '^[[:space:]]*hosts:[[:space:]]*files[[:space:]]+myhostname[[:space:]]+dns[[:space:]]*$' "$NSS"
}
is_fully_switched(){
is_direct && ! systemctl is-active --quiet systemd-resolved &&
[[ "$(systemctl is-enabled systemd-resolved 2>/dev/null || true)" == disabled ]]
}
# BIND must reject a known bogus signature, not merely answer normal queries.
preflight(){
echononl 'BIND9 on 127.0.0.1:53'
if dig @127.0.0.1 oopen.de A +time=3 +tries=1 +short | grep -Eq '^[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$'; then ok 'reachable'; else echo; fatal 'Local BIND9 does not resolve oopen.de'; fi
echononl 'DNSSEC positive test (AD flag)'
local reply
reply=$(dig @127.0.0.1 cloudflare.com A +dnssec +adflag +time=5 +tries=1)
if grep -q 'status: NOERROR' <<< "$reply" && grep -Eq 'flags:.*[[:space:]]ad[;[:space:]]' <<< "$reply"; then ok 'validated'; else echo; fatal 'BIND9 DNSSEC positive test failed'; fi
echononl 'DNSSEC negative test (SERVFAIL)'
reply=$(dig @127.0.0.1 www.dnssec-failed.org A +time=5 +tries=1)
if grep -q 'status: SERVFAIL' <<< "$reply"; then ok 'rejected as expected'; else echo; fatal 'BIND9 does not reject invalid DNSSEC test zone'; fi
}
show_check(){
require_root
need dig; need systemctl; need getent
printf '\n=== DNS resolver status ===\n'
printf 'resolv.conf: '; if [[ -L "$RESOLV" ]]; then readlink "$RESOLV"; else echo 'regular file'; fi
grep -E '^[[:space:]]*(nameserver|search|options)[[:space:]]' "$RESOLV" || true
grep -E '^hosts:' "$NSS" || true
printf 'systemd-resolved active: %s\n' "$(systemctl is-active systemd-resolved 2>/dev/null || true)"
printf 'systemd-resolved enabled: %s\n' "$(systemctl is-enabled systemd-resolved 2>/dev/null || true)"
if is_fully_switched; then ok 'Already directly using BIND9 (resolved disabled)';
elif is_direct; then info 'BIND9 direct configuration is present; resolved still active/enabled';
else info 'Not fully configured for direct BIND9'; fi
if [[ -f "$CURRENT_FILE" ]]; then info "Rollback state: $(state_dir_from_marker)"; fi
preflight
}
restore_files(){
local path="$1"
[[ -d "$path" && -e "$path/nsswitch.conf" ]] || fatal 'Incomplete backup: NSS'
[[ -e "$path/resolv.conf" || -L "$path/resolv.conf" ]] || fatal 'Incomplete backup: resolv.conf'
cp -a --remove-destination "$path/nsswitch.conf" "$NSS"
cp -a --remove-destination "$path/resolv.conf" "$RESOLV"
}
restore_services(){
local path="$1" enabled active
enabled=$(sed -n 's/^resolved_enabled=//p' "$path/metadata")
active=$(sed -n 's/^resolved_active=//p' "$path/metadata")
case "$enabled" in
enabled|enabled-runtime) systemctl enable systemd-resolved >/dev/null ;;
disabled) systemctl disable systemd-resolved >/dev/null ;;
static|indirect|masked|alias|'') info "Previous enabled state '$enabled'; no enable-state change" ;;
*) info "Unrecognized previous enabled state '$enabled'; no enable-state change" ;;
esac
case "$active" in
active) systemctl start systemd-resolved ;;
inactive|failed) systemctl stop systemd-resolved ;;
*) info "Previous active state '$active'; no service-state change" ;;
esac
}
rollback_to(){
local path="$1"
info "Restoring config from $path"
# Stop resolved first only when it was previously not active; otherwise start after files.
restore_files "$path"
restore_services "$path"
ok 'Configuration and resolved service state restored'
}
apply(){
require_root
for cmd in dig getent systemctl cp mv mktemp grep awk sed date; do need "$cmd"; done
[[ -f "$NSS" ]] || fatal "$NSS missing"
[[ -e "$RESOLV" || -L "$RESOLV" ]] || fatal "$RESOLV missing"
[[ ! -f "$CURRENT_FILE" ]] || {
if is_fully_switched; then skipped 'Already installed; no changes'; exit 0; fi
fatal 'An earlier script run has rollback state. Use --check or --rollback first.';
}
if is_fully_switched; then skipped 'Already directly using BIND9; no changes'; exit 0; fi
info 'Preflight checks (no changes)'
preflight
printf '\nPlanned changes:\n hosts: files myhostname dns\n resolv.conf: nameserver 127.0.0.1\n stop and disable systemd-resolved\n'
info 'Network interfaces, routes, BIND9 and MTA are not changed.'
confirm || { skipped 'Abbruch durch User'; exit 0; }
mkdir -p "$STATE_DIR"
chmod 700 "$STATE_DIR"
local path timestamp
timestamp=$(date +%Y%m%d-%H%M%S)
path=$(mktemp -d "$STATE_DIR/run-${timestamp}-XXXXXX")
cp -a "$RESOLV" "$path/resolv.conf"
cp -a "$NSS" "$path/nsswitch.conf"
{
printf 'resolved_active=%s\n' "$(systemctl is-active systemd-resolved 2>/dev/null || true)"
printf 'resolved_enabled=%s\n' "$(systemctl is-enabled systemd-resolved 2>/dev/null || true)"
} > "$path/metadata"
printf '%s\n' "$path" > "$CURRENT_FILE"
info "Backup: $path"
# Roll back this transaction automatically if a command or signal fails.
trap 'rc=$?; trap - ERR INT TERM; failed "Apply failed (exit $rc). Rolling back"; rollback_to "$path" || failed "Automatic rollback failed; backup: $path"; exit "$rc"' ERR
trap 'exit 130' INT
trap 'exit 143' TERM
if ! grep -Eq '^[[:space:]]*hosts:[[:space:]]*files[[:space:]]+myhostname[[:space:]]+dns[[:space:]]*$' "$NSS"; then
sed -i -E '/^[[:space:]]*hosts:/c\hosts: files myhostname dns' "$NSS"
else skipped 'NSS already configured'; fi
if [[ ! -f "$RESOLV" || -L "$RESOLV" ]] || ! grep -Eq '^nameserver[[:space:]]+127\.0\.0\.1$' "$RESOLV"; then
local search_domain=""
search_domain=$(awk '$1=="search" { $1=""; sub(/^[[:space:]]+/, ""); print; exit }' "$RESOLV" 2>/dev/null || true)
rm -f "$RESOLV"
{
printf '# Local BIND9 recursive resolver; DNSSEC validated by BIND9.\n'
printf 'nameserver 127.0.0.1\noptions edns0 trust-ad\n'
[[ -z "$search_domain" ]] || printf 'search %s\n' "$search_domain"
} > "$RESOLV"
chmod 644 "$RESOLV"
else skipped 'resolv.conf already uses local BIND9'; fi
echononl 'NSS forward resolution'
getent ahostsv4 oopen.de >/dev/null && ok 'works' || { echo; false; }
echononl 'NSS reverse resolution'
getent hosts 2607:f8b0:4864:20::72e >/dev/null && ok 'works' || { echo; false; }
echononl 'Resolver configuration'
is_direct && ok 'direct BIND9' || { echo; false; }
systemctl stop systemd-resolved
systemctl disable systemd-resolved >/dev/null
echononl 'systemd-resolved disabled'
is_fully_switched && ok 'yes' || { echo; false; }
preflight
trap - ERR INT TERM
ok 'Switch completed successfully'
info "Rollback available: $0 --rollback"
}
rollback(){
require_root
local path
path=$(state_dir_from_marker) || fatal 'No rollback state from this script exists'
info "Rollback backup: $path"
confirm || { skipped 'Abbruch durch User'; exit 0; }
rollback_to "$path"
rm -f "$CURRENT_FILE"
ok 'Rollback completed; preserved backup remains in place'
}
case "$MODE" in
--help)
cat <<'HELP'
Usage: switch-resolver-to-bind9.sh [--check|--apply|--rollback|--help]
--check read-only checks (default)
--apply verify BIND9 DNSSEC; back up; switch DNS/NSS; stop+disable resolved
--rollback restore files and resolved service state saved before last --apply
--help this help
Notes: run as root; requires BIND9 already working; no package changes.
HELP
;;
--check) show_check ;;
--apply) apply ;;
--rollback) rollback ;;
esac