Цей посібник стосується 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 заборонені, перенаправлення не виконуються. Запит не містить файлів cookie браузера чи облікових даних, не надсилає 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 неправильний | Перевірте, чи правило ввімкнене, чи вміст дійсний, чи є доступні варіанти у випадковому наборі та чи немає пріоритетніших правил вкладки або домену, потім оновіть сторінку. |
| Під час імпорту великого обсягу даних виникає помилка сховища | Розмір файлу та синхронізованого сховища браузера обмежений; скоротіть правила або списки, повторіть спробу та перевірте наявну конфігурацію. |
| Розширення не змінилося після зміни віддаленого файлу | Віддалене завантаження — одноразовий ручний імпорт; знову введіть адресу, завантажте й підтвердьте. |