🚀 REN Gateway

تونل VLESS over WebSocket با پنل مدیریت حرفه‌ای — مخصوص اجرا روی Hugging Face Spaces

بدون نیاز به VPS، بدون نیاز به کارت اعتباری. فقط چند فایل را روی یک Space آپلود کن و پنل مدیریتت آماده است.

---

📌 نحوه عملکرد (How it works)

REN Gateway یک سرور تونل است که با FastAPI نوشته شده و کانفیگ‌های VLESS over WebSocket را مدیریت می‌کند. مکانیزم کارش به این صورت است:

┌──────────────┐      WebSocket (wss)      ┌─────────────────────┐      TCP      ┌──────────────┐
│  اپ کاربر    │ ───────────────────────► │   REN Gateway       │ ───────────► │  اینترنت آزاد │
│ (v2rayNG /   │   tunnel روی پورت 443     │  (Hugging Face)     │   مقصد واقعی  │  (مقصد نهایی) │
│  NekoBox)    │ ◄─────────────────────── │  main.py / FastAPI  │ ◄─────────── │              │
└──────────────┘                          └─────────────────────┘              └──────────────┘

1. اتصال: اپلیکیشن کاربر (v2rayNG یا NekoBox) با لینک VLESS به آدرس wss://<space>.hf.space/ws/<uuid> یک تونل WebSocket باز می‌کند.
2. احراز هویت لینک: سرور uuid داخل مسیر را بررسی می‌کند؛ اگر لینک فعال و حجمش باقی باشد، تونل برقرار می‌شود.
3. رله‌ی داده: سرور بسته‌های ورودی را به مقصد واقعی (TCP) فوروارد می‌کند و پاسخ را برمی‌گرداند — مثل یک پراکسی شفاف.
4. حسابداری: حجم مصرفی، تعداد اتصال‌ها، IP‌ها و ترافیک هر لینک به‌صورت زنده شمارش و در پنل نمایش داده می‌شود.

⚙️ کل وضعیت (لینک‌ها، آمار، اتصال‌ها) در حافظه (RAM) نگه‌داری می‌شود — سبک و سریع، بدون نیاز به دیتابیس.

---

🤖 دیپلوی خودکار با ربات تلگرام (ساده‌ترین روش)

به‌جای انجام دستی مراحل، می‌توانی همه‌چیز را خودکار از طریق ربات تلگرام انجام دهی:

👉 @REN_WZA_BOT

کافیست ربات را استارت کنی و طبق راهنمایی‌اش پیش بروی؛ ربات به‌صورت خودکار پروژه را روی Hugging Face برایت دیپلوی می‌کند و آدرس پنل را تحویلت می‌دهد — بدون نیاز به آپلود دستی فایل‌ها.

اگر می‌خواهی روند نصب را کامل کنترل کنی یا با Hugging Face آشنا هستی، می‌توانی از روش دستی پایین استفاده کنی.

---

⚡ نصب دستی روی Hugging Face Spaces

۱. ساخت Space

1. به huggingface.co/new-space برو
2. Space name: یک نام دلخواه (مثلاً ren)
3. SDK: حتماً Docker → گزینه‌ی Blank
4. Visibility: پیشنهاد می‌شود Private (چون پنل مدیریتی است)
5. روی Create Space بزن

۲. آپلود فایل‌ها

از تب Files → Add file → Upload files، این فایل‌ها را آپلود کن:

فایل	توضیح
main.py	هسته‌ی برنامه
requirements.txt	کتابخانه‌های مورد نیاز
Dockerfile	تنظیمات اجرا (پورت ۷۸۶۰)
README.md	همین فایل (شامل تنظیمات HF)

سپس Commit changes را بزن. Hugging Face خودکار شروع به Build می‌کند (۲–۳ دقیقه).

۳. ورود به پنل

بعد از اینکه وضعیت Space به Running رسید، دامنه‌ی مستقیم اپ این است:

https://<username>-<space>.hf.space

این آدرس خودکار صفحه‌ی ورود را باز می‌کند

• 🔑 رمز عبور پیش‌فرض: admin
• ⚠️ بلافاصله بعد از ورود، رمز را از بخش Security عوض کن.

---

🔒 امنیت (مهم)

برای جلوگیری از دسترسی غیرمجاز، در مسیر Space → Settings → Variables and secrets این دو Secret را اضافه کن:

نام	مقدار	کاربرد
ADMIN_PASSWORD	یک رمز قوی	رمز ورود به پنل
SECRET_KEY	یک رشته‌ی تصادفی طولانی	امضای سشن‌ها و توکن لینک‌ها

بعد از افزودن، Space خودکار ری‌استارت می‌شود و مقادیر جدید فعال می‌شوند. اگر SECRET_KEY را تنظیم نکنی، روی مقدار پیش‌فرض عمومی می‌ماند و امن نیست.

---

🎯 استفاده از پنل

ساخت لینک VLESS

1. وارد پنل شو و روی + Add بزن
2. یک نام انگلیسی وارد کن (مثلاً Ali)
3. حجم مصرفی را مشخص کن (مثلاً 1 GB)
4. روی Create بزن
5. لینک VLESS را کپی کن یا QR Code را اسکن کن

اتصال با اپلیکیشن

1. اپلیکیشن v2rayNG یا NekoBox را نصب کن
2. لینک VLESS را وارد/Import کن
3. اتصال را فعال کن — 🎉 تمام!

---

🖥️ بخش‌های پنل

بخش	توضیح
📊 Dashboard	نمای کلی آمار، نمودار ترافیک، مصرف CPU و RAM
🔗 Inbounds	مدیریت لینک‌های VLESS (افزودن، ویرایش، فعال/غیرفعال، حذف)
📈 Traffic	آمار کلی مصرف ترافیک
🌐 Clean IP	مدیریت آی‌پی‌های تمیز برای پینگ بهتر
🔒 Security	تغییر رمز عبور پنل

---

🔄 کپی و سابسکریپشن

• دکمه Copy: فقط کانفیگ با دامنه‌ی خود سرور را کپی می‌کند — مناسب تست سریع.
• لینک Subscription: تمام کانفیگ‌ها (دامنه + آی‌پی‌های تمیز) را به‌همراه نمایش حجم مصرفی، زمان باقی‌مانده و آپدیت خودکار ارائه می‌دهد — مناسب استفاده‌ی طولانی‌مدت.

---

🌐 آی‌پی تمیز (Clean IP)

آی‌پی تمیز یک IP یا دامنه است که می‌تواند پینگ بهتری بدهد. در بخش Clean IP پنل می‌توانی هر تعداد آدرس دلخواه اضافه کنی؛ کانفیگ‌ها خودکار با این آدرس‌ها ساخته می‌شوند. استفاده از آن اختیاری اما توصیه‌شده است.

---

⚙️ متغیرهای محیطی (Environment Variables)

متغیر	پیش‌فرض	توضیح
PORT	7860	پورتی که سرور روی آن گوش می‌دهد (Hugging Face از ۷۸۶۰ استفاده می‌کند)
ADMIN_PASSWORD	admin	رمز ورود به پنل
SECRET_KEY	(پیش‌فرض داخلی)	کلید امضای سشن و توکن‌ها — حتماً عوضش کن
SPACE_HOST	(خودکار توسط HF)	دامنه‌ی عمومی؛ خودکار تشخیص داده می‌شود
PUBLIC_DOMAIN	—	بازنویسی دستی دامنه (در صورت نیاز)

---

🛠️ مشکل‌یابی

مشکل	راه‌حل
❌ پنل باز نمی‌شود	چند دقیقه صبر کن تا وضعیت Space به Running برسد؛ لاگ‌ها را در تب Logs ببین
❌ host/SNI روی localhost است	مطمئن شو نسخه‌ی به‌روز main.py آپلود شده (تشخیص خودکار SPACE_HOST)
❌ لینک وصل نمی‌شود	مطمئن شو حجم لینک تمام نشده و لینک فعال است
❌ رمز اشتباه است	رمز پیش‌فرض admin است؛ آن را در بخش Security یا با Secret عوض کن
🐢 سرعت پایین	پلن رایگان HF در ریجن آمریکا قفل است و قابل تغییر نیست؛ برای سرعت بالاتر از سرور نزدیک‌تر استفاده کن

---

📝 نکات

• 📱 پنل روی موبایل هم کار می‌کند و از Dark/Light Mode و دو زبان فارسی/انگلیسی پشتیبانی می‌کند.
• 🔒 هر لینک می‌تواند حجم مصرفی و محدودیت IP مستقل داشته باشد.
• 💾 داده‌ها در حافظه نگه‌داری می‌شوند؛ با ری‌استارت Space، لینک‌ها پاک می‌شوند (طبیعت پلن رایگان).
• ⚠️ اجرای تونل/پراکسی ممکن است با قوانین استفاده‌ی بعضی پلتفرم‌ها مغایرت داشته باشد؛ مسئولیت استفاده بر عهده‌ی کاربر است.

---

📄 لایسنس

MIT License