# راهنمای اتصال Faoxima به 3x-ui جدید

این خروجی برای API جدید 3x-ui سری 3.x و به‌طور مشخص نسخه پایدار `v3.4.2` آماده شده است.

## تنظیم پنل

1. در 3x-ui یک Inbound از نوع Shadowsocks بسازید یا از Inbound موجود استفاده کنید.
2. در بخش `Settings → Authentication → API Tokens` یک توکن API ایجاد کنید.
3. در مدیریت Faoxima پنلی با نوع `x-ui_single` اضافه کنید.
4. آدرس کامل پنل، شامل Web Base Path، ولی بدون `/panel` انتهایی را وارد کنید.
5. API Token و شناسه عددی Inbound مربوط به Shadowsocks را وارد کنید.
6. آدرس Subscription را در فیلد مربوط به لینک اشتراک تنظیم کنید.

ربات داخل Inbound انتخاب‌شده کاربر و کانفیگ Shadowsocks می‌سازد؛ خود Inbound را ایجاد نمی‌کند.

## عملیات پشتیبانی‌شده

- تست اتصال با Bearer API Token
- ساخت کاربر Shadowsocks و تولید کلید متناسب با روش رمزنگاری
- دریافت لینک رسمی از API پنل و ساخت لینک استاندارد SIP002 در حالت جایگزین
- مشاهده حجم، مصرف، تاریخ انقضا و وضعیت
- تمدید، افزایش حجم، فعال/غیرفعال‌کردن و ریست ترافیک
- تعویض لینک/کلید و حذف کاربر

## نکات ارتقا

- اجرای روال عادی نصب/آپدیت Faoxima لازم است تا ستون `xui_api_token` به جدول `marzban_panel` اضافه شود.
- برای 3x-ui جدید از API Token استفاده کنید؛ حالت نام‌کاربری/رمزعبور فقط برای پنل‌های قدیمی نگه داشته شده است.
- پس از تست، توکن آزمایشی را حذف یا تعویض کنید.
- قبل از جایگزینی روی سرور اصلی از فایل‌ها و دیتابیس نسخه پشتیبان بگیرید.

## تست نهایی پیشنهادی

یک محصول آزمایشی کم‌حجم بسازید و به‌ترتیب ساخت، اتصال کانفیگ، افزایش حجم، تمدید، ریست مصرف، غیرفعال‌سازی و حذف را بررسی کنید.
