# 3x-ui v3 — راه‌اندازی (فقط API جدید)

این ربات برای پنل **sanaei (3x-ui v3)** فقط از endpointهای `/panel/api/*` استفاده می‌کند.  
API قدیمی `panel/inbound/*` دیگر استفاده نمی‌شود.

## نصب تازه (Fresh deploy)

1. در MySQL یک دیتابیس خالی بساز (مثلاً `wizwiz`).
2. فایل `baseInfo.php` را با توکن ربات، اطلاعات DB و آدرس webhook پر کن.
3. یک‌بار اسکیمای اولیه را بساز:

```bash
# از مرورگر یا curl:
https://YOUR-DOMAIN/wizwizxui-timebot/createDB.php

# یا از CLI روی سرور:
php /var/www/html/wizwizxui-timebot/createDB.php
```

خروجی شامل **username/password پنل wizwiz** (جدول `admins`) است — ذخیره‌اش کن.

4. بعد از نصب موفق، `createDB.php` را از روی سرور **حذف کن** (امنیت).
5. `xui-env.example.php` → `xui-env.local.php` و مقادیر v3 را پر کن (پایین).
6. Webhook تلگرام را ست کن:
   `https://api.telegram.org/bot<TOKEN>/setWebhook?url=https://YOUR-DOMAIN/wizwizxui-timebot/bot.php`

> `install/install.php?updateBot=1` فقط برای **آپدیت** ربات‌های قبلی است، نه نصب اولیه.

## تنظیمات v3

1. `xui-env.example.php` → `xui-env.local.php`
2. یکی از این دو روش auth:

**روش A — API Token (توصیه‌شده):**
```php
$XUI_AUTH_MODE = 'auto'; // یا bearer
$XUI_API_TOKEN = 'توکن از Settings → Security → API Token';
$XUI_SUBSCRIPTION_BASE_URL = 'https://sub.example.com:10882';
$XUI_SUB_PATH = '/sub/';
```

**روش B — یوزر/پسورد پنل (بدون توکن):**
```php
$XUI_AUTH_MODE = 'auto';
$XUI_API_TOKEN = '';  // خالی
// هنگام افزودن سرور، همان user/pass پنل را در ربات وارد کنید
```

3. در دیتابیس `server_config.type` = **`sanaei`**
4. (فقط آپدیت از نسخه قدیمی) `install/install.php?updateBot=1`
5. (اختیاری) backfill سفارش‌های قدیمی: `php install/migrate_xui_v3.php --server-id=1`

## تحویل به مشتری

فقط **لینک سابسکریپشن** — بدون `vless://` / `vmess://` / QR کانفیگ خام.

## Marzban

سرورهای با `type=marzban` همچنان از API مرزبان استفاده می‌کنند.
