Blog

WireGuard IPv4/IPv6-Failover: Warum zwei Peers nicht ausreichen

Erfahren Sie, warum zwei WireGuard-Peers kein Failover des Endpunkts von IPv6 auf IPv4 ermöglichen und wie Sie Endpunkt-, Routing- und Keepalive-Verhalten sicher untersuchen.

FreeGuard Editorial Team · 2026-11-05

Das Hinzufügen eines IPv4-Peers und eines IPv6-Peers zu einem WireGuard-Profil erzeugt für sich genommen weder eine bevorzugte Verbindung noch eine Bereitschaftsverbindung. Unterscheiden Sie zunächst zwischen der Adresse, über die der VPN-Server erreicht wird, und den Zieladressen, deren Daten durch den Tunnel geleitet werden. Diese Unterscheidung erklärt, warum eine Konfiguration redundant aussehen kann, ohne eine automatische Wiederherstellung zu bieten.

Diese Anleitung behandelt die Semantik der WireGuard-Konfiguration und Diagnosebefehle für Linux-Systeme mit WireGuard-Tools. Mobile und Desktop-Anwendungen können eine eigene Verbindungsverwaltung hinzufügen; prüfen Sie das Verhalten des konkreten Clients und der Version, die Sie verwenden. Hier werden keine Live-Netzwerktests behauptet.

Den Endpunkt vom Datenverkehr innerhalb des Tunnels unterscheiden

Die konzeptionelle Übersicht zu WireGuard beschreibt zwei Entscheidungen: Zunächst wird für ein inneres Ziel ein Peer ausgewählt, dann wird das verschlüsselte Paket an den Endpunkt dieses Peers gesendet. IPv4 und IPv6 können über diese Ebenen hinweg kombiniert werden.

Einstellung Welche Frage sie beantwortet
Endpoint Wohin sollen verschlüsselte UDP-Pakete gesendet werden?
AllowedIPs Welche inneren Zieladressen wählen diesen Peer aus, und welche eingehenden Quelladressen werden von ihm akzeptiert?

Ein IPv4-Endpunkt kann IPv6-Tunnelverkehr übertragen. Ein IPv6-Endpunkt kann IPv4-Tunnelverkehr übertragen. Daher bedeutet AllowedIPs = ::/0 nicht „die IPv6-Adresse des Servers verwenden“, und AllowedIPs = 0.0.0.0/0 bedeutet nicht „seine IPv4-Adresse verwenden“. Diese Einträge beziehen sich auf innere Zieladressfamilien, wie im wg-Handbuch dokumentiert.

Warum zwei Peers kein Failover-Paar bilden

Werden einem Peer alle IPv4-Ziele und einem anderen alle IPv6-Ziele zugewiesen, teilt dies den inneren Datenverkehr nach Adressfamilien auf. Dadurch wird WireGuard nicht angewiesen, den Datenverkehr des ersten Peers auf den zweiten zu verlagern, wenn ein Endpunkt nicht mehr funktioniert.

Beiden Peers dasselbe Zielpräfix zuzuweisen, ist ebenfalls keine Bereitschaftsrichtlinie. In der Linux-WireGuard-Implementierung für erlaubte IP-Adressen aktualisiert das Einfügen eines bereits vorhandenen exakten Präfixes dessen Peer-Zuordnung. Das ist eine Beobachtung zur Implementierung und keine plattformübergreifende Zusage darüber, welche Konfiguration ein grafischer Client akzeptiert. Verwenden Sie doppelte Präfixe nicht als Zustandsprüfung oder Prioritätsliste.

Die Einrichtung von Routen ist eine weitere Ebene. Unter Linux leitet wg-quick normalerweise Routen aus den erlaubten IP-Adressen der Peers ab und behandelt Standardrouten gesondert. Die Option Table ändert dieses Verhalten. Sowohl eine Route zur WireGuard-Schnittstelle als auch die Auswahl des vorgesehenen Ziels durch einen Peer müssen korrekt sein.

Roaming, Aktualisierungen von Hostnamen und Keepalives lösen unterschiedliche Probleme

WireGuard kann den Endpunkt eines Peers aktualisieren, nachdem korrekt authentifizierter Datenverkehr von einer neuen Quelladresse und einem neuen Port empfangen wurde. Dieses dokumentierte Roaming-Verhalten definiert keine geordnete Liste von IPv6- und IPv4-Zielen, die geprüft werden sollen, wenn der aktuelle Endpunkt nicht erreichbar ist.

Ebenso ist ein Hostname mit beiden Adressfamilien kein ausreichender Beleg für einen automatischen Fallback. Untersuchen Sie den tatsächlich verwendeten Endpunkt und prüfen Sie die dokumentierte Richtlinie des Clients zur Namensauflösung und zum erneuten Verbindungsaufbau. Der separate Projektbeitrag zur erneuten DNS-Auflösung aktualisiert den Endpunktzustand im Kernel nach einer dynamischen DNS-Änderung; seine Existenz ist ein guter Grund, das verwaltende Tool zu untersuchen, aber kein Grund anzunehmen, dass jeder Client Hostnamen fortlaufend erneut auflöst.

Persistente Keepalives halten NAT- oder Firewall-Zuordnungen bei Inaktivität aufrecht. Der offizielle Schnelleinstieg nennt 25 Sekunden als für viele solcher Konfigurationen geeignetes Intervall und weist darauf hin, dass die meisten Nutzer dies nicht benötigen. Keepalives legen weder einen alternativen Endpunkt noch eine Richtlinie zum Wechseln der Route fest. Dass eine Verbindung nach einem Wechsel des Mobilfunknetzes stockt, ist allein anhand dieses Symptoms kein Beweis für einen Fehler des Mobilfunkanbieters oder ein Keepalive-Problem.

Eine Linux-Verbindung untersuchen, ohne ihre Konfiguration zu exportieren

Ersetzen Sie wg0 durch den Namen Ihrer Schnittstelle. Dies sind Referenzbefehle für Ihren eigenen Rechner; sie wurden nicht auf dem VPN eines Lesers ausgeführt:

sudo wg show wg0 endpoints
sudo wg show wg0 allowed-ips
sudo wg show wg0 latest-handshakes
sudo wg show wg0 transfer

Das wg-Handbuch dokumentiert diese selektiven Ansichten. Bewahren Sie ihre Ausgabe lokal auf: Endpunkte und Peer-Kennungen können dennoch Informationen über Ihr Netzwerk preisgeben. Vermeiden Sie es, vollständige Konfigurationsexporte oder Dumps mit geheimen Daten weiterzugeben.

Halten Sie den Zustand rund um einen Versuch fest, einen bekannten öffentlichen Dienst zu erreichen. Ein alter Handshake bei einem inaktiven Tunnel reicht nicht aus, um einen Fehler zu diagnostizieren. Vergleichen Sie Beobachtungen zu Endpunkt, Handshake und Datenübertragung mit dem Ergebnis der Anwendung.

Beobachtung Nächster Untersuchungsschritt
Die Adressfamilie des Endpunkts unterscheidet sich von der des inneren Datenverkehrs Das kann gültig sein; untersuchen Sie die Zielauswahl separat
Der Datenverkehr bleibt trotz doppelter Präfixe bei einem Peer Prüfen Sie die Peer-Zuordnungen; doppelte Einträge erzeugen kein Bereitschaftsverhalten
Nach einem Netzwerkwechsel ist der Endpunkt nicht mehr erreichbar Prüfen Sie die Richtlinie des Clients zur Endpunktauswahl und zum erneuten Verbindungsaufbau
Der Tunnelverkehr läuft wieder, aber die Namensauflösung schlägt weiterhin fehl Untersuchen Sie DNS separat mit dem Linux-DNS-Ablauf

Eine Wiederherstellungsrichtlinie auswählen und überprüfen

Verwenden Sie für einen Server, der über beide Adressfamilien erreichbar ist, einen Client oder Netzwerkmanager, dessen dokumentiertes Verhalten die benötigte Endpunktauswahl und Wiederherstellung abdeckt. Bei einfachen Profilen kann ein kontrollierter Vergleich mit jeweils einem Endpunkt zeigen, welcher Pfad funktioniert; manuelles Umschalten ist jedoch kein automatisches Failover.

Speichern Sie die ursprünglichen Einstellungen vor Änderungen sicher. Wiederholen Sie über eine vertrauenswürdige Verbindung dieselbe harmlose Anwendungsanfrage vor und nach einem gewöhnlichen Netzwerkwechsel. Lassen Sie den VPN-Schutz aktiviert. Erzwingen Sie keinen Ausfall einer Remote-Verbindung, auf die Sie für die Wiederherstellung angewiesen sind.

Wenn eine automatische Wiederherstellung das Ziel ist, achten Sie nach dem Wechsel auf einen erreichbaren Endpunkt, einen neuen Handshake, Hinweise auf Datenverkehr und eine erfolgreiche Anwendungsanfrage. Überprüfen Sie beide inneren Adressfamilien, wenn beide benötigt werden. Erfassen Sie die Wiederherstellungszeit selbst, statt von einer Garantie auszugehen. Stellen Sie die gespeicherten Einstellungen wieder her, wenn die Änderung die Verbindung verschlechtert.

Eine Browser-IP-Prüfung liefert einen Hinweis zu dieser Browser-Anfrage. Sie kann weder den von WireGuard ausgewählten Endpunkt identifizieren noch die Route jeder Anwendung nachweisen oder belegen, dass ein zukünftiges Failover funktionieren wird. Auch die DNS-Prüfung der Website ermittelt nicht den rekursiven Resolver des Geräts und weist kein VPN-Routing nach. Nutzen Sie Laufzeitbeobachtungen und Anwendungsprüfungen gemeinsam.

Für die umfassendere Frage, welche Ziele einen Tunnel verwenden sollten, lesen Sie im Themenbereich zu Split-Tunneling weiter. Halten Sie diese Routing-Entscheidung getrennt von der Richtlinie, die eine ausgefallene Serververbindung wiederherstellt.