Clients: пользователи и профили доступа
Цель
Показать, как в 3x-ui устроен раздел Clients: общий список клиентов, создание пользователя, учетные данные, ссылки подписки и массовые действия.
Теория
Client в 3x-ui — это учетная единица доступа к одному или нескольким inbound. У клиента могут быть идентификатор, пароль или UUID, лимит трафика, срок действия, группа, комментарий и subscription links.
История
В Xray клиентские записи часто хранятся внутри inbound. 3x-ui добавляет поверх этого административный слой: общий список клиентов, поиск, массовые операции, экспорт/импорт и привязку к группам.
Архитектура
Клиент связан с четырьмя сущностями:
| Сущность | Роль |
|---|---|
| Inbound | где клиент может подключаться |
| Credentials | UUID/password/email/subscription id |
| Limits | traffic limit, IP limit, expiry, auto-renew |
| Subscription | внешние ссылки и формат профиля для приложений |
Настройка
Типовой порядок:
1. Открыть Clients. 2. Нажать Add Client или выбрать inbound и создать клиента из него. 3. На вкладке Main задать email/имя, лимиты, срок действия и группу. 4. На вкладке Credentials проверить UUID, password, ID подписки и Hysteria auth, если он применим. 5. На вкладке Links добавить внешние subscription links только при понятной задаче. 6. Сохранить и проверить, что клиент появился в нужном inbound.
Разбор параметров
| Поле | Значение | Риск ошибки |
|---|---|---|
| имя/идентификатор клиента | не должен раскрывать лишние персональные данные | |
| Subscription ID | id подписки | используется в ссылках подписки |
| UUID | идентификатор для VLESS/VMess | должен совпадать у клиента и сервера |
| Password | пароль для протоколов, где он нужен | нельзя публиковать |
| Total Sent/Received | учет трафика | важен для диагностики и лимитов |
| IP Limit | ограничение одновременных IP | может ломать роуминг и mobile-сети |
| Expiry | срок действия | отличается от срока inbound |
| Start after first use | отсчет после первого подключения | полезно для выдачи доступа заранее |
| Auto Renew | автоматическое продление | требует контроля правил оплаты/учета |
| Group | организационная группа | помогает фильтровать и обслуживать |
| Attached inbounds | где действует клиент | критично при multi-inbound сценариях |
Меню More содержит массовое добавление, экспорт, импорт, сброс трафика и удаление клиентов.
Типовые ошибки
- удалить клиента вместо отключения;
- сбросить трафик всем клиентам без фиксации отчета;
- привязать клиента не к тому inbound;
- выдать одинаковые subscription links разным людям;
- считать IP Limit защитой от передачи доступа без учета NAT и мобильных сетей.
Безопасность
UUID, password, subscription ID и ссылки подписки являются секретами. Их нельзя оставлять в публичных скриншотах, чатах, тикетах и логах без маскирования. Отзыв доступа должен включать отключение или удаление клиента, сброс ссылок и проверку, что профиль не остался активным на другом inbound.
Чек-лист
- Клиент привязан только к нужным inbound.
- Лимиты и expiry заданы осознанно.
- Секреты клиента не опубликованы.
- Subscription links используются только там, где нужны.
- Перед массовыми действиями сделан backup или экспорт.