🛡️ قابلیت‌ها و رفع باگ‌های حیاتی در نسخه v2.4.4 (The Zero-Bug & Resilience Release)
⭐️ تشکر و قدردانی ویژه: با تشکر و سپاس ویژه از همراه گرامی امیر عزیز (آیدی تلگرام: @amirnn21) بابت تست‌های عمیق فنی، شبیه‌سازی شرایط مرزی و گزارش دقیق لاگ‌ها که منجر به شناسایی و حل ریشه‌ای باگ‌های حساس در این نسخه گردید.
🐛 ۱. رفع خطای User already exists در Xray و تداخل ایمیل‌های کلاینت
- در هسته Xray فیلد
email کلاینت‌ها باید در سطح هر اینباند کاملاً یونیک باشد. در نسخه‌های قبلی، ایمیل کلاینت خودِ اینباند با مقدار remark ست می‌شد که در صورت همنام بودن با نام کاربری یک کاربر یا اضافه شدن اینباند جدید با نام مشابه، Xray با خطای User already exists رد می‌شد.
- راهکار: افزودن پیشوند ایمن
~ به ایمیل اختصاصی اینباندها (~remark) و تعریف ساختار addedEmails Set برای جلوگیری قطعی از تکرار ایمیل در هسته Xray.
🛡️ ۲. جلوگیری از ایجاد اینباند یا کاربر تکراری (Atomic DB Rollback)
- در صورت بروز هرگونه خطای احتمالی در پروسه راه‌اندازی مجدد Xray (
reloadXrayService)، رکورد ثبت‌شده فوراً از پایگاه‌داده Rollback و حذف می‌گردد تا در صورت کلیک مجدد کاربر، اینباندهای دوتایی یا سه‌تایی تکراری ایجاد نشوند.
🔒 ۳. اصلاح اعمال دسترسی کاربر به اینباندهای مشخص (inboundIds)
- رفع باگی که باعث می‌شد پارامتر
inboundIds در آبجکت ارسال‌شده به configGenerator قرار نگیرد؛ اکنون تفکیک دسترسی هر کاربر به اینباندهای مجازش با دقت ۱۰۰٪ در هسته Xray اعمال می‌گردد.
⚙️ ۴. حذف دستور مخرب متوقف‌سازی Nginx
- دستور
systemctl stop nginx از اسکریپت ریلود Xray حذف شد تا تداخلی با پروکسی‌های معکوس و سرویس‌های همجوار سرور ایجاد نگردد. همچنین الگوهای pkill هدفمندتر شدند (pkill -9 -f "xray run").
📊 ۵. اصلاح راندمان پردازنده و حذف آمارهای فیک
- فرمول محاسبه مصرف CPU تصحیح شد (تقسیم Load Average بر تعداد هسته‌های پردازنده) و مقادیر رندوم آزمایشی پینگ و سرعت حذف شدند.
⚡ ۶. ارتقای هوشمند موتور دانلود Xray-core در اسکریپت نصب (install.sh)
- اسکریپت نصب به شکل داینامیک آخرین تگ ریلیز رسمی Xray را دریافت نموده و در صورت اختلال شبکه به نسخه امن و پایدار
v25.1.30 سوییچ می‌کند.
🚀 ۷. اعمال فوری انقضای حجم و زمان کاربران در هسته Xray
- به محض رسیدن مصرف کاربر به سقف مجاز یا پایان تاریخ اشتراک، علاوه بر تغییر وضعیت در دیتابیس، هسته Xray بلافاصله ریلود شده و دسترسی کاربر بدون تاخیر قطع می‌گردد.
📶 ۸. حل ریشه‌ای پینگ و تأخیر واقعی در پروتکل XHTTP (SplitHTTP)
- اضافه شدن خودکار پارامترهای کلید عمومی (
pbk)، شناسه کوتاه‌شده (sid) و فینگرپرینت به خروجی لینک‌های XHTTP؛ اکنون در تست Real Delay نرم‌افزارهای v2rayN و v2rayNG پینگ سبز و پایدار نمایش داده می‌شود.
🔐 ۹. رفع خطای فقدان گواهی در اینباندهای TLS (Auto Self-Signed SSL)
- اضافه شدن ماژول خودکار
ensureTlsCertificate جهت تولید گواهی‌های SSL در تنظیمات اینباندها؛ مانع از کرش Xray در پورت‌های دارای رمزنگاری TLS بدون نیاز به تنظیم دستی گواهی.
🌐 ۱۰. پایدارسازی صددرصدی خروجی کلودفلر WARP و جلوگیری از لوپ ریستارت
- ثبت‌نام هوشمند اکانت WARP با بررسی چندگانه اندپوینت‌های رسمی کلودفلر، تنظیم پارامتر
mtu: 1280 و جلوگیری از ایجاد پروفایل‌های نامعتبر در صورت قطعی شبکه.
در این آپدیت بزرگ، بر اساس بازخوردها و پیشنهادات کاربران و ادمین‌های عزیز، امکانات شخصی‌سازی پیشرفته، پشتیبانی از دامنه و CDN، پروتکل‌های نسل جدید و برندینگ کامل برای فروشندگان اضافه شده است:
🌐 ۱. پشتیبانی کامل از دامنه اختصاصی و CDN کلودفلر (Custom Domain & CDN Mapping)
- اتصال دامنه دلخواه به جای IP سرور: ادمین می‌تواند در تب تنظیمات، دامنه شخصی یا ساب‌دامین متصل به CDN کلودفلر (مثل
vpn.mydomain.com) را وارد کند تا در تمام لینک‌های VLESS، سابسکریپشن‌های Base64، سینگ‌باکس و کلش جایگزین IP خام سرور شود.
- تنظیم دامنه مستقل به ازای هر اینباند: قابلیت تعیین دامنه یا هاست مجزا برای هر اینباند به صورت کاملاً مستقل جهت تفکیک اپراتورها یا سرورهای لبه.
⚡ ۲. تنظیمات دقیق و حرفه‌ای پکت فرگمنت در پنل (Packet Fragment Tuning)
- تنظیم دستی پارامترهای پکت: بدون نیاز به دستکاری دستی فایل‌های کانفیگ، مقدار طول پکت (
Fragment Length) و فاصله زمانی ارسال (Fragment Interval) مستقیماً از داخل فرم ساخت و ویرایش اینباندها قابل تنظیم است.
- پریست‌های آماده و بهینه‌سازی‌شده اپراتورها:
- 📱 همراه اول (MCI):
100-200, 10-20 (بالاترین نرخ پایداری روی نت همراه اول)
- 📡 ایرانسل (Irancell):
50-150, 5-15 (عبور موثر از الگوریتم‌های DPI ایرانسل)
- ⚡ ترافیک داخلی / اینترانت:
10-60, 2-10
🚀 ۳. ترنسپورت نسل جدید XHTTP (SplitHTTP)، gRPC و پروتکل‌های Shadowsocks و Trojan
- پروتکل نوین XHTTP: جدیدترین نوآوری هسته Xray برای عبور از شدیدترین فیلترینگ‌ها و دور زدن مسدودی وب‌سوکت‌ها روی کلودفلر و سرورهای واسط.
- پشتیبانی کامل از پروتکل‌ها: ارائه همزمان
VLESS, VMess, Trojan و Shadowsocks (AEAD & SS-2022) روی ترنسپورت‌های TCP Reality, WebSocket, XHTTP, gRPC.
🎨 ۴. شخصی‌سازی کامل صفحه ساب مشتری و برندینگ اختصاصی (Sub Portal Custom Branding)
- برندینگ کامل صفحه مشتری (
/subinfo/:uuid): امکان تعریف نام برند یا فروشگاه، قرار دادن آدرس لوگوی اختصاصی و تنظیم هویت بصری صفحه اشتراک خریداران.
- دکمه‌های مستقیم پشتیبانی و تمدید اشتراک: اتصال مستقیم دکمه‌های شیک به آیدی تلگرام پشتیبانی و کانال تلگرام جهت تمدید سریع و رفع اشکال کاربران.
- کادر پیام و اطلاعیه به مشتریان: درج اعلان‌ها، هشدارها یا راهنمای اتصال مخصوص کاربران در بالای صفحه سابسکریپشن.
- باکس دانلود ۱-کلیک نرم‌افزارهای کلاینت: لینک‌های آماده و مستقیم دانلود اپلیکیشن‌های اندروید (v2rayNG)، آیفون (Streisand) و ویندوز (v2rayN).
🔍 ۵. جستجو و فیلتر لحظه‌ای کاربران و اینباندها (Instant Live Search)
- نوار سرچ سریع کاربران: فیلتر آنی کاربران بر اساس نام کاربری، شناسه UUID یا وضعیت فعال/منقضی.
- نوار سرچ سریع اینباندها: جستجوی فوری بر اساس نام کانفیگ، پورت، پروتکل، SNI یا دامنه.
📱 ۶. طراحی کاملاً لمسی و بهینه‌سازی‌شده برای موبایل (Mobile-First UX)
- بازطراحی و روان‌سازی تمام کارت‌ها، مودال‌ها، اسلایدرها و منوهای پنل جهت استفاده بسیار سریع روی انواع گوشی‌های هوشمند و تبلت‌ها.
📊 جدول مقایسه فنی Nyx Panel با سایر پنل‌ها (3x-ui و مرزبان)
| Feature / Capability |
🛡️ Nyx Panel v2.4 |
3x-ui (Sanaei) |
Marzban |
| ☁️ 1-Click Cloud Deploy (Railway/Codespaces/Docker) |
Yes (100% Free & No Credit Card) |
No |
No |
| ⚛️ Quantum MultiPath 4-Route Engine |
Yes (4 Live Parallel Paths) |
No |
No |
| ⚖️ Smart Health Load Balancer for Subscriptions |
Yes (Auto-ranks healthiest server #1) |
No |
No |
| 🚨 Panic Mode Blackout Detection & Alert |
Yes (Auto Telegram Notification) |
No |
No |
| 🌐 Custom Domain & Cloudflare CDN Mapping |
Yes (Global + Per-Inbound) |
Basic |
Basic |
| ⚡ Packet Fragment Custom Tuning & Presets |
Yes (MCI, Irancell, Intranet Presets) |
Limited |
Limited |
| 🚀 Next-Gen XHTTP (SplitHTTP) & gRPC |
Yes (Full Protocol Suite) |
Basic |
Basic |
| 🔑 Protocols: VLESS + VMess + Trojan + Shadowsocks |
Yes (Full Suite + SS-2022) |
Yes |
Yes |
| 🎨 Subscriber Portal Branding & Support Links |
Yes (Logo, Support, App Downloads) |
No |
Limited |
| Cross-Platform (Linux + Windows Server) |
Yes (Native PowerShell + Bash) |
Linux Only |
Linux Only |
| RAM Footprint (Memory) |
Lightweight (~70 MB) |
Moderate (~250 MB) |
Heavy (~400 MB+) |
| Automated Telegram DB Backup & 1-Click Restore |
Yes (Auto 24h & Telegram Upload) |
Complex Manual |
Manual Script |
| Smart Auto-Failover SNI Daemon |
Yes (DPI Blackout Auto-Switch) |
No |
No |
| 1-Click Cloudflare WARP Outbound |
Yes (Anti-Sanction & IP Shield) |
Complex Manual |
Complex Manual |
| 100% Button-driven Telegram Bot |
Yes (Step-by-step Wizard) |
Limited |
Command-based |
| Standalone User Web Page |
Yes (/subinfo/:uuid) |
No |
Basic |
| Intranet Tunnel Generator |
Yes (Gost v3 / ICMP / DNS) |
No |
No |
| VLESS + REALITY Support |
Yes (X25519 Keypair) |
Yes |
Yes |
💻 راهنمای نصب سریع روی سرور لینوکس و ویندوز
🐧 ۱. نصب روی سرور لینوکس (Ubuntu / Debian / CentOS / AlmaLinux):
دستور زیر را با دسترسی root در ترمینال لینوکس اجرا کنید:
bash <(curl -Ls https://raw.githubusercontent.com/thecynetx/nyx/main/install.sh)
🪟 ۲. نصب روی سرور ویندوز (Windows Server 2016-2022 / Windows 10/11):
ترمینال PowerShell را به صورت Run as Administrator باز کرده و دستور زیر را اجرا کنید:
iwr -useb https://raw.githubusercontent.com/thecynetx/nyx/main/install.ps1 | iex
☁️ ۳. راه‌اندازی رایگان روی سرورهای ابری (GitHub Codespaces / Railway / Docker):
اگر سرور مجازی (VPS) ندارید، می‌توانید پنل Nyx را بدون ۱ ریال هزینه روی GitHub Codespaces یا Railway راه‌اندازی کنید:
⚡ راهنمای راه‌اندازی ۱-کلیکه روی GitHub Codespaces (کاملاً رایگان):
- وارد اکانت گیت‌هاب خود شده و در همین ریپازیتوری روی دکمه سبز
Code و سپس تب Codespaces کلیک کنید و Create codespace on main را بزنید.
- در تب Terminal پایین صفحه، دستور زیر را پیست کرده و اینتر بزنید:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/thecynetx/nyx/main/install.sh)"
- در تب PORTS (کنار Terminal)، روی پورت 3080 راست‌کلیک کرده و Port Visibility را روی Public قرار دهید.
- روی آیکون مرورگر (کره زمین) کلیک کنید تا وارد پنل شوید (یوزر:
admin و پسورد: admin123).
🚀 مراحل راه‌اندازی روی Railway:
- وارد سایت railway.com شده و با اکانت گیت‌هاب لاگین کنید.
- روی دکمه
+ New Project کلیک کرده و گزینه Deploy from GitHub repo را بزنید.
- نام مخزن
thecynetx/nyx را انتخاب کرده و روی Deploy Now کلیک کنید.
- پس از چند ثانیه، وارد تب Settings شده و در بخش Networking روی Generate Domain بزنید تا آدرس امن دامنه رایگان (HTTPS) به شما داده شود.
- آدرس دامنه را در مرورگر باز کرده و با نام کاربری
admin و رمز admin123 وارد پنل شوید!
🐳 اجرای با Docker و Docker Compose:
# اجرا با داکر کامپوز
docker-compose up -d
# یا اجرای مستقیم کانتینر
docker run -d \
--name nyx-panel \
-p 3080:3080 \
-p 443:443 \
-v nyx_data:/data \
--restart unless-stopped \
ghcr.io/thecynetx/nyx:latest
🧩 مستندات جامع امکانات پنل
⚛️ ۱. موتور مسیریابی ۴ مسیره (Quantum MultiPath Engine)
موتور پایش موازی که در شرایط اختلال شدید اینترنت ایران، ۴ مسیر ارتباطی مستقل را به صورت همزمان بررسی و پایش می‌کند:
🛡️ Route 1 (Standard): Direct VLESS + REALITY ──► Free Internet ✅
☁️ Route 2 (DPI Blocked): Domestic Iran CDN (ArvanCloud PoP) ──► Server ──► Internet ✅
🌐 Route 3 (Heavy Cut): DNS Tunnel via Port 53 ──► Internet ✅
📡 Route 4 (Emergency): L3 ICMP Ping Tunnel ──► Internet ✅
- پایش موازی در هر ۱۵ ثانیه: بررسی خودکار و بدون تداخل تمام مسیرها با
Promise.allSettled.
- 🚨 سیستم مدیریت بحران (Panic Mode): در صورت قطعی کامل بین‌الملل، هشد�
Nyx Panel is a self-hosted web management suite for Xray-core proxy servers, built to resist heavy censorship (Iran-focused) using VLESS+REALITY, XHTTP/SplitHTTP, packet fragmentation and Cloudflare WARP.