3X-UI
Мониторинг и управление всеми серверами 3X-UI
Переключаемые настройки серверов для оптимального подключения
Автораспределение
Одна основная карточка сервера здесь, если он не исключён из автораспределения (пул при server_ids = *). Дополнительные копии карточки в других блоках — в форме редактирования сервера («Дубликат карточки»).
Локации
Основная секция, если у сервера включена «Локация (мульти-сервер)» и нет [Balancer] в шаблоне ключа (приоритет секций: балансировка → локации → автораспределение).
Балансировка
Основная секция при наличии [Balancer] в шаблоне ключа. Копию карточки можно вывести в других блоках через «Дубликат карточки» в настройках сервера.
Прочие
Не попали ни в одну группу выше (исключены из автораспределения и без роли локации/балансировки).
Редактировать JSON серверов
Массив объектов серверов (как в API /admin/panels/api/servers-cards). Поля stats и active_users не сохраняются. Для SSH и API Token: panel_api_token, ssh_host, ssh_port, ssh_user, ssh_password (пароль не перезаписывается, если ключ убран из объекта).
Новый сервер — объект без id или с id: null. Удаление строк из JSON не удаляет серверы в БД (удаляйте через меню карточки).
Добавить сервер
Редактировать сервер
Быстрое заполнение из 3X-UI
Основная информация
Кликните в поле и начните вводить название или код; выберите страну (с эмодзи-флагом) или «Другое». В базу сохраняется код и название — как раньше для подписок.
ID инбаунда в панели, к которому бот привязывает клиентов. После создания из шаблона при необходимости обновите вручную.
Создать Inbound на панели из шаблона
Берётся JSON из Инструменты → Шаблон Inbound (слот 1, 2, 3…). Добавляет новый инбаунд через API 3X-UI (существующие не перезаписываются).
Используется при создании клиентов на этой панели (и в ссылках без шаблона). Пустое значение = xtls-rprx-vision.
Данные для подключения к 3X-UI панели
Один и тот же токен можно использовать с бота (удалённый сервер) и с локального ПК — для одной панели 3X-UI это один секрет, не привязан к IP. Скопируйте существующий токен из панели (Настройки → Безопасность → API Tokens), вставьте сюда и нажмите «Сохранить».
Не нажимайте «Пересоздать», если токен уже работает на локальном ПК: кнопка удаляет все токены в панели и создаёт новый — доступ с ПК пропадёт, пока не обновите токен там.
Пустое поле при «Сохранить» не стирает уже записанный токен в БД бота.
SSH на VPS (токен, терминал, установка)
Данные для ссылки-подписки клиента
Для ссылок и шаблона подписки. Порт inbound на панели 3X-UI задаётся в самой панели, а не этим полем.
При включении запросы к run.py для стандартного host/port не выполняются — используется ваш шаблон ссылки.
Для балансировки: случайно выбирается одна строка из шаблона (если их несколько).
При оформлении подписки бот подставляет в эти плейсхолдеры UUID и email клиента, имя сервера, а также публичный хост и публичный порт из настроек этого сервера.
- - UUID клиента (заменяется автоматически при генерации ключа)
- - Email клиента (заменяется автоматически при генерации ключа)
- -имя сервера, URL-encoded формате (заменяетсяа автоматически)
- — маркер балансировки (в подписке не показывается)
Множественные ключи: каждая строка в поле шаблона — отдельный ключ. Можно задать разные IP/домены; все строки попадут в список при генерации подписки.
Если заданы домены, в подписке могут быть созданы несколько вариантов одного ключа с разными SNI.
Группа «Балансировка»: укажите [Balancer] в шаблоне ключа выше. На странице у каждого сервера одна основная секция; ниже — копии карточки в других блоках.
Установка 3X-UI через SSH
IP адрес или доменное имя сервера
Пароль не сохраняется, используется только для установки. Если видите «Authentication failed», проверьте логин и пароль root на VPS (вход с того же хоста, где работает web_admin).
Для v3.x после установки читается API Token и создаётся Inbound id=1.
Будет создан базовый инбаунд выбранного типа
Кликните в поле и начните вводить; страна с эмодзи-флагом в списке или «Другое». Пусто — будет использован IP адрес