Communitygithub.com

superchaospc/reality-wireguard-relay

Claude Code Skill zum Aufbau einer VLESS-XHTTP-REALITY-Relay-Kette mit WireGuard-Backhaul und mehreren SNAT-Ausgängen, sodass die ausgehende IP die des Lande-VPS ist.

Was ist reality-wireguard-relay?

Dieses Skill (Playbook + Skripte, kein Ein-Klick-Setup) für Claude Code ermöglicht den Aufbau einer Proxy-Kette, bei der ein VLESS-XHTTP-REALITY-Eingangsserver (Relay) den Datenverkehr über ein WireGuard-Tunnel an einen oder mehrere Lande-VPS (Landing) weiterleitet. Die entscheidende Neuerung: Der Lande-VPS führt SNAT durch, sodass die ausgehende IP-Adresse die des Lande-VPS und nicht die des Relay-Servers ist – ideal für Szenarien, in denen die Exit-IP geografisch oder netzwerktechnisch von der Relay-IP abweichen soll. Das Skill deckt die gesamte Architektur ab, inklusive MTU-Fallstricke (insbesondere bei REALITY over WireGuard), Erstellungs- und Prüfskripte sowie Konfigurationsvorlagen. Es richtet sich an fortgeschrittene Nutzer, die einen mehrstufigen Proxy mit klarer Trennung von Relay und Exit aufsetzen möchten. Unterstützt werden typische Linux-VPS-Umgebungen mit Xray-Core und WireGuard.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add superchaospc/reality-wireguard-relay

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht reality-wireguard-relay?

VLESS-XHTTP-REALITY-Relay + WireGuard-Multi-Exit-Proxy-Kette als Claude Code Skill (Playbook + Skripte, kein Ein-Klick-Setup). Die ausgehende IP ist die des Lande-VPS. | Claude Code Skill: Erstellen eines VLESS-XHTTP-REALITY-Relays, das über WireGuard an einen oder mehrere Lande-VPS mittels SNAT-Multi-Exit angebunden wird, sodass die Exit-IP die des Lande-VPS ist – Architektur, MTU-Fallstricke, Verifizierung und Hilfsskripte.

Architektur-Übersicht

Das System besteht aus zwei Hauptkomponenten:

  1. Relay-Server (Relay): Führt einen VLESS-XHTTP-REALITY-Eingang aus und leitet den Datenverkehr über einen WireGuard-Tunnel an den Lande-VPS weiter.
  2. Lande-VPS (Landing): Empfängt den getunnelten Datenverkehr und leitet ihn über SNAT an das eigentliche Ziel weiter. Die ausgehende IP ist die des Lande-VPS.

Durch die Verwendung von WireGuard wird eine Ende-zu-Ende-Verschlüsselung zwischen Relay und Landing erreicht, während REALITY die Masquerade des Relay-Eingangs gewährleistet.

MTU-Fallstricke

Ein häufiges Problem bei dieser Konfiguration sind MTU-Probleme. WireGuard hat einen Overhead von 60+ Bytes, und REALITY fügt weitere ~30 Bytes hinzu. Wenn die MTU nicht richtig konfiguriert ist, kann es zu Paketfragmentierung oder Verbindungsabbrüchen kommen.

Empfohlene Einstellungen:

  • WireGuard-Schnittstelle: MTU = 1280 (oder niedriger, z. B. 1200 bei IPv6-Umgebungen)
  • Xray-Core: streamSettings -> sockopt -> tcpMptcp: false und tcpFastOpen: true (optional)
  • REALITY-Konfiguration: `

Verwandte Skills