3x-ui3x-ui
Конфигурация

Клиенты

Управление клиентами 3x-ui — учётные данные, лимиты трафика и срока действия, ограничения по IP, группы, массовые операции, внешние ссылки и статус онлайн.

Клиент — это отдельный пользователь, идентифицируемый по уникальному email. В текущей версии панели клиенты являются полноценными записями, которые можно одновременно привязать к нескольким входящим подключениям (inbounds), с учётом трафика по каждому клиенту.

Поля клиента

ПолеПрименяется кЗначение
EmailвсеУникальный идентификатор для учёта трафика и поиска.
ID (UUID)VLESS, VMess, TUICУчётные данные клиента.
PasswordTrojan, Shadowsocks, TUICУчётные данные клиента.
AuthHysteria2Учётные данные клиента.
FlowVLESSПоток XTLS, например xtls-rprx-vision.
Limit IPвсе (кроме TUIC)Максимум одновременных IP-адресов источника (контролируется через Fail2ban).
Total (GB)все (кроме TUIC)Квота трафика; при исчерпании клиент отключается (для TUIC лимит задаётся на уровне инбаунда).
ExpiryвсеДата, после которой клиент перестаёт работать.
ResetвсеПериод автопродления в днях (обнуляет квоту).
Telegram IDвсеПривязывает клиента к пользователю Telegram для самообслуживания/уведомлений.
Sub IDвсеИдентификатор подписки, группирующий ссылки этого клиента.
GroupвсеНеобязательная группа клиента для организации и массовой фильтрации.
CommentвсеПроизвольная текстовая заметка.

Достижение лимита трафика или срока действия отключает клиента, как и ручное отключение или удаление; тогда панель перезапускает Xray (restartXrayOnClientDisable, включено по умолчанию).

Лимиты и контроль IP

  • Ограничения по трафику / сроку действия отключают клиента при достижении; период Reset автоматически обновляет квоту.
  • Limit IP ограничивает количество одновременных IP-адресов источника. Контроль осуществляется с помощью Fail2ban — см. Безопасность. Вы можете просмотреть недавние IP-адреса клиента и очистить их из действий клиента.
  • Статус онлайн и время последнего входа отслеживаются по каждому клиенту (и по каждому узлу в конфигурациях с несколькими узлами).

Ссылки для общего доступа и внешние ссылки

У каждого клиента есть ссылки для общего доступа и QR-код для его входящих подключений, а также объединённая подписка. К клиенту также можно привязать внешние ссылки — дополнительные ссылки vless://, vmess://, trojan://, ss://, hysteria2:// или wireguard://, либо удалённый URL подписки, — чтобы они отображались рядом со сгенерированными панелью в подписке клиента.

Чтобы точно узнать, что содержит ссылка, вставьте её в инспектор ссылок для общего доступа.

Массовые операции

Для управления множеством клиентов одновременно панель поддерживает массовые операции создания, включения, отключения, удаления, привязки/отвязки (к входящим подключениям), сброса трафика и корректировки (добавить дни / добавить байты / задать flow). Операции обслуживания также позволяют удалять исчерпанных клиентов (исчерпана квота/срок действия) и осиротевших клиентов (не привязанных ни к одному входящему подключению).

Ссылка клиента для общего доступа содержит его учётные данные. Относитесь к ссылкам и QR-кодам как к паролям и меняйте учётные данные, если что-то из этого утекло.

On this page