mhrv-rs — burle a censura gratuitamente, com sua própria conta do Google

Um pequeno programa que roda no seu computador e permite visitar sites bloqueados gratuitamente, usando um Google Apps Script que você implanta na sua própria conta gratuita do Google. Sua operadora vê apenas tráfego criptografado para www.google.com — ela não consegue saber o que você realmente está visitando.

🇬🇧 Guia Rápido em Inglês · Guia Completo (tópicos avançados) 🇮🇷 راه‌اندازی سریع فارسی · راهنمای کامل (مباحث پیشرفته)

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

O que você obtém

• 🌐 Ignora bloqueio DPI / SNI usando a borda do Google como relay
• 💯 Completamente gratuito — roda no nível gratuito da sua própria conta do Google
• ⚡ Um arquivo pequeno (~3 MB), sem Python, sem Node.js, sem dependências
• 🖥️ Funciona em Mac, Windows, Linux, Android, roteadores OpenWRT
• 🦊 Qualquer navegador ou aplicativo que suporte proxy HTTP ou SOCKS5

Como funciona (imagem simples)

   você  →  navegador  →  mhrv-rs  ──┐
                                      │ ISP só vê:  www.google.com
                                      ▼
                              Rede do Google
                                      │
                                      ▼
              seu Apps Script gratuito busca o site real
                                      │
                                      ▼
                Twitter / ChatGPT / site bloqueado de sua escolha

ISPs não conseguem ler dentro do HTTPS criptografado. Eles veem apenas o endereço — www.google.com. A consulta real da página acontece dentro da rede do Google, oculta no túnel criptografado.

Início Rápido

Cerca de 5 minutos. Você precisa de:

• Uma conta gratuita do Google (qualquer Gmail serve)
• Um computador (Mac, Windows ou Linux)
• Firefox ou Chrome

Passo 1 — Crie o Google Apps Script (uma vez)

1. Acesse script.google.com, faça login com sua conta do Google
2. Clique em New project no canto superior esquerdo
3. Exclua o código padrão no editor
4. Abra o arquivo assets/apps_script/Code.gs neste repositório, copie todo o conteúdo, cole no editor do Apps Script (substituindo o que estava lá)
5. Encontre esta linha perto do topo:
   root@kitploit:~

   const AUTH_KEY = "CHANGE_ME_TO_A_STRONG_SECRET";
   

   Altere CHANGE_ME_TO_A_STRONG_SECRET para uma longa string aleatória de sua escolha. Guarde esta string — você a colará no aplicativo no Passo 3. Trate-a como uma senha.
6. Clique em 💾 Save (ou Ctrl/Cmd+S)
7. Clique em Deploy (canto superior direito) → New deployment
8. Clique no ícone de engrenagem ⚙ ao lado de "Select type" → escolha Web app
9. Defina:
   • Execute as: Me (sua conta do Google)
   • Who has access: Anyone
10. Clique em Deploy. O Google pode pedir permissões — clique em Authorize access e aprove
11. O Google mostra um Deployment ID (uma longa string aleatória). Copie-o — você precisará dele no Passo 3.

Dica: se você atualizar Code.gs depois, não crie um novo deployment. Edite o código, depois vá em Deploy → Manage deployments → ✏️ → Version: New version → Deploy. O Deployment ID permanece o mesmo.

Passo 2 — Baixe o mhrv-rs

Acesse a página do último lançamento e baixe o arquivo para seu computador:

Mac: não tem certeza se é Apple Silicon ou Intel? Clique em → About This Mac. Se "Chip" disser Apple, pegue arm64. Se Intel, pegue amd64.

Linux: recebendo erro GLIBC? Use o arquivo linux-musl-amd64 — funciona em qualquer Linux sem dependências.

Descompacte.

Passo 3 — Primeira execução

Clique duas vezes no lançador:

| Mac | run.command | | Windows | run.bat | | Linux | ./run.sh (em um terminal) |

Na primeira vez, ele pede a senha do seu computador. Isso é para instalar um pequeno certificado para que seu navegador confie no mhrv-rs. O certificado é gerado no seu computador e nunca sai dele — nenhuma nuvem, nenhum Google, nada remoto pode usá-lo.

A janela do mhrv-rs abre. Preencha:

• Apps Script ID(s) → cole o Deployment ID do Passo 1
• Auth key → cole a string aleatória que você colocou em Code.gs
• Deixe todo o resto como padrão

Clique em Save config, depois Start. O círculo de status fica verde se funcionar.

Teste: clique no botão Test. Ele envia uma requisição através do relay e informa se funcionou.

Passo 4 — Configure seu navegador para usar o mhrv-rs

Firefox (recomendado — mais fácil)

1. Firefox → ☰ menu → Settings
2. Pesquise "proxy" na caixa de busca
3. Clique em Settings… em Network Settings
4. Escolha Manual proxy configuration
5. HTTP Proxy: 127.0.0.1 Porta: 8085
6. ☑ Marque "Also use this proxy for HTTPS"
7. Clique em OK

Chrome / Edge

Instale a extensão Proxy SwitchyOmega e configure o proxy para 127.0.0.1:8085.

macOS (sistema inteiro)

System Settings → Network → Wi-Fi → Details → Proxies → habilite Web Proxy (HTTP) e Secure Web Proxy (HTTPS), ambos apontando para 127.0.0.1:8085.

Passo 5 — Teste

Abra qualquer site bloqueado em seu navegador. Deve carregar.

Se algo não funcionar:

• Clique em Test na janela do mhrv-rs — ele identifica qual etapa está falhando
• Olhe no painel Recent log na parte inferior da janela
• Veja Perguntas frequentes abaixo

Perguntas frequentes

É realmente gratuito? Sim. O Google oferece a cada conta 20.000 requisições de URL de saída por dia no nível gratuito. Isso é suficiente para a navegação normal de uma pessoa. Para uma família de 3-4 pessoas compartilhando a mesma configuração, faça 2-3 deployments em diferentes contas do Google e adicione todos os IDs.

É seguro? O certificado permanece no seu computador — ninguém mais tem a chave privada. Sua auth_key é seu segredo. O Google vê os sites que você visita através do relay (porque o Apps Script os busca em seu nome) — igual a qualquer proxy hospedado. Se você não se sentir confortável com isso, use o modo Full Tunnel com seu próprio VPS — veja o guia completo.

Vídeos do YouTube não tocam. Os chunks de vídeo do YouTube vêm de googlevideo.com, que o Apps Script não consegue acessar (o Google bloqueia o Apps Script de acessar o próprio CDN de vídeo). A página em si carrega bem; apenas a reprodução de vídeo é afetada. Correção: Full Tunnel + VPS, ou adicione .googlevideo.com a passthrough_hosts na sua configuração (o navegador acessa diretamente, mas em ISPs do Irã ainda é limitado).

ChatGPT / Claude / Grok mostra um CAPTCHA do Cloudflare. O Cloudflare marca IPs de datacenter do Google como bots. Correção: configure um exit node — um pequeno handler TypeScript que você implanta em um host serverless (Deno Deploy, fly.io, seu próprio VPS) que faz a ponte Apps Script → seu exit node → claude.ai. Veja assets/exit_node/README.md.

Telegram é instável. O Telegram usa MTProto, que o Apps Script não entende. Combine com xray na sua máquina — veja Telegram via xray no guia completo.

O ISP bloqueia o próprio script.google.com. O mhrv-rs tem um modo direct que usa apenas o túnel de reescrita SNI (sem Apps Script). Use-o uma vez para acessar script.google.com e implantar seu script, depois mude para o modo apps_script. Veja modo direct.

Minha busca no Google aparece sem JavaScript. O User-Agent do Apps Script é fixo em Google-Apps-Script (o Google não permite que scripts o alterem), então alguns sites servem uma versão sem JS. Solução alternativa: adicione o domínio afetado ao seu mapa hosts para que ele passe pelo túnel de reescrita SNI com o User-Agent real do seu navegador. google.com, youtube.com, fonts.googleapis.com já estão nesta lista por padrão.

Mais perguntas: FAQ completo no guia detalhado.

Precisa de ajuda?

• Pesquise issues abertas e fechadas — seu problema pode já ter resposta
• Abra uma nova issue com: sua configuração (oculte auth_key!), exatamente o que tentou, exatamente o que viu no log

Créditos

Projeto original: @masterking32/MasterHttpRelayVPN. A ideia, o protocolo Apps Script, a arquitetura de proxy — tudo dele. Este port em Rust existe para facilitar a distribuição no lado do cliente (binário único, sem instalação de Python).

A maior parte do código Rust neste port foi escrita com Claude da Anthropic, revisada por um humano em cada commit.

Apoie este projeto

❤️ Doe em sh1n.org — cobre custos de hospedagem e CI runner. Dar estrela no repositório também ajuda a sinalizar que o projeto vale a pena ser mantido.

  تو  ←  مرورگر  ←  mhrv-rs  ──┐
                                │ ISP فقط می‌بیند:  www.google.com
                                ▼
                         شبکهٔ گوگل
                                │
                                ▼
            اسکریپت رایگان گوگل تو  سایت اصلی را  باز می‌کند
                                │
                                ▼
              توییتر / ChatGPT / هر سایت مسدودی

const AUTH_KEY = "CHANGE_ME_TO_A_STRONG_SECRET";