# Первое подключение

Source: https://onexray.com/ru/docs/getting-started/
Description: Выберите прямой регион и исходящий интерфейс на одной странице, разрешите VPN при входе в приложение и добавьте серверы или восстановите конфигурации.


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

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

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

Нажмите кнопку перехода на главный экран, чтобы сохранить настройки. Мастер не переходит дальше автоматически, не запрашивает VPN-разрешение, не импортирует серверы и не запускает VPN. Регион можно изменить позже в [умной маршрутизации](https://onexray.com/ru/docs/connect/smart-routing/).

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

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

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

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

Откройте [Серверы → Добавить серверы](https://onexray.com/ru/docs/servers/import/): подписку, ссылки, файл или JSON узла. На iOS/Android доступно сканирование QR-кодов; импорт файла сразу открывает системный выбор.

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

Если копия уже есть, выберите восстановление на пустой странице подключения или серверов либо откройте **Настройки → Данные → Резервное копирование и восстановление**. Проверьте [предварительный просмотр и подтвердите восстановление](https://onexray.com/ru/docs/backup/). Подписки восстанавливаются как источники без кэша узлов: обновите их для получения серверов. Для полного Raw JSON включите режим эксперта и выберите конфигурацию.

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

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

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

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

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

- Нет доступных серверов или их недостаточно: добавьте и проверьте узлы либо измените область выбора и число входов.
- Нет разрешения: выполните действие авторизации, при необходимости откройте системные настройки и повторите.
- Интерфейс исчез: выберите его в настройках VPN-туннеля. Наличие проверяется перед запуском, а не постоянно.
- Ошибка конфигурации или данных: прочитайте конкретную причину и проверьте [журналы/итоговую конфигурацию](https://onexray.com/ru/docs/advanced/logs/). Отсутствующие данные явно приводят к ошибке; запуск VPN не скачивает GeoData для её обхода.

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