# Резервное копирование

Source: https://onexray.com/ru/docs/backup/
Description: Один заменяемый файл конфигураций в iCloud, через системный выбор файла Android или в папке OneDrive. Восстановление без ожидания загрузки GeoData.


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

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

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

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

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

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

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

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

## Состав копии

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

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

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

Автоматическое копирование включено по умолчанию, но запись невозможна до подтверждения места хранения. Если функция включена, подтверждение создаёт первую копию. Можно отключить её и выполнять копирование вручную.

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

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

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

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

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

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

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

Конфигурация, которой нужен отсутствующий файл, сообщает об этой зависимости: правила не удаляются, трафик незаметно не переводится напрямую, загрузка при запуске VPN не выполняется. При необходимости подключитесь с другой рабочей конфигурацией, затем загрузите файлы в разделе [GeoData](https://onexray.com/ru/docs/advanced/geodata/). Автообновление GeoData по-прежнему требует подключённого VPN. До загрузки и индексации ожидающие данные не предоставляют категории автодополнения.

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

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

Для отдельных конфигураций используйте [обмен и импорт](https://onexray.com/ru/docs/sharing/). В отличие от обмена подпиской, копия намеренно сохраняет закрытые ключи Age и HWID для восстановления. ИИ должен создавать документированные [форматы конфигураций](https://onexray.com/ru/docs/configuration/), а не выдуманный файл резервной копии.