superchaospc/reality-wireguard-relay

O que reality-wireguard-relay faz?

VLESS-XHTTP-REALITY 中转 + WireGuard 落地多出口代理链 — Skill do Claude Code (playbook + scripts, não é automático). A saída IP é a do servidor de destino.

Este skill permite construir um relay VLESS-XHTTP-REALITY com backhaul via WireGuard para um ou mais servidores VPS de destino, usando SNAT multi-saída, de modo que o IP de saída seja o do servidor de destino.

---

Arquitetura

O esquema abaixo mostra a topologia de rede:

[Cliente] --> Relay (VLESS-XHTTP-REALITY) --> [Túnel WireGuard] --> Landing VPS (SNAT) --> Internet

• Relay: Servidor que recebe a conexão do cliente via VLESS-XHTTP-REALITY e a encapsula em um túnel WireGuard.
• Landing VPS: Servidor(s) de destino que decapsulam o túnel WireGuard e fazem SNAT para que o tráfego saia com seu IP público.
• Múltiplas saídas: É possível configurar múltiplos VPS de destino, cada um com seu próprio IP de saída, e rotear o tráfego seletivamente.

Armadilhas de MTU

Um dos pontos críticos deste setup é a configuração correta do MTU para evitar fragmentação de pacotes. O túnel WireGuard adiciona overhead (cerca de 60 bytes ao MTU padrão de 1500). Se o MTU não for reduzido, pacotes maiores podem ser fragmentados, reduzindo a performance e causando problemas de conectividade.

Recomendação:

• Configure o MTU da interface WireGuard para 1350 ou menor.
• Teste com ping -M do -s <tamanho> para verificar o MTU máximo sem fragmentação.

Verificação

Para verificar se o setup está funcionando corretamente:

1. Verificar túnel WireGuard:

   wg show
   

   Deve mostrar o handshake e bytes transferidos.

2. Verificar roteamento:

   ip route show
   

   Confirme que o tráfego de saída está sendo roteado via a interface WireGuard.

3. Verificar IP de saída: Em um cliente configurado para usar o relay, execute:

   curl ifconfig.me
   

   O IP retornado deve ser o IP do servidor de destino.

Scripts Auxiliares

O skill inclui scripts bash para:

• setup-wg.sh: Cria e configura a interface WireGuard no relay e no landing VPS.
• add-route.sh: Adiciona regras de roteamento e SNAT para uma nova saída.
• verify-connectivity.sh: Verifica conectividade e MTU.
• cleanup.sh: Remove configurações e interfaces.

Uso:

./setup-wg.sh <endereço-do-landing-vps> <chave-privada-wireguard>

Gerenciamento de Múltiplas Saídas

Para adicionar uma nova saída (nova landing VPS):

1. Configure o túnel WireGuard com o novo VPS.
2. Execute add-route.sh com o IP do novo VPS.
3. Verifique com verify-connectivity.sh.

Observações

• Este skill é um playbook não automático — você precisa executar manualmente os scripts no servidor relay e nos servidores de destino.
• Requer Xray-core e WireGuard instalados no relay.
• Firewall deve permitir conexões nas portas relevante (VLESS, WireGuard).