عیبیابی و سؤالات متداول¶
مشکلات رایج¶
اتصال رد شد¶
علامت: کلاینتها نمیتوانند به پروکسی متصل شوند.
بررسی کنید:
- آیا نود آنلاین است؟ صفحه نودها را برای وضعیت بررسی کنید
- آیا پورت اینباند باز است؟
ss -tlnp | grep <port> - آیا فایروال اجازه ترافیک میدهد؟
ufw statusیاiptables -L - آیا هسته اجرا میشود؟ لاگهای نود را بررسی کنید
- آیا پروتکل/ترنسپورت در کانفیگ کلاینت صحیح است؟
Tip
دستور vortexui doctor را اجرا کنید تا تمام اجزا را یکجا بررسی کند.
خطاهای TLS¶
علامت: tls: handshake failure یا certificate verify failed
بررسی کنید:
- REALITY: آیا دامنه مقصد/SNI از نود قابل دسترسی است؟
curl -I https://dest-domainرا امتحان کنید - TLS: آیا گواهی معتبر است؟ انقضا را با
openssl s_client -connect host:443بررسی کنید - CDN: آیا حالت SSL کلادفلر روی "Full (Strict)" تنظیم شده؟
- کلاینت: آیا فیلد SNI با تنظیمات سرور مطابقت دارد؟
- فرگمنت: اگر از فرگمنت TLS استفاده میکنید، موقتاً غیرفعالش کنید
نود قطع شد¶
علامت: نود در پنل "آفلاین" نمایش داده میشود.
بررسی کنید:
- آیا سرور نود اجرا میشود؟ SSH کنید و بررسی کنید:
systemctl status vortex-node - اتصال شبکه:
ping <panel-ip>از نود - گواهیهای mTLS: بررسی انقضا یا عدم تطابق
- فایروال: آیا پورت gRPC (پیشفرض ۹۰۹۰) بین پنل و نود باز است؟
- لاگهای ایجنت نود را بررسی کنید:
journalctl -u vortex-node -n 50
سابسکریپشن خالی¶
علامت: کلاینت سابسکریپشن خالی (بدون کانفیگ) دریافت میکند.
بررسی کنید:
- آیا کاربر اینباند اختصاصدادهشده دارد؟ جزئیات کاربر → اینباندها
- آیا اینباندهای اختصاصدادهشده روی نودهای آنلاین هستند؟
- آیا هاستهای سابسکریپشن بهدرستی تنظیم شدهاند (در صورت استفاده)؟
- آیا توکن سابسکریپشن معتبر است (لغو نشده)؟
- پاسخ خام را بررسی کنید:
curl https://panel.example.com/sub/<token>
CPU بالا روی نود¶
علامت: CPU نود بالای ۹۰% باقی میماند.
بررسی کنید:
- کاربران زیاد؟ تعداد اتصالات فعال را بررسی کنید
- آیا مهاجرت خودکار تنظیم شده؟ باید کاربران را منتقل کند
- پروسس هسته:
top -p $(pgrep xray)یاpgrep sing-box - افزودن نودهای بیشتر و فعالسازی بالانسر را در نظر بگیرید
مشکلات اتصال دیتابیس¶
علامت: پنل خطای 500 برمیگرداند، لاگها خطای اتصال PostgreSQL نشان میدهند.
بررسی کنید:
- آیا PostgreSQL اجرا میشود؟
systemctl status postgresql - رشته اتصال در
.envصحیح است؟ - اتصالات حداکثر تمام شده؟
SELECT count(*) FROM pg_stat_activity; - افزودن pgBouncer برای استخر اتصال را در نظر بگیرید
نکات دیباگ¶
vortexui doctor¶
اجرای تشخیص جامع:
بررسیها:
- ✅ اتصال PostgreSQL + نسخه اسکیما
- ✅ اتصال Redis + تأخیر
- ✅ اتصال gRPC نود (به ازای هر نود)
- ✅ اعتبار گواهی
- ✅ در دسترس بودن پورت
- ✅ رزولوشن DNS
- ✅ فضای دیسک
- ✅ وجود و نسخه باینری هسته
اندپوینت سلامت¶
وضعیت اجزا را برمیگرداند:
{
"status": "healthy",
"components": {
"database": "ok",
"redis": "ok",
"nodes": { "online": 3, "offline": 0 }
},
"version": "1.2.9"
}
فعالسازی لاگ دیباگ¶
سپس لاگها را مشاهده کنید:
Warning
لاگ دیباگ حجیم است. پس از عیبیابی غیرفعال کنید تا دیسک پر نشود.
تست دستی سابسکریپشن¶
# فرمت Base64
curl -s https://panel.example.com/sub/<token>
# فرمت Clash
curl -s "https://panel.example.com/sub/<token>?format=clash"
# با تشخیص User-Agent
curl -s -A "clash-meta" https://panel.example.com/sub/<token>
بررسی سلامت نود از طریق API¶
سؤالات متداول¶
چگونه رمز عبور ادمین را بازنشانی کنم؟¶
یا از طریق منوی تعاملی:
چگونه از 3x-ui مهاجرت کنم؟¶
- دیتابیس 3x-ui خود را اکسپورت کنید (
x-ui.db) - در VortexUI: کاربران → ایمپورت → 3x-ui
- فایل دیتابیس را آپلود کنید
- اینباندها را نگاشت کنید (VortexUI کاربران را به اینباندهای مطابق اختصاص میدهد)
- بررسی و تأیید کنید
چگونه از Marzban مهاجرت کنم؟¶
- در VortexUI: کاربران → ایمپورت → Marzban
- رشته اتصال دیتابیس یا فایل اکسپورت ارائه دهید
- کاربران، داده ترافیک و تاریخهای انقضا حفظ میشوند
- نگاشت اینباند تا حد امکان بهصورت خودکار انجام میشود
آیا میتوانم پنل و نود را روی یک سرور اجرا کنم؟¶
بله — از ویژگی نود محلی استفاده کنید. هسته پروکسی درونپروسسی در کنار پنل اجرا میشود. نیازی به ایجنت نیست.
تشخیص خودکار سابسکریپشن چگونه کار میکند؟¶
پنل هدر User-Agent کلاینت را بررسی میکند:
- حاوی "clash" → YAML کلش
- حاوی "sing-box" → JSON سینگباکس
- حاوی "outline" → لینکهای
ss://Outline - سایر → لینکهای اشتراک base64
با پارامتر ?format= بازنویسی کنید.
چگونه دامنه برای HTTPS اضافه کنم؟¶
- رکورد DNS A دامنه را به IP سرور اشاره دهید
VORTEX_DOMAIN=your-domain.comرا در.envتنظیم کنید- پنل را ریستارت کنید — Caddy بهصورت خودکار گواهی صادر میکند
چگونه بکاپ و بازیابی کنم؟¶
بکاپ:
بازیابی:
تفاوت حالت سهمیه اختصاصیافته و مصرفشده چیست؟¶
- اختصاصیافته: استخر هنگام تعیین حد ترافیک به کاربران کاهش مییابد (مجموع حدهای کاربران محاسبه میشود)
- مصرفشده: استخر فقط وقتی کاربران واقعاً ترافیک مصرف کنند کاهش مییابد
از اختصاصیافته برای بستههای ازپیشفروختهشده و از مصرفشده برای پرداخت مصرفی استفاده کنید.
چگونه پرداخت اختصاصی ریسلر تنظیم کنم؟¶
- یک ادمین ریسلر با نقش مناسب ایجاد کنید
- ریسلر وارد شود → اکانت ریسلر → تنظیم پرداخت
- شماره کارت، آدرسهای رمزارز یا مرچنت زرینپال خود را تنظیم کند
- کاربرانش این گزینههای پرداخت را در فروشگاه میبینند
چرا نود من "ناسالم" نمایش داده میشود؟¶
نود در بررسیهای سلامت ناموفق است. دلایل رایج:
- CPU بالا (بیش از ۹۰%) یا RAM (بیش از ۹۰%)
- افت بسته بیش از ۱۰%
- هسته کرش کرده (ریستارت خودکار باید مدیریت کند)
- مشکل گواهی
بررسی: نودها → نود → سلامت برای دلایل خاص خرابی.
چگونه از کلادفلر با VortexUI استفاده کنم؟¶
- دامنه را از طریق کلادفلر به سرور اشاره دهید (ابر نارنجی)
- حالت SSL کلادفلر را روی Full (Strict) تنظیم کنید
- از ترنسپورت WebSocket استفاده کنید (برای پروکسی کلادفلر ضروری)
- هاستهای سابسکریپشن را تنظیم کنید تا دامنه CDN تبلیغ شود
- کاربران به کلادفلر متصل میشوند → کلادفلر به نود شما فوروارد میکند
چگونه فروشگاه سلفسرویس را فعال کنم؟¶
- پلن ایجاد کنید (پلنها → پلن جدید)
- روشهای پرداخت تنظیم کنید (تنظیمات → تنظیم پرداخت)
- لینک پورتال را با کاربران به اشتراک بگذارید:
/portal/login - کاربران همچنین میتوانند از طریق
/sub/{token}/shopبه فروشگاه دسترسی پیدا کنند
وقتی ریسلر سهمیهاش تمام شود چه اتفاقی میافتد؟¶
- اعتبار کاربر تمام شده: نمیتواند کاربر جدید ایجاد کند
- اعتبار ترافیک تمام شده: کاربران موجود تا زمان محدودیت فردی ادامه میدهند (حالت مصرفشده) یا نمیتواند ترافیک بیشتر اختصاص دهد (حالت اختصاصیافته)
- تعلیق خودکار قابل تنظیم است تا ریسلر را کاملاً غیرفعال کند