Xray. Управление модулем

Эта статья — продолжение Xray. Быстрый старт. Если вы ещё не установили модуль и не создали первого пользователя — начните с него. Здесь собраны операции над самим модулем: запуск и остановка сервиса, просмотр логов, настройки подключения (порт и маскировочный домен), обновление, переустановка и удаление. Управление пользователями VPN вынесено в отдельную статью — Xray. Управление пользователями.

Шапка страницы и меню действий

В шапке страницы доступны основные действия с модулем — запуск, остановка и перезапуск сервиса. Состояние сервиса отображается индикатором и чипом с версией Xray. В меню с тремя точками рядом — остальные действия: открыть логи, запустить обновление, переустановить или удалить модуль.

Управление сервисом

• «Запустить» — поднимает сервис Xray из остановленного состояния.
• «Остановить» — выключает сервис. Все активные VPN‑подключения разрываются, новые установить не получится.
• «Перезапустить» — останавливает и сразу запускает сервис заново. Открытые соединения сбрасываются.

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

⚠️ Остановка сервиса разрывает все VPN‑подключения

Пока сервис выключен, ни один пользователь не сможет подключиться. Планируйте остановку и перезапуск на окно обслуживания или предупреждайте пользователей заранее.

Пока модуль обновляется, переустанавливается или удаляется, кнопки управления сервисом и меню действий временно недоступны.

Логи модуля

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

Подключение

Страница «Основные» в настройках модуля содержит группу «Подключение» — здесь меняются два параметра, по которым устройства подключаются к серверу: порт и маскировочный домен. По умолчанию их подбирает сама панель при установке, но если подключение по текущему порту или домену перестало работать, их можно сменить, не переустанавливая модуль.

• «Порт» — TCP‑порт, на котором Xray принимает входящие подключения. По умолчанию 8443. Меняйте, если порт занят другим сервисом на хосте или подключение по нему перестало проходить.
• «Маскировочный домен» — реальный публичный сайт, под обычный HTTPS‑трафик к которому маскируется ваш (подробнее о маскировке — в Xray. Как работает сервис). Можно ввести свой домен или выбрать из предложенных в списке: панель подсказывает несколько проверенных сайтов. Указывайте домен без https:// и без порта. Если с текущим доменом подключение перестало работать, переключитесь на другой.

Кнопка сохранения становится активной, только когда вы поменяли порт или домен. По нажатию панель просит подтверждение — это не лишняя предосторожность, а защита от потери связи у всех пользователей сразу.

‼️ Смена порта или домена разрывает все текущие подключения

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

Если модуль установлен с правами «только просмотр», поля группы «Подключение» доступны лишь для чтения — менять настройки может пользователь с правами редактирования.

Обновление модуля

В меню действий выберите «Обновить Xray». Панель проверит, есть ли более свежая версия Xray в репозитории, установит её поверх текущей и перезапустит сервис. Список пользователей и их строки подключения сохраняются — переимпортировать ссылку или пересканировать QR‑код на устройстве не нужно.

Подтверждения у обновления нет — действие запускается сразу. Пока идёт обновление, кнопки управления сервисом и пункты меню недоступны; текущая версия модуля видна на чипе «Xray» в шапке. Если установлена актуальная версия, обновление не запускается — панель сообщит об этом.

Переустановка модуля

В меню действий выберите «Переустановить Xray». Панель попросит подтвердить переустановку в диалоге «Подтвердите переустановку Xray» — нажмите «Подтвердить». Та же версия Xray разворачивается поверх текущей, сервис перезапускается. Список пользователей, их идентификаторы и строки подключения сохраняются — переимпортировать ссылку или пересканировать QR‑код в клиентском приложении не требуется.

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

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

Если у клиентов перестало подключаться после переустановки — в раскрытой строке пользователя заново скопируйте ссылку или пересканируйте QR‑код в клиентском приложении. Если ошибки сохраняются, крайнее средство — полностью удалить модуль и установить его заново.

Удаление модуля

В меню действий выберите «Удалить Xray». Панель попросит подтвердить удаление в диалоге «Подтвердите удаление модуля Xray»: вместе с модулем удаляются все связанные данные, включая настройки пользователей; после повторной установки модуль появится с нуля.

‼️ Удаление модуля стирает всех пользователей VPN

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

После подтверждения панель запускает удаление. По завершении страница модуля возвращается в исходное состояние с кнопкой «Установить».

Что дальше

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