# راهنمای اتصال پنل x-ui / 3x-ui به پروژه

برای اینکه پنل x-ui بدون مشکل به این پروژه وصل شود، این مراحل را رعایت کنید.

---

## ۱. اطلاعات مورد نیاز از پنل x-ui

قبل از افزودن پنل، این موارد را از پنل x-ui خود داشته باشید:

| مورد | توضیح |
|------|--------|
| **آدرس پنل (URL)** | آدرس کامل پنل؛ با یا بدون مسیر اضافی |
| **نام کاربری** | همان یوزرنیم ورود به پنل |
| **رمز عبور** | همان رمز ورود به پنل |

---

## ۲. فرمت صحیح آدرس پنل (URL)

### ✅ درست

- `https://panel.example.com:2053`
- `http://192.168.1.100:2053`
- `https://panel.example.com:2053/mute`  ← اگر پنل زیر مسیر `/mute` است
- `https://panel.example.com:2096`

### ❌ اشتباه

- بدون پورت وقتی پنل روی پورت غیر ۸۰/۴۴۳ است: `https://panel.example.com`
- اضافه کردن `/login` یا `/xui` در انتهای URL: `https://panel.example.com:2053/login`

**نکته:** اگر با مرورگر با یک مسیر مثل `/mute` وارد پنل می‌شوید، همان را در انتهای URL قرار دهید؛ مثلاً:  
`https://panel.example.com:2053/mute`

---

## ۳. افزودن پنل در پروژه

1. وارد **پنل ادمین** شوید.
2. از منو بروید به **مدیریت پنل‌ها**.
3. روی **افزودن پنل جدید** کلیک کنید.
4. فیلدها را پر کنید:
   - **نام پنل:** یک نام برای شناسایی (مثلاً «پنل اصلی»).
   - **آدرس پنل:** همان URL صحیح (با پورت و در صورت نیاز مسیر، مثل `/mute`).
   - **نام کاربری و رمز عبور:** همان اطلاعات ورود به پنل x-ui.
5. در صورت نیاز:
   - **Proxy:** اگر دسترسی به پنل فقط از طریق SOCKS5 ممکن است، نوع و آدرس و پورت و در صورت نیاز یوزر/پس را وارد کنید.
   - **آدرس پایه Subscription:** فقط اگر لینک ساب روی دامنه/آدرس دیگری است؛ وگرنه خالی بگذارید.
6. **افزودن** را بزنید.

---

## ۴. تست اتصال قبل از استفاده

بعد از افزودن پنل می‌توانید اتصال را تست کنید:

- فایل **`test_connection.php`** را در مرورگر باز کنید (در روت پروژه).
- همان **URL، نام کاربری و رمز عبور** پنل را وارد کنید.
- اگر پیام «اتصال به پنل موفق بود» و لیست Inboundها را دیدید، اتصال درست است.

اگر از **Proxy** استفاده می‌کنید، در این مرحله فعلاً تست را بدون Proxy انجام دهید تا مطمئن شوید خود پنل و یوزر/پس درست است؛ بعد در پروژه Proxy را تنظیم کنید.

---

## ۵. مشکلات رایج و راه‌حل

| مشکل | احتمال | راه‌حل |
|------|--------|--------|
| خطای ۴۰۴ بعد از لاگین | URL یا مسیر اشتباه | URL را دقیقاً مثل مرورگر وارد کنید (با پورت و در صورت وجود با مسیر مثل `/mute`). |
| خطای لاگین / دسترسی | یوزر یا پس اشتباه | نام کاربری و رمز را در خود پنل x-ui چک کنید. |
| اتصال برقرار نمی‌شود | فایروال / شبکه | از سرور یا جایی که سایت روی آن است به آدرس و پورت پنل دسترسی باشد؛ در صورت نیاز از Proxy استفاده کنید. |
| لیست Inbound خالی است | نسخه پنل یا API | پنل 3x-ui (MHSanaei) باشد؛ endpointها در کد به‌صورت خودکار امتحان می‌شوند. |
| خطای SSL / certificate | گواهی self-signed | در این پروژه بررسی SSL برای پنل غیرفعال است؛ اگر هنوز خطا می‌گیرید از همان سرورِ سایت به پنل دسترسی شبکه داشته باشید. |

---

## ۶. بعد از اتصال پنل

1. در **مدیریت نمایندگان**، به هر نماینده یک **پنل** اختصاص دهید.
2. در **Inboundهای مجاز**، مشخص کنید هر نماینده به کدام Inboundها دسترسی داشته باشد.
3. نماینده از **پنل نماینده** با همان یوزرنیم/رمز خودش وارد می‌شود و فقط کاربران و Inboundهای مجاز را می‌بیند.

با رعایت این مراحل، پنل x-ui بدون مشکل به پروژه وصل می‌شود.

**اگر باز هم وصل نشد:** صفحه **`test_api_endpoints.php`** را در مرورگر باز کنید، همان آدرس و یوزر/رمز پنل را وارد کنید و «تست» بزنید. خروجی نشان می‌دهد کدام آدرس‌ها امتحان شده‌اند و پاسخ هر کدام چیست. متن خطا یا شماره HTTP را یادداشت کنید و برای رفع مشکل استفاده کنید.
