clients.mdx 6.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. ---
  2. title: Клиенты
  3. description: Управление клиентами 3x-ui — учётные данные, лимиты трафика и срока действия, ограничения по IP, группы, массовые операции, внешние ссылки и статус онлайн.
  4. icon: Users
  5. ---
  6. **Клиент** — это отдельный пользователь, идентифицируемый по уникальному
  7. **email**. В текущей версии панели клиенты являются полноценными записями,
  8. которые можно одновременно привязать к **нескольким входящим подключениям**
  9. (inbounds), с учётом трафика по каждому клиенту.
  10. ## Поля клиента
  11. | Поле | Применяется к | Значение |
  12. | -------------- | --------------------- | ------------------------------------------------------------------ |
  13. | **Email** | все | Уникальный идентификатор для учёта трафика и поиска. |
  14. | **ID (UUID)** | VLESS, VMess | Учётные данные клиента. |
  15. | **Password** | Trojan, Shadowsocks | Учётные данные клиента. |
  16. | **Auth** | Hysteria2 | Учётные данные клиента. |
  17. | **Flow** | VLESS | Поток XTLS, например `xtls-rprx-vision`. |
  18. | **Limit IP** | все | Максимум одновременных IP-адресов источника (контролируется через Fail2ban). |
  19. | **Total (GB)** | все | Квота трафика; при исчерпании клиент отключается. |
  20. | **Expiry** | все | Дата, после которой клиент перестаёт работать. |
  21. | **Reset** | все | Период автопродления в **днях** (обнуляет квоту). |
  22. | **Telegram ID**| все | Привязывает клиента к пользователю Telegram для самообслуживания/уведомлений.|
  23. | **Sub ID** | все | Идентификатор подписки, группирующий ссылки этого клиента. |
  24. | **Group** | все | Необязательная группа клиента для организации и массовой фильтрации.|
  25. | **Comment** | все | Произвольная текстовая заметка. |
  26. <Callout type="info">
  27. Достижение лимита **трафика** или **срока действия** отключает клиента; при
  28. автоматическом отключении клиентов панель может автоматически перезапускать
  29. Xray (`restartXrayOnClientDisable`, включено по умолчанию).
  30. </Callout>
  31. ## Лимиты и контроль IP
  32. - Ограничения по **трафику / сроку действия** отключают клиента при достижении;
  33. период **Reset** автоматически обновляет квоту.
  34. - **Limit IP** ограничивает количество одновременных IP-адресов источника.
  35. Контроль осуществляется с помощью Fail2ban — см.
  36. [Безопасность](/docs/operations/security). Вы можете просмотреть недавние
  37. IP-адреса клиента и очистить их из действий клиента.
  38. - **Статус онлайн** и время **последнего входа** отслеживаются по каждому
  39. клиенту (и по каждому узлу в конфигурациях с несколькими узлами).
  40. ## Ссылки для общего доступа и внешние ссылки
  41. У каждого клиента есть ссылки для общего доступа и QR-код для его входящих
  42. подключений, а также объединённая [подписка](/docs/config/subscription). К
  43. клиенту также можно привязать **внешние ссылки** — дополнительные ссылки
  44. `vless://`, `vmess://`, `trojan://`, `ss://`, `hysteria2://` или
  45. `wireguard://`, либо удалённый URL подписки, — чтобы они отображались рядом со
  46. сгенерированными панелью в подписке клиента.
  47. Чтобы точно узнать, что содержит ссылка, вставьте её в
  48. [инспектор ссылок для общего доступа](/docs/config/share-links).
  49. ## Массовые операции
  50. Для управления множеством клиентов одновременно панель поддерживает массовые
  51. операции **создания, включения, отключения, удаления, привязки/отвязки** (к
  52. входящим подключениям), **сброса трафика** и **корректировки** (добавить дни /
  53. добавить байты / задать flow). Операции обслуживания также позволяют удалять
  54. **исчерпанных** клиентов (исчерпана квота/срок действия) и **осиротевших**
  55. клиентов (не привязанных ни к одному входящему подключению).
  56. <Callout type="warn">
  57. Ссылка клиента для общего доступа содержит его учётные данные. Относитесь к
  58. ссылкам и QR-кодам как к паролям и меняйте учётные данные, если что-то из
  59. этого утекло.
  60. </Callout>