🇬🇧 Englischer Schnellstart · Vollständige Anleitung (fortgeschrittene Themen) 🇮🇷 راه‌اندازی سریع فارسی · راهنمای کامل (مباحث پیشرفته)

۱. راهنمای تصویری راه اندازی به زبان فارسی (YouTube)
۲. راهنمای جامع متنی راه اندازی به زبان فارسی با تشکر از Kian Irani

Was du bekommst

• 🌐 Umgeht DPI / SNI-Blockierung durch Nutzung von Googles Edge als Relay
• 💯 Völlig kostenlos — läuft in der kostenlosen Stufe deines eigenen Google-Kontos
• ⚡ Eine kleine Datei (~3 MB), kein Python, kein Node.js, keine Abhängigkeiten
• 🖥️ Funktioniert auf Mac, Windows, Linux, Android, OpenWRT-Routern
• 🦊 Jeder Browser oder jede App, die HTTP-Proxy oder SOCKS5 unterstützt

Wie es funktioniert (das einfache Bild)

ISPs können nicht in verschlüsseltes HTTPS hineinlesen. Sie sehen nur die Adresse — www.google.com. Die eigentliche Seitenabfrage findet in Googles Netzwerk statt, versteckt im verschlüsselten Tunnel.

Schnellstart

Etwa 5 Minuten. Du benötigst:

• Ein kostenloses Google-Konto (jede Gmail-Adresse funktioniert)
• Einen Computer (Mac, Windows oder Linux)
• Firefox oder Chrome

Schritt 1 — Das Google Apps Script erstellen (einmalig)

1. Gehe zu script.google.com und melde dich mit deinem Google-Konto an
2. Klicke oben links auf Neues Projekt
3. Lösche den Standardcode im Editor
4. Öffne die Datei assets/apps_script/Code.gs in diesem Repository, kopiere den gesamten Inhalt und füge ihn in den Apps Script-Editor ein (ersetze den vorhandenen Code)
5. Finde diese Zeile in der Nähe des Anfangs:
   root@kitploit:~

   const AUTH_KEY = "CHANGE_ME_TO_A_STRONG_SECRET";
   

   Ersetze CHANGE_ME_TO_A_STRONG_SECRET durch einen eigenen langen, zufälligen String. Behalte diesen String — du wirst ihn in Schritt 3 in die App einfügen. Behandle ihn wie ein Passwort.
6. Klicke auf 💾 Speichern (oder Ctrl/Cmd+S)
7. Klicke auf Bereitstellen (oben rechts) → Neue Bereitstellung
8. Klicke auf das Zahnradsymbol ⚙ neben „Typ auswählen" → wähle Web-App
9. Stelle ein:
   • Ausführen als: Ich (dein Google-Konto)
   • Zugriff für: Jeder
10. Klicke auf Bereitstellen. Google fragt möglicherweise nach Berechtigungen — klicke auf Zugriff autorisieren und bestätige
11. Google zeigt eine Bereitstellungs-ID (einen langen zufälligen String). Kopiere sie — du wirst sie in Schritt 3 benötigen.

Tipp: Wenn du später Code.gs aktualisierst, erstelle keine neue Bereitstellung. Bearbeite den Code, gehe dann zu Bereitstellen → Bereitstellungen verwalten → ✏️ → Version: Neue Version → Bereitstellen. Die Bereitstellungs-ID bleibt gleich.

Schritt 2 — mhrv-rs herunterladen

Gehe zur letzten Release-Seite und lade die Datei für deinen Computer herunter:

Mac: Nicht sicher, ob Apple Silicon oder Intel? Klicke auf → Über diesen Mac. Wenn bei „Chip" Apple steht, nimm arm64. Wenn Intel, nimm amd64.

Linux: Du erhältst einen GLIBC-Fehler? Verwende stattdessen die Datei linux-musl-amd64 — sie funktioniert auf jedem Linux ohne Abhängigkeiten.

Entpacke die Datei.

Schritt 3 — Erster Start

Doppelklicke auf den Starter:

| Mac | run.command | | Windows | run.bat | | Linux | ./run.sh (im Terminal) |

Beim ersten Mal fragt es nach deinem Computer-Passwort. Dies dient dazu, ein kleines Zertifikat zu installieren, damit dein Browser mhrv-rs vertraut. Das Zertifikat wird auf deinem Computer generiert und verlässt ihn nie — keine Cloud, kein Google, nichts Fernes kann es nutzen.

Das mhrv-rs-Fenster öffnet sich. Fülle aus:

• Apps Script-ID(s) → füge die Bereitstellungs-ID aus Schritt 1 ein
• Auth-Key → füge den zufälligen String ein, den du in Code.gs gesetzt hast
• Lasse alles andere auf den Standardwerten

Klicke auf Konfiguration speichern, dann auf Starten. Der Statuskreis wird grün, wenn es funktioniert.

Teste es: Klicke auf die Schaltfläche Test. Es sendet eine Anfrage durch das Relay und teilt dir mit, ob es funktioniert hat.

Schritt 4 — Deinem Browser mitteilen, mhrv-rs zu verwenden

Firefox (empfohlen — am einfachsten)

1. Firefox → ☰-Menü → Einstellungen
2. Suche im Suchfeld nach „Proxy"
3. Klicke unter Netzwerkeinstellungen auf Einstellungen…
4. Wähle Manuelle Proxy-Konfiguration
5. HTTP-Proxy: 127.0.0.1 Port: 8085
6. ☑ Aktiviere „Diesen Proxy auch für HTTPS verwenden"
7. Klicke auf OK

Chrome / Edge

Installiere die Erweiterung Proxy SwitchyOmega und setze den Proxy auf 127.0.0.1:8085.

macOS (systemweit)

Systemeinstellungen → Netzwerk → Wi-Fi → Details → Proxies → aktiviere sowohl Web-Proxy (HTTP) als auch Sicherer Web-Proxy (HTTPS), beide mit 127.0.0.1:8085.

Schritt 5 — Ausprobieren

Öffne eine blockierte Website in deinem Browser. Sie sollte geladen werden.

Wenn etwas nicht funktioniert:

• Klicke im mhrv-rs-Fenster auf Test — es zeigt an, bei welchem Schritt es hakt
• Sieh dir das Bedienfeld Letzte Logs am unteren Rand des Fensters an
• Siehe die Häufigen Fragen unten

Häufige Fragen

Ist das wirklich kostenlos? Ja. Google gewährt jedem Konto 20.000 ausgehende URL-Abrufe pro Tag in der kostenlosen Stufe. Das ist reichlich für das normale Surfen einer Person. Für eine Familie mit 3–4 Personen, die das gleiche Setup teilt, erstelle 2–3 Bereitstellungen in verschiedenen Google-Konten und füge alle IDs hinzu.

Ist es sicher? Das Zertifikat bleibt auf deinem Computer — niemand anders hat den privaten Schlüssel. Dein auth_key ist dein Geheimnis. Google sieht die Websites, die du über das Relay besuchst (weil Apps Script sie in deinem Auftrag abruft) — genauso wie bei jedem gehosteten Proxy. Wenn dir das nicht recht ist, verwende den Full-Tunnel-Modus mit einem eigenen VPS — siehe die vollständige Anleitung.

YouTube-Videos werden nicht abgespielt. Die Videosegmente von YouTube kommen von googlevideo.com, das Apps Script nicht erreichen kann (Google blockiert den Zugriff von Apps Script auf das eigene Video-CDN). Die Seite selbst wird normal geladen; nur die Videowiedergabe ist betroffen. Lösung: Full Tunnel + VPS, oder füge .googlevideo.com zu passthrough_hosts in deiner Konfiguration hinzu (der Browser greift direkt darauf zu, aber bei iranischen ISPs ist es immer noch gedrosselt).

ChatGPT / Claude / Grok zeigt ein Cloudflare-CAPTCHA. Cloudflare markiert Google-Rechenzentrums-IPs als Bots. Lösung: Richte einen Exit-Node ein — einen kleinen TypeScript-Handler, den du auf einem serverlosen Host (Deno Deploy, fly.io, deinem eigenen VPS) bereitstellst und der Apps Script → deinen Exit-Node → claude.ai verbindet. Siehe assets/exit_node/README.md.

Telegram ist instabil. Telegram verwendet MTProto, das Apps Script nicht spricht. Kombiniere es mit xray auf deinem Rechner — siehe Telegram via xray in der vollständigen Anleitung.

Der ISP blockiert script.google.com selbst. mhrv-rs hat einen direct-Modus, der nur den SNI-Umschreibungstunnel verwendet (ohne Apps Script). Verwende ihn einmal, um auf script.google.com zuzugreifen und dein Skript bereitzustellen, wechsle dann in den apps_script-Modus. Siehe direct-Modus.

Meine Google-Suche erscheint ohne JavaScript. Der User-Agent von Apps Script ist fest auf Google-Apps-Script eingestellt (Google erlaubt Skripten nicht, ihn zu ändern), daher liefern einige Websites einen JavaScript-freien Fallback. Workaround: Füge die betroffene Domain zu deiner hosts-Map hinzu, damit sie mit deinem echten Browser-User-Agent durch den SNI-Umschreibungstunnel geht. google.com, youtube.com, fonts.googleapis.com sind standardmäßig bereits in dieser Liste.

Weitere Fragen: Vollständige FAQ in der ausführlichen Anleitung.

Hilfe benötigt?

• Suche in offenen und geschlossenen Issues — dein Problem könnte bereits beantwortet sein
• Erstelle ein neues Issue mit: deiner Konfiguration (auth_key maskieren!), genau dem, was du versucht hast, und genau dem, was du im Log gesehen hast

Danksagungen

Originalprojekt: @masterking32/MasterHttpRelayVPN. Die Idee, das Apps Script-Protokoll, die Proxy-Architektur — alles von ihm. Dieser Rust-Port existiert, um die clientseitige Verteilung zu vereinfachen (einzelne Binärdatei, keine Python-Installation).

Der Großteil des Rust-Codes in diesem Port wurde mit Anthropics Claude geschrieben und bei jedem Commit von einem Menschen überprüft.

Unterstütze dieses Projekt

❤️ Spende auf sh1n.org — deckt Hosting- und CI-Runner-Kosten. Das Sternen des Repos hilft auch zu signalisieren, dass das Projekt es wert ist, am Leben erhalten zu werden.