#!/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|--repair-postfix|--help) ;; *) echo "Usage: $0 [--check|--apply|--rollback|--repair-postfix|--help]" >&2; exit 2;; esac # Colorize status labels on terminals; respect NO_COLOR and redirected output. if [[ -t 1 && ! -v NO_COLOR && "${TERM:-}" != dumb ]]; then GREEN=$'\033[32m' GREY=$'\033[90m' RED=$'\033[31m' YELLOW=$'\033[33m' RESET=$'\033[0m' else GREEN='' GREY='' RED='' YELLOW='' RESET='' fi info() { printf '[ Info ] %s\n' "$*"; } ok() { printf '%s[ ok ]%s %s\n' "$GREEN" "$RESET" "$*"; } skipped() { printf '%s[ skipped ]%s %s\n' "$GREY" "$RESET" "$*"; } failed() { printf '%s[ failed ]%s %s\n' "$RED" "$RESET" "$*" >&2; } # Delimited summary at the end of --check / before an interactive --apply. status_banner(){ local color="$1" message="$2" detail="${3:-}" printf '\n%s------------------------------------------------------------%s\n' "$color" "$RESET" printf '%s%s%s\n' "$color" "$message" "$RESET" [[ -z "$detail" ]] || printf '%s%s%s\n' "$color" "$detail" "$RESET" printf '%s------------------------------------------------------------%s\n' "$color" "$RESET" } # Every invocation finishes with one additional empty output line. trap 'printf "\n"' EXIT 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; failed 'Local BIND9 does not resolve oopen.de'; return 1; 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; failed 'BIND9 DNSSEC positive test failed'; return 1; 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; failed 'BIND9 does not reject invalid DNSSEC test zone'; return 1; fi } # Debian Postfix: systemd instance startup refreshes the chroot resolver files. # This is deliberately limited to running Postfix instances. No data_directory # files are ever removed. A queue flush remains a separate admin decision. postfix_units(){ local unit while read -r unit _; do [[ "$unit" == postfix@*.service ]] || continue printf '%s\n' "$unit" done < <(systemctl list-units --type=service --state=active --no-legend --plain 'postfix@*.service' 2>/dev/null) } sync_postfix(){ local -a units=() local unit queue_dir chroot_resolv if ! command -v postconf >/dev/null 2>&1; then skipped 'Postfix not installed; no MTA restart required' return 0 fi mapfile -t units < <(postfix_units) if (( ${#units[@]} == 0 )); then if systemctl is-active --quiet postfix.service; then units=(postfix.service) else skipped 'No active Postfix service; no MTA restart required' return 0 fi fi info 'Restarting active Postfix systemd service(s) to refresh chroot DNS' for unit in "${units[@]}"; do systemctl restart "$unit" || { failed "Postfix restart failed: $unit"; return 1; } if ! systemctl is-active --quiet "$unit"; then failed "Postfix service not active after restart: $unit" return 1 fi ok "Postfix restarted: $unit" done # Only assert a chroot resolver copy when it exists; custom setups may # use multiple queue directories or run SMTP clients without chroot. queue_dir=$(postconf -h queue_directory 2>/dev/null || true) if [[ -n "$queue_dir" && -f "$queue_dir/etc/resolv.conf" ]]; then chroot_resolv="$queue_dir/etc/resolv.conf" if cmp -s "$RESOLV" "$chroot_resolv"; then ok "Postfix chroot resolver synchronized: $chroot_resolv" else failed "Postfix chroot resolver differs: $chroot_resolv" failed 'Check Debian postfix configure-instance.sh / active instances' return 1 fi else info 'No default Postfix chroot resolv.conf found (possibly non-chroot or custom layout)' fi info 'Deferred mail is not flushed automatically; if appropriate run: postqueue -f' } 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)" local readiness=0 if preflight; then readiness=1; fi if is_fully_switched; then if (( readiness )); then status_banner "$GREY" 'Umstellung auf BIND9 bereits durchgeführt.' else status_banner "$YELLOW" 'Umstellung bereits durchgeführt, aber DNS-Prüfung fehlgeschlagen.' fi elif [[ -f "$CURRENT_FILE" ]]; then status_banner "$YELLOW" 'Umstellung kann nicht ausgeführt werden.' \ 'Ein vorheriger Rollback-Stand ist vorhanden; zunächst prüfen oder zurückbauen.' elif (( readiness )); then status_banner "$GREEN" 'Umstellung kann durchgeführt werden.' \ "Ausführen mit: $0 --apply" else status_banner "$YELLOW" 'Umstellung kann nicht ausgeführt werden.' \ 'BIND9-/DNSSEC-Voraussetzungen nicht erfüllt; bitte Fehler prüfen.' fi if [[ -f "$CURRENT_FILE" ]]; then printf '\n=== Rollback information ===\n' info 'Backup from before the last --apply is available' info "Backup: $(state_dir_from_marker)" info "Restore with: $0 --rollback" fi } 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' sync_postfix } 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 status_banner "$GREY" 'Umstellung auf BIND9 bereits durchgeführt.'; skipped 'No changes'; exit 0; fi status_banner "$YELLOW" 'Umstellung kann nicht ausgeführt werden.' 'Vorheriger Rollback-Stand vorhanden.' fatal 'An earlier script run has rollback state. Use --check or --rollback first.'; } if is_fully_switched; then status_banner "$GREY" 'Umstellung auf BIND9 bereits durchgeführt.'; skipped 'No changes'; exit 0; fi info 'Preflight checks (no changes)' if ! preflight; then status_banner "$YELLOW" 'Umstellung kann nicht ausgeführt werden.' 'BIND9-/DNSSEC-Voraussetzungen nicht erfüllt.' return 1 fi status_banner "$GREEN" 'Umstellung kann durchgeführt werden.' \ "Ausführen mit: $0 --apply" 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 and BIND9 are unchanged; active Postfix will restart.' 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 sync_postfix trap - ERR INT TERM ok 'Switch completed successfully' info "Rollback available: $0 --rollback" } repair_postfix(){ require_root need systemctl; need postconf; need cmp if ! is_direct; then fatal 'Resolver is not configured for direct BIND9; use --check first' fi if ! preflight; then fatal 'Local DNSSEC preflight failed; Postfix unchanged' fi sync_postfix ok 'Postfix DNS synchronization completed' } 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|--repair-postfix|--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 --repair-postfix restart active Postfix instance(s) to refresh chroot DNS --help this help After Postfix restart: consider postqueue -f to retry deferred messages. Notes: run as root; requires BIND9 already working; no package changes. HELP ;; --check) show_check ;; --apply) apply ;; --rollback) rollback ;; --repair-postfix) repair_postfix ;; esac