Откройте Настройки → Данные → Резервное копирование и восстановление. На пустых страницах подключения и серверов также есть кнопка восстановления. Она открывает страницу внутри текущей вкладки.

OneXray привязывает один файл; для нового файла по умолчанию предлагается имя OneXray-backup.json. Последующие успешные записи заменяют его содержимое. Истории версий, слияния и автоматической двусторонней синхронизации конфигураций нет.

Выбор места хранения

Платформа	Место хранения
iPhone, iPad, macOS, macOS System Extension	Первый вариант — iCloud Drive с контейнером документов OneXray. Можно также выбрать существующий файл или создать новый системным диалогом. Восстановление и автоматическое копирование работают одинаково для обоих вариантов.
Android	Создайте или выберите файл системным диалогом. Google Drive подходит, если его поставщик документов доступен в этом диалоге. OneXray сохраняет разрешение читать и перезаписывать файл; отдельного входа в Google в приложении нет.
Windows EXE, ZIP, MSIX	Выберите папку, уже синхронизируемую OneDrive. OneXray записывает обычный файл; вход в учётную запись и облачную синхронизацию выполняет OneDrive.

В Linux эта функция не отображается. Успешная запись означает, что поставщик хранилища принял файл, а не завершил отправку в облако. Убедитесь, что файл читается на другом устройстве. Сбой сети или поставщика может прервать запись; атомарная замена не гарантируется для всех поставщиков.

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

На Apple используйте Переключить на локальную копию, чтобы выбрать или создать файл, либо Переключить на облачную копию для iCloud Drive. При создании файла iOS предлагает выбрать папку. Храните файл вне каталога данных OneXray, чтобы он сохранился при удалении приложения; после переустановки выберите его заново. Отмена переключения сохраняет текущее место, отвязка и очистка данных не удаляют внешний файл.

Чувствительные данные

Копия не зашифрована. Она может содержать учётные данные узлов, URL подписок, закрытые ключи Age и HWID подписок. Base64 — не шифрование. Ограничьте доступ к файлу, не публикуйте его и не вставляйте в диалог с ИИ. К облачному хранилищу применяются правила его поставщика; файл не отправляется на сервер OneXray.

Состав копии

Включено	Не включено
Добавленные вручную узлы и исходный полный Raw JSON	Кэш узлов подписок и его локальные изменения, результаты тестов и избранное
Названия и URL подписок, явный User-Agent, ключи Age, HWID и состояние его отправки	Загруженные файлы, содержимое и индексы GeoData, журналы, сертификаты и внешние ключи
Названия, типы и исходные конфигурации обычных и расширенных собственных маршрутов	Текущий выбор узла/маршрута/Raw, режим эксперта и выбранный в приложении конечный выход
Параметры Smart и VPN-настройки совпадающей платформы	Имена физических интерфейсов, разрешения ОС, авторизация API/автоматизации и предпочтения приложения
Имена файлов, типы и HTTPS-источники собственных GeoData, включая ожидающие загрузки	Стандартные файлы GeoData и записи их источников

Raw JSON сохраняет собственные определения outbounds. Исключение выбранного в приложении конечного выхода не удаляет узлы из полного Raw. Внешние файлы, на которые ссылается конфигурация, нужно подготовить на принимающем устройстве отдельно.

Автоматическое и ручное копирование

Автоматическое копирование включено по умолчанию. При выборе пустого файла или подтверждении перезаписи первая копия создаётся независимо от переключателя. При восстановлении исходный файл остаётся неизменным, следующий интервал отсчитывается от привязки; время последней успешной записи меняется только после записи. Переключатель управляет последующими автоматическими копиями; ручная запись доступна и при выключенном переключателе.

Интервал не зависит от настройки GeoData: 1, 3 или 7 дней, по умолчанию 3 дня. Приложение проверяет срок при запуске, возвращении на передний план и периодически во время работы. Это не гарантированное фоновое расписание ОС, когда приложение приостановлено или закрыто. Подключение VPN не требуется.

Ошибки автоматического копирования отображаются на странице резервирования и не меняют состояние VPN. Можно повторить вручную. Отключение автоматического копирования не удаляет существующий файл.

Восстановление

1. Выберите место хранения и прочитайте копию. Файл, доступный только в облаке, поставщик хранилища может сначала загрузить.
2. Проверьте предварительный просмотр и подтвердите замену. Восстановление заменяет управляемые конфигурации подключения, а не объединяет их. Перед применением OneXray останавливает VPN. Если остановка не удалась, существующие конфигурации не меняются.
3. Вернитесь в приложение. Выбор сбрасывается в обычный режим с автоматическим выбором и Smart; VPN не запускается. Настройки совпадающей платформы восстанавливаются при наличии, иначе остаются местными. Предпочтения приложения сохраняются.
4. Обновите восстановленные подписки для получения узлов. Ручные узлы и Raw JSON уже входят в копию. Восстановление не запускает обновление подписок и не ждёт тестов узлов.

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

Если GeoData не загружается

Исправные локальные данные с теми же именем файла, типом и URL используются повторно. Другие собственные источники получают состояние ожидания загрузки, не блокируя восстановление или вход на главный экран. Конфликт источников с одинаковым именем показывается до замены. Для стандартных данных используются исправные существующие или встроенные файлы устройства.

Конфигурация, которой нужен отсутствующий файл, сообщает об этой зависимости: правила не удаляются, трафик незаметно не переводится напрямую, загрузка при запуске VPN не выполняется. При необходимости подключитесь с другой рабочей конфигурацией, затем загрузите файлы в разделе GeoData. Автообновление GeoData по-прежнему требует подключённого VPN. До загрузки и индексации ожидающие данные не предоставляют категории автодополнения.

Формат копии и обмен

Копия — JSON версии 1 с идентификатором format: "onexray-backup", а не старый ZIP-архив. Поддерживаются файлы до 64 MiB. Используйте страницу резервного копирования, а не импорт узлов, собственных маршрутов или Raw JSON.

Для отдельных конфигураций используйте обмен и импорт. В отличие от обмена подпиской, копия намеренно сохраняет закрытые ключи Age и HWID для восстановления. ИИ должен создавать документированные форматы конфигураций, а не выдуманный файл резервной копии.

Поля копии и совместимость

Протокол остаётся v1 и сохраняет panel/mode подписки, поддерживаемые DNS/sniffing/выбор Smart. При отсутствии полей используются Generic/App-managed и прежние defaults. Кеш провайдера и производные узлы не копируются: после восстановления обновите подписку. Личные Raw-копии сохраняются как обычные записи. Неизвестные поля игнорируются и не экспортируются повторно; формат, версия, разделы, известные типы и явные enum проверяются. Пробы runtime и удалённые регионы не сохраняются. Старые внутренние обычные DNS-фильтры/тайм-ауты/кеш/параллельность и исключения sniffing больше не используются; внешний обычный JSON проверяется строго.

Протокол v1 сохраняет явный User-Agent подписки. Без него используется совместимое значение принимающего устройства. Сортировка списка остаётся локальной; дозвон к серверу входит в совпадающий платформенный раздел.

Протокол v1 также сохраняет именованные ручные группы, включая пустые, их порядок, принадлежность узлов и позиции внутри групп. Старые копии без этих необязательных полей восстанавливают ручные узлы без группы в прежнем порядке. Группы организуют записи, а не выбор подключения; восстановление не создаёт автоматического подключения по группе.

Платформенные настройки VPN

Протокол v1 допускает platformSettings с отдельными ключами ios, macos, android, windows, linux. Копия записывает переносимые настройки текущей платформы; восстановление читает и проверяет только совпадающий ключ. iOS и macOS не совпадают; OneXraySE использует macos, все варианты Windows — windows. Это не добавляет экран копирования в Linux.

Раздел содержит IPv6, DNS туннеля, дозвон к серверу, LAN-прокси, параметры журналов и VPN-политику данной платформы. Android сохраняет режим доступа и оба списка имён пакетов: включённых и исключённых, в том числе ещё не установленных. Другие разделы не меняют местные настройки. Отсутствующий раздел или параметр сохраняет значение принимающего устройства; неверный совпадающий раздел отклоняется до замены.

Имена физических исходящих интерфейсов, разрешения ОС, авторизация API/автоматизации, оформление и место хранения копии остаются локальными. После подтверждения подходящие настройки восстанавливаются вместе с конфигурациями, с предварительной остановкой VPN; автоматического переподключения нет.