Управление клиентами

Что такое «клиент» в 3x-ui

Клиент — это учётная запись внутри inbound'а. Один inbound (например, VLESS на порту 8443) может содержать десятки и сотни клиентов. Каждый клиент идентифицируется по UUID (для VLESS/VMess) или паролю (для Trojan/Shadowsocks) и имеет собственный набор ограничений. Панель не создаёт отдельный порт или inbound для каждого пользователя — все они разделяют один вход, но учитываются раздельно.

Такая модель удобна для персонального использования (несколько устройств — несколько клиентов с разными лимитами) и для небольших групп, где нужно видеть, кто сколько трафика потребил.

Основные параметры клиента

Квота трафика (Total GB)

Лимит в гигабайтах (или терабайтах). Когда клиент исчерпывает квоту, Xray перестаёт пропускать его трафик до сброса счётчика или увеличения лимита. Это полезно, чтобы одно устройство или пользователь не «съел» весь канал.

Срок действия (Expiry Time)

Дата и время, после которой клиент автоматически отключается. Можно ставить «навсегда» или ограничивать подпиской на месяц. Панель проверяет срок при каждом подключении.

Лимит IP (Limit IP)

Максимальное число одновременных уникальных IP-адресов с одного клиента. Если клиент подключается с большего числа адресов, новые соединения блокируются. Это защита от «расшаривания» одного аккаунта на много устройств.

HWID-лимит

Ограничение по уникальным hardware ID устройств. В отличие от лимита IP, который можно обойти сменой сети, HWID привязывает клиента к конкретным устройствам. Работает, если клиентское приложение передаёт HWID (не все клиенты это поддерживают).

Группы клиентов

Клиентов можно объединять в группы и применять настройки массово: изменить лимит, продлить срок, сбросить трафик. Удобно, когда клиентов много и нужно управлять ими по категориям.

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

Панель позволяет:

• Добавлять клиентов по одному через веб-интерфейс.
• Импортировать список клиентов (например, из CSV или другого inbound'а).
• Клонировать клиента на другой inbound или ноду.
• Удалять группой по фильтру.
• Экспортировать ссылки подключения и QR-коды для каждого клиента.

Для каждого клиента генерируется уникальная ссылка вида vless://uuid@host:port?params, которую можно передать пользователю. QR-код удобен для мобильных клиентов.

Статистика по клиентам

Панель собирает для каждого клиента:

• Потреблённый трафик (входящий/исходящий).
• Время последнего подключения.
• Текущее число активных IP (если включён лимит IP).
• Историю подключений (в зависимости от настроек логирования).

Эти данные видны в реальном времени и используются для биллинга (если вы продаёте доступ) или просто для контроля расхода.

Пример: создание клиента через API

POST /panel/api/inbounds/addClient
{
  "id": 1,
  "settings": "{\"clients\":[{
    \"email\": \"user@example\",
    \"totalGB\": 107374182400,
    \"expiryTime\": 1767225600000,
    \"limitIp\": 2,
    \"enable\": true
  }]}"
}

Параметр totalGB указывается в байтах (100 ГБ = 107374182400). expiryTime — Unix-время в миллисекундах.