آموزش vps

[ArashKhandani]

سلام میشه یکی آموزش کامل بهم بگه برای اینکه با vps بتونم وصل بشم

[therealaleph]

@ArashKhandani سلام — راهنمای کامل Full mode + VPS این مراحل هست:

۱. VPS بگیرید

ارزون‌ترین گزینه‌ها:

• Hetzner CX11 (~۵ یورو/ماه) — Falkenstein/Helsinki/Ashburn datacenter
• Contabo VPS-S (~۵ دلار/ماه) — DE/USA
• RackNerd (~۱ دلار/ماه — ولی reliability variable)
• Oracle Cloud Free Tier ($0 forever — اگه کارت بین‌المللی برای signup داری)

VPS رو بگیر، آدرس IP و SSH access رو ذخیره کن.

۲. Docker روی VPS install کن

SSH به VPS:

ssh root@your-vps-ip

# Install Docker
curl -fsSL https://get.docker.com | sh

۳. tunnel-node container راه بنداز

# Generate auth key
AUTH_KEY=$(openssl rand -hex 16)
echo "Save this auth key: $AUTH_KEY"

# Run tunnel-node
docker run -d --name mhrv-tunnel \
  --restart unless-stopped \
  -p 8443:8443 \
  -e MHRV_AUTH_KEY="$AUTH_KEY" \
  ghcr.io/therealaleph/mhrv-tunnel-node:latest

این روی port 8443 listening می‌شه. اگه می‌خوای TLS valid (recommended)، با Caddy جلوش بذار — راهنما در reply #277.

۴. Apps Script CodeFull.gs رو deploy کن

روی ویندوز/مک، در browser به https://script.google.com بروید (با mhrv-rs در google_only mode اگه فیلتر شده).

• New project
• محتویات از https://raw.githubusercontent.com/therealaleph/MasterHttpRelayVPN-RUST/main/assets/apps_script/CodeFull.gs paste کن
• در ابتدای فایل:

  const AUTH_KEY = "your-secret-key-1";
  const TUNNEL_NODE_URL = "https://your-vps-ip:8443";  // یا https://tunnel.your-domain.com
  const TUNNEL_AUTH_KEY = "AUTH_KEY-from-step-3";

• Save → Deploy → New deployment → Web app → "Anyone" → Deploy
• URL deployment رو copy کن
• ID رو extract کن (قسمت AKfycbXY... بین /s/ و /exec)

۵. mhrv-rs config

{
  "mode": "full",
  "auth_key": "your-secret-key-1",
  "deployment_ids": ["AKfycbXY..."],
  "tunnel_node_url": "https://your-vps-ip:8443",
  "google_ip": "216.239.38.120",
  "front_domain": "www.google.com"
}

۶. mhrv-rs رو راه بنداز + test

mhrv-rs در terminal — یا UI binary اگه دسکتاپ گرافیکی داری.

سپس در browser proxy ست کن روی 127.0.0.1:8085 (HTTP) یا 127.0.0.1:8086 (SOCKS5).

برای تست، به https://www.google.com برو — باید بدون مشکل باز بشه. سپس به یه سایت non-Google (مثل https://github.com) برو — باید از مسیر Apps Script + tunnel-node + VPS بره.

---

منابع کامل‌تر:

• tunnel-node README
• #277 reply — Caddy + Let's Encrypt setup
• #251 reply — apps_script vs Full mode comparison

اگه در هر مرحله گیر کردی، با log + screenshot reply بزن.

---

_{[reply via Anthropic Claude | reviewed by @therealaleph]}

[sina-b4hrm]

@ArashKhandani سلام — راهنمای کامل Full mode + VPS این مراحل هست:

۱. VPS بگیرید

ارزون‌ترین گزینه‌ها:

• Hetzner CX11 (~۵ یورو/ماه) — Falkenstein/Helsinki/Ashburn datacenter
• Contabo VPS-S (~۵ دلار/ماه) — DE/USA
• RackNerd (~۱ دلار/ماه — ولی reliability variable)
• Oracle Cloud Free Tier ($0 forever — اگه کارت بین‌المللی برای signup داری)

VPS رو بگیر، آدرس IP و SSH access رو ذخیره کن.

۲. Docker روی VPS install کن

SSH به VPS:

ssh root@your-vps-ip

Install Docker

curl -fsSL https://get.docker.com | sh
۳. tunnel-node container راه بنداز

Generate auth key

AUTH_KEY=$(openssl rand -hex 16)
echo "Save this auth key: $AUTH_KEY"

Run tunnel-node

docker run -d --name mhrv-tunnel
--restart unless-stopped
-p 8443:8443
-e MHRV_AUTH_KEY="$AUTH_KEY"
ghcr.io/therealaleph/mhrv-tunnel-node:latest
این روی port 8443 listening می‌شه. اگه می‌خوای TLS valid (recommended)، با Caddy جلوش بذار — راهنما در reply #277.

۴. Apps Script CodeFull.gs رو deploy کن

روی ویندوز/مک، در browser به https://script.google.com بروید (با mhrv-rs در google_only mode اگه فیلتر شده).

• New project
• محتویات از https://raw.githubusercontent.com/therealaleph/MasterHttpRelayVPN-RUST/main/assets/apps_script/CodeFull.gs paste کن
• در ابتدای فایل:
  const AUTH_KEY = "your-secret-key-1";
  const TUNNEL_NODE_URL = "https://your-vps-ip:8443"; // یا https://tunnel.your-domain.com
  const TUNNEL_AUTH_KEY = "AUTH_KEY-from-step-3";
• Save → Deploy → New deployment → Web app → "Anyone" → Deploy
• URL deployment رو copy کن
• ID رو extract کن (قسمت AKfycbXY... بین /s/ و /exec)

۵. mhrv-rs config

{
"mode": "full",
"auth_key": "your-secret-key-1",
"deployment_ids": ["AKfycbXY..."],
"tunnel_node_url": "https://your-vps-ip:8443",
"google_ip": "216.239.38.120",
"front_domain": "www.google.com"
}
۶. mhrv-rs رو راه بنداز + test

mhrv-rs در terminal — یا UI binary اگه دسکتاپ گرافیکی داری.

سپس در browser proxy ست کن روی 127.0.0.1:8085 (HTTP) یا 127.0.0.1:8086 (SOCKS5).

برای تست، به https://www.google.com برو — باید بدون مشکل باز بشه. سپس به یه سایت non-Google (مثل https://github.com) برو — باید از مسیر Apps Script + tunnel-node + VPS بره.

منابع کامل‌تر:

• tunnel-node README
• #277 reply — Caddy + Let's Encrypt setup
• #251 reply — apps_script vs Full mode comparison

اگه در هر مرحله گیر کردی، با log + screenshot reply بزن.

[reply via Anthropic Claude | reviewed by @therealaleph]

سلام خسته نباشید. من تمام مراحل انجام دادم ولی هنوز اتصال مشکل داره. اگر میشه کمک کنین

log-20260428-030452.txt

[therealaleph]

@ArashKhandani — log محکم narrow می‌کنه. مشکل دقیق:

WARN batch failed: bad response: no json in batch response:
<!DOCTYPE html><html><head><title>Web App</title></head>
<body><p>The script completed but did not return anything.</p></body></html>

این HTML دقیقاً decoy ای هست که در v1.8.0 برای active-probing defense اضافه شد. Code.gs شما این decoy رو وقتی برمی‌گردونه که AUTH_KEY که mhrv-rs می‌فرسته، با AUTH_KEY در Code.gs match نکنه.

پس علت قطعی: AUTH_KEY mismatch بین config mhrv-rs شما + Code.gs deployment.

Fix در ۳ مرحله:

۱. AUTH_KEY واقعی deployment رو پیدا کنید:

• به https://script.google.com بروید + پروژه رو باز کنید
• در بالای فایل Code.gs (یا CodeFull.gs)، خطی شبیه این:

  const AUTH_KEY = "your-secret-here";

• مقدار your-secret-here رو کپی کنید (دقیق، شامل همه کاراکترها بدون فاصله ابتدا/انتها)

۲. AUTH_KEY در config mhrv-rs رو بررسی کنید:

%APPDATA%\mhrv-rs\config\config.json (روی ویندوز شما، با توجه به path در log) باز کنید. خط:

"auth_key": "..."

باید دقیقاً با AUTH_KEY مرحله ۱ یکی باشه — حتی یک کاراکتر فرق نکنه.

اگر فرق داره، اصلاح کنید + Save + mhrv-rs رو restart کنید.

۳. اگر AUTH_KEY‌ها یکی بودن ولی همچنان decoy می‌گیرید:

Apps Script ممکنه deployment فعلی شما رو روی version قدیمی Code.gs قفل کرده باشه. وقتی Code.gs رو ادیت می‌کنید، deployment موجود خود به خود نسخه جدید رو نمی‌گیره — باید explicit redeploy کنید:

• Apps Script → Deploy → Manage Deployments
• روی deployment موجود → پنسیل (Edit)
• Version → New version (نه Version 1، نه Version 2 — انتخاب New version)
• Deploy

URL deployment + ID همون می‌مونن، فقط منبع کد به‌روز می‌شه.

برای debug آسون‌تر: v1.8.0+ یک flag داره به نام DIAGNOSTIC_MODE در بالای Code.gs:

const DIAGNOSTIC_MODE = false;

موقتاً به true تغییر بدید + redeploy کنید (روال مرحله ۳). حالا به‌جای decoy HTML، JSON {"e":"unauthorized"} صریح برمی‌گرده — می‌تونید روی کلمات key + auth_key مطمئن بشید. بعد از fix، به false برگردونید + redeploy کنید (production-strong).

علائم بعدی در log شما ("3 timeouts in 30s" + blacklist + بقیه timeoutها) همه consequence این auth mismatch هستن — وقتی deployment auth fail می‌کنه + decoy HTML برمی‌گردونه، mhrv-rs client اون رو "bad response" تلقی می‌کنه + بعد از ۳ چنین failure، deployment رو blacklist می‌کنه. پس از blacklist، چون شما فقط ۱ deployment دارید (1 deployment(s) در log اول نوشته)، هیچ alternative نیست + همه چیز timeout می‌شه.

Fix AUTH_KEY مشکل اصلی رو حل می‌کنه. اگه AUTH_KEY درست بود ولی همچنان decoy می‌گرفتید، بعد از enable کردن DIAGNOSTIC_MODE log جدید رو share کنید — می‌تونیم ادامه بدیم.

اگر دو مرحله بالا کمک کرد، گزارش بدید + close می‌کنیم. ممنون از log کامل — این باعث شد دقیق diagnose بشه.

---

_{[reply via Anthropic Claude | reviewed by @therealaleph]}

[sina-b4hrm]

@ArashKhandani — log محکم narrow می‌کنه. مشکل دقیق:

WARN batch failed: bad response: no json in batch response:
<!DOCTYPE html><html><head><title>Web App</title></head>
<body><p>The script completed but did not return anything.</p></body></html>

این HTML دقیقاً decoy ای هست که در v1.8.0 برای active-probing defense اضافه شد. Code.gs شما این decoy رو وقتی برمی‌گردونه که AUTH_KEY که mhrv-rs می‌فرسته، با AUTH_KEY در Code.gs match نکنه.

پس علت قطعی: AUTH_KEY mismatch بین config mhrv-rs شما + Code.gs deployment.

Fix در ۳ مرحله:

۱. AUTH_KEY واقعی deployment رو پیدا کنید:

• به https://script.google.com بروید + پروژه رو باز کنید
• در بالای فایل Code.gs (یا CodeFull.gs)، خطی شبیه این:
  const AUTH_KEY = "your-secret-here";
• مقدار your-secret-here رو کپی کنید (دقیق، شامل همه کاراکترها بدون فاصله ابتدا/انتها)

۲. AUTH_KEY در config mhrv-rs رو بررسی کنید:

%APPDATA%\mhrv-rs\config\config.json (روی ویندوز شما، با توجه به path در log) باز کنید. خط:

"auth_key": "..."
باید دقیقاً با AUTH_KEY مرحله ۱ یکی باشه — حتی یک کاراکتر فرق نکنه.

اگر فرق داره، اصلاح کنید + Save + mhrv-rs رو restart کنید.

۳. اگر AUTH_KEY‌ها یکی بودن ولی همچنان decoy می‌گیرید:

Apps Script ممکنه deployment فعلی شما رو روی version قدیمی Code.gs قفل کرده باشه. وقتی Code.gs رو ادیت می‌کنید، deployment موجود خود به خود نسخه جدید رو نمی‌گیره — باید explicit redeploy کنید:

• Apps Script → Deploy → Manage Deployments
• روی deployment موجود → پنسیل (Edit)
• Version → New version (نه Version 1، نه Version 2 — انتخاب New version)
• Deploy

URL deployment + ID همون می‌مونن، فقط منبع کد به‌روز می‌شه.

برای debug آسون‌تر: v1.8.0+ یک flag داره به نام DIAGNOSTIC_MODE در بالای Code.gs:

const DIAGNOSTIC_MODE = false;
موقتاً به true تغییر بدید + redeploy کنید (روال مرحله ۳). حالا به‌جای decoy HTML، JSON {"e":"unauthorized"} صریح برمی‌گرده — می‌تونید روی کلمات key + auth_key مطمئن بشید. بعد از fix، به false برگردونید + redeploy کنید (production-strong).

علائم بعدی در log شما ("3 timeouts in 30s" + blacklist + بقیه timeoutها) همه consequence این auth mismatch هستن — وقتی deployment auth fail می‌کنه + decoy HTML برمی‌گردونه، mhrv-rs client اون رو "bad response" تلقی می‌کنه + بعد از ۳ چنین failure، deployment رو blacklist می‌کنه. پس از blacklist، چون شما فقط ۱ deployment دارید (1 deployment(s) در log اول نوشته)، هیچ alternative نیست + همه چیز timeout می‌شه.

Fix AUTH_KEY مشکل اصلی رو حل می‌کنه. اگه AUTH_KEY درست بود ولی همچنان decoy می‌گرفتید، بعد از enable کردن DIAGNOSTIC_MODE log جدید رو share کنید — می‌تونیم ادامه بدیم.

اگر دو مرحله بالا کمک کرد، گزارش بدید + close می‌کنیم. ممنون از log کامل — این باعث شد دقیق diagnose بشه.

[reply via Anthropic Claude | reviewed by @therealaleph]

ممنون بابت راهنمایی تمام مراحل دقیق انجام دادم. قسمت اوت کی چک شد کاملا مطابق در فایل کانفیگ بود. مراحل ریدیپلوی انجام شد. ولی مشکل پابرجاست. من از فول کد استفاده می کنم امکان داره قسمت اوت کی تونل مشکل داشته باشه?

log-20260428-035801.txt

[therealaleph]

@sina-b4hrm — log جدید الگوی متفاوتی نشون می‌ده از log قبلی @ArashKhandani. شما decoy HTML نمی‌گیرید — یعنی AUTH_KEY (کلید بین mhrv-rs ↔ Apps Script) درست هست. مشکل لایه‌ی پایین‌تره:

ERROR tunnel connect_data error for X:443: missing response in batch
batch failed: timeout (10-11s RTT)

missing response in batch = mhrv-rs یک batch با N op فرستاد، Apps Script با response array کم‌تر از N entry برگشت — یعنی _doTunnelBatch در CodeFull.gs نتونست همه opها رو process کنه. یا اون‌که Apps Script timeout می‌گیره قبل از پاسخ کامل tunnel-node.

شما درست حدس زدید — TUNNEL_AUTH_KEY بسیار محتمل علت اصلی است. این کلید جداست از AUTH_KEY شما:

کلید	بین	هدف
AUTH_KEY	mhrv-rs (clientshow) ↔ Apps Script	احراز هویت کاربر شما
TUNNEL_AUTH_KEY	Apps Script ↔ tunnel-node	احراز هویت Apps Script در VPS شما

اگه TUNNEL_AUTH_KEY در CodeFull.gs با TUNNEL_AUTH_KEY در tunnel-node container match نکنه:

• در v1.8.0 tunnel-node decoy 404 nginx برمی‌گردونه (به‌جای JSON unauthorized)
• Apps Script اون 404 رو می‌خونه + می‌بینه که response به‌فرم JSON نیست + احتمالاً exception می‌اندازه
• نتیجه: response batch ناقص یا empty

Diagnostic ۳ مرحله‌ای:

۱. TUNNEL_AUTH_KEY در CodeFull.gs:

به https://script.google.com بروید + پروژه‌تون رو باز کنید. در بالای CodeFull.gs:

const TUNNEL_AUTH_KEY = "your-tunnel-secret-here";

مقدار رو copy کنید (دقیق، بدون فاصله).

۲. TUNNEL_AUTH_KEY در tunnel-node container روی VPS:

ssh root@your-vps-ip
docker exec mhrv-tunnel env | grep TUNNEL_AUTH_KEY

این باید identical با مرحله ۱ باشه.

اگه match نکنن، fix:

• اگه می‌خواید TUNNEL_AUTH_KEY در CodeFull.gs رو تغییر بدید: ادیت Code.gs + Deploy → Manage Deployments → Edit → New version → Deploy
• اگه می‌خواید tunnel-node رو با TUNNEL_AUTH_KEY در CodeFull.gs مقدار restart کنید:

  docker stop mhrv-tunnel && docker rm mhrv-tunnel
  docker run -d --name mhrv-tunnel --restart unless-stopped \
    -p 8080:8080 \
    -e TUNNEL_AUTH_KEY="EXACT_VALUE_FROM_CodeFull.gs" \
    ghcr.io/therealaleph/mhrv-tunnel-node:latest

۳. تست مستقیم Apps Script ↔ tunnel-node:

از یک machine outside Iran (یا از VPS خودش):

curl -X POST 'https://YOUR_TUNNEL_URL/tunnel' \
  -H 'Content-Type: application/json' \
  -d '{"k":"YOUR_TUNNEL_AUTH_KEY","op":"connect","host":"www.google.com","port":443}' \
  --max-time 10

نتایج:

• {"sid":"...","s":200,...} = tunnel-node کار می‌کنه + AUTH_KEY درسته. مشکل جای دیگه هست.
• <!DOCTYPE html>...nginx... = TUNNEL_AUTH_KEY mismatch (decoy 404). Fix طبق مرحله ۲.
• {"e":"connect failed: ..."} = tunnel-node نتونسته به destination برسه. VPS network issue.
• timeout = tunnel-node URL از خارج قابل دسترس نیست. firewall یا port mapping VPS.

برای debug آسون‌تر در tunnel-node: v1.8.0+ یک env var داره:

docker run -d ... -e MHRV_DIAGNOSTIC=1 ...

این کار رو می‌کنه که tunnel-node به‌جای decoy 404، JSON {"e":"unauthorized"} صریح برمی‌گردونه — فقط برای setup. بعد از rفع، MHRV_DIAGNOSTIC رو در‌نظر نگیرید (default off = production-strong).

نتیجه مرحله ۳ رو share کنید + می‌تونیم narrow کنیم.

نکته: این issue اصلاً مال @ArashKhandani بود (#310 = "آموزش vps"). شما (sina-b4hrm) issue جداگانه دارید. اگه پاسخ‌های اینجا حل نکرد، یک issue جدید با log شما بسازید تا تداخل نکنیم با مشکل ArashKhandani.

---

_{[reply via Anthropic Claude | reviewed by @therealaleph]}