Системный VPN Android

Откройте Дополнительно → VPN Tunnel → системный VPN Android.

Режим

Списки включения и исключения независимы. Переключение режима не заменяет второй список.

Выбор приложений

В списке можно искать имя или пакет и выбирать приложения. Иконки помогают различать похожие названия. Список обрабатывается локально и не передаётся OneXray.

Для режима «Только выбранные» требуется хотя бы одно установленное приложение. Пустой разрешающий список не означает «все приложения».

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

Разрешения и системные действия

После Setup при входе в основной интерфейс проверяется состояние VPN и запрашиваются недостающие разрешения. На Android 17+ также требуется применимое разрешение локальной сети. Отказ не мешает просматривать приложение; повторить запрос можно со страницы подключения. Возврат на передний план обновляет состояние без повторного открытия диалогов разрешений.

Управлять VPN можно через приложение, уведомление, плитку быстрых настроек и действия значка приложения. Камера запрашивается отдельно только для сканирования QR-кода.

Внешняя автоматизация

Откройте «Внешняя автоматизация» на этой странице, разрешите её и скопируйте токен. По умолчанию функция выключена. Доступны только запуск и остановка VPN, без выбора сервера, обновления подписок и запросов состояния. Это не HTTP API настольной версии.

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

Параметры broadcast

Указывайте Package и Class. START и STOP требуют один и тот же строковый токен в Extra, а не в HTTP-заголовке.

Target: Broadcast Receiver
Package: net.yuandev.onexray
Class: net.yuandev.onexray.automation.VpnAutomationReceiver
START Action: net.yuandev.onexray.action.START_VPN
STOP Action: net.yuandev.onexray.action.STOP_VPN
Extra key: token
Extra type: String

Automate

Добавьте блок Broadcast send, укажите Package и Receiver class из таблицы. Переключите Action в режим выражения (fx) и введите действие в кавычках, например:

"net.yuandev.onexray.action.START_VPN"

В Extras задайте словарь, заменив YOUR_TOKEN полным скопированным токеном:

{"token": "YOUR_TOKEN"}

Остальные поля оставьте пустыми. Блок Delay перед отправкой позволяет заранее вернуться на главный экран. Automate 1.53.2 проверен на Android API 37: фоновый START/STOP, неверный токен и отказ после сброса токена. Другие версии Android и энергосбережение производителей требуют отдельной проверки. Документация Automate.

Tasker

В Send Intent выберите Target Broadcast Receiver, заполните Action, Package и Class. Extra: token:YOUR_TOKEN, либо token:%OneXrayToken, если токен сохранён в переменной. Не добавляйте кавычки или пробелы; остальные поля пустые. Префикс ox_ предотвращает преобразование в число. Tasker не проверялся на устройстве в этой серии тестов; способ заполнения основан на официальной документации.

MacroDroid

Используйте Send Intent, выберите Broadcast и заполните Action, Package и Class. Добавьте Extra типа String с именем token и скопированным значением либо строковой переменной через её выбор в интерфейсе. Остальные поля оставьте пустыми. MacroDroid не проверялся на устройстве; названия полей могут отличаться, поэтому проверьте тип получателя и String.

Токен и ошибки

• Отключение сохраняет токен; после повторного включения задачи можно использовать снова. Сброс требует заменить токен во всех задачах. Эти действия не останавливают текущий VPN.
• Токен относится только к устройству и не попадает в конфигурации или резервные копии. Очистка данных и удаление приложения требуют новой авторизации; восстановление копии сохраняет авторизацию этого устройства. Удаляйте токен перед публикацией сценариев. Обычная переменная не является защищённым хранилищем паролей.
• Повторный START не запускает второй core. STOP отменяет незавершённый запуск и не требует файла конфигурации или разрешений для запуска.
• При отсутствии конфигурации, разрешений или ресурсов приложение не скачивает файлы и не открывается автоматически. Прочитайте уведомление об ошибке и нажмите его для исправления. Если уведомления выключены, проверьте системные настройки и состояние приложения.
• Неверный, отсутствующий или нестроковый токен, а также выключенная автоматизация приводят к молчаливому отказу. «Отправлено» не означает «VPN подключён»: проверяйте уведомление VPN, виджет или приложение.
• Очистка и восстановление блокируют START, но принимают авторизованный STOP. Принудительная остановка, отсутствие разблокировки после перезагрузки, Doze, ограничения производителя и другой always-on/lockdown VPN могут мешать работе; функция их не обходит.