پنل مدیریت VPN نسل جدید — تحت وب + ربات تلگرام + پورتال اشتراک
مدیریت کانفیگهای VLESS / XHTTP / TCP با داشبورد سهبعدی، ربات تلگرام فروش، پورتال مشتری حرفهای و پروکسی تلگرام — آمادهی اجرا روی Shiprr و هر PaaS دیگر.
- اسکرینشاتها
- امکانات کامل
- صفحه ورود سهبعدی
- داشبورد مدیریت
- پورتال اشتراک مشتری
- ربات تلگرام
- موتور اتصال
- اجرا روی Shiprr
- اجرای محلی
- اجرا با Docker
- متغیرهای محیطی
- نکات امنیتی
- استودیو ظاهر
- ساختار کد
- سؤالات متداول
- عیبیابی
- پشتیبانی
| ماژول | توضیح |
|---|---|
| داشبورد زنده | مصرف CPU / RAM / دیسک / شبکه بهصورت لحظهای + نمودار ترافیک |
| اینباندها | ساخت و مدیریت اینباند، پورت، پروتکل، امنیت و مسیر |
| کلاینتها | ساخت کلاینت، UUID خودکار، سقف حجم، سقف زمان، سقف IP همزمان |
| دستهبندیها | سازماندهی کانفیگها بر اساس اپراتور / نوع / قیمت |
| گروههای ساب | گروهبندی کانفیگها در یک لینک اشتراک واحد + رمز اختیاری |
| گزارشها | گزارش مصرف، فروش و کاربران با خروجی CSV |
| نودها | اتصال پنلبهپنل با توکن امن |
| سرورهای VPS | ثبت سرور، اسکن پورت، اسکن SNI، خروجی Xray / WireGuard و اسکریپت نصب خودکار |
| پروکسی تلگرام | ساخت پروکسی MTProto با secret امن (dd·padded) و اشتراک پورت با پنل |
| ادمینها | چند ادمین با مجوز تفکیکی (هر ادمین فقط بخشهای مجاز را میبیند) |
| لاگ فعالیت | ثبت کامل همهی رخدادهای پنل |
| مرکز پیام | اطلاعرسانی و پیامرسانی داخل پنل |
- لینک ساب استاندارد
/sub/{uuid}با هدرsubscription-userinfo(سازگار با همهی اپها) - پورتال کامل مشتری: گیج مصرف حجم، زمان باقیمانده، وضعیت اتصال
- QR آفلاین (بدون نیاز به اینترنت برای تولید)
- نمایش تعداد کاربران متصل به هر کانفیگ
- دانلود مستقیم اپها: Hiddify · v2rayNG · v2rayN · Streisand · Shadowrocket · sing-box
- دکمه ورود یککلیکی با دیپلینک برای هر اپ
- صفحه اطلاعات کامل کانفیگ: پروتکل، آدرس، پورت، SNI، ALPN، Fingerprint، Transport
- حالت تاریک / روشن و طراحی کاملاً موبایلفرست
- ساخت سریع + ساخت پیشرفتهی ۹ مرحلهای
- لیست، ویرایش، حذف کانفیگ + ارسال لینک و QR
- ساخت دستهای (Bulk) با یک دستور
- گروه ساب، بکاپگیری، هشدار انقضا و اتمام حجم
- مینیاپ تلگرام
صفحه ورود SUKOT کاملاً سهبعدی و متحرک طراحی شده:
- صحنهی 3D با لایههای شناور، ذرات متحرک و نورپردازی عمقی
- کارت ورود با افکت پارالاکس و چرخش سهبعدی
- لوگوی گرد SUKOT با انیمیشن هالهی نور و پالس
- انیمیشن ورود مرحلهبهمرحلهی فیلدها و دکمهها
- نمایشگر وضعیت زنده (سرور، آنلاینها، نسخه)
- لینک کانال تلگرام و پشتیبانی روی صفحه
ورود پیشفرض: نام کاربری
Sukot· رمزSukot— بعد از اولین ورود عوضش کن!
- RTL کامل با فونت وزیرمتن و آیکونهای بومی (بدون CDN — همهچیز آفلاین)
- طرحبندی سهستونه: ناوبری + محتوا + پنل جزئیات
- Drawerهای شیشهای (Glassmorphism) برای ساخت و ویرایش
- جستجوی زنده، فیلتر و مرتبسازی روی همهی جدولها
- اعلانهای Toast و دیالوگهای تأیید
- ریسپانسیو کامل موبایل تا دسکتاپ
وقتی مشتری لینک ساب را باز میکند، بهجای یک متن خام یک صفحهی کامل فروش میبیند:
- کارت اشتراک با نام، وضعیت و گیج مصرف حجم/زمان
- دکمهی کپی لینک + QR اسکنشدنی
- جدول تمام جزئیات کانفیگ (UUID، آدرس، پورت، SNI، fingerprint، transport، ALPN...)
- تعداد کاربران متصل به هر کانفیگ
- بخش دانلود اپها با لینک رسمی هر پلتفرم (اندروید / iOS / ویندوز / مک)
- راهنمای اتصال مرحلهبهمرحله برای هر اپ
- کانال و پشتیبانی تلگرام SUKOT در پایین صفحه
| قابلیت | توضیح |
|---|---|
| VLESS + WebSocket | مسیر /ws/{uuid} با پشتیبانی CDN |
| XHTTP | حالتهای packet-up و stream-up |
| VLESS + TCP خام | رله TCP مستقیم برای VPS واقعی |
| محدودیت سرعت | توکنباکت هر کلاینت بهصورت مستقل |
| سقف IP همزمان | کنترل تعداد اتصال همزمان هر کلاینت |
| خروجی پروکسی | استخر SOCKS / HTTP برای خروج ترافیک |
| پروکسی تلگرام | MTProto روی همان پورت پنل (تکپورتی) |
این ریپو را Fork کن یا در Shiprr «Import from GitHub» بزن و آدرس این ریپو را بده.
در Shiprr یک اپ جدید بساز و ریپو را وصل کن. Shiprr خودش Dockerfile را تشخیص میدهد و اپ را میسازد.
در Settings → Environment Variables:
ADMIN_USERNAME=Sukot
ADMIN_PASSWORD=Sukot
SECRET_KEY=یک-رشته-تصادفی-طولانی
PUBLIC_BASE_URL=https://YOUR-APP.shiprr.app
DATABASE_URL=postgresql://user:pass@host/db?sslmode=require
TELEGRAM_BOT_TOKEN=123456:ABC... (اختیاری)
TELEGRAM_ADMIN_IDS=111111,222222 (اختیاری)
دکمهی Deploy را بزن. بعد از بالا آمدن، به آدرس /login برو و وارد شو.
⚠️ DATABASE_URL مهم است! دیسک Shiprr موقتی است؛ بدون Postgres بعد از هر ریاستارت دادهها پاک میشوند. یک Postgres رایگان از neon.tech یا supabase.com بساز و Connection string را بگذار — پنل بهصورت خودکار همهچیز را آنجا آینهسازی میکند.
- روی Shiprr فقط پورت 443 (TLS) از بیرون باز است؛ لینکها خودکار روی
security=tlsوport=443ساخته میشوند (SUKOT_TLS=1,SUKOT_FORCE_PORT=443). - پنل همیشه با
python app.pyاجرا شود تا پروکسی تلگرام روی همان پورت سوار شود (تکپورتی). - رلهی TCP خام (
TCP_LISTEN_PORT=6543) روی PaaS فقط لینک میسازد و ترافیک رد نمیکند — روی VPS واقعی کامل کار میکند. - آدرس عمومی اپ را حتماً در
PUBLIC_BASE_URLبگذار تا لینکهای ساب درست ساخته شوند.
git clone https://github.com/fffddeer4/SUKOT-VPN-Panel.git
cd SUKOT-VPN-Panel
pip install -r requirements.txt
python app.pyسپس باز کن: http://localhost:8000 — ورود: Sukot / Sukot
docker build -t sukot-panel .
docker run -d --name sukot -p 8000:8000 \
-e ADMIN_USERNAME=Sukot \
-e ADMIN_PASSWORD=رمز-قوی-خودت \
-e SECRET_KEY=یک-رشته-تصادفی \
-e PUBLIC_BASE_URL=https://YOUR-DOMAIN \
sukot-panelروی VPS میتوانی docker-compose هم بنویسی و TCP_LISTEN_PORT را مپ کنی تا رلهی TCP خام فعال شود.
| متغیر | الزامی | پیشفرض | توضیح |
|---|---|---|---|
ADMIN_USERNAME |
✅ | Sukot |
نام کاربری ادمین |
ADMIN_PASSWORD |
✅ | Sukot |
رمز ادمین — حتماً عوض کن |
SECRET_KEY |
✅ | — | کلید رمزنگاری نشستها؛ رشتهی تصادفی طولانی |
PUBLIC_BASE_URL |
✅ | — | آدرس عمومی اپ؛ برای ساخت لینک ساب |
DATABASE_URL |
▫️ | — | Postgres برای ذخیرهی دائمی (neon.tech / supabase) |
TELEGRAM_BOT_TOKEN |
▫️ | — | توکن ربات از @BotFather |
TELEGRAM_ADMIN_IDS |
▫️ | — | آیدی عددی ادمینهای ربات، با کاما جدا شود |
TELEGRAM_BOT_USERNAME |
▫️ | SukotBot |
یوزرنیم ربات برای لینکها |
KEEPALIVE_ENABLED |
▫️ | 1 |
پینگ خودکار برای بیدار ماندن اپ |
KEEPALIVE_INTERVAL |
▫️ | 240 |
فاصلهی پینگ (ثانیه) |
SUKOT_TLS |
▫️ | 1 |
ساخت لینکها با security=tls |
SUKOT_FORCE_PORT |
▫️ | 443 |
پورت اجباری در لینکهای ساب |
TCP_LISTEN_PORT |
▫️ | — | پورت رلهی TCP خام (فقط روی VPS معنیدار است) |
- همان اول رمز را عوض کن — پیشفرض ورود
Sukot/Sukotاست و همه میدانند! SECRET_KEYرا یک رشتهی تصادفی طولانی بگذار (مثلاً خروجیopenssl rand -hex 32).DATABASE_URLرا فقط داخل Environment Variables بگذار؛ هرگز در کد هاردکد نکن.- برای هر ادمین کماختیار، مجوزها را از بخش «ادمینها» محدود کن.
- بکاپ منظم: از داشبورد، بخش بکاپ، خروجی کامل JSON را بگیر و نگهدار.
از تنظیمات → استودیو ظاهر داخل خود پنل، بدون دستزدن به کد:
- پوستهی تیره / روشن
- ۹ رنگ اصلی آماده + ذخیرهی خودکار در مرورگر
- اندازهی متن، گردی گوشهها، سرعت انیمیشن، هالهی نورانی
برای تغییر رنگ پیشفرض کل پنل، در ui/theme.py مقدار --accent / --accent-rgb را عوض کن.
app.py اجراکننده (uvicorn + mux پروکسی تلگرام)
main.py اپ FastAPI، همهی روتها و APIها
core.py تنظیمات، نشستها، مجوزها، لاگ، ابزارها
links.py موتور کانفیگها و لینکهای اشتراک
relays.py رله VLESS-WS + XHTTP
tcp_relay.py رله TCP خام
outbound.py استخر پروکسی خروجی (SOCKS/HTTP)
speed_limit.py محدودیت سرعت توکنباکت
tg_proxy.py پروکسی MTProto تلگرام + SOCKS
nodes.py نودهای پنلبهپنل
vps_serv.py سرورهای VPS، Xray/WireGuard، اسکنرها
operators.py پریست اپراتورها (همراه اول، ایرانسل، ...)
persist_db.py آینهسازی خودکار روی Postgres
keepalive.py پینگ خودکار (Keep-alive)
sukot_bot.py ربات تلگرام کامل
ui/
login.py صفحه ورود سهبعدی
dashboard.py شِل داشبورد
dash_html.py قالب HTML داشبورد
dash_css.py استایل داشبورد
dash_js.py منطق جاوااسکریپت داشبورد
portal.py پورتال اشتراک مشتری
theme.py موتور تم و استودیو ظاهر
app_assets/ فونت وزیرمتن، آیکونها، کتابخانه QR، تصاویر برند
docs/ اسکرینشاتها و تصاویر مستندات
لینک ساب را که باز میکنم صفحه خالی است؟
PUBLIC_BASE_URL را دقیقاً برابر آدرس عمومی اپ بگذار و مطمئن شو لینک با همان دامنه باز میشود.
بعد از ریاستارت همهچیز پاک شد؟
DATABASE_URL را تنظیم نکردهای. دیسک Shiprr موقتی است — Postgres رایگان بساز و وصل کن.
روی Shiprr پورت TCP خام کار نمیکند؟ PaaS فقط پورت HTTPS میدهد. از VLESS+WS با TLS روی 443 استفاده کن؛ رلهی TCP فقط برای VPS واقعی است.
ربات جواب نمیدهد؟
توکن و آیدیها را چک کن و مطمئن شو PUBLIC_BASE_URL درست است (وبهوک روی همان آدرس ست میشود).
چند ادمین میشود داشت؟ بله — از بخش «ادمینها» با مجوز تفکیکی بساز.
| مشکل | راهحل |
|---|---|
| صفحهی ورود باز نمیشود | لاگ اپ را در Shiprr ببین؛ معمولاً خطای SECRET_KEY یا پورت است |
| کانفیگ وصل نمیشود | نوع اینباند/امنیت را با لینک ساختهشده مقایسه کن؛ روی Shiprr فقط TLS/443 درست کار میکند |
| پورتال ساب خالی است | کلاینت باید «فعال» باشد و داخل گروه ساب باشد |
| پروکسی تلگرام وصل نمیشود | از صفحهی «پروکسی تلگرام» دکمهی «خودکار» و بعد تست داخلی را بزن |
| Postgres خطا میدهد | sslmode=require را در انتهای Connection string بگذار |
| مورد | مقدار |
|---|---|
| زبان | Python 3.11 |
| فریمورک | FastAPI + Uvicorn |
| دیتابیس | JSON محلی + آینهسازی خودکار Postgres |
| پورت | تکپورت (پنل + ساب + پروکسی تلگرام همه روی یک پورت) |
| وابستگیهای خارجی | هیچ — فونت، آیکون و QR کاملاً آفلاین |
| مصرف حافظه | کم (~۵۰MB بدون ترافیک) |
کانال رسمی: t.me/SUKOT1344 · پشتیبانی: @SUKOT1344
— ساختهشده با ⚡ برای SUKOT
این پروژه تحت لایسنس MIT منتشر شده است.



