mirror of
https://github.com/MHSanaei/3x-ui.git
synced 2026-10-28 19:45:24 +08:00
MHSanaei
9b91f0f42e
Fold the standalone 3x-ui-docs project (Next.js 16 + Fumadocs, deployed to docs.sanaei.dev) into docs/ so the panel and its documentation share a single source of truth, the way sing-box keeps its docs in-tree. The old repo becomes redundant and can be retired. - Import the full site under docs/ (app, components, content, lib, public, scripts, config). The self-contained pnpm project sits alongside the existing engineering notes with no filename collisions. - Re-point "Edit on GitHub" links from MHSanaei/3x-ui-docs to this repo's docs/content/docs path (docs/lib/shared.ts, docs/app/.../page.tsx). - Add docs-ci.yml and docs-deploy.yml under .github/workflows/, scoped to docs/** and run with working-directory: docs, since GitHub only runs workflows from the repo-root .github/. deploy-static.yml's GitHub Pages publish (CNAME docs.sanaei.dev) carries over unchanged. Follow-up (outside this commit): attach the docs.sanaei.dev custom domain to this repository's Pages (or set the Vercel project's root directory to docs), confirm the site is live from the monorepo, then delete MHSanaei/3x-ui-docs.
43 lines
2.8 KiB
Plaintext
43 lines
2.8 KiB
Plaintext
---
|
|
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>
|