# Форматы Xray и совместимость версий

Source: https://onexray.com/ru/docs/configuration/compatibility/
Description: Проверьте форматы JSON и ссылок OneXray, ограничения маршрутов и требования встроенного Xray-core перед импортом.


Эти форматы описывают **OneXray 26.9.3**. Изменения относительно предыдущих версий перечислены в [руководстве по обновлению](https://onexray.com/ru/docs/upgrading/). [Копия конфигураций](https://onexray.com/ru/docs/backup/) — отдельный формат восстановления, а не четвёртый тип импорта конфигурации.

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 не заменяет отсутствующую интеграцию платформы.

## Основания

- Границы импорта определены [контрактами конфигураций](https://onexray.com/ru/docs/configuration/); данные о проверке примеров находятся в манифесте ниже.
- Получение приложения: [установка](https://onexray.com/ru/docs/install/).
- Проверка примеров: libXray `c145d94071088cebd445d7b0f4b1bea35732011e`, Xray-core `v1.260327.1-0.20260908222543-52a412d9e2f5`.
- [Манифест](https://onexray.com/examples/manifest.json): тип импорта, зависимости и замены каждого файла.

Текущий upstream может быть новее встроенного Core. Структура импорта и управляемые поля определяются OneXray, допустимость протоколов — поставляемым libXray. Не смешивайте форматы других клиентов и старый VMessQrCode.

## Ограничения

Общий лимит обычного и продвинутого Custom — три профиля с уникальным именем длиной 1–32 символа и 1–3 начальными пустыми слотами. Продвинутый шаблон может добавлять вспомогательные outbounds; тип при редактировании не меняется. Новых Raw — до трёх; старые записи сверх лимита сохраняются, кнопка добавления скрывается.

Обычному режиму нужны реальные узлы в приложении. Для автоматического/группового выбора требуется достаточно разных подходящих узлов; фиксированный одиночный выбор использует один сервер. Raw содержит свои узлы и не заимствует выбор обычного режима.

Домены примеров и UUID вымышлены. Замените их реквизитами поставщика; это не бесплатные рабочие серверы.