Xray. Управление пользователями

В этой статье — операции со списком пользователей VPN: как устроен список, как получить ссылку для подключения, отредактировать пользователя, временно отключить или удалить и докупить слоты сверх бесплатной квоты. Минимальный сценарий «установить модуль и подключить первое устройство» описан в Xray. Быстрый старт; здесь разбираем подробнее.

Список пользователей

Список открывается на странице модуля Xray по умолчанию и содержит всех созданных пользователей с актуальным состоянием каждого. Над списком виден остаток свободных слотов лицензии — он подсказывает, есть ли место для нового пользователя. Заводят пользователя кнопкой «Создать пользователя»; на лимите кнопка становится неактивной, а подсказка объясняет причину. Подробнее про лимит и слоты — в разделе Лимит пользователей.

Каждый пользователь — отдельная строка, которая раскрывается по клику. В свёрнутом виде она держит имя, адрес электронной почты и переключатель «Включён» для временной деактивации. Действия с пользователем открываются, когда строка раскрыта: нажмите её, чтобы развернуть.

Если пользователей ещё нет

Сразу после установки список пуст: панель показывает карточку «Здесь пока пусто» с предложением создать первого пользователя и кнопкой «Создать пользователя». После создания первого пользователя карточка пропадает, а на её месте появляется обычный список.

Раскрытая строка пользователя

Раскрытая строка — место, где пользователь получает конфигурацию для устройства и где живут действия над ним.

QR‑код и ссылка для подключения

Сразу под аватаром строка показывает QR‑код — он содержит ссылку вида vless://… для Xray‑совместимого клиента. Покажите этот QR‑код пользователю на экране для сканирования камерой устройства — либо сохраните файл изображения кнопкой «QR‑код» и отправьте удобным способом. Кнопка «Ссылка» копирует ту же строку vless://… в буфер обмена. Если открыли панель с того же устройства, на котором будете подключаться, — скопируйте ссылку напрямую: панель кладёт её в буфер, и можно вставить в клиент без камеры.

Файл .conf у Xray не используется — клиенты принимают только ссылку или QR‑код с той же ссылкой.

Отправка на почту

Кнопка «На почту» отправляет ссылку для подключения на адрес из карточки пользователя. Доступна, если в панели настроен SMTP. Если SMTP не настроен, в раскрытой строке появляется подсказка «Отправка писем с сервера не настроена.» со ссылкой «К настройкам» — она ведёт на системные настройки панели, где включается SMTP‑релей. До тех пор, пока релей не настроен, кнопка «На почту» остаётся неактивной; копирование ссылки и скачивание QR‑кода работают независимо. Подробнее о настройке релея — в статье Как настроить SMTP‑релей для отправки писем.

Редактирование и удаление

Кнопка «Редактировать» открывает диалог с настройками пользователя (подробнее — в разделе Редактирование пользователя). Кнопка «Удалить» запускает удаление — подробнее в разделе Удаление пользователя.

Плитки с электронной почтой и статистикой трафика

Под кнопками — плитка с адресом электронной почты пользователя и две плитки со статистикой трафика по этому пользователю: входящий и исходящий. Счётчики берутся из статистики Xray, обновляются автоматически и показывают накопленный объём с момента запуска сервиса. При перезапуске сервиса Xray счётчики обнуляются.

Создание пользователя

Минимальный сценарий описан в Xray. Быстрый старт: откройте диалог кнопкой «Создать пользователя» в шапке списка и заполните поля «Электронная почта» и «Имя» — оба обязательные. Опционально выберите «Язык пользователя» для письма со ссылкой; переключатель «Включён» в подвале управляет состоянием пользователя сразу после создания. Кнопка «Создать» активна, пока оба обязательных поля заполнены без ошибок валидации и пока в лицензии есть свободный слот (см. Лимит пользователей).

⚠️ Ограничения провайдеров

Шифрование трафика делает VPN надёжным средством защиты подключения, но в ряде стран и регионов провайдеры применяют технические меры против VPN-протоколов. Из-за этого стопроцентная доступность сервиса не гарантируется — независимо от типа подключения. Если один протокол не подходит, попробуйте другой модуль VPN из панели. Если ни один не работает в вашей сети, напишите в поддержку — оформим возврат средств за лицензию.

Редактирование пользователя

В раскрытой строке нажмите «Редактировать» — откроется диалог «Редактировать пользователя».

В диалоге доступны для изменения:

• «Электронная почта» — идентификатор пользователя в Xray. Редактируется по тем же правилам, что и при создании: адрес должен быть валидным и уникальным среди уже существующих пользователей.
• «Имя» — произвольная подпись для удобной навигации по списку.
• «Язык пользователя» — язык письма со ссылкой для подключения. По умолчанию — «Английский».
• «Включён» — позволяет временно выключить учётную запись, не удаляя её.

Кнопка «Сохранить» активна, только если в форме что‑то изменилось по сравнению с текущим состоянием.

ℹ️ Смена адреса электронной почты у активных подключений

Адрес электронной почты — это идентификатор пользователя в Xray, и он зашит в ссылку для подключения. Если у пользователя уже сохранена ссылка в клиентском приложении, после смены адреса на стороне сервера она перестанет подходить: чтобы клиент продолжил подключаться, заберите новую ссылку из раскрытой строки и переимпортируйте её в приложении.

Включение и отключение пользователя

В строке пользователя есть переключатель — одно нажатие включает или отключает учётную запись без открытия диалога. Отключённый пользователь остаётся в списке, статистика трафика по нему сохраняется, но подключиться под его ссылкой нельзя. Изменения применяются сразу, перезапуск сервиса не требуется.

При повторном включении ссылка не меняется: та же строка vless://…, что уже была сохранена в клиентском приложении, снова заработает.

Удаление пользователя

В раскрытой строке нажмите «Удалить». Панель попросит подтвердить действие в диалоге «Удалить пользователя» с указанием адреса удаляемого пользователя. После подтверждения слот лицензии освобождается — на освободившееся место можно создать другого пользователя.

‼️ Удаление пользователя необратимо

После подтверждения учётная запись и её идентификатор теряются навсегда. Ссылка vless://…, которая была импортирована в клиентское приложение, перестаёт работать. Восстановить пользователя «как был» нельзя — даже если создать нового с тем же адресом, идентификатор внутри ссылки сменится, и клиенту придётся импортировать новую конфигурацию.

Лимит пользователей

ℹ️ На бесплатной лицензии доступен один пользователь

В тарифе по умолчанию модуль Xray позволяет создать одного пользователя VPN — этого хватает на одно устройство, например личный смартфон. Для нескольких устройств или членов семьи понадобится докупить дополнительные слоты.

Что меняется на разных уровнях занятости квоты:

• В пределах квоты (N < M) — создавайте новых пользователей свободно.
• Достигнут лимит (N = M) — новых пользователей больше не создать. Чтобы продолжить — докупите слоты ссылкой «Докупить слоты» прямо в плитке либо удалите ненужных пользователей.
• Сверх лимита (N > M, например после понижения тарифа) — самые недавно созданные пользователи остаются в списке, но без рабочей конфигурации: ссылка и QR‑код им не выдаются, отправка письмом и редактирование тоже недоступны. Чтобы вернуть им работу — докупите слоты или удалите лишних пользователей.

Ссылка «Докупить слоты» ведёт в раздел «Лицензия» — на оформление новой лицензии, если её ещё нет, или на изменение существующей с предзаполненным количеством слотов. Лицензия суммируется с бесплатной квотой: если в лицензии указано, например, 5 слотов, всего у вас будет 6 пользователей (1 бесплатный + 5 по лицензии). В разделе «Лицензия» эта возможность отображается под человекочитаемой меткой «Xray VPN».

Что дальше

• Xray. Быстрый старт — установка модуля и первое подключение.
• Xray. Управление модулем — управление сервисом, обновление и удаление модуля.
• Как настроить SMTP‑релей для отправки писем — чтобы можно было отправлять пользователям ссылку для подключения на почту.