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

Source: https://onexray.com/ru/docs/sharing/
Description: Стандартные ссылки, OneXray URL, полный JSON и зависимости GeoData без передачи существующих age-ключей.


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

| Объект | Формат |
| --- | --- |
| Сервер | Ссылка протокола, JSON узла или OneXray |
| Подписка | HTTPS URL или OneXray |
| Собственный маршрут | Полный JSON маршрута или OneXray |
| Raw JSON | Полная конфигурация или OneXray |
| Собственные GeoData | Имя/тип файла и HTTPS URL |
| Копия конфигураций | OneXray-backup.json через страницу резервирования |

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

Ссылки VMess и VLESS соответствуют [стандарту VMessAEAD / VLESS](https://github.com/XTLS/Xray-core/discussions/716). Старые ссылки VMessQrCode (`vmess://Base64(JSON)`) не поддерживаются. Ссылки SS, SOCKS, Trojan и подписки в Base64 / age по-прежнему поддерживаются.

Импорт серверов извлекает только узлы. Полные конфигурации импортируются в редакторе маршрутов или Raw JSON. Копия конфигураций читается через отдельную страницу [резервирования](https://onexray.com/ru/docs/backup/), а не через импорт конфигураций. Старые ZIP-копии не поддерживаются. В отличие от обмена подпиской, копия сохраняет исходные ключи Age и HWID; не публикуйте её как ссылку обмена.

## Ссылки OneXray

```text
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#Name
onexray://onexray.com/dat/add?type=domain|ip&url=<percent-encoded-https-url>#Name
```

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

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

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

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

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

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

Стандартные geoip.dat и geosite.dat не включаются. Обычный Custom экспортирует пустые слоты; продвинутый — также пользовательские вспомогательные outbounds. Ни один не экспортирует созданные proxy-узлы, balancer или определения direct/block приложения. Импорт проверяет зависимости, отклоняет совпадающие имена и удаляет служебное поле geodata до сохранения.

Обычные Custom-маршруты сохраняют и экспортируют адрес локального DNS в стандартной записи `dns.servers` с фиксированным тегом `app-dns-direct`. Сопоставление прямых доменов генерируется приложением при запуске. См. [пример JSON маршрута](https://onexray.com/ru/docs/connect/custom-routing/).

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

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. Продвинутый шаблон нельзя направлять в обычную форму.


