RVG README

The project's README from github.com/arvin341az-glitch/RVG. As one markdown file: README.md.


Typing SVG


Python FastAPI Railway License

Stars Forks Last Commit Repo Size


🇬🇧 English

📖 Table of Contents


🚀 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

🔌 Core Gateway

  • VLESS over WebSocket (TLS 443)
  • Trojan, Shadowsocks (AEAD / aes-256-gcm)
  • MTProto proxy via mtg binary
  • Internal HTTP Proxy
  • xHTTP / gRPC / HTTPUpgrade transports

📊 Management Dashboard

  • Real-time traffic charts & trend indicators
  • Live connection monitoring
  • Unlimited link creation with per-link quotas (MB/GB)
  • Instant enable / disable per link
  • QR Code export for every link

🛡️ Security & Reliability

  • Strict UUID validation
  • Session-based authentication
  • TLS fingerprint spoofing (Chrome)
  • Optimized relay buffers (512KB, TCP_NODELAY, SO_KEEPALIVE)

🤖 Automation

  • Telegram-bot-integrated proxy management
  • Domain suggestion via Cloudflare Worker
  • Automated TCP proxy dispatch with blacklist targeting
  • One-click Railway deployment

🌐 Supported Protocols

Protocol Transport Status
VLESS WebSocket / xHTTP / gRPC ✅
Trojan WebSocket / HTTPUpgrade ✅
Shadowsocks AEAD (aes-256-gcm) ✅
MTProto mtg v2.1.7 ✅
HTTP Proxy Internal ✅

🏗️ 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)

1️⃣

Fork this repository

https://github.com/arvin341az-glitch/RVG/fork
2️⃣

Deploy on Railway

  1. Go to Railway.app
  2. Click New Project → Deploy from GitHub repo
  3. Select your forked repository
  4. Railway auto-builds and deploys 🎉
3️⃣

Enable a public domain

Railway → Settings → Networking → Generate Domain (this sets RAILWAY_PUBLIC_DOMAIN automatically)
4️⃣

Open your dashboard

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

Copy the default VLESS link and import it into your client (v2rayNG, NekoBox, Streisand, …).

💻 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

Variable Description Default
PORT Port the service runs on 8000
SECRET_KEY Internal security key Randomly generated
RAILWAY_PUBLIC_DOMAIN Public Railway domain (auto-set) localhost

📸 Dashboard Preview

Traffic overview • Live connections • Link manager • QR export


🗺️ Roadmap


🤝 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:

Donate Wallets

Made with ❤️ by codebox



🇮🇷 فارسی

📖 فهرست مطالب


🚀 معرفی

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

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

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


✨ ویژگی‌ها

🔌 هسته دروازه

  • VLESS روی WebSocket (TLS 443)
  • Trojan، Shadowsocks (AEAD / aes-256-gcm)
  • پروکسی MTProto از طریق باینری mtg
  • HTTP Proxy داخلی
  • ترنسپورت‌های xHTTP / gRPC / HTTPUpgrade

📊 داشبورد مدیریتی

  • نمودار ترافیک لحظه‌ای و شاخص‌های روند
  • مانیتورینگ اتصالات زنده
  • ساخت لینک نامحدود با محدودیت ترافیک اختصاصی (MB/GB)
  • فعال/غیرفعال‌سازی آنی هر لینک
  • خروجی QR Code برای هر لینک

🛡️ امنیت و پایداری

  • اعتبارسنجی دقیق UUID
  • احراز هویت مبتنی بر سشن
  • جعل فینگرپرینت TLS (Chrome)
  • بافرهای بهینه‌شده ریلی (۵۱۲ کیلوبایت، TCP_NODELAY، SO_KEEPALIVE)

🤖 اتوماسیون

  • مدیریت پروکسی یکپارچه با ربات تلگرام
  • پیشنهاد دامنه از طریق Cloudflare Worker
  • ارسال خودکار پروکسی TCP با هدف‌گیری بلک‌لیست
  • دیپلوی با یک کلیک روی Railway

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

پروتکل ترنسپورت وضعیت
VLESS WebSocket / xHTTP / gRPC ✅
Trojan WebSocket / HTTPUpgrade ✅
Shadowsocks AEAD (aes-256-gcm) ✅
MTProto mtg v2.1.7 ✅
HTTP Proxy داخلی ✅

🏗️ معماری

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)

1️⃣

فورک کردن این ریپازیتوری

https://github.com/arvin341az-glitch/RVG/fork
2️⃣

دیپلوی روی Railway

۱. وارد Railway.app شوید ۲. روی New Project → Deploy from GitHub repo کلیک کنید ۳. ریپازیتوری فورک‌شده خود را انتخاب کنید ۴. Railway به‌صورت خودکار پروژه را می‌سازد و دیپلوی می‌کند 🎉
3️⃣

فعال‌سازی دامنه عمومی

Railway ← Settings ← Networking ← Generate Domain (این کار متغیر RAILWAY_PUBLIC_DOMAIN را خودکار تنظیم می‌کند)
4️⃣

باز کردن داشبورد

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

لینک پیش‌فرض VLESS را کپی کرده و در کلاینت دلخواه (v2rayNG، NekoBox، Streisand و...) وارد کنید.

💻 توسعه محلی

# کلون کردن فورک شما
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 در دسترس خواهد بود.


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

متغیر توضیح پیش‌فرض
PORT پورت اجرای سرویس 8000
SECRET_KEY کلید امنیتی داخلی تولید تصادفی
RAILWAY_PUBLIC_DOMAIN دامنه عمومی Railway (خودکار) localhost

🗺️ نقشه راه


🤝 مشارکت

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

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


📄 لایسنس

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

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


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

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

Donate Wallets

ساخته‌شده با ❤️ توسط codebox


RVG (arvin341az-glitch/RVG)

Searching Database…

4.3K ·GitHub
RVG
Что это?RVG Gateway — это self-hosted панель управления мультипротокольными прокси, построенная на Python и FastAPI. Она позволяет создавать, отслеживать и управлять прокси-ссылками VLESS, Trojan, Shadowsocks и MTProto через веб-панель, а разворачивается на Railway за считанные минуты.
Это просто админ-панель или она сама запускает прокси?И то и другое: сервис поднимает сами прокси-релеи (VLESS, Trojan, Shadowsocks, MTProto) и при этом предлагает панель для создания, отслеживания и управления этими ссылками — всё в одном лёгком процессе.
Как его развернуть?Сделайте форк репозитория, создайте из него новый проект Railway (New Project → Deploy from GitHub repo), и Railway сам соберёт и развернёт его. Затем сгенерируйте публичный домен в Settings → Networking, чтобы RAILWAY_PUBLIC_DOMAIN выставился автоматически.
От чего ещё он зависит, кроме Railway?Это приложение на Python/FastAPI, которое можно запустить и локально; поддержка MTProto опирается на прилагаемый бинарник mtg (v2.1.7).
Что ещё не готово?Постоянного хранилища пока нет (поддержка Redis/PostgreSQL всё ещё в планах), а поддержка multi-node/кластеров и публичный REST API — тоже незакрытые пункты роадмапа.
Могу ли я изменять его и распространять изменённую версию?Нет — лицензия разрешает свободно использовать, разворачивать и делать форки, но изменять и распространять изменённую версию прямо запрещено.
Какие прокси-протоколы он поддерживает?VLESS поверх WebSocket/xHTTP/gRPC, Trojan (WebSocket/HTTPUpgrade), Shadowsocks (AEAD aes-256-gcm), MTProto через mtg и внутренний HTTP-прокси.
Он работает с Telegram?Да, есть управление прокси через интегрированного Telegram-бота для автоматической обработки ссылок, а также автоматический подбор доменов через Cloudflare Worker.
Можно получить QR-код для прокси-ссылки?Да, любую ссылку можно экспортировать как QR-код для быстрого импорта в клиенты вроде v2rayNG, NekoBox или Streisand.
С чего начинался этот проект?Проект начинался как простой релей VLESS поверх WebSocket, а вырос в полноценный мультипротокольный шлюз с аутентификацией, учётом квот и интерфейсом управления.
What are similar projects?SideRail, nyx, NewYork, SuperJinX, CFNext, dsh-bridge, Open-Box, 3x-ui
Which topics is it in?gateway, telegram-bot, vless, trojan, qr-code, shadowsocks, tls, fastapi, websocket, authentication, proxy, dashboard
Creator
arvin341az-glitch
Size
0.4 MB
Stars
4.3K
Updated
CommitSep 13
Age
4mo
Commits · 90 Days