mhrv-rs — bypassa la censura gratuitamente con il tuo account Google

Un piccolo programma che gira sul tuo computer e ti permette di visitare siti bloccati gratuitamente, utilizzando uno Google Apps Script che implementi nel tuo account Google gratuito. Il tuo ISP vede solo traffico criptato verso www.google.com e non può sapere quali siti visiti realmente.

🇬🇧 Guida rapida in inglese · Guida completa (argomenti avanzati) 🇮🇷 راهنمای راه‌اندازی سریع فارسی · راهنمای کامل (موضوعات پیشرفته)

Cosa ottieni

Come funziona (schema semplice)

   tu  →  browser  →  mhrv-rs  ──┐
                                 │ ISP vede solo: www.google.com
                                 ▼
                         Rete di Google
                                 │
                                 ▼
           Tuo Google Apps Script recupera il sito reale
                                 │
                                 ▼
            Twitter / ChatGPT / sito bloccato a scelta tua

Gli ISP non possono leggere l'interno del traffico HTTPS criptato, vedono solo che stai accedendo a www.google.com. La richiesta reale avviene internamente alla rete di Google.

Guida rapida

Durata ~5 minuti. Hai bisogno di:

• Un account Google gratuito (qualsiasi Gmail)
• Un computer (Mac, Windows, Linux)
• Browser Firefox o Chrome

Passo 1 — Crea lo script Google Apps (una tantum)

1. Vai su script.google.com e accedi con il tuo account Google
2. Clicca su Nuovo progetto in alto a sinistra
3. Elimina il codice predefinito
4. Apri il file assets/apps_script/Code.gs di questo repository, copia tutto e incollalo nell’editor di Apps Script
5. Trova la riga:

   const AUTH_KEY = "CHANGE_ME_TO_A_STRONG_SECRET";
   

   Sostituisci CHANGE_ME_TO_A_STRONG_SECRET con una stringa casuale lunga a tua scelta. Salvala, ti servirà come password.
6. Clicca 💾 Salva
7. Clicca su Deploy → New deployment
8. Clicca sull'ingranaggio ⚙ accanto a "Select type" e scegli Web app
9. Imposta:
   • Execute as: Me (il tuo account Google)
   • Who has access: Anyone
10. Clicca Deploy, autorizza se richiesto
11. Copia il Deployment ID (stringa casuale che ti viene mostrata) — ti serve nel passo successivo

Nota: per aggiornare il codice non servono nuove distribuzioni, usa Manage deployments e crea una nuova versione mantenendo lo stesso Deployment ID.

Passo 2 — Scarica mhrv-rs

Scarica il file adatto al tuo sistema operativo dalla pagina delle ultime release:

Se dubbi sul chip Mac, verifica in "Informazioni su Mac".

Per errori GLIBC su Linux usa la versione linux-musl-amd64.

Estrai l’archivio.

Passo 3 — Primo avvio

Avvia il programma:

Al primo avvio ti verrà chiesta la password di sistema per installare un certificato locale che il browser può fidarsi. Il certificato viene generato solo sul tuo computer.

Nella finestra di mhrv-rs inserisci:

• Apps Script ID(s): incolla il Deployment ID ottenuto nel Passo 1
• Auth key: incolla la stringa segreta scelta nel Passo 1

Lascia le altre opzioni di default, clicca Save config e poi Start. Il cerchio di stato diventerà verde se funziona.

Puoi cliccare Test per provare immediatamente la connessione.

Passo 4 — Configura il browser per usare mhrv-rs come proxy

Firefox (consigliato)

1. Ottieni il menu ☰ → Impostazioni
2. Cerca "proxy"
3. In "Impostazioni di rete" clicca su Impostazioni...
4. Seleziona Configurazione manuale del proxy
5. Imposta "HTTP Proxy" a 127.0.0.1 e porta 8085
6. Spunta Utilizza questo proxy anche per HTTPS
7. Conferma con OK

Chrome / Edge

Installa l’estensione Proxy SwitchyOmega e configura il proxy a 127.0.0.1:8085.

macOS (sistema intero)

Impostazioni di sistema → Rete → Wi-Fi → Dettagli → Proxy → attiva sia Web Proxy (HTTP) che Secure Web Proxy (HTTPS) a 127.0.0.1:8085.

Passo 5 — Prova a navigare

Apri qualsiasi sito bloccato, dovrebbe caricarsi.

Se non funziona:

• Usa il pulsante Test in mhrv-rs
• Controlla i log recenti nella finestra
• Consulta la sezione FAQ nel readme

Domande frequenti

• È veramente gratuito? Sì. Google fornisce 20.000 fetch URL in uscita al giorno per account, sufficiente per navigazione normale di una persona. Famiglie o gruppi possono distribuire le chiamate su più account.

• È sicuro? La chiave privata del certificato resta sul tuo dispositivo. Google vede i siti visitati attraverso il relay, come qualsiasi proxy.

• I video di YouTube non si caricano. Apps Script non può accedere a googlevideo.com (CDN video), quindi solo il video fallisce; la pagina si carica.

• ChatGPT e servizi simili mostrano CAPTCHA. Cloudflare segnala gli IP Google come bot. È possibile configurare un nodo di uscita su un server esterno per aggirare questo.

• Telegram è instabile. Usa con soluzioni aggiuntive come xray per il protocollo MTProto.

• Il tuo ISP blocca anche script.google.com. Usa la modalità direct per superare il blocco temporaneamente.

• La ricerca Google appare senza JavaScript. Alcuni siti servono contenuti fallback perché lo User-Agent è "Google-Apps-Script". Puoi aggirare aggiungendo il dominio interessato alla mappa hosts per forzare il routing alternativo.

Supporto

• Cerca nelle issue aperte o chiuse per problemi simili
• Apri una nuova issue fornendo la configurazione (nascondendo auth_key), cosa hai provato e i log

Crediti

Progetto originale: @masterking32/MasterHttpRelayVPN — idea, protocollo Apps Script, architettura proxy. Questa versione in Rust facilita la distribuzione cliente (single binary senza Python).

Molto del codice Rust è stato scritto con l’aiuto di Anthropic's Claude e revisionato da umani.

Supporta il progetto

❤️ Dona su sh1n.org per coprire i costi di hosting e CI.