OneXray

Add and Import

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

Use the add menu on the Home page to create local outbound nodes, add subscriptions, scan QR codes, pick files, pick images, or read text from the clipboard.

Manual Input#

Manual input opens the outbound editor. Use it when you want to create a local node directly in OneXray.

The outbound editor writes a single outbound node. At runtime OneXray assigns the active node the reserved proxy tag.

Subscription Link#

Subscription input creates a subscription row and immediately downloads it. The subscription name is read from the URL fragment when available. Empty names become anonymous.

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

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

Платформа	Минимальная версия	Распространение	Скачать
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 запускается и останавливается из UI приложения.

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 используют эту общую конфигурацию.

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

OneXray использует общие форматы обмена данными вместо legacy private import format.

Тип	Формат share
Outbound nodes	Стандартный Xray share link text и QR code, если это поддерживает libXray.
Subscriptions	Обычный HTTPS subscription URL.
Raw Json	JSON text и `.json` file.
Xray Setting	JSON text и `.json` file.
GeoData	Не передается отдельно. Для полной миграции используйте Backup.

Import#

Imported text классифицируется запущенным приложением:

Input	Behavior
`https://...`	Добавляет подписку и обновляет ее.
Standard Xray share text	Импортирует Outbound nodes через libXray.
Other text	Завершается без valid config, если libXray не может прочитать Outbound nodes.

QR image import поддерживает png, jpg и jpeg. Text file import поддерживает txt, json и yaml; такие файлы проходят через те же правила text import.

GeoData

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

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

geosite:CN
geoip:CN

OneXray содержит два built-in GeoData files:

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

Custom GeoData#

Custom rule sets require:

Field	Meaning
Name	Unique name. It becomes the file base name and rule prefix target.
Type	`domain` for geosite-style data or `ip` for geoip-style data.
URL	Download URL for the `.dat` file.

When a custom rule set is added or updated, OneXray downloads the .dat file, asks the host core API to count categories and rules, saves the .dat file, and saves a generated JSON summary.

Auto Update

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

Auto Update controls automatic data refresh after the app has initialized. It does not run during early startup.

Subscription Refresh#

Setting	Meaning
Enable	Refresh outdated subscriptions automatically.
Interval	`1 day`, `3 days`, or `1 week`.
Auto Ping	Ping outbound nodes in a refreshed subscription after updating it.

Refresh keeps the old running config until the user starts VPN again. Updating a subscription replaces the subscription’s stored outbound nodes and updates its timestamp and count.

Develop

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

Эта страница описывает import behavior и runtime data semantics для advanced users и integrations.

Порядок определения import text#

Когда OneXray получает import text из UI приложения, используется такой порядок:

Текст, начинающийся с https://, обрабатывается как subscription URL.
Остальной текст разбирается libXray как Outbound share content.

Import pipeline больше не обрабатывает legacy private import text, GeoData import payloads, Raw Json records или Xray Setting records.

Поддерживаемый import text#

Format	Result
HTTPS subscription URL	Добавляет subscription row, обновляет URL и импортирует Outbound nodes.
Standard Xray share link	Импортирует Outbound nodes через libXray.
Multi-line Xray share text	Импортирует несколько Outbound nodes, если libXray может прочитать content.
Clash.Meta YAML	Импортирует Outbound nodes, если это поддерживает bundled libXray API.
Xray JSON	Импортирует Outbound nodes, если это поддерживает bundled libXray API.

Subscriptions поддерживают только Outbound. Они не создают Raw Json, Xray Setting, GeoData, DNS, routing, inbounds, policy, stats, metrics или logs.

Raw Json

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

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

Эта страница предполагает знание Xray-core. OneXray validates JSON и тестирует его через bundled core API перед сохранением.

Xray-core Config Reference

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

Core > Logs > Xray config file

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

Local Only#

Raw Json is local-only. The Raw Json list always shows a single Local group and does not use subscription grouping. Historical Raw rows with non-local subscription ids are still displayed under Local; database rows are not migrated.

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 and Google#

FlutterFire: firebase_core, firebase_analytics, firebase_crashlytics
Google Play Integrity API
Google services Gradle plugin
Firebase Crashlytics Gradle plugin

Android Platform Libraries#

Apple Platform Packages#

OneXray использует FlutterFire на 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, который можно сохранить, передать и позже импортировать.

Included Data#

Data	Included
Local Xray Settings	Yes
Local outbound nodes	Yes
Raw Json configs	Yes
Subscriptions	Yes, as subscription records and URLs
Subscription node rows	No; they are downloaded again from subscription URLs during restore.
Custom GeoData rows	Yes
Custom GeoData `.dat` and generated `.json` files	Yes
Built-in `geosite` and `geoip` rows	No; they are restored from bundled assets.
Simple Setting preferences	No; kept outside backup data.
Other app preferences	No

File Structure#

Backup files are named by date:

Routing

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

Routing templates для OneXray поддерживаются как Xray Setting JSON files в репозитории OneXray/Routing.

Регион	Template	Custom GeoData dependencies
China	cn.json	`EnhancedGeoSite`, `EnhancedGeoIP`
Iran	ir.json	`IranGeoSite`
Russia	ru.json	`RussiaGeoSite`, `RussiaGeoIP`

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

Откройте Core > GeoData в OneXray.
Добавьте нужные custom GeoData entries с точными именами из таблицы выше.
Откройте соответствующую ссылку JSON template и скопируйте или скачайте JSON.
В OneXray откройте Core > Xray Settings > Add > Raw Edit.
Вставьте template JSON, сохраните его и выберите этот Xray Setting.

Templates содержат name, dns и routing. Они не содержат runtime fields приложения: inbounds, outbounds, log, policy, stats или metrics. Выбранный outbound node по-прежнему добавляется OneXray при запуске VPN как runtime proxy outbound.

Privacy

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

Privacy Policy#

Effective Date: May 1, 2025
Last Updated: June 25, 2026

Thank you for choosing our VPN application (the “App”). We are committed to protecting your privacy and providing a transparent experience. This Privacy Policy explains how we handle information and our commitment to user anonymity.

1. Strict No-Logs Policy#

We maintain a zero-logs policy for VPN traffic. We do not collect, store, or monitor activity data related to your VPN connection, including:

AI Reference

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

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

Core Concepts#

Identifier	Meaning
`CoreConfigType.outbound`	Один local или subscription node.
`CoreConfigType.setting`	Structured Xray Setting, сохраненный OneXray; всегда показывается под Local в списке Xray Setting.
`CoreConfigType.raw`	Full Raw Json config, сохраненный как text; всегда показывается под Local в списке Raw Json.
`Simple`	Built-in 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.

Primary route	Meaning
`/home`	Connection state и node operation.
`/subscriptions`	Subscription source list.
`/core`	Xray-core settings и diagnostics.
`/settings`	App preferences и support.

Secondary pages зарегистрированы под каждым primary route. Например, /home/tun, /core/tun и /settings/tun открывают одну и ту же TUN page, сохраняя выбранный primary section.

OneXray

Add and Import

Manual Input#

Subscription Link#

TUN Setting

TUN#

DNS#

Xray Setting

Разделы#

DNS#

Установка

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

Ping

Share

Import#

GeoData

Custom GeoData#

Auto Update

Subscription Refresh#

Develop

Порядок определения import text#

Поддерживаемый import text#

Raw Json

Local Only#

Credits

Core Runtime#

Application Framework#

Flutter and Dart Packages#

Firebase and Google#

Android Platform Libraries#

Apple Platform Packages#

Log

Xray Logs#

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

Запуск#

Остановка#

Backup and Restore

Included Data#

File Structure#

Routing

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

Privacy

Privacy Policy#

1. Strict No-Logs Policy#

AI Reference

Core Concepts#

Primary Navigation#