📖 Table of Contents

• Overview
• Features
• Supported Protocols
• Architecture
• Project Structure
• Quick Start (Railway)
• Local Development
• Environment Variables
• Dashboard Preview
• Roadmap
• Contributing
• License
• Support the Project

🚀 Overview

RVG Gateway is a fast, modern, self-hosted multi-protocol proxy management panel, built with Python + FastAPI, designed to deploy in minutes on Railway.

It gives you a beautiful admin dashboard to create, monitor, and manage proxy links across multiple protocols — with per-link traffic quotas, live connection stats, and QR code generation — all from a single lightweight service.

💡 Originally built around a simple VLESS-over-WebSocket relay, RVG has evolved into a full multi-protocol gateway with authentication, quota tracking, and a polished management UI.

✨ Features

🌐 Supported Protocols

🏗️ Architecture

flowchart LR
    A[Client / v2rayNG / NekoBox] -->|VLESS / Trojan / SS| B(RVG Gateway<br/>FastAPI Server)
    B --> C{Protocol Router}
    C -->|WebSocket| D[VLESS / Trojan Relay]
    C -->|TCP| E[Shadowsocks Relay]
    C -->|mtg binary| F[MTProto Relay]
    B --> G[(In-Memory<br/>Link & Quota Store)]
    B --> H[Admin Dashboard :8000/dashboard]
    B --> I[Telegram Bot Automation]
    style B fill:#203a43,stroke:#0f2027,color:#fff
    style H fill:#2c5364,stroke:#0f2027,color:#fff

📂 Project Structure

RVG/
├── protocol/                 # Per-protocol relay implementations
├── main.py                   # FastAPI app entrypoint
├── central.py                 # Core orchestration logic
├── pages.py                   # Dashboard route/page handlers
├── updater.py                  # Self-update logic
├── botgeneratedomin.py         # Telegram bot: domain generation
├── bottokentcpproxy.py         # TCP proxy automation via Telegram
├── zeussocks5.py                # SOCKS5 proxy handler
├── requirements.txt
├── .gitignore
└── README.md

⚡ Quick Start (Railway Deploy)

https://github.com/arvin341az-glitch/RVG/fork

https://your-app.up.railway.app/dashboard

💻 Local Development

# Clone your fork
git clone https://github.com/<your-username>/RVG.git
cd RVG

# Create a virtual environment
python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run the server
python main.py

The dashboard will be available at http://localhost:8000/dashboard.

⚙️ Environment Variables

📸 Dashboard Preview

Traffic overview • Live connections • Link manager • QR export

🗺️ Roadmap

• Multi-protocol relay (VLESS, Trojan, Shadowsocks, MTProto)
• Telegram bot automation
• Traffic dashboard with charts
• Persistent storage (Redis / PostgreSQL)
• Multi-node / cluster support
• Public REST API for external integrations

🤝 Contributing

Pull requests are welcome for bug fixes, optimizations, and documentation.

⚠️ Please read the LICENSE before contributing — modification and redistribution of modified versions is restricted. Open an issue first if you'd like to discuss a change.

📄 License

This project is distributed under a custom license: ✅ Free to use, deploy, and fork ❌ Modifying and redistributing a modified version is not permitted

See the full LICENSE file for details.

❤️ Support the Project

If this project helped you, consider supporting its development:

📖 فهرست مطالب

• معرفی
• ویژگی‌ها
• پروتکل‌های پشتیبانی‌شده
• معماری
• ساختار پروژه
• شروع سریع (دیپلوی روی Railway)
• توسعه محلی
• متغیرهای محیطی
• نقشه راه
• مشارکت
• لایسنس
• حمایت از پروژه

🚀 معرفی

RVG Gateway یک پنل مدیریت پروکسی چندپروتکلی، سریع و مدرن است که با Python + FastAPI ساخته شده و در چند دقیقه روی Railway قابل دیپلوی است.

این پروژه یک داشبورد مدیریتی زیبا در اختیارتان می‌گذارد تا لینک‌های پروکسی را در پروتکل‌های مختلف بسازید، مانیتور کنید و مدیریت کنید — همراه با محدودیت ترافیک اختصاصی برای هر لینک، آمار اتصالات زنده و خروجی QR Code، همه از طریق یک سرویس سبک و یکپارچه.

💡 این پروژه که ابتدا یک ریلی ساده VLESS روی WebSocket بود، اکنون به یک دروازه کامل چندپروتکلی با احراز هویت، مدیریت سهمیه و رابط کاربری حرفه‌ای تبدیل شده است.

✨ ویژگی‌ها

🌐 پروتکل‌های پشتیبانی‌شده

🏗️ معماری

flowchart RL
    A[کلاینت / v2rayNG / NekoBox] -->|VLESS / Trojan / SS| B(RVG Gateway<br/>سرور FastAPI)
    B --> C{مسیریاب پروتکل}
    C -->|WebSocket| D[ریلی VLESS / Trojan]
    C -->|TCP| E[ریلی Shadowsocks]
    C -->|باینری mtg| F[ریلی MTProto]
    B --> G[(ذخیره‌سازی درون‌حافظه<br/>لینک و سهمیه)]
    B --> H[داشبورد مدیریت :8000/dashboard]
    B --> I[اتوماسیون ربات تلگرام]
    style B fill:#203a43,stroke:#0f2027,color:#fff
    style H fill:#2c5364,stroke:#0f2027,color:#fff

📂 ساختار پروژه

RVG/
├── protocol/                 # پیاده‌سازی ریلی هر پروتکل
├── main.py                   # نقطه ورود اپلیکیشن FastAPI
├── central.py                 # منطق اصلی هماهنگ‌سازی
├── pages.py                   # هندلر مسیرها/صفحات داشبورد
├── updater.py                  # منطق به‌روزرسانی خودکار
├── botgeneratedomin.py         # ربات تلگرام: تولید دامنه
├── bottokentcpproxy.py         # اتوماسیون پروکسی TCP از طریق تلگرام
├── zeussocks5.py                # هندلر پروکسی SOCKS5
├── requirements.txt
├── .gitignore
└── README.md

⚡ شروع سریع (دیپلوی روی Railway)

https://github.com/arvin341az-glitch/RVG/fork

https://your-app.up.railway.app/dashboard

💻 توسعه محلی

# کلون کردن فورک شما
git clone https://github.com/<your-username>/RVG.git
cd RVG

# ساخت محیط مجازی
python -m venv venv
source venv/bin/activate   # ویندوز: venv\Scripts\activate

# نصب وابستگی‌ها
pip install -r requirements.txt

# اجرای سرور
python main.py

داشبورد در آدرس http://localhost:8000/dashboard در دسترس خواهد بود.

⚙️ متغیرهای محیطی

🗺️ نقشه راه

• ریلی چندپروتکلی (VLESS، Trojan، Shadowsocks، MTProto)
• اتوماسیون ربات تلگرام
• داشبورد ترافیک با نمودار
• ذخیره‌سازی دائمی (Redis / PostgreSQL)
• پشتیبانی چندنودی / کلاستر
• API عمومی REST برای یکپارچه‌سازی با سرویس‌های دیگر

🤝 مشارکت

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

⚠️ لطفاً قبل از مشارکت، فایل LICENSE را مطالعه کنید — تغییر و بازنشر نسخه تغییریافته محدود شده است. برای هرگونه تغییر، ابتدا یک Issue باز کنید.

📄 لایسنس

این پروژه تحت یک لایسنس سفارشی منتشر شده است: ✅ استفاده، دیپلوی و فورک آزاد ❌ تغییر و بازنشر نسخه تغییریافته مجاز نیست

برای جزئیات کامل به فایل LICENSE مراجعه کنید.

❤️ حمایت از پروژه

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