---
title: عیب‌یابی
description: رفع مشکلات رایج 3x-ui — اجرا نشدن پنل، خطاهای 502، مشکلات گواهی و کلاینت‌هایی که نمی‌توانند متصل شوند.
icon: Wrench
---

فهرستی برای رسیدگی به رایج‌ترین مشکلات. هرگاه مطمئن نبودید، سطح لاگ را بالا ببرید
(`XUI_LOG_LEVEL=debug`) و لاگ‌های پنل و Xray را بررسی کنید.

## پنل اجرا نمی‌شود

- وضعیت سرویس و لاگ‌ها را بررسی کنید (منوی `x-ui` ← وضعیت/لاگ‌ها).
- مطمئن شوید که **پورت پنل از قبل توسط سرویس دیگری اشغال نشده** باشد.
- بررسی کنید که مسیر دیتابیس قابل نوشتن باشد (پیش‌فرض `/etc/x-ui/x-ui.db`).

## خطای 502 / در دسترس نبودن پنل پشت یک پروکسی

- مطمئن شوید که پنل واقعاً روی پورت upstream در حال شنود است (مثلاً `2053`).
- اطمینان حاصل کنید که [پروکسی معکوس](/docs/operations/reverse-proxy) شما هدرهای
  ارتقای WebSocket را عبور می‌دهد و به پورت درست و **مسیر پایه وب** صحیح اشاره می‌کند.
- بررسی کنید که فایروال اتصال پروکسی ← پنل را مسدود نکرده باشد.

## مشکلات گواهی

- پیش از صدور گواهی، DNS دامنه باید به سرور اشاره کند.
- پورت‌های 80/443 باید برای اعتبارسنجی HTTP/TLS در دسترس باشند (یا از اعتبارسنجی DNS استفاده کنید).
- برای REALITY به یاد داشته باشید که **به هیچ گواهی نیازی ندارد** — مشکل معمولاً یک
  `dest`/SNI نادرست است (به [نکات کلیدی REALITY](/docs/config/reality) مراجعه کنید).

## یک کلاینت نمی‌تواند متصل شود

- لینک کلاینت را با
  [بازرس لینک اشتراک](/docs/config/share-links) رمزگشایی کنید و تک‌تک پارامترها را تأیید کنید.
- بررسی کنید که **transport و security در دو طرف مطابقت داشته باشند**.
- مطمئن شوید که کلاینت به **محدودیت ترافیک، انقضا یا IP** خود نرسیده باشد.
- اطمینان حاصل کنید که پورت inbound در فایروال باز است.

<Callout type="info">
  همچنان به مشکل خورده‌اید؟ در میان
  [مسائل GitHub](https://github.com/MHSanaei/3x-ui/issues) جست‌وجو کنید — احتمالاً
  علامت مشکل شما قبلاً دیده شده است.
</Callout>
