🛡️ راهنمای mhrv-rs + Tunnel Node

🧹 پاک‌سازی (اختیاری)

docker rm -f mhrv-tunnel 2>/dev/null || true
docker rmi ghcr.io/therealaleph/mhrv-tunnel-node:latest 2>/dev/null || true
ufw --force reset && ufw --force disable
echo "✅ پاک شد"

🚀 مراحل Deploy (خلاصه)

• 1
  script.google.com → New project

  کد پیش‌فرض رو کامل پاک کن

• 2
  کد بالا رو Paste کن

  آخر فایل رو چک کن — خط اضافه پاک کن

• 3
  Deploy → New deployment → Web app

  Execute as: Me | Who has access: Anyone

• 4
  Authorize → Advanced → Go to project → Allow

  گوگل ازت می‌خواد دسترسی بدی — باید تأیید کنی.

• 5
  ⚠️ مهم: URL رو در مرورگر باز کن

  بعد از Deploy، آدرس Web App رو کپی کن و در مرورگر باز کن. گوگل یه بار دیگه احراز هویت می‌خواد. اگه این مرحله رو انجام ندی، اپ وصل نمی‌شه.

  باید بنویسه: The script completed but did not return anything ✅

• 4
  هشدار Authorize → Advanced → Go to (unsafe) → Allow

  این مرحله طبیعیه — برای راهنمای تصویری ← سربرگ «آموزش تصویری»

• 5
  Deployment ID رو کپی کن

  فقط ID (رشته AKfyc...) — نه URL. بده به اپ اندروید.

👥 چند Deployment — سرعت بیشتر

• 1چند مرورگر مختلف نصب کن (Chrome، Brave، Firefox)
• 2در هر مرورگر با جیمیل جدید CodeFull.gs رو deploy کن
• 3همه ID ها رو در اپ وارد کن — هر ID یه خط جداگانه
• ⚠️از جیمیل شخصی اصلی استفاده نکن

🌐 ورود به Google Apps Script

به script.google.com برو و Sign in بزن.

➕ پروژه جدید

دکمه New project رو بزن.

🗑️ پاک کردن کد پیش‌فرض

Ctrl+A بزن، همه رو انتخاب کن و پاک کن.

📋 Paste کردن CodeFull.gs

از سربرگ «Apps Script» کد رو کپی کن و اینجا Paste کن.

🚀 کلیک روی Deploy

دکمه Deploy بالا راست → New deployment

⚙️ تنظیمات Deployment

Type: Web app | Execute as: Me | Who has access: Anyone

⚠️ هشدار «This app isn't verified»

این هشدار کاملاً طبیعیه. روی Advanced کلیک کن.

🔓 Go to ... (unsafe)

بعد از Advanced، لینک «Go to [نام پروژه] (unsafe)» رو بزن.

✅ Allow

پایین صفحه دکمه Allow رو بزن.

📋 کپی Deployment ID

فقط Deployment ID رو کپی کن — همین رو به اپ میدی.

📥 دانلود اپ اندروید (v1.9.36)

آخرین نسخه رسمی mhrv-rs — متن‌باز با لایسنس MIT.

📋 تنظیم اپ (v1.9+)

• 1
  APK نصب کن

  «نصب از منابع ناشناس» فعال باشد

• 2
  Mode → «Full tunnel (no cert)»

  همه ترافیک بدون certificate از VPS رد میشه

• 3
  Deployment ID رو وارد کن

  چند تا با خط جدا — اپ round-robin می‌کنه

• 4
  Auth key: وارد نشده

  همون رمزی که در تنظیمات وارد کردی

• 5
  Google IP و Front Domain

  IP: 216.239.38.120 یا Auto-detect | Front: www.google.com

• 6
  SNI Pool → Test all

  فقط ✅ ها — معمولاً accounts.google.com بهترینه

• 7
  App splitting (اختیاری)

  اپ‌های بدون نیاز به VPN رو exclude کن

📤 اشتراک کانفیگ با QR

• 1«Export config» → QR code میگیری
• 2در دستگاه دوم Scan QR — همه تنظیمات خودکار وارد میشه
• ⚠️فقط با افراد مورد اعتماد به اشتراک بذار

🩺 ربات اشکال‌زدا — هوش مصنوعی (رایگان)

اگه اتصال داری ولی کند یا قطع میشه، اول این رو امتحان کن:

1. 1️⃣وارد ربات شو: @Vpscript_bot
2. 2️⃣دکمه «اشکال‌زدایی لاگ» رو بزن
3. 3️⃣به ۴ سوال کوتاه پاسخ بده (مدل، نسخه اپ، ...)
4. 4️⃣لاگ .txt رو از اپ بفرست (در اپ: لاگ زنده → ذخیره)
5. 5️⃣۱۰-۳۰ ثانیه بعد، تشخیص + راه‌حل می‌گیری

🏗️ معماری

✅ سازگاری با نسخه‌های قدیمی

• ✅CodeFull.gs (773 خط، v1.9.34+) — با همه نسخه‌های v1.7+ سازگاره
• ⚠️Code.gs ساده — فقط HTTP relay، Full Tunnel کار نمی‌کنه
• ❌نسخه‌های با req.auth — باید redeploy بشه

⚙️ تنظیمات بهینه Full Tunnel (مهم!)

در اپ mhrv-rs این تنظیمات رو اعمال کن:

• 1️⃣
  Mode: Full tunnel (no cert)همه ترافیک — بدون certificate — از VPS رد می‌شه.
• 2️⃣
  Block QUIC: ✅ روشنUDP/443 بلاک می‌شه — مرورگرها به TCP/HTTPS می‌افتن. بدون این تنظیم tunnel crash می‌کنه.
• 3️⃣
  Block DoH: ✅ روشنDNS over HTTPS بلاک می‌شه — DNS از تونل رد می‌شه. جلوی DNS leak رو می‌گیره.
• 4️⃣
  SNI Tester (مهم‌ترین!)هر SNI رو تست کن. فقط ۲-۳ تا با کمترین ping انتخاب کن. بقیه رو بردار. سرعت ۲ برابر می‌شه.
• 5️⃣
  Google IP: 216.239.38.120یا Auto-detect بزن. اگه SNI همه fail شد این IP رو تغییر بده: 216.239.32.0 یا 216.239.36.0
• 6️⃣
  Front Domain: www.google.comدست نزن — ISP این رو می‌بینه و فکر می‌کنه به گوگل وصل شدی.
• 7️⃣
  parallel_relay: 1 (پیش‌فرض)اگه اتصال ناپایداره، 2 امتحان کن. بیشتر از 3 نزن — quota سریع تموم می‌شه.
• 8️⃣
  چند Deployment IDهر جیمیل = یه Deployment = سهمیه جداگانه. ۳ تا جیمیل = سرعت و quota ۳ برابر.

🚀 چطور سرعت رو چند برابر کنیم؟

• 1️⃣
  چند جیمیل = سهمیه چند برابرهر اکانت گوگل روزانه ۲۰,۰۰۰ درخواست داره. ۳ جیمیل = ۶۰,۰۰۰ درخواست/روز. همین اسکریپت رو روی ۲-۳ جیمیل دیگه deploy کن و همه ID ها رو در اپ وارد کن (هر کدوم یه خط). اپ بین‌شون تقسیم می‌کنه. ⚡
• 2️⃣
  SNI بهینه (مهم!)از منوی اپ → SNI → Test all. فقط ۲-۳ تا با کمترین ping تیک بزن. بقیه رو بردار. سرعت محسوس بالا می‌ره.
• 3️⃣
  Block QUIC و Block DoH روشن باشنهر دو تو تنظیمات پیشرفته اپ. اگه خاموشن، Full Tunnel درست کار نمی‌کنه.

⚠️ محدودیت‌های طبیعی این روش

این روش از Apps Script گوگل استفاده می‌کنه — یه سرویس رایگان که برای relay طراحی نشده. چند محدودیت ذاتی داره:

• 🔸
  تأخیر ۲۵۰ms تا ۵۰۰ms هر درخواستتأخیر داخلی Apps Script گوگل — قابل تغییر نیست. برای مرور عادی کافیه، برای gaming مناسب نیست.
• 🔸
  ۲۰,۰۰۰ درخواست/روز هر جیمیلبا چند Deployment از جیمیل‌های مختلف حل می‌شه.
• 🔸
  YouTube video کندترCDN یوتیوب (googlevideo.com) از Apps Script قابل دسترس نیست. صفحه لود می‌شه ولی ویدیو کُنده.
• 🔸
  بعضی سایت‌های Cloudflare (مثل ChatGPT)IP گوگل توسط Cloudflare شناخته شده‌ست و captcha می‌ده.

🛡 آخرین آپدیت — نسخه v1.9.34 (مه ۲۰۲۶)

• ⚡پشتیبانی فشرده‌سازی zstd — حجم batch ها کمتر، سهمیه روزانه دیرتر تموم می‌شه (v1.9.32)
• 🔋رفع باگ quota burn — session های idle دیگه سهمیه چند Deployment رو نمی‌سوزونن (v1.9.31)
• 🎤block_stun پیش‌فرض false — تماس صوتی WebRTC حالا کار می‌کنه (v1.9.31)
• 📏اسکریپت جدید: ۷۷۳ خط (قبلاً ۷۴۵ خط بود)
• 🆕برای استفاده از zstd: اپ + اسکریپت + tunnel-node — هر سه باید آپدیت بشن
• 💡کاربران ربات: «📥 دریافت مجدد اسکریپت» بزنن، کد جدید رو Paste کنن، Manage deployments → New version → Deploy
• 🔄آپدیت اختیاریه — اسکریپت قبلی هنوز کار می‌کنه (بدون zstd)

📜 سابقه آپدیت‌ها

• 📦v1.9.34 (آخرین): مهاجرت config از JSON به TOML با upgrade خودکار (PR #1317)
• 📦v1.9.32: zstd compression در batch protocol (backward compatible)
• 📦v1.9.31: رفع باگ quota burn در idle sessions، block_stun پیش‌فرض false
• 📦v1.9.30: CodeFull.gs بهینه‌سازی شد (۷۴۵ خط)
• 📦v1.9.29: رفع باگ Code.gs JSON parse
• 📦v1.9.28: Pipeline Full-mode، WebRTC fallback، benchmark

⚡ بهینه‌سازی

• 💡3-6 Deployment از اکانت‌های مختلف گوگل
• 💡SNI pool → Test all → فقط ✅ ها — accounts.google.com معمولاً بهترینه
• 💡App splitting — اپ‌های بدون VPN رو exclude کن
• 💡parallel_relay روی 2-3 در Advanced اگه اتصال ناپایداره
• 💡coalesce (v1.9+): batch هوشمند — RTT از 6s به 3s بهتر شد
• 💡request_timeout_secs: ISP کند → 45-60 | fail-fast → 15

⚠️ محدودیت‌ها

• ❌WebSocket — Discord voice
• ⚠️ChatGPT/Claude: Cloudflare captcha — راه‌حل: exit node رایگان روی val.town
• ⚠️YouTube video: از googlevideo.com بارگذاری میشه — fix: Advanced → youtube_via_relay (v1.9+)
• ⚠️سهمیه 20k call/روز هر اکانت — با 3+ اکانت مشکلی نیست
• 💡تلگرام: Settings → Proxy → SOCKS5 → 127.0.0.1:8086

🔧 عیب‌یابی Apps Script

• 🔴
  504 Relay timeout / Apps Script unresponsivequota روزانه تموم شده (۲۰k call/روز). راه‌حل: جیمیل دیگه + deploy جدید. یا فردا صبر کن.
• 🔴
  Syntax Error deployخط آخر اضافه رو پاک کن. یا کد رو دوباره paste کن.
• 🔴
  tunnel bad base64Apps Script خراب شده — دوباره deploy کن.
• 🔴
  invalid front_domainفیلد front domain باید www.google.com باشه.
• 🟡
  unauthorized در لاگAUTH_KEY در VPS و Apps Script باید دقیقاً یکی باشن.
• 🟡
  batch failed: timeout (زیاد)SNI مناسب نیست. SNI Tester بزن، فقط ۲-۳ تا با کمترین ping نگه دار.
• 🟡
  sni_probe همه FAILGoogle IP رو عوض کن: 216.239.32.0 یا Auto-detect بزن.
• 🟡
  اتصال قطع و وصلdeployment معیوب خودکار ۲ دقیقه blacklist می‌شه — طبیعیه. چند deployment داشته باش.
• 🟢
  App not installed هنگام آپدیتSettings → Apps → mhrv-rs → Uninstall → نصب مجدد (یه بار)
• 🟢
  VPS قفل شدپورت SSH رو قبل از ufw enable باز کن. قفل شد: OS reinstall لازمه.
• 🟢
  Docker error (dpkg)dpkg --configure -a بزن، بعد: apt install -y docker.io

📊 توضیح لاگ‌های اپ mhrv-rs

از منوی اپ → Logs رو باز کن. هر پیام یه معنی داره:

• 🟢
  tunnel session opened✅ اتصال موفق برقرار شد.
• 🟢
  dispatch X → blocked (block_doh)عمدیه! اپ DNS over HTTPS رو بلاک می‌کنه تا DNS لو نره. نشانه سلامت اپ.
• 🟢
  dispatch X → full tunnel (via batch mux)✅ ترافیک از تونل رد شد.
• 🟢
  h2 connection established✅ اتصال HTTP/2 به Apps Script برقراره.
• 🟢
  sni_probe: X ok in Xmsاین SNI خوبه، نگهش دار. کمتر از ۲۰۰ms عالیه.
• 🟡
  WARN ...mux...چند اتصال در یک batch — سرعت بهتر. کاملاً طبیعی.
• 🟡
  batch failed: timeoutیه batch بعد از ۳۰ ثانیه جواب نگرفت. اپ retry می‌کنه. اگه زیاد ببینی → SNI بهتر انتخاب کن.
• 🟡
  sni_probe: X FAILاین SNI از ایران بسته‌ست. تیکش رو بردار. اگه همه FAIL → IP گوگل رو عوض کن.
• 🔴
  tunnel connect_data error: timeoutquota تموم / AUTH_KEY اشتباه / سرور قطع. چک کن کدوم مشکله.
• 🔴
  Relay timeout — Apps Script unresponsivequota پر شده. یه Deployment جدید روی جیمیل دیگه بساز.

📋 چک‌لیست راه‌اندازی

• ☐VPS خریدی: 1 vCPU، 512MB، Ubuntu 22.04
• ☐اطلاعات در سربرگ «تنظیمات» وارد کردی
• ☐install.sh اجرا شد — «✅ نصب موفق» نشون داد
• ☐CodeFull.gs در script.google.com deploy شد
• ☐Deployment ID (AKfyc...) گرفتی
• ☐اپ mhrv-rs نصب و تنظیم شد
• ☐SNI Test all زدی و Connect کردی

🌟 از پروژه حمایت رایگان کن!

اگه این ابزار به دردت خورد، یه راه عالی برای حمایت رایگان داری:

💝 حمایت از پروژه

این پروژه رایگانه، ولی هزینه سرور (~۳۰ دلار/ماه) و وقت توسعه واقعیه. اگه دوست داری حمایت کنی:

🔑 چرا کار می‌کند؟

ترافیک از طریق سرورهای Google (که فیلتر نیست) رد می‌شود. ISP فقط اتصال به www.google.com می‌بیند.

📚 منابع

• ⭐mhrv-rs — Rust Port توسط @therealaleph
• 🐍پروژه اصلی Python — @masterking32
• 📦آخرین APK اندروید

👤 کانال‌ها و ربات

🙏 تشکر

• 💡ایده اصلی: @masterking32
• 🦀Rust Port و Full Tunnel: @therealaleph
• 📖راهنما: Kian Irani