Whitelist-Einträge "name/NN" für dynamische IPv6-Präfixe

- "name/NN": AAAA-Records werden auf das Netz /NN gekürzt, A-Records
  bleiben /32. Gedacht für Anschlüsse mit wechselndem DHCPv6-PD-Präfix,
  deren Clients Privacy-Adressen in mehreren /64-Netzen nutzen.
- IPV6_PREFIX_MIN (Standard 48) schützt vor zu großen Freigaben.
- Zone-IDs (%eth0) in aufgelösten Adressen werden ignoriert.
This commit is contained in:
Patrick Asmus committed 2026-11-13 21:28:56 +01:00
1 parent 200d11077a
commit 5c83607dd4
3 files changed
+31 -4

No files matched your search

+4
View File
@@ -52,10 +52,13 @@ vpn.example.com
203.0.113.42
198.51.100.0/24
2001:db8:1234::/48
home.example.com/56
```
DNS-Einträge werden in A- und AAAA-Records aufgelöst. Einzelne IPv4-Adressen werden zu `/32`, einzelne IPv6-Adressen zu `/128`.
**DNS-Name mit IPv6-Präfix (`name/NN`):** Die AAAA-Records werden auf das Netz `/NN` gekürzt, A-Records bleiben `/32`. Das ist für Anschlüsse mit wechselndem IPv6-Präfix (DHCPv6-PD) gedacht, deren Clients Privacy-Adressen in mehreren /64-Netzen nutzen. Der Name muss per DynDNS auf eine Adresse innerhalb des Netzes zeigen. Beispiel: `home.example.com/56` mit AAAA `2001:db8:abcd:1234::1` ergibt `2001:db8:abcd:1200::/56`. Präfixe kürzer als `IPV6_PREFIX_MIN` (Standard `/48`) werden mit Warnung ignoriert.
## Einrichtung
1. Kopiere diesen Ordner in dein Traefik-Projekt:
@@ -215,6 +218,7 @@ curl -i -u "team:zweites-langes-zufaelliges-passwort" -H "X-Forwarded-For: 203.0
- `BASIC_AUTH_PASSWORD_3`: optionales Passwort des dritten BasicAuth-Benutzers.
- `BASIC_AUTH_PASSWORD_SHA256_3`: optionale Alternative zu `BASIC_AUTH_PASSWORD_3`; Hex-SHA-256-Digest des dritten Passworts.
- `WHITELIST_EXTRA_CIDRS`: optionale, kommagetrennte CIDR/IP-Liste, die zur externen Whitelist hinzugefügt wird.
- `IPV6_PREFIX_MIN`: kleinste erlaubte Präfixlänge für Einträge `name/NN`, Standardwert `48`.
- `CLIENT_IP_STRATEGY`: standardmäßig `rightmost`, alternativ `leftmost`.
- `CLIENT_IP_HEADER`: optionaler benutzerdefinierter Client-IP-Header; standardmäßig `X-Forwarded-For`.
+25 -4
View File
@@ -30,6 +30,9 @@ LISTEN_PORT = int(os.getenv("LISTEN_PORT", "8080"))
BASIC_AUTH_REALM = os.getenv("BASIC_AUTH_REALM", "Protected Area")
CLIENT_IP_STRATEGY = os.getenv("CLIENT_IP_STRATEGY", "rightmost").lower()
EXTRA_CIDRS = os.getenv("WHITELIST_EXTRA_CIDRS", "")
# Kleinste erlaubte IPv6-Präfixlänge für Einträge der Form "domain/NN"
# (Schutz vor zu großen Freigaben wie /32 = ganzer Provider)
IPV6_PREFIX_MIN = int(os.getenv("IPV6_PREFIX_MIN", "48"))
MAX_BASIC_AUTH_USERS = 3
@@ -157,20 +160,38 @@ def resolve_entry(entry):
except ValueError:
pass
# "domain/NN": AAAA-Records auf das Netz /NN kürzen (z. B. DHCPv6-PD-Anschluss),
# A-Records bleiben Einzeladressen.
host = entry
v6_prefix = 128
if "/" in entry:
host, _, prefix_text = entry.rpartition("/")
if not prefix_text.isdigit():
logging.warning("invalid entry %s: prefix length is not a number", entry)
return []
v6_prefix = int(prefix_text)
if not IPV6_PREFIX_MIN <= v6_prefix <= 128:
logging.warning(
"invalid entry %s: IPv6 prefix length must be between /%s and /128",
entry,
IPV6_PREFIX_MIN,
)
return []
networks = []
try:
answers = socket.getaddrinfo(entry, None, type=socket.SOCK_STREAM)
answers = socket.getaddrinfo(host, None, type=socket.SOCK_STREAM)
except socket.gaierror as exc:
logging.warning("DNS lookup failed for %s: %s", entry, exc)
logging.warning("DNS lookup failed for %s: %s", host, exc)
return networks
for family, _, _, _, sockaddr in answers:
ip_text = sockaddr[0]
ip_text = sockaddr[0].split("%", 1)[0]
ip = ipaddress.ip_address(ip_text)
if family == socket.AF_INET:
networks.append(ipaddress.ip_network(f"{ip}/32", strict=False))
elif family == socket.AF_INET6:
networks.append(ipaddress.ip_network(f"{ip}/128", strict=False))
networks.append(ipaddress.ip_network(f"{ip}/{v6_prefix}", strict=False))
return list(set(networks))
+2
View File
@@ -1,8 +1,10 @@
# One entry per line.
# Entries can be DNS names, single IP addresses, or CIDR ranges.
# DNS name with IPv6 prefix: name/NN -> AAAA records are widened to /NN.
office.example.com
vpn.example.com
203.0.113.42
198.51.100.0/24
2001:db8:1234::/48
home.example.com/56