OneXray

TUN Setting

Mon, 01 Jan 0001 00:00:00 +0000

TUN Setting управляет туннелем платформы и сетевыми интерфейсами, которые используются всеми конфигурациями.

TUN#

TUN device — виртуальный сетевой интерфейс. Когда VPN запускается, платформа создает или активирует tunnel и направляет трафик через Xray-core.

DNS#

TUN DNS содержит один IPv4 address и один IPv6 address. Это plain IP addresses без портов.

При запуске эти адреса применяются к tunnel. System DNS queries затем входят в Xray-core и обрабатываются routing и DNS outbound rules.

Xray Setting

Mon, 01 Jan 0001 00:00:00 +0000

Xray Setting — структурированный writer Xray-core JSON в OneXray. Он подходит, когда нужны DNS, FakeDNS, routing, inbounds, outbounds, logs или chain proxy, управляемые через UI.

Финальный runtime config генерируется из этого состояния при запуске VPN. Runtime fixers могут изменить порты, интерфейсы и logs под текущую платформу.

Разделы#

Раздел	Что записывает
Log	`log`
DNS	`dns`
FakeDNS	`fakeDns`
Routing	`routing`
Inbounds	`inbounds`
Outbounds	`outbounds`

DNS#

Страница DNS записывает объект Xray dns.

Поле	Значение
`hosts`	Статические host mappings.
`servers`	Список DNS servers. Каждый server может иметь address, port, domains, expectIPs, skipFallback, clientIP, queryStrategy и tag.
`queryStrategy`	`UseIP`, `UseIPv4` или `UseIPv6`.
`disableCache`	Отключает DNS cache.
`disableFallback`	Отключает fallback server behavior.
`disableFallbackIfMatch`	Останавливает fallback, если сработало domain rule.
`useSystemHosts`	Разрешает Xray использовать system hosts.

Если DNS server имеет непустой tag, OneXray показывает этот tag как вариант inboundTag для routing rules.

Добавление и импорт

Mon, 01 Jan 0001 00:00:00 +0000

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

Ввод#

Ручной ввод#

Ручной ввод открывает редактор outbound. Используйте его, если хотите создать локальный узел прямо в OneXray.

Редактор сохраняет один outbound-узел. Во время запуска OneXray назначает активному узлу зарезервированный runtime tag proxy.

Ссылка подписки#

Ввод подписки создает запись подписки и сразу загружает ее. Имя подписки берется из URL fragment, если он есть. Пустое имя становится anonymous.

Установка

Mon, 01 Jan 0001 00:00:00 +0000

Поддерживаемые платформы#

Платформа	Минимальная версия	Распространение	Скачать
iOS	iOS 15	App Store, IPA	App Store, IPA
macOS	macOS 12	Mac App Store, ZIP	Mac App Store, Universal ZIP
Android	Android 10	Google Play, APK	Google Play, Universal APK
Windows x86_64	Windows 10	EXE, ZIP	EXE, ZIP
Linux x86_64	glibc 2.39	DEB, ZIP	DEB, ZIP
Linux arm64	glibc 2.39	DEB, ZIP	DEB, ZIP

OneXray включает Xray-core и сетевую интеграцию для каждой платформы. Обычно VPN запускается из приложения. В настольные сборки также входит CLI onexray, который управляет запущенным приложением через локальный Automation API.

Ping

Mon, 01 Jan 0001 00:00:00 +0000

Ping settings управляют latency tests узлов и connection checks.

Поле	Значение
URL	Test URL для ping и connection checks.
Timeout	Максимальное ожидание одного теста.

Home page ping, subscription auto-ping и post-start checks используют эту общую конфигурацию.

Sharing

Mon, 01 Jan 0001 00:00:00 +0000

OneXray может делиться конфигами как QR codes, text links или через системный share target.

Поддерживаемые объекты:

Type	Share format
Outbound nodes	Standard Xray share links, если возможно; OneXray URL Scheme для app-native data.
Xray Setting	OneXray URL Scheme с Base64 config data.
Raw Config	OneXray URL Scheme с Base64 raw JSON.
Subscriptions	OneXray subscription link wrapper.
GeoData	OneXray GeoData link.

Common Protocol#

Outbound nodes используют common Xray share-link formats через libXray, если возможно.

GeoData

Mon, 01 Jan 0001 00:00:00 +0000

GeoData предоставляет rule-set files для Xray-core expressions:

geosite:CN
geoip:CN

OneXray имеет два встроенных GeoData файла:

Name	Type	Source
`geosite`	`domain`	latest `dlc.dat` из `v2fly/domain-list-community`
`geoip`	`ip`	latest `geoip.dat` из `v2fly/geoip`

Custom GeoData#

Custom rule sets требуют:

Поле	Значение
Name	Уникальное имя. Оно становится base name файла и целью rule prefix.
Type	`domain` для geosite-style data или `ip` для geoip-style data.
URL	Download URL для `.dat` file.

Когда custom rule set добавляется или обновляется, OneXray загружает .dat file, вызывает host core API для подсчета categories и rules, сохраняет .dat file и generated JSON summary.

Develop

Mon, 01 Jan 0001 00:00:00 +0000

Эта страница описывает интерфейсы для automation tools, AI agents, launchers и integrations.

Порядок определения импорта#

Когда OneXray получает текст из UI import, URL Scheme, CLI или Automation API, используется порядок:

Текст, начинающийся с onexray://onexray.com, разбирается как OneXray URL Scheme.
Текст, начинающийся с https://, разбирается как subscription URL.
Остальной текст разбирается через libXray как Xray share content.

OneXray URL Scheme#

Base:

onexray://onexray.com

Config#

onexray://onexray.com/config/add?type=setting&data=<base64>#<name>
onexray://onexray.com/config/add?type=outbound&data=<base64>#<name>
onexray://onexray.com/config/add?type=raw&data=<base64>#<name>

Query или fragment	Значение
`type`	`setting`, `outbound` или `raw`.
`data`	Base64-encoded UTF-8 config text.
Fragment	Display name. Пустое имя становится `anonymous`.

Значение query data нужно URL-encode после Base64 encoding.

Raw Config

Mon, 01 Jan 0001 00:00:00 +0000

Raw Config хранит полный Xray JSON document. Используйте его, когда структурированные страницы Xray Setting не покрывают нужную функцию Xray-core.

Эта страница предполагает знание Xray-core. Перед сохранением OneXray проверяет JSON и тестирует его через встроенный core API.

Xray-core Config Reference

Самый безопасный поток — скопировать сгенерированный Xray config file:

Settings > Log > Xray config file

Затем редактировать копию как Raw Config.

Обязательные поля#

`name`#

OneXray требует непустое top-level поле name для отображения в списке конфигов.

Subscription Update

Mon, 01 Jan 0001 00:00:00 +0000

Subscription Update управляет автоматическим обновлением данных после запуска Home page. Он не выполняется во время ранней инициализации приложения.

Subscription Refresh#

Setting	Значение
Enable	Автоматически обновлять устаревшие подписки.
Interval	`1 day`, `3 days` или `1 week`.
Auto Ping	Выполнять ping узлов обновленной подписки после обновления.

Refresh сохраняет старый running config до следующего запуска VPN пользователем. Обновление подписки заменяет сохраненные nodes этой подписки и обновляет timestamp и count.

GeoData Refresh#

Setting	Значение
Enable GeoData	Автоматически обновлять system и custom GeoData.
GeoData interval	`1 day`, `3 days` или `1 week`.

System GeoData обновляет geosite и geoip вместе. Custom GeoData rows обновляются по одной, если их timestamp старше выбранного interval.

Credits

Mon, 01 Jan 0001 00:00:00 +0000

OneXray построен на open source runtimes, libraries, platform SDKs и build tools. Эта страница отражает direct third-party components, которые сейчас используются в проекте.

Core Runtime#

Application Framework#

Flutter and Dart Packages#

Firebase, Google, and Ads#

FlutterFire: firebase_core, firebase_analytics, firebase_crashlytics
Google Mobile Ads for Flutter
Google Mobile Ads SDK
Google Play Integrity API
Google services Gradle plugin
Firebase Crashlytics Gradle plugin

Android Platform Libraries#

Apple Platform Packages#

OneXray использует FlutterFire и Google Mobile Ads на Apple platforms. Apple builds resolve Firebase и Google packages через Swift Package Manager, including:

Log

Mon, 01 Jan 0001 00:00:00 +0000

Страница Log показывает diagnostic files.

Item	Значение
App log	Application log OneXray.
Xray access log	Xray-core access log, если включен.
Xray error log	Xray-core error log, если включен.
Xray config file	Финальный generated JSON, который читает Xray-core.

Xray Logs#

Xray logs управляются выбранным Xray Setting или Simple Setting.

Для структурированного Xray Setting:

Xray Setting > Edit Log

Для Simple Setting:

Simple Setting > Log > Enable Log

На macOS с включенным System Extension mode OneXray принудительно отключает Xray logs в runtime configs.

Запуск и остановка

Mon, 01 Jan 0001 00:00:00 +0000

Используйте нижнюю кнопку на главной странице для запуска и остановки VPN.

Запуск#

При запуске outbound-узла OneXray:

Загружает выбранный узел.
Загружает выбранный Xray Setting или записывает встроенный Simple setting.
Применяет chain proxy, если он настроен.
Применяет platform runtime fixes: interface binding, ping port, macOS System Extension log handling.
Записывает Xray JSON runtime config.
Запускает VPN tunnel платформы.
Проверяет latency и node IP information, если доступно.

Остановка#

Остановка VPN закрывает tunnel платформы и очищает running state в приложении.

Backup and Restore

Mon, 01 Jan 0001 00:00:00 +0000

Backup экспортирует данные OneXray в ZIP file, который можно отправить, сохранить и позже импортировать.

Включенные данные#

Data	Included
Local Xray Settings	Да
Local outbound nodes	Да
Raw Configs	Да
Subscriptions	Да, как subscription links
Custom GeoData rows	Да
Custom GeoData `.dat` и generated `.json` files	Да
Subscription node rows	Нет; они загружаются заново из subscription URLs при restore.
Simple Setting preferences	Нет
Other app preferences	Нет

File Structure#

Backup files именуются по дате:

Routing

Mon, 01 Jan 0001 00:00:00 +0000

One-click Import#

Эти ссылки импортируют поддерживаемые routing subscriptions в OneXray.

China CNRouting

Iran IRRouting

Russia RURouting

Как использовать#

Откройте routing link на устройстве с установленным OneXray.
OneXray импортирует его как subscription.
Используйте импортированные nodes или configs на главной странице.

Эти же ссылки можно импортировать из clipboard, file, QR code, CLI или Automation API.

Privacy

Mon, 01 Jan 0001 00:00:00 +0000

Privacy Policy#

Effective Date: May 1, 2025
Last Updated: February 20, 2026

OneXray придерживается no-logs подхода для VPN traffic. Приложение не собирает, не хранит и не отслеживает историю сайтов, исходный IP пользователя, содержимое соединений, объемы трафика или VPN session timestamps.

Analytics and Crash Reports#

OneXray может использовать analytics и crash reporting для диагностики сбоев, улучшения стабильности и понимания качества работы приложения. Эти данные не предназначены для восстановления истории VPN traffic.

AI Reference

Mon, 01 Jan 0001 00:00:00 +0000

Эта страница — компактный machine-readable reference текущего поведения OneXray. Здесь намеренно используются точные identifiers, tags, paths и JSON keys.

Core Concepts#

Identifier	Значение
`CoreConfigType.outbound`	Один локальный или subscription node.
`CoreConfigType.setting`	Структурированный Xray Setting, сохраненный OneXray.
`CoreConfigType.raw`	Полный Raw Config JSON, сохраненный как текст.
`Simple`	Встроенный setting writer с id `-1`.
`proxy`	Runtime tag выбранного exit node.
`chainProxy`	Fixed tag для front или relay node.
`tunIn`	TUN inbound tag.
`pingIn`	HTTP ping inbound tag.
`dnsQuery`	DNS component inbound tag и rule tag.
`dnsOut`	DNS outbound tag и rule tag.
`dnsDoT`	Routing rule tag для port `853`.
`ping`	Routing rule tag для ping traffic.

Import Text Classification#

Prefix или content	Import result
`onexray://onexray.com`	OneXray URL Scheme.
`https://`	Subscription URL.
Other Xray share content	Outbound nodes через libXray.

Text files для UI import: txt, json, yaml.

OneXray

TUN Setting

TUN#

DNS#

Xray Setting

Разделы#

DNS#

Добавление и импорт

Ввод#

Ручной ввод#

Ссылка подписки#

Установка

Поддерживаемые платформы#

Ping

Sharing

Common Protocol#

GeoData

Custom GeoData#

Develop

Порядок определения импорта#

OneXray URL Scheme#

Config#

Raw Config

Обязательные поля#

name#

Subscription Update

Subscription Refresh#

GeoData Refresh#

Credits

Core Runtime#

Application Framework#

Flutter and Dart Packages#

Firebase, Google, and Ads#

Android Platform Libraries#

Apple Platform Packages#

Log

Xray Logs#

Запуск и остановка

Запуск#

Остановка#

Backup and Restore

Включенные данные#

File Structure#

Routing

One-click Import#

Как использовать#

Privacy

Privacy Policy#

Analytics and Crash Reports#

AI Reference

Core Concepts#

Import Text Classification#

`name`#