A lightweight VLESS-over-WebSocket proxy panel built with FastAPI, deployable on Render or Railway.

• VLESS over WebSocket (TLS) tunneling
• Multi-inbound management with per-user traffic quotas
• Connection limits per inbound (max IPs)
• Expiry date support per inbound
• Subscription link (/sub/<uid>) compatible with v2rayNG, Hiddify, etc.
• Clean IP / alternative address management
• Real-time dashboard: CPU, memory, hourly traffic chart
• Bilingual UI (English / Persian)
• Dark & Light mode
• Session-based authentication with password change
• Keep-alive mechanism for free-tier hosting

.
├── main.py             # FastAPI application (gateway + panel UI)
├── requirements.txt    # Python dependencies
├── render.yaml         # Render deployment config
└── Procfile            # Process entry point

1. Fork or push this repo to GitHub.
2. Go to render.com → New Web Service → connect your repo.
3. Render will auto-detect render.yaml and configure everything.
4. Set your ADMIN_PASSWORD environment variable (default: admin).

💡 Tip: For better speed, set the Region to Frankfurt (EU) in Render settings.

This panel on Render routes through Cloudflare's clean IPs exclusively.

Render's infrastructure sits behind Cloudflare's network, so all VLESS+WS configs will automatically use Cloudflare clean IP ranges — which are generally unblocked and stable in restricted regions.

✅ Use the panel URL directly — Cloudflare CDN handles routing automatically.

If configs don't connect, try manually entering a known Cloudflare clean IP (e.g. 104.21.x.x or 172.67.x.x) in your client instead of the hostname.

1. Fork or push this repo to GitHub.
2. Go to railway.app → New Project → Deploy from GitHub repo → select your repo.
3. Wait for the deployment to finish. You'll be given a URL — that's your service domain. To access the panel, just add /login to the end of your domain.

Railway does NOT use Cloudflare. It uses its own dedicated IP ranges.

Railway's outbound IPs typically fall in the range 69.46.46.x, so your configs will use Railway's own IPs — not Cloudflare's. These may or may not be accessible depending on your network restrictions.

If configs don't work on Railway:

1. Check whether the 69.46.46.x range is reachable from your network.
2. Enable Fragment Mode in your v2ray / v2rayNG client (see section below).
3. Switch to Render for Cloudflare clean IP routing.

If your configurations are not connecting — especially on Railway — enable Fragment Mode in your client:

v2rayNG (Android):

1. Go to Settings → Fragment
2. Enable Fragment and set: Packets tlshello, Length 10-30, Interval 10-20
3. Reconnect

v2ray (Desktop): Add to your outbound → streamSettings:

"sockopt": {
  "dialerProxy": "fragment",
  "tcpKeepAliveIdle": 100
}

Fragment mode splits the TLS ClientHello packet to bypass deep packet inspection (DPI) firewalls.

pip install -r requirements.txt
python main.py

Panel will be available at: http://localhost:8000/login

After deploying on Render or Railway, access your panel at: https://yourdomain/login

⚠️ Change ADMIN_PASSWORD before deploying to production.

fastapi==0.104.1
uvicorn==0.24.0
websockets==12.0
httpx==0.25.1
psutil==5.9.6

vless://<uuid>@<domain>:443?encryption=none&security=tls&type=ws&host=<domain>&path=/ws/<uuid>&sni=<domain>&fp=chrome&alpn=http/1.1#Luffy-<name>

1. Open the panel and go to Inbounds.
2. Click Sub to copy the subscription URL.
3. In your client app, add a new subscription with that URL.
4. Update subscription — configs will appear automatically.

• All data is stored in-memory. Restarting the service resets all inbounds and traffic stats.
• For persistent storage, a database backend (e.g. SQLite) would need to be added.
• The keep-alive task pings /health every 10 minutes to prevent Render free-tier spin-down.

1. Fork the repository
2. Create a new branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to your branch: git push origin feature/amazing-feature
5. Open a Pull Request

MIT — use freely, modify as needed.

My Telegram channel

یک پنل پراکسی سبک VLESS-over-WebSocket ساخته‌شده با FastAPI، قابل استقرار روی Render یا Railway.

• تانلینگ VLESS روی WebSocket (TLS)
• مدیریت چند اینباند با محدودیت ترافیک برای هر کاربر
• محدودیت تعداد اتصال (IP) برای هر اینباند
• پشتیبانی از تاریخ انقضا برای هر اینباند
• لینک اشتراک (/sub/<uid>) سازگار با v2rayNG، Hiddify و غیره
• مدیریت آی‌پی تمیز / آدرس‌های جایگزین
• داشبورد لحظه‌ای: CPU، حافظه، نمودار ترافیک ساعتی
• رابط کاربری دو زبانه (فارسی / انگلیسی)
• حالت تاریک و روشن
• احراز هویت مبتنی بر session با امکان تغییر رمز
• مکانیزم keep-alive برای هاستینگ رایگان

.
├── main.py             # اپلیکیشن FastAPI (گیت‌وی + رابط پنل)
├── requirements.txt    # وابستگی‌های پایتون
├── render.yaml         # تنظیمات استقرار Render
└── Procfile            # نقطه ورود پروسه

1. ریپو را fork کنید یا روی GitHub آپلود کنید.
2. به render.com بروید ← New Web Service ← ریپو را متصل کنید.
3. Render به‌صورت خودکار render.yaml را شناسایی و همه چیز را تنظیم می‌کند.
4. متغیر ADMIN_PASSWORD را تنظیم کنید (پیش‌فرض: admin).

💡 نکته: برای سرعت بهتر، Region را روی Frankfurt (EU) تنظیم کنید.

⭐ این پنل روی Render فقط از آی‌پی‌های تمیز Cloudflare استفاده می‌کند.

زیرساخت Render پشت شبکه Cloudflare قرار دارد، بنابراین تمام کانفیگ‌های VLESS+WS به‌صورت خودکار از آی‌پی‌های تمیز Cloudflare عبور می‌کنند — که معمولاً آنبلاک و پایدار هستند.

✅ URL پنل را مستقیم استفاده کنید — Cloudflare CDN مسیریابی را خودکار انجام می‌دهد.

اگر کانفیگ‌ها وصل نشدند، یک آی‌پی تمیز شناخته‌شده Cloudflare (مثل 104.21.x.x یا 172.67.x.x) را در کلاینت خود به جای hostname وارد کنید.

1. ریپو را fork کنید یا روی GitHub آپلود کنید.
2. به railway.app بروید ← New Project ← Deploy from GitHub repo ← ریپو را انتخاب کنید. 3.صبر کنید تا deploy شود بعد از deploy یک url به شما داده میشود که ان دامنه سرویس شماست برای ورود به پنل کافیست به اخر دامنه تان /login اضافه کنید.

⭐ Railway از Cloudflare استفاده نمی‌کند و از آی‌پی‌های اختصاصی خودش استفاده می‌کند.

آی‌پی‌های خروجی Railway معمولاً در رنج 69.46.46.x هستند، بنابراین کانفیگ‌های شما از آی‌پی‌های خود Railway عبور می‌کنند — نه از Cloudflare. این آی‌پی‌ها ممکن است بسته به محدودیت‌های شبکه شما در دسترس باشند یا نباشند.

اگر کانفیگ‌ها روی Railway کار نکرد:

1. بررسی کنید که رنج 69.46.46.x از شبکه شما در دسترس است.
2. حالت Fragment را در کلاینت v2ray / v2rayNG فعال کنید (بخش زیر را ببینید).
3. برای استفاده از آی‌پی‌های تمیز Cloudflare، به Render بروید.

اگر کانفیگ‌ها وصل نمی‌شوند — به‌خصوص روی Railway — حالت Fragment را فعال کنید:

v2rayNG (اندروید):

1. به Settings → Fragment بروید
2. Fragment را فعال کنید و تنظیم کنید: Packets روی tlshello، Length روی 10-30، Interval روی 10-20
3. مجدداً وصل شوید

v2ray (دسکتاپ): به outbound → streamSettings اضافه کنید:

"sockopt": {
  "dialerProxy": "fragment",
  "tcpKeepAliveIdle": 100
}

حالت Fragment بسته TLS ClientHello را تقسیم می‌کند تا از فایروال‌های DPI عبور کند.

pip install -r requirements.txt
python main.py

پنل در این آدرس در دسترس است: http://localhost:8000/login

بعد از استقرار روی Render،Railway از این آدرس وارد پنل شوید: https://yourdomain/login

⚠️ بعد از استقرار در محیط عمومی، ADMIN_PASSWORD را تغییر دهید.

fastapi==0.104.1
uvicorn==0.24.0
websockets==12.0
httpx==0.25.1
psutil==5.9.6

vless://<uuid>@<domain>:443?encryption=none&security=tls&type=ws&host=<domain>&path=/ws/<uuid>&sni=<domain>&fp=chrome&alpn=http/1.1#Luffy-<name>

1. پنل را باز کنید و به اینباندها بروید.
2. روی Sub کلیک کنید تا لینک اشتراک کپی شود.
3. در اپ کلاینت، یک اشتراک جدید با آن لینک اضافه کنید.
4. اشتراک را آپدیت کنید — کانفیگ‌ها به‌صورت خودکار نمایش داده می‌شوند.

• تمام داده‌ها در حافظه ذخیره می‌شوند. با ریستارت سرویس، همه اینباندها و آمار ترافیک پاک می‌شوند.
• برای ذخیره‌سازی دائمی، نیاز به اضافه کردن دیتابیس (مثلاً SQLite) وجود دارد.
• تسک keep-alive هر ۱۰ دقیقه به /health پینگ می‌زند تا از خواب رفتن سرویس رایگان Render جلوگیری کند.

MIT — آزادانه استفاده و ویرایش کنید.

چنل تلگراممون