Merge pull request 'v0.3.0: IPv6-Präfixe für DynDNS-Einträge und Dry-Run-Fix' (#4) from alpha-0.3.0 into main

Merge pull request 'v0.3.0: IPv6-Präfixe für DynDNS-Einträge und Dry-Run-Fix' (#4) from alpha-0.3.0 into main
This commit was merged in pull request #4.
This commit is contained in:
scriptos committed 2026-11-13 19:32:15 +00:00
commit f5b8750bd0
4 files changed
+189 -3

No files matched your search

+4
View File
@@ -27,6 +27,7 @@ Der **CrowdSec Manager** ist ein Bash-Script, das:
| **Interaktives Menü** | Grafische Administration von CrowdSec via Menü |
| **DNS-Auflösung** | Automatische Auflösung von Domains zu IPv4 und IPv6 |
| **CIDR-Support** | Ganze Subnetze können allowgelistet werden |
| **Dynamische IPv6-Präfixe** | `domain/56` allowlistet das ganze Netz hinter einem DynDNS-Namen (DHCPv6-PD) |
| **Auto-Cleanup** | Entfernt IPs die nicht mehr zu konfigurierten Domains gehören |
| **Decisions verwalten** | Anzeigen, Suchen, Hinzufügen, Entfernen von Decisions |
| **Alerts verwalten** | Anzeigen, Inspizieren, Löschen von Alerts |
@@ -151,9 +152,12 @@ ALLOWLIST_ENTRIES=(
"203.0.113.50" # Einzelne IP
"10.0.0.0/8" # CIDR-Bereich
"2001:db8::1" # IPv6
"home.example.com/56" # AAAA → ganzes /56 (wechselndes Präfix)
)
```
Details zu IPv6-Präfixen: [docs/CONFIGURATION.md](docs/CONFIGURATION.md#ipv6_prefix_length-und-ipv6_prefix_min-ab-v030)
### Benachrichtigungen
```bash
+18
View File
@@ -41,6 +41,10 @@ ALLOWLIST_REASON="allowlist-manager-auto"
# - IPv6-Adressen: 2001:db8::1
# - CIDR-Notation: 192.168.1.0/24
# - CIDR IPv6: 2001:db8::/32
# - Domain mit IPv6-Präfix: home.example.com/56
# → AAAA-Records werden auf das Netz gekürzt (z. B. 2001:db8:abcd:1200::/56),
# A-Records bleiben Einzeladressen. Nützlich für Anschlüsse mit
# wechselndem IPv6-Präfix (DHCPv6-PD), siehe IPV6_PREFIX_LENGTH.
ALLOWLIST_ENTRIES=(
# === Domains & Subdomains ===
@@ -54,6 +58,9 @@ ALLOWLIST_ENTRIES=(
# === CIDR-Bereiche ===
# "10.0.0.0/8"
# "2001:db8::/32"
# === Domains mit IPv6-Präfix (dynamisches Präfix) ===
# "home.example.com/56"
)
# ----------------------------------------------------------------------------
@@ -67,6 +74,17 @@ DNS_SERVER=""
# IPv6-Adressen ebenfalls auflösen? (true/false)
RESOLVE_IPV6=true
# Standard-Präfixlänge für aufgelöste IPv6-Adressen (AAAA)
# 128 = nur die einzelne Adresse (Standard, bisheriges Verhalten)
# 56 = das ganze /56 der Adresse allowlisten (z. B. Heimanschluss mit DHCPv6-PD)
# Gilt für alle Domains ohne eigene Angabe. Einzelne Einträge können
# das mit "domain/NN" überschreiben (siehe ALLOWLIST_ENTRIES).
IPV6_PREFIX_LENGTH=128
# Kleinste erlaubte IPv6-Präfixlänge (Schutz vor zu großen Freigaben)
# Einträge mit kürzerem Präfix (z. B. /32 = ganzer Provider) werden abgelehnt.
IPV6_PREFIX_MIN=48
# DNS-Auflösungs-Timeout in Sekunden
DNS_TIMEOUT=5
+134 -3
View File
@@ -17,7 +17,7 @@ set -euo pipefail
# ----------------------------------------------------------------------------
SCRIPT_NAME="$(basename "$0")"
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
SCRIPT_VERSION="0.2.2"
SCRIPT_VERSION="0.3.0"
CONFIG_FILE="${SCRIPT_DIR}/config/crowdsec-manager.conf"
# Farben (werden ggf. deaktiviert wenn nicht im Terminal)
@@ -263,12 +263,109 @@ is_domain() {
return 1
}
# Domain mit IPv6-Präfixlänge, z. B. "home.example.com/56"
# Die Präfixlänge gilt nur für die aufgelösten AAAA-Records.
is_domain_with_prefix() {
local entry="$1"
[[ "$entry" =~ ^[^/]+/[0-9]{1,3}$ ]] || return 1
is_domain "${entry%/*}"
}
# Prüft eine IPv6-Präfixlänge gegen den erlaubten Bereich
# (IPV6_PREFIX_MIN .. 128). Schützt vor zu großen Freigaben (z. B. /32).
is_valid_ipv6_prefix_length() {
local len="$1"
local min="${IPV6_PREFIX_MIN:-48}"
[[ "$len" =~ ^[0-9]{1,3}$ ]] || return 1
(( len >= min && len <= 128 ))
}
# Kürzt eine IPv6-Adresse auf ihr Netz und gibt "netz/länge" zurück.
# Ausgabe im kanonischen Format nach RFC 5952 (klein, ohne führende Nullen,
# längste Null-Folge als "::"), z. B. 2001:db8:abcd:1200::/56
ipv6_to_prefix() {
local ip="${1,,}"
local len="$2"
local -a groups=()
local i
# "::" auf 8 Gruppen expandieren
if [[ "$ip" == *"::"* ]]; then
local head="${ip%%::*}" tail="${ip#*::}"
local -a h=() t=()
[[ -n "$head" ]] && IFS=':' read -ra h <<< "$head"
[[ -n "$tail" ]] && IFS=':' read -ra t <<< "$tail"
local missing=$(( 8 - ${#h[@]} - ${#t[@]} ))
(( missing < 1 )) && return 1
groups=("${h[@]}")
for (( i = 0; i < missing; i++ )); do groups+=("0"); done
groups+=("${t[@]}")
else
IFS=':' read -ra groups <<< "$ip"
fi
(( ${#groups[@]} == 8 )) || return 1
# Hostanteil ausmaskieren
local -a net=()
local bits remaining="$len"
for (( i = 0; i < 8; i++ )); do
[[ "${groups[$i]}" =~ ^[0-9a-f]{1,4}$ ]] || return 1
local val=$(( 16#${groups[$i]} ))
if (( remaining >= 16 )); then
bits=16
elif (( remaining <= 0 )); then
bits=0
else
bits=$remaining
fi
local mask=$(( bits == 0 ? 0 : (0xFFFF << (16 - bits)) & 0xFFFF ))
net+=( "$(( val & mask ))" )
remaining=$(( remaining - 16 ))
done
# Längste Folge von Null-Gruppen (mind. 2) für "::" suchen
local best_start=-1 best_len=0 cur_start=-1 cur_len=0
for (( i = 0; i < 8; i++ )); do
if (( net[i] == 0 )); then
(( cur_start < 0 )) && cur_start=$i
cur_len=$(( cur_len + 1 ))
if (( cur_len > best_len )); then
best_start=$cur_start
best_len=$cur_len
fi
else
cur_start=-1
cur_len=0
fi
done
(( best_len < 2 )) && best_start=-1
local out=""
for (( i = 0; i < 8; i++ )); do
if (( i == best_start )); then
out+="::"
i=$(( i + best_len - 1 ))
continue
fi
[[ -n "$out" && "$out" != *"::" ]] && out+=":"
out+=$(printf '%x' "${net[$i]}")
done
echo "${out}/${len}"
}
# ============================================================================
# TEIL 3: DNS-AUFLÖSUNG
# ============================================================================
resolve_domain() {
local domain="$1"
# Optionale IPv6-Präfixlänge (Standard: IPV6_PREFIX_LENGTH bzw. 128 = Einzeladresse)
local v6_prefix="${2:-${IPV6_PREFIX_LENGTH:-128}}"
if [[ "$v6_prefix" != "128" ]] && ! is_valid_ipv6_prefix_length "$v6_prefix"; then
log "WARN" "Ungültige IPv6-Präfixlänge '$v6_prefix' für '$domain' (erlaubt: /${IPV6_PREFIX_MIN:-48} bis /128) - verwende Einzeladressen"
v6_prefix=128
fi
local resolved_ips=()
log "DEBUG" "Löse Domain auf: $domain"
@@ -299,8 +396,19 @@ resolve_domain() {
if [[ -n "$ipv6_results" ]]; then
while IFS= read -r ip; do
if is_valid_ipv6 "$ip"; then
resolved_ips+=("$ip")
log "DEBUG" " IPv6 aufgelöst: $domain -> $ip"
if (( v6_prefix < 128 )); then
local net
if net=$(ipv6_to_prefix "$ip" "$v6_prefix"); then
resolved_ips+=("$net")
log "DEBUG" " IPv6 aufgelöst: $domain -> $ip -> $net"
else
log "WARN" " IPv6 '$ip' von '$domain' konnte nicht auf /$v6_prefix gekürzt werden"
STAT_ERRORS=$((STAT_ERRORS + 1))
fi
else
resolved_ips+=("$ip")
log "DEBUG" " IPv6 aufgelöst: $domain -> $ip"
fi
fi
done <<< "$ipv6_results"
fi
@@ -328,6 +436,21 @@ resolve_all_entries() {
log "DEBUG" "Direkter Eintrag: $entry"
echo "$entry" >> "$NEW_IPS_FILE"
STAT_TOTAL_IPS=$((STAT_TOTAL_IPS + 1))
elif is_domain_with_prefix "$entry"; then
local domain="${entry%/*}" prefix="${entry##*/}"
if ! is_valid_ipv6_prefix_length "$prefix"; then
log "WARN" "Ungültige IPv6-Präfixlänge in '$entry' (erlaubt: /${IPV6_PREFIX_MIN:-48} bis /128) - wird übersprungen"
STAT_ERRORS=$((STAT_ERRORS + 1))
REPORT_MESSAGES+=("WARN: Präfixlänge außerhalb des erlaubten Bereichs: $entry")
continue
fi
local resolved
if resolved=$(resolve_domain "$domain" "$prefix"); then
while IFS= read -r ip; do
echo "$ip" >> "$NEW_IPS_FILE"
STAT_TOTAL_IPS=$((STAT_TOTAL_IPS + 1))
done <<< "$resolved"
fi
elif is_domain "$entry"; then
local resolved
if resolved=$(resolve_domain "$entry"); then
@@ -1835,6 +1958,11 @@ load_config() {
# shellcheck source=/dev/null
source "$CONFIG_FILE"
# Kommandozeilen-Optionen haben Vorrang vor der Konfigurationsdatei
# (sonst würde z. B. DRY_RUN=false aus der Config ein --dry-run aushebeln)
[[ -n "${CLI_DRY_RUN:-}" ]] && DRY_RUN="$CLI_DRY_RUN"
[[ -n "${CLI_LOG_LEVEL:-}" ]] && LOG_LEVEL="$CLI_LOG_LEVEL"
if [[ -n "${LOG_FILE:-}" ]]; then
local log_dir
log_dir="$(dirname "$LOG_FILE")"
@@ -1886,14 +2014,17 @@ main() {
;;
-d|--dry-run)
DRY_RUN=true
CLI_DRY_RUN=true
shift
;;
-v|--verbose)
LOG_LEVEL="DEBUG"
CLI_LOG_LEVEL="DEBUG"
shift
;;
-q|--quiet)
LOG_LEVEL="ERROR"
CLI_LOG_LEVEL="ERROR"
shift
;;
-l|--list)
+33
View File
@@ -169,6 +169,39 @@ RESOLVE_IPV6=true # IPv4 + IPv6
RESOLVE_IPV6=false # Nur IPv4
```
### `IPV6_PREFIX_LENGTH` und `IPV6_PREFIX_MIN` (ab v0.3.0)
Viele Heimanschlüsse bekommen ihr IPv6-Präfix per DHCPv6-PD und es wechselt regelmäßig (oft nachts). Die Clients dahinter nutzen wechselnde Privacy-Adressen in mehreren /64-Netzen. Eine einzelne aufgelöste Adresse reicht dann nicht, um das ganze Netz zu allowlisten.
Mit einer Präfixlänge wird jede aufgelöste AAAA-Adresse auf ihr Netz gekürzt und als CIDR eingetragen:
```bash
IPV6_PREFIX_LENGTH=128 # Standard: nur die einzelne Adresse (bisheriges Verhalten)
IPV6_PREFIX_MIN=48 # kürzere Präfixe werden abgelehnt
```
Pro Eintrag geht das auch gezielt, ohne die anderen Domains zu verändern:
```bash
ALLOWLIST_ENTRIES=(
"vpn.example.com" # einzelne Adressen (A + AAAA)
"home.example.com/56" # A einzeln, AAAA → z. B. 2001:db8:abcd:1200::/56
)
```
| Einstellung | Wirkung |
|-------------|---------|
| `domain` | AAAA mit `IPV6_PREFIX_LENGTH` (Standard 128 = Einzeladresse) |
| `domain/NN` | AAAA auf `/NN` gekürzt, A-Records bleiben Einzeladressen |
| `NN < IPV6_PREFIX_MIN` | Eintrag wird mit Warnung übersprungen |
**Hinweise:**
- Die Präfixlänge gilt nur für IPv6. Für IPv4-Bereiche weiterhin die CIDR-Notation (`10.0.0.0/8`) verwenden.
- Der DNS-Name muss auf eine Adresse **innerhalb** des gewünschten Netzes zeigen, z. B. per DynDNS auf die WAN-Adresse des Routers bzw. der Firewall hinter dem Provider-Router. Die WAN-Adresse eines Providerrouters (z. B. myfritz) liegt oft in einem anderen Netz als die Clients.
- Wechselt das Präfix, wird beim nächsten Sync das neue Netz eingetragen und das alte entfernt (bei `AUTO_CLEANUP=true`).
- Die Ausgabe erfolgt im kanonischen Format nach RFC 5952 (`2001:db8:abcd:1200::/56`), damit der Abgleich mit der bestehenden Allowlist stabil bleibt.
### `DNS_TIMEOUT` und `DNS_RETRIES`
```bash