Skip to content
DarKpR279Public

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

SUKOT Panel

⚡ SUKOT VPN Panel

پنل مدیریت VPN نسل جدید — تحت وب + ربات تلگرام + پورتال اشتراک

مدیریت کانفیگ‌های VLESS / XHTTP / TCP با داشبورد سه‌بعدی، ربات تلگرام فروش، پورتال مشتری حرفه‌ای و پروکسی تلگرام — آماده‌ی اجرا روی Shiprr و هر PaaS دیگر.

Python FastAPI Docker License Telegram

🚀 نصب سریع · 📸 اسکرین‌شات‌ها · 🤖 ربات تلگرام · 💬 پشتیبانی


📖 فهرست


📸 اسکرین‌شات‌ها

صفحه ورود سه‌بعدی با انیمیشن

SUKOT Login 3D

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

Dashboard Links
کنترل کامل شبکه مدیریت کانفیگ‌ها

پورتال اشتراک مشتری

Subscription Portal

✨ امکانات کامل

🖥 پنل وب (داشبورد ادمین)

ماژول توضیح
داشبورد زنده مصرف CPU / RAM / دیسک / شبکه به‌صورت لحظه‌ای + نمودار ترافیک
اینباندها ساخت و مدیریت اینباند، پورت، پروتکل، امنیت و مسیر
کلاینت‌ها ساخت کلاینت، UUID خودکار، سقف حجم، سقف زمان، سقف IP هم‌زمان
دسته‌بندی‌ها سازماندهی کانفیگ‌ها بر اساس اپراتور / نوع / قیمت
گروه‌های ساب گروه‌بندی کانفیگ‌ها در یک لینک اشتراک واحد + رمز اختیاری
گزارش‌ها گزارش مصرف، فروش و کاربران با خروجی CSV
نودها اتصال پنل‌به‌پنل با توکن امن
سرورهای VPS ثبت سرور، اسکن پورت، اسکن SNI، خروجی Xray / WireGuard و اسکریپت نصب خودکار
پروکسی تلگرام ساخت پروکسی MTProto با secret امن (dd·padded) و اشتراک پورت با پنل
ادمین‌ها چند ادمین با مجوز تفکیکی (هر ادمین فقط بخش‌های مجاز را می‌بیند)
لاگ فعالیت ثبت کامل همه‌ی رخدادهای پنل
مرکز پیام اطلاع‌رسانی و پیام‌رسانی داخل پنل

🔗 صفحه اشتراک (Sub Link)

  • لینک ساب استاندارد /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 و دیالوگ‌های تأیید
  • ریسپانسیو کامل موبایل تا دسکتاپ

🛍 پورتال اشتراک مشتری

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

  1. کارت اشتراک با نام، وضعیت و گیج مصرف حجم/زمان
  2. دکمه‌ی کپی لینک + QR اسکن‌شدنی
  3. جدول تمام جزئیات کانفیگ (UUID، آدرس، پورت، SNI، fingerprint، transport، ALPN...)
  4. تعداد کاربران متصل به هر کانفیگ
  5. بخش دانلود اپ‌ها با لینک رسمی هر پلتفرم (اندروید / iOS / ویندوز / مک)
  6. راهنمای اتصال مرحله‌به‌مرحله برای هر اپ
  7. کانال و پشتیبانی تلگرام SUKOT در پایین صفحه

🔌 موتور اتصال

قابلیت توضیح
VLESS + WebSocket مسیر /ws/{uuid} با پشتیبانی CDN
XHTTP حالت‌های packet-up و stream-up
VLESS + TCP خام رله TCP مستقیم برای VPS واقعی
محدودیت سرعت توکن‌باکت هر کلاینت به‌صورت مستقل
سقف IP هم‌زمان کنترل تعداد اتصال هم‌زمان هر کلاینت
خروجی پروکسی استخر SOCKS / HTTP برای خروج ترافیک
پروکسی تلگرام MTProto روی همان پورت پنل (تک‌پورتی)

🚀 اجرا روی Shiprr

قدم ۱ — ریپو

این ریپو را 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

دکمه‌ی 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

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 معنی‌دار است)

🔒 نکات امنیتی

  1. همان اول رمز را عوض کن — پیش‌فرض ورود Sukot / Sukot است و همه می‌دانند!
  2. SECRET_KEY را یک رشته‌ی تصادفی طولانی بگذار (مثلاً خروجی openssl rand -hex 32).
  3. DATABASE_URL را فقط داخل Environment Variables بگذار؛ هرگز در کد هارد‌کد نکن.
  4. برای هر ادمین کم‌اختیار، مجوزها را از بخش «ادمین‌ها» محدود کن.
  5. بکاپ منظم: از داشبورد، بخش بکاپ، خروجی کامل 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 منتشر شده است.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages