Импорт и обмен

Выбор формата

Ссылки протоколов не представляют все поля Xray. Для их сохранения используйте полный JSON узла или формат OneXray.

Ссылки VMess и VLESS соответствуют стандарту VMessAEAD / VLESS. Старые ссылки VMessQrCode (vmess://Base64(JSON)) не поддерживаются. Поддерживаются ссылки Hysteria2 (hysteria2:// / hy2://), SS, SOCKS, Trojan и подписки в Base64 / age.

Импорт серверов извлекает только узлы. Полные конфигурации импортируются в редакторе маршрутов или Raw JSON. Копия конфигураций читается через отдельную страницу резервирования, а не через импорт конфигураций. Старые ZIP-копии не поддерживаются. В отличие от обмена подпиской, копия сохраняет исходные ключи Age и HWID; не публикуйте её как ссылку обмена.

Ссылки OneXray

onexray://onexray.com/config/add?type=outbound|raw|custom|custom-advanced&data=<percent-encoded-base64-json>#Name
onexray://onexray.com/sub/add?url=<percent-encoded-https-url>&age=x25519|hybrid&panel=generic|remnawave&mode=appManaged|providerManaged&userAgent=<percent-encoded-user-agent>#Name
onexray://onexray.com/dat/add?type=domain|ip&url=<percent-encoded-https-url>#Name

Выберите одно значение из альтернатив. Для незашифрованной подписки age пропускается. Фрагмент задаёт отображаемое имя. Старые типы profile/full/setting не поддерживаются.

age описывает алгоритм; принимающее устройство создаёт свою пару. Существующие публичный и закрытый ключи не передаются. Экспорт подписки также не содержит HWID и его переключателя. Импорт ссылки не включает HWID: принимающий пользователь должен разрешить его для подписки сам.

Необязательный userAgent с percent-encoding сохраняет явно заданный UA источника. При отсутствии или пустом значении принимающее устройство использует совместимый default для любой панели. HWID не включается, секретные ключи не передаются.

Зависимости маршрута

Полная конфигурация может объявить собственные данные:

{
  "geodata": {
    "assets": [
      {"file": "other.dat", "url": "https://example.com/other.dat"}
    ]
  }
}

Это фрагмент зависимостей, не готовая конфигурация. Подставьте реальный URL.

Стандартные geoip.dat и geosite.dat не включаются. Обычный Custom экспортирует пустые слоты, необязательный Fragment и контролируемый dnsOut для прямого/пустого DNS-ответа; Advanced сохраняет также остальные вспомогательные outbounds. Поддерживаемые DNS, sniffing и выбор прокси остаются в формате. Сгенерированные proxy-узлы, runtime-селекторы/fallback balancer и direct/block App не экспортируются. Импорт проверяет зависимости, имена и удаляет служебные метаданные geodata.

Обычные Custom-маршруты сохраняют и экспортируют адрес локального DNS в стандартной записи dns.servers с фиксированным тегом app-dns-direct. Сопоставление прямых доменов генерируется приложением при запуске. См. пример JSON маршрута.

Отправка из приложения

iOS, Android, macOS и Windows открывают системный интерфейс обмена. Linux предлагает явное копирование. Закрытие или отмена панели не закрывает исходную страницу и не считается успешной доставкой. При ошибке показывается доступная причина.

Открытие ссылок

Мобильные/macOS-приложения, Windows EXE/MSIX и Linux DEB регистрируют onexray://. ZIP для Windows/Linux не делает этого автоматически: используйте файл или буфер обмена. При нескольких версиях Mac обработчик выбирает ОС.

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

Обычный Custom использует тип ссылки custom, продвинутый JSON — custom-advanced, полный Raw — raw. Тип отдельного JSON-файла задаётся редактором, а не угадывается по полям DNS. Продвинутый шаблон нельзя направлять в обычную форму.

Для HTTPS-подписок действует отдельное определение формата: полные объекты/массивы Xray сохраняются как конфигурации провайдера без потери DNS/маршрутов. Обычный импорт узла из текста/файла по-прежнему извлекает узлы.

В ссылке подписки panel/mode необязательны: panel по умолчанию generic, режим нового источника может определяться первым ответом. Экспорт включает сохранённые значения. Повторный URL обновляет источник без смены panel/mode. Полная конфигурация отправляется адаптированной Raw-копией. Обычный экспорт сохраняет DNS/sniffing/выбор, но не runtime-теги или результаты проб.

Холодный запуск и перенаправления

Во время инициализации и Setup ссылки подписки временно хранятся в памяти и открываются после готовности интерфейса. Начальное чтение и уведомление используют одно получение: одна ожидающая ссылка открывается один раз. Импорт ждёт закрытия текущего диалога. После завершения или отмены повторное открытие той же ссылки — новое действие.

Если веб-перенаправление оборачивает onexray://, кодируйте весь внутренний URI как один внешний параметр. Сервер должен разобрать/декодировать этот параметр один раз и вернуть исходный URI в Location, сохранив panel, mode, userAgent и фрагмент имени, если они есть. App не может восстановить поля, отброшенные сервером перенаправления.