🇬🇧 Guide de démarrage rapide en anglais · Guide complet (sujets avancés) 🇮🇷 راه‌اندازی سریع فارسی · راهنمای کامل (مباحث پیشرفته)

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

Ce que vous obtenez

• 🌐 Contourne le blocage DPI/SNI en utilisant le bord de Google comme relais
• 💯 Entièrement gratuit — fonctionne sur le niveau gratuit de votre propre compte Google
• ⚡ Un seul petit fichier (~3 Mo), pas de Python, pas de Node.js, pas de dépendances
• 🖥️ Fonctionne sur Mac, Windows, Linux, Android, routeurs OpenWRT
• 🦊 Tout navigateur ou application supportant un proxy HTTP ou SOCKS5

Comment ça marche (vue simplifiée)

Les FAI ne peuvent pas lire à l'intérieur du HTTPS chiffré. Ils ne voient que l'adresse — www.google.com. La recherche réelle de la page se fait à l'intérieur du réseau de Google, cachée dans le tunnel chiffré.

Démarrage rapide

Environ 5 minutes. Il vous faut :

• Un compte Google gratuit (n'importe quel Gmail fonctionne)
• Un ordinateur (Mac, Windows ou Linux)
• Firefox ou Chrome

Étape 1 — Créer le Google Apps Script (une fois)

1. Allez sur script.google.com et connectez-vous avec votre compte Google
2. Cliquez sur Nouveau projet en haut à gauche
3. Supprimez le code par défaut dans l'éditeur
4. Ouvrez le fichier assets/apps_script/Code.gs de ce dépôt, copiez tout son contenu, et collez-le dans l'éditeur Apps Script (en remplaçant ce qu'il y avait)
5. Trouvez cette ligne près du haut :
   root@kitploit:~

   const AUTH_KEY = "CHANGE_ME_TO_A_STRONG_SECRET";
   

   Remplacez CHANGE_ME_TO_A_STRONG_SECRET par une longue chaîne aléatoire de votre choix. Conservez cette chaîne — vous la collerez dans l'application à l'étape 3. Traitez-la comme un mot de passe.
6. Cliquez sur 💾 Enregistrer (ou Ctrl/Cmd+S)
7. Cliquez sur Déployer (en haut à droite) → Nouveau déploiement
8. Cliquez sur l'icône d'engrenage ⚙ à côté de "Sélectionner le type" → choisissez Application Web
9. Définissez :
   • Exécuter en tant que : Moi (votre compte Google)
   • Qui a accès : Tout le monde
10. Cliquez sur Déployer. Google peut demander des autorisations — cliquez sur Autoriser l'accès et approuvez
11. Google affiche un ID de déploiement (une longue chaîne aléatoire). Copiez-le — vous en aurez besoin à l'étape 3.

Astuce : si vous mettez à jour Code.gs plus tard, ne créez pas un nouveau déploiement. Modifiez le code, puis allez dans Déployer → Gérer les déploiements → ✏️ → Version : Nouvelle version → Déployer. L'ID de déploiement reste le même.

Étape 2 — Télécharger mhrv-rs

Rendez-vous sur la page de la dernière version et téléchargez le fichier correspondant à votre ordinateur :

Mac : vous ne savez pas si c'est Apple Silicon ou Intel ? Cliquez sur → À propos de ce Mac. Si "Puce" indique Apple, prenez arm64. Si Intel, prenez amd64.

Linux : vous obtenez une erreur GLIBC ? Utilisez plutôt le fichier linux-musl-amd64 — il fonctionne sur n'importe quel Linux sans dépendances.

Décompressez-le.

Étape 3 — Premier lancement

Double-cliquez sur le lanceur :

| Mac | run.command | | Windows | run.bat | | Linux | ./run.sh (dans un terminal) |

La première fois, il demande votre mot de passe d'ordinateur. Ceci est nécessaire pour installer un petit certificat afin que votre navigateur fasse confiance à mhrv-rs. Le certificat est généré sur votre ordinateur et ne le quitte jamais — aucun cloud, aucun Google, rien à distance ne peut l'utiliser.

La fenêtre de mhrv-rs s'ouvre. Remplissez :

• Apps Script ID(s) → collez l'ID de déploiement de l'étape 1
• Auth key → collez la chaîne aléatoire que vous avez mise dans Code.gs
• Laissez tout le reste par défaut

Cliquez sur Enregistrer la config, puis Démarrer. Le cercle d'état devient vert si cela fonctionne.

Testez-le : cliquez sur le bouton Tester. Il envoie une requête via le relais et vous indique si cela a fonctionné.

Étape 4 — Configurer votre navigateur pour utiliser mhrv-rs

Firefox (recommandé — le plus simple)

1. Firefox → menu ☰ → Paramètres
2. Recherchez "proxy" dans la zone de recherche
3. Cliquez sur Paramètres… sous Paramètres réseau
4. Choisissez Configuration manuelle du proxy
5. Proxy HTTP : 127.0.0.1 Port : 8085
6. ☑ Cochez "Utiliser aussi ce proxy pour HTTPS"
7. Cliquez sur OK

Chrome / Edge

Installez l'extension Proxy SwitchyOmega et configurez le proxy sur 127.0.0.1:8085.

macOS (système entier)

Paramètres système → Réseau → Wi-Fi → Détails → Proxies → activez à la fois Proxy Web (HTTP) et Proxy Web sécurisé (HTTPS), les deux pointant sur 127.0.0.1:8085.

Étape 5 — Essayez-le

Ouvrez n'importe quel site bloqué dans votre navigateur. Il devrait se charger.

Si quelque chose ne fonctionne pas :

• Cliquez sur Tester dans la fenêtre de mhrv-rs — cela identifie l'étape qui échoue
• Regardez le panneau Journal récent en bas de la fenêtre
• Consultez la section Questions courantes ci-dessous

Questions courantes

Est-ce vraiment gratuit ? Oui. Google offre à chaque compte 20 000 récupérations d'URL sortantes par jour sur le niveau gratuit. C'est largement suffisant pour la navigation normale d'une seule personne. Pour une famille de 3 à 4 personnes partageant la même configuration, créez 2 à 3 déploiements dans différents comptes Google et ajoutez tous les ID.

Est-ce sûr ? Le certificat reste sur votre ordinateur — personne d'autre n'a la clé privée. Votre auth_key est votre secret. Google voit les sites web que vous visitez via le relais (car Apps Script les récupère pour vous) — comme tout proxy hébergé. Si cela ne vous convient pas, utilisez le mode Tunnel complet avec votre propre VPS — voir le guide complet.

Les vidéos YouTube ne se lancent pas. Les fragments vidéo de YouTube proviennent de googlevideo.com, inaccessible à Apps Script (Google bloque l'accès d'Apps Script à son propre CDN vidéo). La page elle-même se charge bien ; seule la lecture vidéo est affectée. Solution : Tunnel complet + VPS, ou ajoutez .googlevideo.com à passthrough_hosts dans votre configuration (le navigateur y accède directement, mais sur les FAI iraniens, il reste ralenti).

ChatGPT / Claude / Grok affiche un CAPTCHA Cloudflare. Cloudflare signale les adresses IP des datacenters Google comme des robots. Solution : configurez un nœud de sortie — un petit gestionnaire TypeScript que vous déployez sur un hébergeur serverless (Deno Deploy, fly.io, votre propre VPS) qui fait le pont entre Apps Script et votre nœud de sortie, puis vers claude.ai. Voir assets/exit_node/README.md.

Telegram est instable. Telegram utilise MTProto, qu'Apps Script ne comprend pas. Associez-le avec xray sur votre machine — voir Telegram via xray dans le guide complet.

Le FAI bloque script.google.com lui-même. mhrv-rs dispose d'un mode direct qui utilise uniquement le tunnel de réécriture SNI (sans Apps Script). Utilisez-le une fois pour accéder à script.google.com et déployer votre script, puis basculez en mode apps_script. Voir mode direct.

Ma recherche Google s'affiche sans JavaScript. Le User-Agent d'Apps Script est fixé à Google-Apps-Script (Google ne permet pas aux scripts de le changer), donc certains sites renvoient une version sans JS. Solution : ajoutez le domaine concerné à votre carte hosts pour qu'il passe par le tunnel de réécriture SNI avec votre vrai User-Agent de navigateur. google.com, youtube.com, fonts.googleapis.com sont déjà dans cette liste par défaut.

Plus de questions : FAQ complète dans le guide détaillé.

Besoin d'aide ?

• Recherchez dans les problèmes ouverts et fermés — votre problème a peut-être déjà une réponse
• Ouvrez un nouveau problème avec : votre configuration (masquez auth_key !), exactement ce que vous avez essayé, exactement ce que vous avez vu dans le journal

Crédits

Projet original : @masterking32/MasterHttpRelayVPN. L'idée, le protocole Apps Script, l'architecture proxy — tout lui appartient. Ce portage Rust existe pour faciliter la distribution côté client (un seul binaire, pas d'installation Python).

La majeure partie du code Rust de ce portage a été écrite avec Anthropic's Claude, et revue par un humain à chaque commit.

Soutenir ce projet

❤️ Faire un don sur sh1n.org — couvre les frais d'hébergement et de CI. Mettre une étoile au dépôt aide aussi à signaler que le projet mérite d'être maintenu.