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

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

Что вы получаете

• 🌐 Обход DPI / блокировки SNI с использованием граничных сетей Google в качестве ретранслятора
• 💯 Полностью бесплатно — работает на бесплатном тарифе вашего собственного аккаунта Google
• ⚡ Один небольшой файл (~3 МБ), не требуется Python, Node.js или других зависимостей
• 🖥️ Работает на Mac, Windows, Linux, Android, роутерах OpenWRT
• 🦊 Любой браузер или приложение, поддерживающее HTTP-прокси или SOCKS5

Как это работает (упрощённая схема)

Провайдеры не могут прочитать содержимое зашифрованного HTTPS. Они видят только адрес — www.google.com. Фактическая загрузка страниц происходит внутри сети Google, скрытая в зашифрованном туннеле.

Быстрый старт

Примерно 5 минут. Вам понадобятся:

• Бесплатный аккаунт Google (подойдёт любой Gmail)
• Компьютер (Mac, Windows или Linux)
• Firefox или Chrome

Шаг 1 — Создание Google Apps Script (один раз)

1. Перейдите на script.google.com, войдите в свой аккаунт Google
2. Нажмите New project в левом верхнем углу
3. Удалите код по умолчанию в редакторе
4. Откройте файл assets/apps_script/Code.gs в этом репозитории, скопируйте весь его содержимое и вставьте в редактор Apps Script, заменив предыдущий код
5. Найдите эту строку в начале:
   root@kitploit:~

   const AUTH_KEY = "CHANGE_ME_TO_A_STRONG_SECRET";
   

   Замените CHANGE_ME_TO_A_STRONG_SECRET на вашу собственную длинную случайную строку. Сохраните эту строку — вы вставите её в приложение на шаге 3. Относитесь к ней как к паролю.
6. Нажмите 💾 Save (или Ctrl/Cmd+S)
7. Нажмите Deploy (в правом верхнем углу) → New deployment
8. Нажмите на значок шестерёнки ⚙ рядом с «Select type» → выберите Web app
9. Установите:
   • Execute as: Me (ваш аккаунт Google)
   • Who has access: Anyone
10. Нажмите Deploy. Google может запросить разрешения — нажмите Authorize access и подтвердите
11. Google покажет Deployment ID (длинная случайная строка). Скопируйте его — он понадобится на шаге 3.

Совет: если впоследствии вы обновите код в Code.gs, не создавайте новый деплой. Отредактируйте код, затем перейдите Deploy → Manage deployments → ✏️ → Version: New version → Deploy. Deployment ID останется прежним.

Шаг 2 — Загрузка mhrv-rs

Перейдите на страницу последнего релиза и скачайте файл для вашего компьютера:

Mac: не уверены, Apple Silicon или Intel? Нажмите → About This Mac. Если в строке «Chip» указано Apple, скачивайте arm64. Если Intel — amd64.

Linux: появляется ошибка GLIBC? Вместо этого используйте файл linux-musl-amd64 — он работает на любом Linux без зависимостей.

Распакуйте архив.

Шаг 3 — Первый запуск

Дважды щёлкните по файлу запуска:

При первом запуске программа запросит пароль вашего компьютера. Это необходимо для установки небольшого сертификата, чтобы ваш браузер доверял mhrv-rs. Сертификат создаётся на вашем компьютере и никогда его не покидает — ни облако, ни Google, ни кто-либо ещё не может его использовать.

Откроется окно mhrv-rs. Заполните поля:

• Apps Script ID(s) — вставьте Deployment ID с шага 1
• Auth key — вставьте случайную строку, которую вы задали в Code.gs
• Остальные параметры оставьте по умолчанию

Нажмите Save config, затем Start. Если всё работает, индикатор состояния станет зелёным.

Проверьте: нажмите кнопку Test. Она отправляет один запрос через ретранслятор и сообщает, успешно ли он выполнен.

Шаг 4 — Настройка браузера на использование mhrv-rs

Firefox (рекомендуется, проще всего)

1. Firefox → меню ☰ → Settings
2. Введите «proxy» в строке поиска
3. Нажмите Settings… в разделе Network Settings
4. Выберите Manual proxy configuration
5. HTTP Proxy: 127.0.0.1 Порт: 8085
6. ☑ Отметьте «Also use this proxy for HTTPS»
7. Нажмите OK

Chrome / Edge

Установите расширение Proxy SwitchyOmega и настройте прокси на 127.0.0.1:8085.

macOS (системный прокси)

System Settings → Network → Wi-Fi → Details → Proxies → включите оба Web Proxy (HTTP) и Secure Web Proxy (HTTPS), оба указывают на 127.0.0.1:8085.

Шаг 5 — Проверка

Откройте любой заблокированный сайт в браузере. Он должен загрузиться.

Если что-то не работает:

• Нажмите Test в окне mhrv-rs — он точно укажет, на каком этапе возникла проблема
• Посмотрите панель Recent log внизу окна
• См. раздел Часто задаваемые вопросы ниже

Часто задаваемые вопросы

Это действительно бесплатно? Да. Google предоставляет каждому аккаунту 20 000 исходящих запросов URL в день на бесплатном тарифе. Этого достаточно для обычного серфинга одного человека. Для семьи из 3–4 человек, использующих одну настройку, создайте 2–3 деплоя в разных аккаунтах Google и добавьте все их ID.

Безопасно ли это? Сертификат остаётся на вашем компьютере — никто другой не имеет к нему доступа. Ваш auth_key — это ваш секрет. Google видит сайты, которые вы посещаете через ретранслятор (так как Apps Script запрашивает их от вашего имени) — как и в случае с любым хостируемым прокси. Если вас это не устраивает, используйте режим Full Tunnel с собственным VPS — см. полное руководство.

Видео на YouTube не воспроизводятся. Видеофрагменты YouTube поступают с googlevideo.com, к которому Apps Script не может обратиться (Google блокирует доступ Apps Script к собственному видеохостингу). Сама страница загружается нормально; проблема только с воспроизведением видео. Решение: Full Tunnel + VPS, или добавьте .googlevideo.com в passthrough_hosts в вашей конфигурации (браузер будет обращаться к нему напрямую, но на провайдерах Ирана это всё равно может быть заторможено).

ChatGPT / Claude / Grok показывает капчу Cloudflare. Cloudflare помечает IP-адреса датацентров Google как ботов. Решение: настройте exit node — небольшой обработчик на TypeScript, развёрнутый на бессерверном хостинге (Deno Deploy, fly.io, ваш собственный VPS), который станет мостом от Apps Script к целевому сайту. См. assets/exit_node/README.md.

Telegram работает нестабильно. Telegram использует MTProto, который Apps Script не поддерживает. Объедините mhrv-rs с xray на вашем компьютере — см. Telegram через xray в полном руководстве.

Провайдер блокирует сам script.google.com. mhrv-rs имеет режим direct, который использует только туннель с перезаписью SNI (без Apps Script). Воспользуйтесь им один раз, чтобы открыть script.google.com и развернуть скрипт, затем переключитесь обратно в режим apps_script. См. режим direct.

Поиск Google отображается без JavaScript. У Apps Script фиксированный User-Agent — Google-Apps-Script (Google не позволяет скриптам его менять), поэтому некоторые сайты возвращают упрощённую версию без JS. Решение: добавьте проблемный домен в вашу карту hosts, чтобы он шёл через туннель с перезаписью SNI и настоящим User-Agent вашего браузера. google.com, youtube.com, fonts.googleapis.com уже включены в этот список по умолчанию.

Больше вопросов: полный FAQ в подробном руководстве.

Нужна помощь?

• Поищите в открытых и закрытых issue — возможно, ваша проблема уже решена
• Откройте новый issue с указанием: вашей конфигурации (обязательно скройте auth_key!), что именно вы пробовали и что именно увидели в логах

Авторы

Оригинальный проект: @masterking32/MasterHttpRelayVPN. Идея, протокол Apps Script, архитектура прокси — всё его. Этот порт на Rust сделан для упрощения распространения клиентской части (один бинарный файл, не требуется установка Python).

Большая часть кода на Rust в этом порте была написана с помощью Claude от Anthropic и проверена человеком в каждом коммите.

Поддержать проект

❤️ Пожертвовать на sh1n.org — покрывает расходы на хостинг и CI-раннеры. Постановка звезды репозиторию также помогает показать, что проект стоит поддерживать.