🇬🇧 English

White Panel — modern control panel and network operations

⚡ Ultimate All-in-One Proxy & Subscription Management System

Manage users, subscriptions, nodes, scanners, Vercel relays, and Telegram bots from a single unified panel.

VPS · Railway · Docker-ready · Responsive Glassmorphism UI

🌐 Language / زبان / اللغة / Язык

🇬🇧 English | 🇮🇷 فارسی | 🇸🇦 العربية | 🇷🇺 Русский

📺 🎬 Official Video Tutorial / ویدیوی آموزشی / فيديو الشرح / Видеоурок

💡 Watch the step-by-step setup guide on YouTube:
Learn how to deploy White Panel on VPS & Railway, connect Telegram Sales Bot, configure Vercel WebSocket relays, and use the built-in scanner.
🔗 Direct YouTube Link: https://www.youtube.com/watch?v=pgGy_bN65Pk

🇬🇧 English

✦ Why White Panel?

White Panel unifies all the operational pieces of modern proxy infrastructure into a high-performance, single-dashboard command center: users, subscriptions, generated links, dynamic QR codes, nodes, scanners, and automated Telegram bots.

Core Capabilities

Area	Feature Breakdown
👤 Users	Create/manage accounts, dynamic traffic quotas, expiration dates, link generation, and bulk actions
🔗 Subscriptions	Beautiful public responsive subscription pages (`/p/<key>`), single-click client imports, and QR codes
🛡 Engine v4.0	High-performance core, strict IP concurrency limiting, anti-domestic & anti-torrent shield
🌐 Web Proxy	Built-in zero-configuration Telegram Web Proxy (`t.me/webproxy`) directly on port 443 via Railway/domain
⚡ Vercel Relay	TLS + WebSocket bridge to bypass strict network blockades using serverless Edge functions
🛰 Nodes & Workers	Multi-node management, real-time health checks, Cloudflare worker integration, sync & heartbeats
🧪 Scanner	Ultra-fast multi-threaded TCP / IP / SNI scanner, Cloudflare IP lookup, batch ping with touch-friendly mobile copy
🤖 Telegram Bots	Channel auto-publisher & full-featured Customer Sell Bot with plans, card-to-card receipts, and instant approval

License

White Panel is free to use, copy, redistribute and fork — as long as it stays unmodified. Modifying the code or selling the software itself is not permitted. Using the panel to run your own service is allowed. See the LICENSE file for the full terms.

🚀 Deployment

Option A — One-Command VPS Installation (Recommended)

Run the automated installer on any clean Ubuntu/Debian VPS:

curl -fsSL https://raw.githubusercontent.com/Itskillmaster/WhitePanel-Ui/main/start.sh | bash

The installer configures dependencies, uv, Xray-core, service daemons, and starts the panel on port 8080.

Useful Installer Environment Variables

Variable	Default	Purpose
`WHITE_APP_DIR`	`/opt/WhitePanel`	Root directory for application files
`WHITE_REPO`	Project Git Repository	Git source URL
`WHITE_BRANCH`	`main`	Branch to clone and maintain
`WHITE_UV_VERSION`	`0.12.9`	uv release package
`WHITE_XRAY_VERSION`	`26.3.27`	High-performance Xray binary

Option B — Railway One-Click Cloud Deployment

Fork this repository into your GitHub account.
Sign in to Railway and create a New Project from GitHub repo.
Railway detects Dockerfile and railway.toml automatically.
Set the service port to 8080.
Generate a Public Domain in Railway settings.
Open https://your-domain.up.railway.app/white and enjoy!

🧭 Public Endpoint & Subscription Flow

White Panel dynamically resolves public endpoints so you never have to hard-code changing IP addresses:

Panel Architecture
  ├── /white                → Authenticated Administration Panel
  ├── /login                → Secure Admin Login
  ├── /dashboard            → Visual System Telemetry & Statistics
  ├── /link/<uuid>          → Per-user configuration viewer
  ├── /p/<uuid_key>         → Public Responsive Subscription Page
  ├── /api/sub/<uuid_key>   → Raw client subscription payload
  └── /api/v1/ws            → High-speed Telegram Web Proxy (TWP)

🤖 Telegram Automation

Channel Bot

Generates ready-to-use configurations and QR codes with custom branding and posts them automatically to your Telegram channel.

Sell Bot (Automated Sales System)

Simple customer journey:

/start  →  🛍 Products  →  Select Plan  →  Upload Receipt  →  Admin Approval  →  Instant Config Delivery

Numeric Telegram Admin ID verification.
Mandatory Channel Membership enforcement.
Automated cleanup and customer notifications upon quota/duration expiry.

🌐 Built-in `Web Proxy` Inbound (Telegram Web Proxy)

Ships with a native system inbound named Web Proxy (telegram-webproxy), bound internally to port 8080 and exposed on port 443 with zero extra daemon configuration.

Generates safe https://t.me/webproxy?server=<DOMAIN>&secret=<USER_SECRET> links.
Cryptographic HMAC tokens verified via WHITE_TWP_SIGNING_KEY.
Runs alongside dashboard traffic without interfering with VLESS/Xray ports.

⚡ Vercel Domain (TLS + WebSocket relay)

Deploys a Node.js WebSocket bridge onto Vercel Edge compute:

Uses security=tls, type=ws, and path /ws/vl/{uuid} on your Vercel production domain.
Bridges traffic securely back to your primary Railway or VPS deployment.
Bypasses network filtering via Vercel's global CDN IP pools.

🇮🇷 فارسی

✦ White Panel چیست؟

White Panel (وایت پنل) یک پنل جامع، مدرن و قدرتمند برای مدیریت کامل زیرساخت‌های پروکسی، کاربران، اشتراک‌ها، نودها، اسکنرها و ربات‌های اتوماسیون تلگرام است. این نسخه با رابط کاربری شیشه‌ای (Glassmorphism)، بهینه‌سازی شده برای موبایل و دسکتاپ، و با پشتیبانی کامل از داکر، ریلوی و VPS اختصاصی ارائه شده است.

📺 ویدیوی آموزش کامل در یوتیوب

برای یادگیری گام‌به‌گام نحوه نصب، تنظیم ربات فروش تلگرام، اتصال دامنه‌های Vercel و کار با اسکنر قدرتمند، ویدیوی زیر را در یوتیوب مشاهده کنید:

🔗 لینک مستقیم آموزش در یوتیوب: https://www.youtube.com/watch?v=pgGy_bN65Pk
(همچنین برای اطلاع از آخرین آپدیت‌ها در کانال تلگرام عضو شوید)

🌟 قابلیت‌های کلیدی نسخه ۴.۰.۰

بخش	توضیحات و امکانات
👤 مدیریت کاربران	تعریف کاربر، محدودیت حجم، تاریخ انقضا، ساخت لینک اختصاصی و اعمال تغییرات گروهی
🔗 سیستم اشتراک پیشرفته	صفحه اختصاصی عمومی برای هر کاربر (`/p/key`)، کد QR محلی، دکمه کپی و راهنمای اتصال
🛡 هسته ایمن و سریع	موتور Golang پرسرعت، جلوگیری سختگیرانه از باز کردن چند کانکشن همزمان، آنتی تورنت و مسدودسازی سایت‌های داخلی
🤖 ربات فروش اتوماتیک	تعریف پلن‌ها، دریافت فیش کارت‌به‌کارت از مشتری، تایید/رد توسط ادمین و تحویل فوری کانفیگ
📡 Telegram Web Proxy	پروکسی داخلی وب برای تلگرام با لینک مستقیم `t.me/webproxy` بدون نیاز به نصب MTProxy جداگانه
⚡ رله ورسل (Vercel Relay)	عبور از اختلالات و فیلترینگ شدید با تبدیل و رله ترافیک روی بسترهای بدون سرور Vercel
🧪 اسکنر پیشرفته	اسکن IP، SNI، ساب‌نت‌های کلودفلر، پینگ گروهی و استخراج پرسرعت‌ترین سرورها
🛰 نودها و ورکرها	مدیریت چند سرور همزمان، بررسی سلامت زنده (Healthcheck) و اتصال به ورکر کلودفلر

📄 مجوز استفاده

استفاده، کپی، بازنشر و فورکِ نسخه‌ی بدون تغییر آزاد است. تغییر کد یا فروش خودِ نرم‌افزار مجاز نیست (استفاده از پنل برای راه‌اندازی سرویس شخصی آزاد است). متن کامل در فایل LICENSE موجود است.

🚀 نصب سریع روی VPS

تنها با اجرای یک دستور ساده در ترمینال لینوکس (اوبونتو / دبیان):

curl -fsSL https://raw.githubusercontent.com/Itskillmaster/WhitePanel-Ui/main/start.sh | bash

پنل روی پورت پیش‌فرض 8080 بالا می‌آید. پس از اتمام نصب، پنل از طریق آدرس زیر در دسترس خواهد بود:

http://YOUR_SERVER_IP:8080/white

🚂 نصب روی Railway (سرویس ابری)

مخزن (Repository) را در حساب گیت‌هاب خود Fork کنید.
وارد Railway شوید و یک New Project از گیت‌هاب بسازید.
سرویس به‌طور خودکار از Dockerfile بیلد می‌شود.
پورت سرویس را روی 8080 تنظیم کنید.
در تنظیمات یک Public Domain بسازید و وارد مسیر /white شوید.

🤖 ربات فروش و اتوماسیون تلگرام

جریان خرید مشتری بسیار ساده و روان طراحی شده است:

/start
  ↓
🛍 محصولات و تعرفه‌ها
  ↓
انتخاب پلن دلخواه
  ↓
دریافت شماره کارت و ارسال فیش
  ↓
بررسی توسط ادمین در پنل
  ├─ ✅ تایید → ارسال خودکار لینک ساب و بارکد QR
  └─ ❌ رد فیش

🔐 نکات امنیتی

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

🇸🇦 العربية

✦ ما هو White Panel؟

White Panel هي لوحة تحكم سحابية متقدمة وشاملة لإدارة خدمات البروكسي والشبكات الافتراضية، إدارة المشتركين، إنشاء روابط الاشتراكات الذكية ورموز QR، فحص الخوادم وعناوين IP، والتشغيل الآلي الكامل عبر بوتات تيليجرام.

📺 فيديو الشرح على YouTube

شاهد دليل الإعداد والتثبيت خطوة بخطوة على يوتيوب، بما في ذلك إعدادات البوت والربط مع Vercel و Railway:

🔗 رابط يوتيوب المباشر: https://www.youtube.com/watch?v=pgGy_bN65Pk

🌟 أبرز المميزات

الميزة	الوصف
👤 إدارة المستخدمين	إنشاء وتعديل الحسابات، تحديد الباقات وحدود الاستهلاك وتواريخ الانتهاء
🔗 صفحات اشتراك تفاعلية	واجهة ويب متجاوبة للهواتف والحواسيب لكل عميل مع رموز QR سريعة القراءة
🤖 بوت مبيعات آلي	استقبال الطلبات وإيصالات الدفع، تأكيد يدوي من الإدارة، وتسليم فوري للاشتراكات
🌐 بروكسی تيليجرام ويب (TWP)	رابط سريع ومباشر `t.me/webproxy` مدمج داخل اللوحة بدون تعقيدات
⚡ محول Vercel Relay	رله فائق السرعة عبر Edge Functions لتجاوز الحجب الصارم
🧪 فاحص الشبكات الذكي	فحص فوري لعناوين IP، نطاقات Cloudflare، وفحص استجابة Ping مع نسخ سريع

🚀 طريقة التثبيت

التثبيت المباشر على خادم Linux (VPS)

قم بتشغيل هذا الأمر في سطر أوامر السيرفر:

curl -fsSL https://raw.githubusercontent.com/Itskillmaster/WhitePanel-Ui/main/start.sh | bash

المنفذ الافتراضي للوحة هو 8080. يمكنك الدخول للوحة عبر المتصفح:

http://YOUR_SERVER_IP:8080/white

التثبيت على سحابة Railway

قم بعمل Fork للمستودع في حسابك على GitHub.
أنشئ مشروعاً جديداً في Railway واختر المستودع.
حدد المنفذ (Port) على 8080.
أنشئ نطاقاً عاماً (Public Domain) واستمتع باللوحة فوراً.

🇷🇺 Русский

✦ Что такое White Panel?

White Panel — это современная, высокопроизводительная панель управления для прокси-серверов, управления пользователями, динамическими подписками, мониторингом нод, сканером подсетей и полной автоматизацией через Telegram-ботов.

📺 Видео руководство на YouTube

Подробная видеоинструкция по установке, настройке бота продаж, подключению Vercel Relay и работе со сканером:

🔗 Прямая ссылка на YouTube: https://www.youtube.com/watch?v=pgGy_bN65Pk

🌟 Основные возможности

Раздел	Описание функционала
👤 Пользователи	Создание аккаунтов, квоты трафика, даты окончания, блокировка мульти-аккаунтов
🔗 Подписки	Удобная адаптивная веб-страница подписки (`/p/<key>`), QR-коды и мгновенный импорт
🤖 Telegram Бот продаж	Каталог тарифов, загрузка чеков об оплате, ручное подтверждение админом и автовыдача
🌐 Telegram Web Proxy	Встроенный прокси `t.me/webproxy` прямо на порту 443 без сторонних MTProxy сервисов
⚡ Vercel Relay	TLS + WebSocket мост через Vercel Edge Functions для обхода глубоких блокировок
🧪 Сетевой сканер	Быстрый многопоточный сканер TCP / IP / SNI, подсетей Cloudflare и пакетный пинг
🛰 Управление нодами	Поддержка распределенных серверов, проверка доступности и Cloudflare Workers

🚀 Развертывание

Быстрая установка на VPS (Linux Ubuntu/Debian) в одну команду:

curl -fsSL https://raw.githubusercontent.com/Itskillmaster/WhitePanel-Ui/main/start.sh | bash

Панель запускается на порту 8080. Откройте в браузере:

http://IP_ВАШЕГО_СЕРВЕРА:8080/white

Развертывание на Railway

Сделайте Fork этого репозитория в свой аккаунт GitHub.
В Railway создайте New Project из вашего репозитория.
Railway автоматически соберет проект по Dockerfile и railway.toml.
Укажите внутренний порт 8080.
Сгенерируйте Public Domain и перейдите в /white.

📁 Структура проекта / Project Structure

.
├── backend/                # Backend API services & controllers
├── bot/                    # Telegram bots (Sales Bot, Channel Publisher)
├── data/                   # SNI lists, Subnets, persistent storage
├── static/                 # Glassmorphic UI (HTML, CSS, JS, QR engine)
├── svg/                    # Animated vector artwork & badges
├── worker/                 # Cloudflare worker scripts
├── Dockerfile              # Docker production image
├── railway.toml            # Railway cloud deployment manifest
├── requirements.txt        # Python package dependencies
├── start.sh                # VPS installer & auto-updater
├── tm.py                   # Telegram manager daemon
├── twp.py                  # Telegram Web Proxy engine
├── vercel_relay.py         # Vercel WebSocket bridge integration
└── README.md               # Multilingual documentation

WHITE PANEL 4.0

Modern · Fast · Resilient · Open Source

GitHub • Developer Telegram • Telegram Channel • YouTube Tutorial

Name		Name	Last commit message	Last commit date
backend		backend
bot		bot
data		data
deploy/vercel		deploy/vercel
seed		seed
static		static
svg		svg
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
entrypoint.sh		entrypoint.sh
railway.toml		railway.toml
requirements.txt		requirements.txt
start.sh		start.sh
tm.py		tm.py
twp.py		twp.py
vercel_relay.py		vercel_relay.py
version.json		version.json

Latest commit

History

Folders and files

Repository files navigation

⚡ Ultimate All-in-One Proxy & Subscription Management System

📺 🎬 Official Video Tutorial / ویدیوی آموزشی / فيديو الشرح / Видеоурок

📚 Quick Navigation

🇬🇧 English

✦ Why White Panel?

Core Capabilities

License

🚀 Deployment

Option A — One-Command VPS Installation (Recommended)

Useful Installer Environment Variables

Option B — Railway One-Click Cloud Deployment

🧭 Public Endpoint & Subscription Flow

🤖 Telegram Automation

Channel Bot

Sell Bot (Automated Sales System)

🌐 Built-in Web Proxy Inbound (Telegram Web Proxy)

⚡ Vercel Domain (TLS + WebSocket relay)

🇮🇷 فارسی

✦ White Panel چیست؟

📺 ویدیوی آموزش کامل در یوتیوب

🌟 قابلیت‌های کلیدی نسخه ۴.۰.۰

📄 مجوز استفاده

🚀 نصب سریع روی VPS

🚂 نصب روی Railway (سرویس ابری)

🤖 ربات فروش و اتوماسیون تلگرام

🔐 نکات امنیتی

🇸🇦 العربية

✦ ما هو White Panel؟

📺 فيديو الشرح على YouTube

🌟 أبرز المميزات

🚀 طريقة التثبيت

التثبيت المباشر على خادم Linux (VPS)

التثبيت على سحابة Railway

🇷🇺 Русский

✦ Что такое White Panel?

📺 Видео руководство на YouTube

🌟 Основные возможности

🚀 Развертывание

Быстрая установка на VPS (Linux Ubuntu/Debian) в одну команду:

Развертывание на Railway

📁 Структура проекта / Project Structure

WHITE PANEL 4.0

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

🌐 Built-in `Web Proxy` Inbound (Telegram Web Proxy)