mhrv-rs — elude la censura gratis, con tu propia cuenta de Google

Un pequeño programa que se ejecuta en tu ordenador y te permite visitar sitios web bloqueados de forma gratuita, usando un Google Apps Script que despliegas en tu propia cuenta gratuita de Google. Tu ISP solo ve tráfico cifrado hacia www.google.com — no puede saber qué estás visitando realmente.

🇬🇧 English Quick Start · Full Guide (advanced topics) 🇮🇷 راه‌اندازی سریع فارسی · راهنمای کامل (مباحث پیشرفته)

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

Lo que obtienes

• 🌐 Evita el bloqueo DPI / SNI usando el borde de Google como relé
• 💯 Completamente gratuito — se ejecuta en el nivel gratuito de tu propia cuenta de Google
• ⚡ Un archivo pequeño (~3 MB), sin Python, sin Node.js, sin dependencias
• 🖥️ Funciona en Mac, Windows, Linux, Android, routers OpenWRT
• 🦊 Cualquier navegador o aplicación que admita proxy HTTP o SOCKS5

Cómo funciona (la imagen simple)

   tú  →  navegador  →  mhrv-rs  ──┐
                                   │ El ISP solo ve:  www.google.com
                                   ▼
                           La red de Google
                                   │
                                   ▼
              tu Apps Script gratuito  obtiene  el sitio real
                                   │
                                   ▼
                Twitter / ChatGPT / sitio bloqueado de tu elección

Los ISP no pueden leer dentro del HTTPS cifrado. Solo ven la dirección — www.google.com. La búsqueda real de la página ocurre dentro de la red de Google, oculta en el túnel cifrado.

Inicio rápido

Unos 5 minutos. Necesitas:

• Una cuenta gratuita de Google (cualquier Gmail funciona)
• Un ordenador (Mac, Windows o Linux)
• Firefox o Chrome

Paso 1 — Crear el Google Apps Script (una sola vez)

1. Ve a script.google.com, inicia sesión con tu cuenta de Google
2. Haz clic en New project en la parte superior izquierda
3. Elimina el código predeterminado en el editor
4. Abre el archivo assets/apps_script/Code.gs en este repositorio, cópialo todo, pégalo en el editor de Apps Script (reemplazando lo que había)
5. Busca esta línea cerca de la parte superior:
   root@kitploit:~

   const AUTH_KEY = "CHANGE_ME_TO_A_STRONG_SECRET";
   

   Cambia CHANGE_ME_TO_A_STRONG_SECRET por una cadena aleatoria larga propia. Guarda esta cadena — la pegarás en la aplicación en el Paso 3. Trátala como una contraseña.
6. Haz clic en 💾 Save (o Ctrl/Cmd+S)
7. Haz clic en Deploy (arriba a la derecha) → New deployment
8. Haz clic en el icono de engranaje ⚙ junto a "Select type" → elige Web app
9. Configura:
   • Execute as: Me (tu cuenta de Google)
   • Who has access: Anyone
10. Haz clic en Deploy. Google puede solicitar permisos — haz clic en Authorize access y aprueba
11. Google muestra un Deployment ID (una cadena aleatoria larga). Cópialo — lo necesitarás en el Paso 3.

Consejo: si más tarde actualizas Code.gs, no crees un nuevo deployment. Edita el código, luego ve a Deploy → Manage deployments → ✏️ → Version: New version → Deploy. El Deployment ID sigue siendo el mismo.

Paso 2 — Descargar mhrv-rs

Ve a la página de la última versión y descarga el archivo para tu ordenador:

Mac: ¿no sabes si es Apple Silicon o Intel? Haz clic en → About This Mac. Si "Chip" dice Apple, obtén arm64. Si dice Intel, obtén amd64.

Linux: ¿tienes un error de GLIBC? Usa el archivo linux-musl-amd64 en su lugar — funciona en cualquier Linux sin dependencias.

Descomprímelo.

Paso 3 — Primera ejecución

Haz doble clic en el lanzador:

| Mac | run.command | | Windows | run.bat | | Linux | ./run.sh (en una terminal) |

La primera vez, solicita la contraseña de tu ordenador. Esto es para instalar un pequeño certificado para que tu navegador confíe en mhrv-rs. El certificado se genera en tu ordenador y nunca sale de él — ninguna nube, ni Google, ni nada remoto puede usarlo.

Se abre la ventana de mhrv-rs. Rellena:

• Apps Script ID(s) → pega el Deployment ID del Paso 1
• Auth key → pega la cadena aleatoria que pusiste en Code.gs
• Deja todo lo demás con los valores predeterminados

Haz clic en Save config, luego en Start. El círculo de estado se vuelve verde si funciona.

Pruébalo: haz clic en el botón Test. Envía una solicitud a través del relé y te dice si funcionó.

Paso 4 — Configurar tu navegador para usar mhrv-rs

Firefox (recomendado — el más fácil)

1. Firefox → menú ☰ → Settings
2. Busca "proxy" en el cuadro de búsqueda
3. Haz clic en Settings… en Network Settings
4. Elige Manual proxy configuration
5. HTTP Proxy: 127.0.0.1 Puerto: 8085
6. ☑ Marca "Also use this proxy for HTTPS"
7. Haz clic en OK

Chrome / Edge

Instala la extensión Proxy SwitchyOmega y configura el proxy a 127.0.0.1:8085.

macOS (todo el sistema)

System Settings → Network → Wi-Fi → Details → Proxies → habilita tanto Web Proxy (HTTP) como Secure Web Proxy (HTTPS), ambos apuntando a 127.0.0.1:8085.

Paso 5 — Pruébalo

Abre cualquier sitio bloqueado en tu navegador. Debería cargarse.

Si algo no funciona:

• Haz clic en Test en la ventana de mhrv-rs — señala qué paso está fallando
• Mira el panel Recent log en la parte inferior de la ventana
• Consulta Preguntas frecuentes a continuación

Preguntas frecuentes

¿Esto es realmente gratuito? Sí. Google ofrece a cada cuenta 20 000 solicitudes de URL salientes por día en el nivel gratuito. Es más que suficiente para la navegación normal de una persona. Para una familia de 3-4 personas que compartan la misma configuración, haz 2-3 despliegues en diferentes cuentas de Google y añade todos los IDs.

¿Es seguro? El certificado permanece en tu ordenador — nadie más tiene la clave privada. Tu auth_key es tu secreto. Google ve los sitios web que visitas a través del relé (porque Apps Script los obtiene en tu nombre) — igual que cualquier proxy alojado. Si no te parece bien, usa el modo Full Tunnel con tu propio VPS — consulta la guía completa.

Los videos de YouTube no se reproducen. Los fragmentos de video de YouTube provienen de googlevideo.com, a los que Apps Script no puede acceder (Google bloquea que Apps Script acceda a su propia CDN de video). La página en sí se carga bien; solo se ve afectada la reproducción de video. Solución: Full Tunnel + VPS, o añade .googlevideo.com a passthrough_hosts en tu configuración (el navegador lo accede directamente, pero en los ISP de Irán sigue siendo estrangulado).

ChatGPT / Claude / Grok muestra un CAPTCHA de Cloudflare. Cloudflare marca las IPs del centro de datos de Google como bots. Solución: configura un exit node — un pequeño manejador TypeScript que despliegues en un host serverless (Deno Deploy, fly.io, tu propio VPS) que sirva de puente entre Apps Script → tu exit node → claude.ai. Consulta assets/exit_node/README.md.

Telegram es inestable. Telegram usa MTProto, que Apps Script no entiende. Combínalo con xray en tu máquina — consulta Telegram via xray en la guía completa.

El ISP bloquea script.google.com en sí. mhrv-rs tiene un modo direct que usa solo el túnel de reescritura SNI (sin Apps Script). Úsalo una vez para acceder a script.google.com y desplegar tu script, luego cambia al modo apps_script. Consulta modo direct.

Mi búsqueda de Google aparece sin JavaScript. El User-Agent de Apps Script está fijado a Google-Apps-Script (Google no permite que los scripts lo cambien), por lo que algunos sitios sirven una versión sin JS. Solución: añade el dominio afectado a tu mapa hosts para que pase por el túnel de reescritura SNI con el User-Agent real de tu navegador. google.com, youtube.com, fonts.googleapis.com ya están en esta lista por defecto.

Más preguntas: FAQ completa en la guía larga.

¿Necesitas ayuda?

• Busca en issues abiertos y cerrados — tu problema podría tener respuesta
• Abre un nuevo issue con: tu configuración (¡oculta auth_key!), exactamente qué intentaste, exactamente qué viste en el registro

Créditos

Proyecto original: @masterking32/MasterHttpRelayVPN. La idea, el protocolo Apps Script, la arquitectura del proxy — todo suyo. Este puerto a Rust existe para facilitar la distribución del lado del cliente (un solo binario, sin instalación de Python).

La mayor parte del código Rust de este puerto fue escrita con Claude de Anthropic, revisada por un humano en cada commit.

Apoya este proyecto

❤️ Donar en sh1n.org — cubre los costos de hosting y los runners de CI. Marcar el repositorio con estrella también ayuda a señalar que vale la pena mantener el proyecto.

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

const AUTH_KEY = "CHANGE_ME_TO_A_STRONG_SECRET";