3x-uiعیبیابی
رفع مشکلات رایج 3x-ui — اجرا نشدن پنل، خطاهای 502، مشکلات گواهی و کلاینتهایی که نمیتوانند متصل شوند.
فهرستی برای رسیدگی به رایجترین مشکلات. هرگاه مطمئن نبودید، سطح لاگ را بالا ببرید
(XUI_LOG_LEVEL=debug) و لاگهای پنل و Xray را بررسی کنید.
پنل اجرا نمیشود
- وضعیت سرویس و لاگها را بررسی کنید (منوی
x-ui← وضعیت/لاگها). - مطمئن شوید که پورت پنل از قبل توسط سرویس دیگری اشغال نشده باشد.
- بررسی کنید که مسیر دیتابیس قابل نوشتن باشد (پیشفرض
/etc/x-ui/x-ui.db).
خطای 502 / در دسترس نبودن پنل پشت یک پروکسی
- مطمئن شوید که پنل واقعاً روی پورت upstream در حال شنود است (مثلاً
2053). - اطمینان حاصل کنید که پروکسی معکوس شما هدرهای ارتقای WebSocket را عبور میدهد و به پورت درست و مسیر پایه وب صحیح اشاره میکند.
- بررسی کنید که فایروال اتصال پروکسی ← پنل را مسدود نکرده باشد.
مشکلات گواهی
- پیش از صدور گواهی، DNS دامنه باید به سرور اشاره کند.
- پورتهای 80/443 باید برای اعتبارسنجی HTTP/TLS در دسترس باشند (یا از اعتبارسنجی DNS استفاده کنید).
- برای REALITY به یاد داشته باشید که به هیچ گواهی نیازی ندارد — مشکل معمولاً یک
dest/SNI نادرست است (به نکات کلیدی REALITY مراجعه کنید).
یک کلاینت نمیتواند متصل شود
- لینک کلاینت را با بازرس لینک اشتراک رمزگشایی کنید و تکتک پارامترها را تأیید کنید.
- بررسی کنید که transport و security در دو طرف مطابقت داشته باشند.
- مطمئن شوید که کلاینت به محدودیت ترافیک، انقضا یا IP خود نرسیده باشد.
- اطمینان حاصل کنید که پورت inbound در فایروال باز است.
همچنان به مشکل خوردهاید؟ در میان مسائل GitHub جستوجو کنید — احتمالاً علامت مشکل شما قبلاً دیده شده است.
WebSocket
دریافت بهروزرسانیهای وضعیت در لحظه از طریق WebSocket. تنها یکبار به <code>ws://<panel>/ws</code> متصل شوید تا بدون نیاز به polling، جریانی از پیامهای JSON دریافت کنید. به یک کوکی نشست احرازهویتشده نیاز دارد (احرازهویت با توکن Bearer پشتیبانی نمیشود). هر پیام دارای یک فیلد <code>type</code> است که شکل دادهی آن را مشخص میکند.
سؤالات متداول
پرسشهای پرتکرار درباره 3x-ui — مجوز، سیستمهای پشتیبانیشده، پایگاههای داده و کلاینتها.