1. Пройдите два шага настройки

Прочитайте уведомление о конфиденциальности и согласитесь продолжить. На странице подготовки к подключению дождитесь создания локальной конфигурации и встроенных данных:

• Страна или регион задаёт прямые правила умной маршрутизации, а не местоположение VPN-сервера. Можно выбрать один регион, очистить выбор или ничего не менять, сохранив прежнюю настройку. Исходное значение новой установки — материковый Китай.
• На Windows/Linux явно выберите исходящий интерфейс Xray на этой же странице. Отметка текущего интернет-адаптера служит подсказкой, но не выбирает его автоматически. На Apple и Android этого пункта нет.

Нажмите кнопку перехода на главный экран, чтобы сохранить настройки. Мастер не переходит дальше автоматически, не запрашивает VPN-разрешение, не импортирует серверы и не запускает VPN. Регион можно изменить позже в умной маршрутизации.

2. Разрешите VPN при входе в основной интерфейс

При инициализации основного интерфейса приложение читает состояние VPN и один раз запрашивает недостающие разрешения, даже если серверов ещё нет. Apple запрашивает добавление VPN-конфигурации; OneXraySE также может потребовать одобрения System Extension. На Android 17 и новее проверяется разрешение локальной сети.

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

3. Добавьте серверы или восстановите копию

Откройте Серверы → Добавить серверы: подписку, ссылки, файл или JSON узла. На iOS/Android доступно сканирование QR-кодов; импорт файла сразу открывает системный выбор.

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

Если копия уже есть, выберите восстановление на пустой странице подключения или серверов либо откройте Настройки → Данные → Резервное копирование и восстановление. Проверьте предварительный просмотр и подтвердите восстановление. Подписки восстанавливаются как источники без кэша узлов: обновите их для получения серверов. Для полного Raw JSON включите режим эксперта и выберите конфигурацию.

Восстановление не запускает VPN. Отсутствующие собственные GeoData не мешают входу на главный экран, но требуются до запуска зависимой конфигурации.

4. Выберите маршрут и подключитесь

На странице подключения выберите источник серверов и способ обработки трафика. Можно начать с автоматического выбора и умной маршрутизации, либо выбрать один сервер и «Всё через VPN» для проверки. Автоматический выбор требует подходящих работоспособных узлов с результатами тестирования.

Запустите VPN и дождитесь подключения. Кнопка показывает ожидание разрешений, очереди и изменения соединения. Трафик обновляется, пока страница и окно видимы; потеря фокуса настольного окна не останавливает обновление.

Если что-то не готово

• Нет доступных серверов или их недостаточно: добавьте и проверьте узлы либо измените область выбора и число входов.
• Нет разрешения: выполните действие авторизации, при необходимости откройте системные настройки и повторите.
• Интерфейс исчез: выберите его в настройках VPN-туннеля. Наличие проверяется перед запуском, а не постоянно.
• Ошибка конфигурации или данных: прочитайте конкретную причину и проверьте журналы/итоговую конфигурацию. Отсутствующие данные явно приводят к ошибке; запуск VPN не скачивает GeoData для её обхода.

Обычный запуск снова проверяет необходимые условия. При смене активной конфигурации старый VPN сначала останавливается; при неудаче новой связи он автоматически не восстанавливается.