Форматы Xray и совместимость версий
Эти форматы описывают OneXray 26.11.4. Изменения относительно предыдущих версий перечислены в руководстве по обновлению. Копия конфигураций — отдельный формат восстановления, а не четвёртый тип импорта конфигурации.
OneXray поддерживает импорт outbound, Custom Routing и Raw JSON. У каждого типа свои поля и требования; выбирайте подходящий для задачи путь импорта.
| Возможность | Поведение |
|---|---|
| Импорт outbound/Custom/Raw | Поддерживается |
| Custom: домен, целевой IP, порт, сеть | Поддерживается |
| Local DNS через app-dns-direct | Поддерживается |
| Custom protocol/localOS | Поддерживается |
| Smart/Custom FakeDNS, app-dns-fake | Поддерживается; по умолчанию выключен |
| Продвинутые Custom DNS, sniffing, вспомогательные outbounds и локальные inbounds | Поддерживаются отдельным JSON-шаблоном |
| Восстановление FakeDNS в новом Raw inbound | При объявленном сервере или пуле FakeDNS; существующий sniffing не меняется |
| Приоритет GitHub proxy при прямом доступе к Microsoft | Поддерживается; раньше direct-правил |
Старые версии могут не поддерживать все описанные поля. Если параметр отсутствует или поддерживаемое поле отклоняется, сначала обновите приложение. Не удаляйте условия незаметно для «совместимости»; если нужна старая версия, объясните ограничение и согласуйте альтернативу. Raw не заменяет отсутствующую интеграцию платформы.
Основания
- Границы импорта определены контрактами конфигураций; данные о проверке примеров находятся в манифесте ниже.
- Получение приложения: установка.
- Проверка примеров: libXray
c145d94071088cebd445d7b0f4b1bea35732011e, Xray-corev1.260327.1-0.20260908222543-52a412d9e2f5. - Манифест: тип импорта, зависимости и замены каждого файла.
Текущий upstream может быть новее встроенного Core. Структура импорта и управляемые поля определяются OneXray, допустимость протоколов — поставляемым libXray. Не смешивайте форматы других клиентов и старый VMessQrCode.
Текущий контракт проверен 2026-11-13 по App 26.11.4, исходный код a9c690c3db9818a6c4fc78b74794967553d73048, в сравнении с v26.11.3 (2c66a8bf2277d08aac408d2984e459a3576bbf12). Выбор подключения, форматы импорта, границы DNS и резервная копия v1 не меняются; обновлены настройка, показ сеанса, общие страницы и интеграция рабочего стола. Манифест сохраняет прежние данные о нативной проверке примеров; эта проверка документации не запускает их заново.
Ограничения
Общий лимит обычного и продвинутого Custom — три профиля с уникальным именем длиной 1–32 символа и 1–3 начальными пустыми слотами. Продвинутый шаблон может добавлять вспомогательные outbounds; тип при редактировании не меняется. Новых Raw — до трёх; старые записи сверх лимита сохраняются, кнопка добавления скрывается.
Обычному режиму нужны реальные серверные записи в App. Автоматический выбор/источник сначала ищет достаточно активных читаемых обычных узлов для числа входов; при недостатке может выбрать одну подходящую полную конфигурацию провайдера в том же диапазоне. Фиксированный сервер использует свою запись. Raw содержит собственную прокси-схему и не заимствует обычные узлы.
Домены примеров и UUID вымышлены. Замените их реквизитами поставщика; это не бесплатные рабочие серверы.
Дополнения формата в 26.10.2
Fragment изначально выключен; Smart и каждый обычный Custom сохраняют собственную настройку. Значения и правила шаблонов описаны в руководстве Fragment.
Общий LAN-прокси. Переключатель и порт применяются при следующем запуске или перезапуске из приложения; сохранение не переподключает текущий VPN.
Текущий контракт проверен 2026-11-09 по исходникам App 26.11.3 d9310df057babfaa27840d63cad665c68296d306 в сравнении с v26.11.2 (555e2b738eb8578defe00b5e813e34e010aec816). Манифест сохраняет прежние источники нативной проверки примеров; эта проверка документации не выполняла примеры повторно.
Возможности 26.10.3
Полные подписки Remnawave принимают Xray-объекты/массивы и отдельные режимы App/провайдера. Настройки маршрутов добавляют DNS/резервы, управляемый sniffing и roundRobin/leastPing; Advanced получает ограниченные параметры проб. Нативные фильтры/переопределения кеша и исключения sniffing остаются в Advanced/Raw. Подсказки соответствуют Core v26.10.10: XDNS names/addrs, MASQUE WARP, TLS useSystemCA; Lua не входит в редактор/ресурсы App.
Возможности 26.10.4
- Подключение к серверу добавляет общую политику разрешения и необязательный Happy Eyeballs для Smart, обычного Custom и полного VPN. Расширенные шаблоны, Raw JSON и конфигурации провайдера сохраняют собственные границы.
- Подписки поддерживают свой User-Agent и совместимый default. Неверные полные конфигурации пропускаются отдельно; текущему режиму нужны пригодные записи. Ответ Remnawave не в JSON превращается в обычную подписку только после подтверждения.
- Копия на Apple привязывает выбранный файл или iCloud Drive, предлагая восстановление/перезапись существующих данных. Протокол v1 сохраняет явный UA; общая политика подключения и сортировка остаются на устройстве.
Возможности 26.10.5
- Raw и графы провайдера используют переносимое VPN-дополнение. При отсутствии DNS servers DNS туннеля добавляется только в runtime; явные DNS и правила сохраняются.
- Подсказки JSON учитывают контекст XDrive template/XMUX, MASQUE XMUX, XDNS TLS/QUIC и TLS/ECH/REALITY. Свободные и неизвестные поля сохраняются.
- Управляемый FakeDNS использует IPv6-пул
2001:2::/48; явные пулы и адрес интерфейса TUN не меняются. - Ручные группы и позиции сохраняются необязательными полями копии v1 и не создают автоматических областей подключения.
- Xray-core обновлён до v26.10.21.
Дополнения конфигурации 26.11.1
- Smart/обычный Custom добавляют другие DNS-запросы, по умолчанию через прокси; roundRobin возвращается к полной прокси-цепочке.
- Новые настройки Fragment используют FinalMask, сохраняя авторские старые Fragment/noise. FinalMask доступен Freedom-helper в Advanced.
- Нативные JSON-входы и подсказки охватывают XDrive S3 и Freedom finalRules; подсказки не расширяют проекцию обычных подписок.
- При недостатке здоровых обычных узлов автоматический выбор/источник может использовать одну активную конфигурацию провайдера.
- Копия v1 включает VPN-настройки совпадающей платформы; задания geodata Core остаются под управлением App.
- Xray-core — v26.10.29.
Границы конфигурации 26.11.2
- Для запуска не нужна успешная задержка: успешные результаты приоритетны, неизмеренные узлы, ошибки и тайм-ауты идут по ID после них. Подключение не начинает и не ждёт тестирование.
- Личный Raw JSON и конфигурации провайдера выбираются без экспертного переключателя; Raw добавляется через страницу добавления серверов. Их формат, VPN-адаптация и границы владения не объединяются с обычными узлами.
- Виджет iOS 17+ и Пункт управления iOS 18+ могут в фоне повторно использовать последний подготовленный вход VPN; это не повторная компиляция текущего плана и не проверка всех примеров документации.
- Журналы доступа и ошибок очищаются перед новым запуском Core. Прежние файлы нужно экспортировать до следующего подключения.
- Xray-core — v26.10.31.
26.11.3: DNS и список серверов
- Управляемый DNS по умолчанию использует TCP. Явные резолверы, шаблоны и кеш запросов запуска не преобразуются.
- Advanced-шаблоны принимают loopback с совпадающим тегом; новые шаблоны пересылают другие типы DNS по TCP через прокси к исходному назначению. Старые политики запросов сохраняются.
- Дополнение DNS Raw/провайдера и bootstrap DNS создают TCP URL из IP туннеля; поля туннеля остаются IP-литералами.
- Серверы позволяют тестировать отфильтрованные узлы пакетом; область автоматического подключения выбирается на странице подключения.
- Xray-core остаётся v26.10.31.
26.11.4: интерфейс и рабочий стол
- Настройка показывает два шага; подключение объединяет конфигурацию и показатели сеанса с постоянными заполнителями до запуска.
- Общие страницы упрощают названия и интервалы, учитывают сокращение анимации; Linux использует системное оформление окон.
- Импорт, выбор подключения, границы сохранённых DNS и runtime-входа, а также резервная копия v1 не меняются. Обновление интерфейса не переписывает сохранённые конфигурации или кеш.
- Xray-core — v26.11.9.