Skip to content

Repository files navigation

StanNG logo

⚡ StanNG v1.5.5

یک پنل تک‌سرویسهٔ VLESS با تم جادوگری

A single‑service VLESS panel with a wizarding theme

⚠️ پنل StanNG رایگان و غیر قابل فروش است

هرگونه فروش این پنل ممنوع بوده و تخلف محسوب می‌شود.

Deploy on Railway Deploy to Render

StanNG login screen

ویژگی‌ها

فارسی
🪄 بدون دیتابیس — همه‌چیز در یک فایل JSON محلی
👤 تنظیم یک‌باره — اولین بازدید، نام کاربری/رمز را می‌سازد
📱 واکنش‌گرا — کاملاً سازگار با موبایل
📊 محدودیت‌های پیشرفته — حجم (GB)، روز اعتبار، سقف درخواست و قطع خودکار
🔌 کنترل همزمان — محدودیت تعداد دستگاه + قفل IP
⚙️ تنظیمات سراسری — Fingerprint، ALPN، SNI، Fragment و پروتکل‌های انتقال (xhttp، ws)
🔄 آپدیت درون‌پنلی — یک‌کلیک، بدون از دست دادن داده‌ها
🔗 لینک اشتراک v2rayNG — خروجی متن ساده (Plain Text)، کاملاً سازگار
🛑 ابطال لینک‌ها — چرخش UUID برای ابطال آنی
📱 صفحه وضعیت عمومی — لینک عمومی برای رصد مصرف، بدون نیاز به ورود
🌍 مکان‌یابی خودکار — تشخیص شهر/کشور سرور از Cloudflare trace
🌗 حالت تاریک/روشن + دو زبانه — فارسی و انگلیسی، فونت محلی
🔊 جلوه صوتی و انیمیشن — بدون وابستگی خارجی
💬 دکمه پشتیبانی تلگرام — دسترسی سریع به پشتیبانی
⏱ بیدارباش خودکار — پینگ داخلی هر ۱۰ دقیقه

🆕 تغییرات نسخه ۱.۵.۵

  • ✅ رفع باگ‌ها و مشکلات — رفع باگ‌های OTA، آمار ترافیک، نمودار ساعتی، منوی ترافیک و کانفیگ‌های نمایشی.
  • ✅ اضافه شدن XHTTP و پشتیبانی از DOH — پشتیبانی از پروتکل انتقال xhttp و DNS‑over‑HTTPS داخلی.
  • ✅ به‌سازی دریافت آمار از Xray — استفاده از خروجی JSON به‌جای regex برای دقت بیشتر.
  • ✅ شمارش دقیق اتصالات فعال — تشخیص کاربران بر اساس آخرین ترافیک (last_seen) بدون وابستگی به netstat.
  • ✅ بهینه‌سازی کلی پنل — بهبود عملکرد و کاهش مصرف منابع.

🖼 تصاویر

Dashboard Inbounds
داشبورد با نمودار ترافیک ساعتی مدیریت کاربران و اینباندها
Links & QR Settings
لینک‌های اشتراک و QR تنظیمات عمومی و پیشرفته
Mobile view
نمای واکنش‌گرا روی موبایل — جدول‌ها به کارت تبدیل می‌شوند

🚀 نصب سریع

🚂 Railway (توصیه‌شده)

  • ریپازیتوری را Fork یا push کنید.
  • در railway.app → New Project → Deploy from GitHub repo.
  • Railway railway.json را تشخیص داده و python main.py اجرا می‌کند.
  • پس از دیپلوی، به آدرس سرویس + /setup بروید و نام‌کاربری/رمز عبور بسازید.

💡 Railway از IP اختصاصی استفاده می‌کند (نه کلودفلر). در صورت فیلتر، حالت Fragment را از پنل (تنظیمات → پیشرفته) و کلاینت فعال کنید.

🌐 Render

  • Fork/push به گیت‌هاب.
  • در render.com → New → Web Service → ریپازیتوری را وصل کنید؛ render.yaml شناسایی می‌شود.
  • بعد از دیپلوی به /setup بروید.

💡 روی Render پشت شبکهٔ Cloudflare هستید؛ کانفیگ‌ها از آی‌پی‌های تمیز عبور می‌کنند.

💻 اجرای محلی

git clone https://github.com/<your-username>/StanNG.git
cd StanNG
pip install -r requirements.txt
python main.py
# → http://localhost:8000/setup

🧭 راه‌اندازی اولیه

  1. بازدید از <your-domain>/setup
  2. ساخت نام‌کاربری و رمز عبور (این همان اعتبار مدیریتی برای همیشه خواهد بود)
  3. پس از ورود، کاربران خود را در بخش اینباندها بسازید.
  4. در تنظیمات → تنظیمات پیشرفته کانفیگ می‌توانید پروتکل انتقال (xhttp، ws) و سایر پارامترها را تغییر دهید.

🔧 متغیرهای محیطی

متغیر پیش‌فرض توضیح
PORT 8000 پورت اجرا
SECRET_KEY (خودکار) کلید رمزنگاری نشست‌ها (توصیه می‌شود در محیط ابری تنظیم شود)
BASE_PATH "" در صورت نیاز به مسیر پایه (مثلاً /stan)

📚 مستندات API

مسیر متد توضیح
/api/login POST ورود با username/password، دریافت توکن
/api/users GET لیست تمام کاربران (نیاز به توکن)
/api/users POST ایجاد کاربر جدید (نیاز به توکن)
/api/users/<uid> PUT ویرایش کاربر
/api/users/<uid> DELETE حذف کاربر
/api/users/<uid>/rotate POST چرخش UUID
/api/settings GET/PUT دریافت/ویرایش تنظیمات عمومی و پیشرفته
/api/status GET وضعیت سرور (CPU، RAM، دیسک)
/api/update POST آپدیت خودکار (نیاز به توکن)
/sub/<uid> GET لینک اشتراک متن ساده (عمومی)
/status/<uid> GET صفحه وضعیت عمومی (فقط خواندنی)

تمام درخواست‌های محافظت‌شده نیاز به هدر Authorization: Bearer <token> دارند.


🔒 نکات امنیتی

  • رمز عبور را قوی انتخاب کنید و هرگز به اشتراک نگذارید.
  • فایل data.json حاوی تمام اطلاعات حساس است؛ از دسترسی مستقیم به آن جلوگیری کنید (مسیریابی نشده).
  • در صورت نشت لینک اشتراک، از دکمه چرخش UUID در پنل استفاده کنید تا لینک‌های قبلی بی‌اثر شوند.
  • توصیه می‌شود از HTTPS (مثلاً با Cloudflare یا خود پلتفرم) استفاده شود.

📜 مجوز و اعتبارها

  • این پروژه تحت مجوز MIT منتشر شده است.
  • ساخته شده با ❤️ توسط جامعهٔ متن‌باز.
  • فونت وزیرمتن (Vazirmatn) با مجوز OFL.
  • نمادها و طراحی الهام‌گرفته از تم جادوگری.
  • قدردانی ویژه از Alireza78na برای بهبودها و رفع باگ‌های ارزشمند.

**StanNG** — ساده، سبک، و جادویی 🧙‍♂️

About

No description, website, or topics provided.

Resources

Stars

1.0k stars

Watchers

1 watching

Forks

Releases

Contributors

Languages