
MasterHttpRelayVPN-RUST v1.9.37
@masterking32のMasterHttpRelayVPNのRust移植版 — 元のアイデアとPython実装の功績はすべて@masterking32に帰属します。Google Apps ScriptリレーとTLS SNI隠蔽による無料のDPIバイパス。CLI + クロスプラットフォームデスクトップUI、HTTP + SOCKS5プロキシ、実行時依存関係なし。
mhrv-rs — 検閲を無料で回避、自分のGoogleアカウントで
あなたのコンピュータ上で動作し、自身の無料GoogleアカウントにデプロイしたGoogle Apps Scriptを使って、ブロックされたWebサイトを無料で訪問できる小さなプログラムです。ISPからはwww.google.comへの暗号化トラフィックにしか見えません — 実際に何を訪れているかはわかりません。
🇬🇧 English Quick Start · Full Guide (advanced topics) 🇮🇷 راهاندازی سریع فارسی · راهنمای کامل (مباحث پیشرفته)
۱. راهنمای تصویری راه اندازی به زبان فارسی (YouTube)
۲. راهنمای جامع متنی راه اندازی به زبان فارسی با تشکر از Kian Irani
得られるもの
- 🌐 DPI / SNIブロッキングをバイパス — Googleのエッジをリレーとして使用
- 💯 完全無料 — 自分のGoogleアカウントの無料枠で動作
- ⚡ 小さなファイル1つ(約3 MB)、Python不要、Node.js不要、依存関係なし
- 🖥️ 対応OS Mac、Windows、Linux、Android、OpenWRTルーター
- 🦊 HTTPプロキシまたはSOCKS5をサポートするあらゆるブラウザやアプリ
仕組み(簡単な図)
あなた → ブラウザ → mhrv-rs ──┐
│ ISPからは次のようにしか見えない: www.google.com
▼
Googleのネットワーク
│
▼
あなたの無料Apps Scriptが実際のサイトを取得
│
▼
Twitter / ChatGPT / お好みのブロックサイト
ISPは暗号化されたHTTPSの中身を読めません。見えるのはアドレス — www.google.com だけです。実際のページ検索はGoogleのネットワーク内で、暗号化トンネルの中で行われます。
クイックスタート
約5分。 必要なもの:
- 無料のGoogleアカウント(Gmailならどれでも可)
- コンピュータ(Mac、Windows、Linux)
- FirefoxまたはChrome
ステップ1 — Google Apps Scriptの作成(一度だけ)
- script.google.com にアクセスし、Googleアカウントでサインイン
- 左上の New project をクリック
- エディタにあるデフォルトのコードを削除
- このリポジトリのファイル
assets/apps_script/Code.gsを開き、すべてコピーしてApps Scriptエディタに貼り付け(既存のコードを置き換え) - 上部付近で次の行を見つけます:
const AUTH_KEY = "CHANGE_ME_TO_A_STRONG_SECRET";CHANGE_ME_TO_A_STRONG_SECRETを自分だけの長くランダムな文字列に変更します。この文字列は保管しておいてください — ステップ3でアプリに貼り付けます。パスワードとして扱ってください。 - 💾 Save(または
Ctrl/Cmd+S)をクリック - Deploy(右上)→ New deployment をクリック
- 「Select type」の横にある歯車アイコン⚙をクリック → Web app を選択
- 設定:
- Execute as: Me(自分のGoogleアカウント)
- Who has access: Anyone
- Deploy をクリック。Googleが権限を求めてきたら Authorize access をクリックして承認
- Googleが Deployment ID(長いランダムな文字列)を表示します。コピーしてください — ステップ3で必要になります。
ヒント: 後で
Code.gsを更新する場合、新しいデプロイメントを作らないでください。コードを編集したら、Deploy → Manage deployments → ✏️ → Version: New version → Deploy に進みます。Deployment IDは同じままです。
ステップ2 — mhrv-rsのダウンロード
最新リリースページ にアクセスし、お使いのコンピュータに合ったファイルをダウンロードします:
| お使いの環境 | ダウンロードするファイル |
|---|---|
| Apple Silicon搭載Mac(M1 / M2 / M3 / M4チップ) | mhrv-rs-macos-arm64-app.zip |
| Intelチップ搭載Mac | mhrv-rs-macos-amd64-app.zip |
| Windows | mhrv-rs-windows-amd64.zip |
| Linux(Ubuntu / Mint / Fedora / Debian / Arch) | mhrv-rs-linux-amd64.tar.gz |
| Androidスマートフォンまたはタブレット | mhrv-rs-android-universal-v*.apk |
| OpenWRTルーターまたはAlpine | mhrv-rs-linux-musl-amd64.tar.gz |
Mac: Apple SiliconかIntelかわからない場合? アップルメニュー → このMacについて をクリック。「チップ」に Apple と表示されていればarm64を、Intel と表示されていればamd64を入手してください。
Linux:
GLIBCエラーが出る場合? 代わりにlinux-musl-amd64ファイルを使用してください — 依存関係なしでどのLinuxでも動作します。
解凍します。
ステップ3 — 初回実行
ランチャーをダブルクリック:
| Mac | run.command |
| Windows | run.bat |
| Linux | ./run.sh(ターミナルで) |
初回起動時に、コンピュータのパスワードを求められます。これは、ブラウザがmhrv-rsを信頼するように小さな証明書をインストールするためです。この証明書はお使いのコンピュータ上で生成され、外部に出ることはありません — クラウドもGoogleもリモートも使用できません。
mhrv-rsのウィンドウが開きます。次の項目を入力します:
- Apps Script ID(s) → ステップ1の Deployment ID を貼り付け
- Auth key →
Code.gsに設定したランダムな文字列を貼り付け - その他はデフォルトのままにします
Save config をクリックし、次に Start をクリックします。正常に動作すればステータスサークルが緑色になります。
テストする: Test ボタンをクリックします。リレーを通して1つのリクエストを送信し、動作したかどうかを通知します。
ステップ4 — ブラウザにmhrv-rsを使用するよう設定
Firefox(推奨 — 最も簡単)
- Firefox → ☰ メニュー → 設定
- 検索ボックスで「proxy」を検索
- ネットワーク設定の下にある 設定… をクリック
- 手動プロキシ設定 を選択
- HTTP プロキシ:
127.0.0.1ポート:8085 - ☑ 「HTTPSにもこのプロキシを使用する」 にチェック
- OK をクリック
Chrome / Edge
Proxy SwitchyOmega 拡張機能をインストールし、プロキシを 127.0.0.1:8085 に設定します。
macOS(システム全体)
システム設定 → ネットワーク → Wi-Fi → 詳細 → プロキシ → Web プロキシ(HTTP) と セキュア Web プロキシ(HTTPS) の両方を有効にし、両方とも 127.0.0.1:8085 を指定します。
ステップ5 — 試してみる
ブラウザでブロックされたサイトを開きます。読み込まれるはずです。
何かがうまくいかない場合:
- mhrv-rsウィンドウの Test ボタンをクリック — どのステップで失敗しているかを特定します
- ウィンドウ下部の Recent log パネルを確認します
- 以下の「よくある質問」を参照
よくある質問
本当に無料ですか? はい。Googleはすべてのアカウントに無料枠で1日20,000回の外部URLフェッチを許可しています。これは一人の通常のブラウジングには十分です。同じ設定を共有する3〜4人家族の場合は、異なるGoogleアカウントで2〜3のデプロイメントを作成し、すべてのIDを追加してください。
安全ですか? 証明書はお使いのコンピュータ上に残ります — 他の誰も秘密鍵を持ちません。auth_key はあなたの秘密です。Googleはリレーを通じてアクセスしたWebサイトを確認します(Apps Scriptがあなたの代わりにフェッチするため)— これはホスト型プロキシと同じです。これが許容できない場合は、独自のVPSを使用したFull Tunnelモードを使用してください — 完全ガイドを参照。
YouTube動画が再生されない。 YouTubeの動画チャンクは googlevideo.com から送信されますが、Apps Scriptはそこにアクセスできません(GoogleはApps Scriptが自社のビデオCDNにアクセスするのをブロックします)。ページ自体は問題なく読み込まれますが、動画の再生のみ影響を受けます。修正方法:Full Tunnel + VPS、または passthrough_hosts に .googlevideo.com を追加(ブラウザは直接アクセスしますが、イランのISPでは依然として帯域制限の対象となります)。
ChatGPT / Claude / Grok でCloudflare CAPTCHAが表示される。 CloudflareはGoogleのデータセンターIPをボットとしてフラグ付けします。修正方法:exit node を設定します — サーバーレスホスト(Deno Deploy、fly.io、独自のVPS)にデプロイする小さなTypeScriptハンドラで、Apps Script → exit node → claude.ai をブリッジします。assets/exit_node/README.md を参照。
Telegramが不安定。 TelegramはMTProtoを使用しており、Apps Scriptは対応していません。お使いのマシンで xray と組み合わせてください — 完全ガイドのTelegram via xray を参照。
ISPが script.google.com自体をブロックしている。 mhrv-rsには、SNI書き換えトンネル(Apps Scriptなし)のみを使用する direct モードがあります。これを使用して script.google.com にアクセスしスクリプトをデプロイした後、apps_scriptモードに切り替えます。direct モード を参照。