Руководство относится к UA Pro 1.5.0 и описывает резервное копирование, перенос, ручное создание конфигурации и загрузку с удалённого адреса. Новая версия использует полный снимок: version в файле конфигурации равен 2.
Перед импортом экспортируйте резервную копию в целевом браузере. Каждый импорт заменяет глобальное правило, весь набор правил доменов, обе библиотеки UA и переключатель резервного правила домена ресурса полным снимком из файла, без поэлементного объединения. "globalRule": null удаляет глобальное правило в целевом браузере.
01Экспорт конфигурации
- Нажмите значок UA Pro на панели инструментов браузера.
- Откройте «Ещё» → «Импорт и экспорт конфигурации».
- Нажмите «Экспорт конфигурации» и сохраните скачанный файл
.json. - Имя файла выглядит примерно так:
ua-switcher-config-2026-11-16.json. Дата в имени создаётся по UTC и может отличаться от местной на один день.
Файл содержит следующие постоянные настройки:
- Глобальное правило и его состояние: включено или приостановлено.
- Весь набор правил доменов и их состояние: включены или приостановлены.
- Пользовательские категории и записи UA.
- Категории и записи добавляемого текста.
- Переключатель «Резервное правило домена ресурса».
Файл не содержит правил вкладок, уже выбранных привязок случайного UA, открытых вкладок, языка интерфейса, темы и настроек плавающей панели. При импорте они не восстанавливаются из копии. Существующие правила вкладок в целевом браузере также не удаляются и могут продолжать иметь приоритет над правилами доменов или глобальным правилом.
Экспортированный файл — читаемый JSON в открытом виде. Если пользовательские UA или категории содержат сведения, которые вы не хотите раскрывать, храните копию в надёжном месте.
02Импорт из локального файла
- В целевом браузере откройте UA Pro → «Ещё» → «Импорт и экспорт конфигурации».
- Сначала нажмите «Экспорт конфигурации», чтобы сохранить исходную конфигурацию целевого браузера для возможного восстановления.
- Нажмите «Импорт конфигурации» и выберите файл
.json. - Прочитайте предупреждение о замене и проверьте количество правил и записей списков. Нажмите «Посмотреть содержимое конфигурации», чтобы проверить полный JSON до подтверждения. При выборе «Отмена» запись не выполняется. После подтверждения дождитесь сообщения «Конфигурация импортирована!». Если настройки изменятся во время подтверждения, расширение попросит повторить операцию.
- Проверьте глобальное правило и правила доменов, пользовательские списки и переключатель резервного правила домена ресурса; проверьте, не имеют ли существующие правила вкладок приоритет над ними. Обновите нужную страницу и проверьте UA.
Расширение сначала проверяет файл, затем пытается установить правила и в конце записывает постоянную конфигурацию. При сбое установки или записи оно пытается восстановить правила, сейчас сохранённые в браузере; если восстановление невозможно, проверьте фактические настройки. При одновременном изменении конфигурации синхронизацией браузера или другими окнами этот процесс не является транзакцией между устройствами.
03Загрузка с удалённого адреса
Удалённая конфигурация использует то же содержимое JSON, что и локальная копия. Загрузка и импорт выполняются вручную один раз; это не подписка с автоматическим обновлением.
- Сначала экспортируйте резервную копию конфигурации или подготовьте файл JSON по инструкции ниже.
- Разместите файл на доступном целевому браузеру HTTPS-сервисе и получите полный адрес, который напрямую возвращает содержимое JSON, например
https://example.com/ua-pro/config.json. Это только пример; замените его своим реальным адресом. - В UA Pro откройте «Ещё» → «Импорт и экспорт конфигурации», разверните «Удалённая конфигурация», вставьте адрес и нажмите «Загрузить».
- После загрузки и проверки формата расширение покажет окно подтверждения и имя удалённого хоста. Нажмите «Посмотреть содержимое конфигурации», чтобы проверить полный фактически скачанный JSON. Подтверждение обновляет настройки по тем же правилам, что и локальный импорт; при отмене импорт не выполняется.
- После изменения файла на сервере для использования нового содержимого нужно снова ввести адрес, загрузить и подтвердить. При повторном открытии панели адрес автоматически не сохраняется.
Допускаются только прямые HTTPS-ссылки; HTTP, имя пользователя или пароль в адресе и фрагменты URL запрещены, перенаправления не выполняются. Запрос не содержит cookies браузера или учётных данных, не отправляет Referer и обходит кэш; поэтому сервис с обязательным cookie входа не подходит. UA Pro не применяет к этому запросу правила UA, настроенные в данном расширении, но другие расширения или сетевые устройства могут его изменить. Адрес может содержать параметры запроса; адреса с токенами доступа храните как пароли. Используйте доверенный адрес и убедитесь, что ответ — непосредственно файл JSON, а не страница входа или HTML-страница с кодом.
Локальный файл и удалённый ответ ограничены каждый размером 128 KiB; удалённое чтение ограничено 10 секундами, учитывается фактически прочитанный объём. В синхронизируемом хранилище браузера также действует меньшая квота на отдельный элемент: даже файл меньше 128 KiB может не сохраниться, если правила или отдельная библиотека слишком велики. При ошибке проверьте, возвращает ли сервер статус 200 и корректный JSON, действителен ли сертификат, нет ли перенаправления и доступна ли сеть.
04Полный пример JSON
Пример ниже можно сохранить как config.json в кодировке UTF-8. Домены и значения UA приведены для примера; перед заменой сохраните резервную копию текущей конфигурации. JSON чувствителен к регистру: строки заключайте в прямые двойные кавычки, не ставьте запятую после последнего элемента и не пишите комментарии внутри JSON.
{
"version": 2,
"type": "ua-switcher-config",
"timestamp": "2026-11-16T06:00:00.000Z",
"data": {
"globalRule": {
"enabled": true,
"mode": "builtin",
"params": {
"os": "Windows",
"uaKey": "Edge 125 (Latest)"
}
},
"domainRules": {
"example.com": {
"enabled": true,
"mode": "custom",
"params": {
"category": "手机示例",
"value": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
}
},
"app.example.com": {
"enabled": true,
"mode": "append",
"params": {
"category": "测试标记",
"value": "MyApp/1.0"
}
},
"random.example.com": {
"enabled": true,
"mode": "random",
"params": {
"pool": "custom:随机示例",
"strategy": "page"
}
},
"paused.example.com": {
"enabled": false,
"mode": "custom",
"params": {
"category": "测试",
"value": "ExampleAgent/1.0"
}
}
},
"userCustomData": {
"手机示例": [
"Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
],
"随机示例": [
"ExampleAgent/1.0",
"ExampleAgent/2.0"
],
"测试": [
"ExampleAgent/1.0"
]
},
"userAppendData": {
"测试标记": [
"MyApp/1.0"
]
},
"resourceDomainFallback": false
}
}
В примере задан один встроенный глобальный UA и четыре правила доменов. Более конкретные правила поддоменов, например app.example.com, имеют приоритет над example.com. Приостановленные правила не участвуют в сопоставлении; вместо них может примениться правило родительского домена или глобальное правило. Распознавание примера UA зависит от конкретного сайта.
05Поля верхнего уровня и замена
| Поле | Пример | Назначение |
|---|---|---|
version |
2 |
Обязательно. Новая версия принимает только числовое значение 2. |
type |
"ua-switcher-config" |
Обязательно. Идентификатор типа конфигурации; должен точно совпадать с этой строкой. |
timestamp |
"2026-11-16T06:00:00.000Z" |
Обязательно. Время UTC с миллисекундами и Z; только для записи, не определяет время вступления правил в силу. |
data |
{ ... } |
Обязательно. Объект с полной конфигурацией и всеми полями следующей таблицы. |
Поля в data |
Правильный формат | Поведение при импорте в этой версии |
|---|---|---|
globalRule |
Объект правила или null |
Объект правила заменяет существующее глобальное правило; null удаляет его. |
domainRules |
{ "域名": 规则对象 } |
Объект целиком заменяет прежние правила доменов; {} очищает их. |
userCustomData |
{ "分类": ["UA", ...] } |
Объект целиком заменяет прежнюю библиотеку пользовательских UA; {} очищает её. |
userAppendData |
{ "分类": ["追加文本", ...] } |
Объект целиком заменяет прежнюю библиотеку добавляемого текста; {} очищает её. |
resourceDomainFallback |
true или false |
Логическое значение JSON: включает или выключает резервное правило домена ресурса. |
Все пять полей обязательны; null допустим только для globalRule. Отсутствующие или неизвестные поля и повторяющиеся ключи JSON отклоняются; старые версии и частичные конфигурации тоже не импортируются. Правила доменов и обе библиотеки заменяются каждая целиком: например, domainRules с одним доменом заменит остальные существующие правила доменов в целевом браузере. Рекомендуется редактировать файл, действительно экспортированный новой версией, полностью сохраняя нужные элементы.
Резервное правило домена ресурса может применить правило по домену назначения запроса ресурса только тогда, когда у основной страницы нет действующего UA вкладки, домена или глобального UA. Это не означает, что все междоменные ресурсы имеют приоритет над правилом основной страницы.
06Как написать объект правила
Глобальное правило и каждое правило домена имеют одинаковую структуру:
{
"enabled": true,
"mode": "custom",
"params": {
"category": "常用",
"value": "ExampleAgent/1.0"
}
}
enabled: true означает включено, false — приостановлено. mode определяет поля params:
6.1 Встроенный UA: builtin
{
"enabled": true,
"mode": "builtin",
"params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}
os и uaKey должны точно соответствовать внутренним предустановленным ключам этой версии расширения; они не обязательно совпадают с переведёнными названиями в интерфейсе. Надёжнее выбрать предустановку в интерфейсе, экспортировать конфигурацию и скопировать соответствующий params. При изменении списка предустановок между версиями проверьте его снова.
6.2 Пользовательский UA: custom
{
"enabled": true,
"mode": "custom",
"params": { "category": "常用", "value": "ExampleAgent/1.0" }
}
value — полная строка UA. category используется для классификации и редактирования в интерфейсе; рекомендуется также включить значение в одноимённую категорию userCustomData. Действующее правило читает собственное значение value; ручной импорт правила не добавляет его автоматически в пользовательскую библиотеку.
6.3 Добавляемый текст: append
{
"enabled": true,
"mode": "append",
"params": { "category": "应用标记", "value": "MyApp/1.0" }
}
Расширение добавляет пробел после исходного UA текущего браузера, затем добавляет value. Рекомендуется также хранить текст в одноимённой категории userAppendData; импорт правила не заполняет список автоматически.
6.4 Случайный UA: random
{
"enabled": true,
"mode": "random",
"params": { "pool": "custom:随机示例", "strategy": "page" }
}
strategy должен быть "page" (выбор при каждой полной загрузке страницы) или "tab" (сохранение для правила и вкладки). Случайный выбор может повторяться; два одинаковых результата подряд не обязательно означают отсутствие нового выбора.
Распространённые значения pool:
| Значение | Источник случайного выбора |
|---|---|
all |
Все встроенные и пользовательские UA и UA, созданные из добавляемого текста |
builtin |
Все встроенные UA |
builtin_desktop, builtin_mobile, builtin_legacy |
Встроенные категории настольных, мобильных или устаревших устройств |
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social |
Соответствующие встроенные категории |
custom |
UA из всех пользовательских категорий |
custom:分类名 |
UA категории, указанной в userCustomData |
append_all |
UA, соответствующие всему добавляемому тексту |
append:分类名 |
UA, соответствующие добавляемому тексту категории, указанной в userAppendData |
Имя категории после двоеточия должно совпадать с ключом библиотеки. Для включённого случайного правила нужны доступные варианты, иначе файл будет отклонён.
07Проверки при ручном редактировании
- В качестве ключей
domainRulesуказывайте домены, напримерexample.comилиshop.example.com, безhttps://, пути, порта и пробелов. Правила доменов также охватывают вложенные поддомены;*.example.comв текущей версии включает и самexample.com, а не только поддомены. - Имена категорий могут быть на китайском языке; это должны быть непустые строки без управляющих символов и опасных символов управления двунаправленным текстом.
__proto__,prototypeиconstructorнельзя использовать как имена категорий. Для UA и добавляемого текста рекомендуются печатные символы ASCII; не используйте переводы строк, табуляцию или другие управляющие символы. Длина одного UA — не более 4096 символов. Прямые двойные кавычки и обратные косые черты в тексте нужно экранировать по правилам JSON. - Каждой категории соответствует массив строк, например
"常用": ["Agent/1.0", "Agent/2.0"]. Сохраняйте квадратные скобки даже для одного элемента. Пустую категорию можно записать как[]. true,falseиnullнельзя заключать в двойные кавычки;"false"— строка, а не логическое значение.- Файл должен содержать корректные UTF-8 и JSON без повторяющихся ключей. Расширение также проверяет структуру, типы полей, правила, имена предустановок и случайные наборы. Правильный синтаксис не гарантирует применимость правила.
Файл конфигурации может изменить UA, который браузер отправляет сайтам. HTTPS защищает передачу, но не гарантирует, что конфигурация сервера соответствует вашим намерениям. Импортируйте файлы только из доверенных источников, проверяйте содержимое до подтверждения и фактический результат после обновления целевой страницы.
08Частые вопросы
| Проблема | Проверка |
|---|---|
| Сообщается о неверном формате файла | Проверьте UTF-8, синтаксис JSON, повторяющиеся ключи, версию, обязательные поля и типы правил; используйте как шаблон экспорт новой версии. |
| Не удалось загрузить удалённую конфигурацию | Проверьте сертификат HTTPS, прямую ссылку, сеть и содержимое ответа; перенаправления, вход через cookie и HTTP запрещены. |
| После импорта стало меньше правил | Правила доменов и обе библиотеки заменяются каждая целиком; восстановите резервную копию, созданную до импорта, или добавьте в новый файл нужные элементы. |
| После импорта пустого глобального правила страница использует другой UA | Проверьте существующие правила вкладок или подходящие правила доменов: они могут иметь приоритет над глобальным правилом. |
| Показан успех, но UA неверный | Проверьте, включено ли правило, корректно ли содержимое, есть ли доступные варианты в случайном наборе и нет ли более приоритетных правил вкладки или домена, затем обновите страницу. |
| При импорте большого объёма данных возникает ошибка хранилища | Размер файла и синхронизируемого хранилища браузера ограничен; сократите правила или списки, повторите попытку и проверьте текущую конфигурацию. |
| Расширение не изменилось после изменения удалённого файла | Удалённая загрузка — разовый ручной импорт; снова введите адрес, загрузите и подтвердите. |