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

⚠️ اطلاعات رو وارد کن تا کدها آماده بشن

⚙️ اطلاعات مشترک — یه بار وارد کن

بعد از پر کردن، کدهای همه سربرگ‌ها خودکار آپدیت میشن.

آدرس IP سرور VPS بعد از نصب با curl -4s ifconfig.me بدستت میاد

پورت Tunnel Node پیش‌فرض 8080 — معمولاً نیازی به تغییر نیست

پورت SSH سرور ⚠️ مهم: اشتباه باشه VPS قفل میشه

رمز مشترک (AUTH KEY) در VPS، Apps Script و اپ باید دقیقاً یکی باشد

📋 ترتیب کارها

1
اطلاعات بالا رو پر کن
یه بار کافیه — کدها خودکار آپدیت میشن
2
«کد VPS» → install.sh کپی → در Termius بزن
همه چیز خودکار نصب میشه
3
«Apps Script» → کپی → deploy → Deployment ID بگیر
برای راهنمای تصویری → سربرگ «آموزش تصویری»
4
اپ mhrv-rs → ID وارد کن → Connect
تمام — همه اپ‌ها از VPS رد میشن

🛒 خرید VPS

حداقل: 1 vCPU — 512MB RAM — Ubuntu 22.04

🇮🇷 Parsdev

✓ پشتیبانی فارسی
✓ پرداخت ریالی
✗ احراز هویت

parsdev.com ↗

🌐 Netlen (ترکیه)

✓ بدون KYC
✓ کریپتو
✗ انگلیسی

netlen.com.tr ↗

✅ کد رو کامل کپی کن و در Termius paste کن.
دانلود Termius ↗

📦 install.sh — نصب کامل

ابتدا اطلاعات را در سربرگ «تنظیمات» وارد کنید

🔍 check.sh — چک وضعیت

ابتدا اطلاعات را در سربرگ «تنظیمات» وارد کنید

🔄 update.sh — آپدیت

ابتدا اطلاعات را در سربرگ «تنظیمات» وارد کنید

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

cleanup.sh

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 "✅ پاک شد"

🤖

نداری؟ اسکریپت آماده رو از ربات بگیر: @Mhrv_script_bot — رایگان با دعوت یا پرداخت

⚠️ باگ مهم: بعد از paste آخر فایل رو چک کن — خط خالی اضافه رو پاک کن.

✅ کاربران قدیمی: اگه قبلاً CodeFull.gs deploy کردی، نیازی به redeploy نیست.

CodeFull.gs — کپی → Apps Script → Deploy

ابتدا اطلاعات را در سربرگ «تنظیمات» وارد کنید

🚀 مراحل 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 (unsafe) → Allow
این مرحله طبیعیه — برای راهنمای تصویری ← سربرگ «آموزش تصویری»
5
Deployment ID رو کپی کن
فقط ID (رشته AKfyc...) — نه URL. بده به اپ اندروید.

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

💡 هر اکانت گوگل = یه Deployment = سهمیه جداگانه و سرعت بیشتر

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

📖 راهنمای گام‌به‌گام با تصویر برای راه‌اندازی Google Apps Script

📖

راهنمای تصویری کامل — ۸ مرحله از ورود به گوگل تا دریافت Deployment ID

باز کن

🔒

نیاز به فیلترشکن دارید؟

برای دسترسی به script.google.com به VPN نیاز دارید.

→ دریافت کانفیگ از ربات ما

Step 1

🌐 ورود به Google Apps Script

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

script.google.com

Google

اینجا کلیک کن

Step 2

➕ پروژه جدید

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

script.google.com/home

پروژه جدید

Step 3

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

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

script.google.com/d/.../edit

function myFunction() {}

همه رو پاک کن (Ctrl+A → Delete)

Step 4

📋 Paste کردن CodeFull.gs

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

script.google.com/d/.../edit

// CodeFull.gs
const AUTH_KEY = "...";
const TUNNEL_URL = "http://...";
function doPost(e) {...}

کد اینجا paste شده

⚠️ مهم: آخر فایل رو چک کن — اگه خط خالی اضافه هست پاکش کن.

Step 5

🚀 کلیک روی Deploy

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

script.google.com/d/.../edit

Untitled project

▸ New deployment

Manage deployments

Deploy → New deployment

Step 6

⚙️ تنظیمات Deployment

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

New deployment

Type:

Execute as:

انتخاب: Me

Who has access:

انتخاب: Anyone

Deploy بزن

Step 7

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

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

accounts.google.com

🚫

This app isn't verified

This app hasn't been verified by Google.

Advanced

Advanced کلیک کن

🔴 دکمه «Back to safety» رو نزن!

Step 8

🔓 Go to ... (unsafe)

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

accounts.google.com

🚫

This app isn't verified

⚠ If you understand the risks and want to proceed...

Go to Untitled project (unsafe)

اینجا کلیک کن

Step 9

✅ Allow

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

accounts.google.com/o/oauth2/...

Untitled project

wants access to your Google Account

✓ Connect to an external service
✓ Run as a web app

Allow بزن

Step 10

📋 کپی Deployment ID

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

script.google.com

✅ Deployment successful

Deployment ID:

AKfycbyXXXXXXXXXXXXXXXXXXX

این ID رو کپی کن

✅ فقط ID (رشته AKfyc...) رو کپی کن — نه URL کامل. در اپ mhrv-rs وارد کن.

📥 دانلود

📥 دانلود mhrv-rs APK — آخرین نسخه (v1.9.x) 💻 Termius SSH Client

✅ v1.9+: Full tunnel (no cert) — بدون certificate. YouTube via relay toggle اضافه شد.

📋 تنظیم اپ (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 — همه تنظیمات خودکار وارد میشه
⚠️فقط با افراد مورد اعتماد به اشتراک بذار

🏗️ معماری

📱 گوشی شما

↓ mhrv-rs | TLS — SNI: www.google.com ← ISP فقط این رو می‌بینه

☁️ Google Edge (فیلتر نمیشه)

↓ CodeFull.gs (جیمیل شما — رایگان)

🖥️ mhrv-tunnel (VPS شما)

↓ TCP مستقیم

🌍 اینترنت آزاد

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

💡 کاربرانی که قبلاً CodeFull.gs deploy کردن نیازی به redeploy ندارن. فقط اپ اندروید رو آپدیت کن و کد VPS رو دوباره بزن.

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

⚡ بهینه‌سازی

💡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

🔧 عیب‌یابی

🔴
504 Relay timeoutApps Script deploy نشده یا خطا داره — دوباره deploy کن
🔴
Syntax Error deployخط آخر اضافه رو پاک کن
🔴
VPS قفل شدپورت SSH رو قبل از ufw enable باز کن — قفل شد: OS reinstall
🔴
Docker error (dpkg)dpkg --configure -a بزن، بعد: apt install -y docker.io
🟡
unauthorized در لاگAUTH_KEY در VPS و Apps Script باید دقیقاً یکی باشن
🟡
خطای MHRV_AUTH_KEYمقدار صحیح TUNNEL_AUTH_KEY است — راهنماهای قدیمی اشتباه بودن
🟡
اتصال قطع و وصلdeployment معیوب خودکار 2 دق blacklist میشه — طبیعیه (v1.8.5+)
🟡
SNI همه failAuto-detect google_ip بزن
🟢
App not installed هنگام آپدیتSettings → Apps → mhrv-rs → Uninstall → نصب مجدد (فقط یه بار)

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

☐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 می‌بیند.

📚 منابع

👤 کانال‌ها

🎓

آموزش و راهنمایی@kian_irani_cdn_f

👨‍💻

سازنده اپلیکیشن@shin_persian

🙏 تشکر

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

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

⚙️ اطلاعات مشترک — یه بار وارد کن

📋 ترتیب کارها

🛒 خرید VPS

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

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

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

🌐 ورود به Google Apps Script

➕ پروژه جدید

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

📋 Paste کردن CodeFull.gs

🚀 کلیک روی Deploy

⚙️ تنظیمات Deployment

New deployment

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

🔓 Go to ... (unsafe)

✅ Allow

📋 کپی Deployment ID

✅ Deployment successful

📥 دانلود

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

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

🏗️ معماری

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

⚡ بهینه‌سازی

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

🔧 عیب‌یابی

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

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

📚 منابع

👤 کانال‌ها

🙏 تشکر