Ръководство за конфигурацията на UA Pro

Импорт, експорт и отдалечена конфигурация

Архивиране, прехвърляне и ръчно създаване на конфигурация и зареждането ѝ от отдалечен адрес.

За версия: UA Pro 1.5.0

Това ръководство се отнася за UA Pro 1.5.0. То описва архивирането, прехвърлянето и ръчното създаване на конфигурация, както и зареждането ѝ от отдалечен адрес. Новата версия използва формат на пълна снимка: version на конфигурационния файл е 2.

Преди импорта експортирайте резервно копие в целевия браузър. Всеки импорт заменя глобалното правило, целия набор от правила по домейн, двете библиотеки с UA и превключвателя за правило по домейна на ресурса с пълната снимка от файла; отделните записи не се обединяват. "globalRule": null означава изчистване на глобалното правило в целевия браузър.

01Експорт на конфигурация

  1. Щракнете върху иконата на UA Pro в лентата с инструменти на браузъра.
  2. Отворете „Още“ → „Импорт/Експорт на конфигурация“.
  3. Щракнете върху „Експорт на конфигурация“ и запазете изтегления файл .json.
  4. Името на файла е подобно на ua-switcher-config-2026-11-16.json. Датата в името се създава по UTC и може да се различава с един ден от местната дата.

Файлът съдържа следните постоянни настройки:

  • Глобалното правило и състоянието му — включено или поставено на пауза.
  • Целия набор от правила по домейн и състоянието им — включени или поставени на пауза.
  • Категории и записи на потребителски UA.
  • Категории и записи на добавян текст.
  • Превключвателя „Правило по домейна на ресурса“.

Файлът не съдържа правила за раздели, вече избрани обвързвания на случаен UA, отворените в момента раздели, езика на интерфейса, темата и настройките на плаващия панел. Тези елементи няма да се възстановят от копието след импорта; импортът не изчиства и съществуващите правила за раздели в целевия браузър, така че те може да продължат да имат предимство пред правилата по домейн или глобалното правило.

Експортираният файл е четим JSON в обикновен текст. Съхранявайте копието сигурно, ако потребителските UA или категории съдържат информация, която не искате да разкривате.

02Импорт от локален файл

  1. В целевия браузър отворете UA Pro → „Още“ → „Импорт/Експорт на конфигурация“.
  2. Първо щракнете върху „Експорт на конфигурация“, за да запазите първоначалната конфигурация на целевия браузър за евентуално възстановяване.
  3. Щракнете върху „Импорт на конфигурация“ и изберете файла .json.
  4. Прочетете предупреждението за замяна и проверете броя на правилата и списъците. Щракнете върху „Преглед на конфигурацията“, за да проверите целия JSON преди потвърждение. Изборът на „Отказ“ не записва нищо. След потвърждението изчакайте съобщението „Конфигурацията е импортирана!“. Ако настройките се променят по време на потвърждаването, разширението ще поиска да повторите операцията.
  5. Проверете глобалното правило и правилата по домейн, потребителските списъци и превключвателя за правило по домейна на ресурса; проверете и дали съществуващи правила за раздели нямат предимство пред тях. Презаредете страниците за проверка и проверете UA.

Разширението първо проверява файла, после се опитва да инсталира правилата и накрая записва постоянната конфигурация. Ако инсталацията или записът се провали, то се опитва да възстанови правилата, записани в момента в браузъра. Ако съобщи, че възстановяването е невъзможно, проверете действителните настройки. Когато синхронизацията на браузъра или друг прозорец променя конфигурацията едновременно, процесът не бива да се разглежда като транзакция между устройства.

03Зареждане от отдалечен адрес

Отдалечената конфигурация използва същото JSON съдържание като локалното резервно копие. Това е еднократно ръчно зареждане и импортиране, а не автоматично обновяван абонамент.

  1. Първо експортирайте резервно копие на конфигурацията или подгответе JSON файл според указанията по-долу.
  2. Поставете файла в HTTPS услуга, достъпна за целевия браузър, и получете пълен адрес, който връща директно JSON съдържанието, например https://example.com/ua-pro/config.json. Адресът е само пример; заменете го със своя действителен адрес.
  3. В UA Pro отворете „Още“ → „Импорт/Експорт на конфигурация“, разгънете „Отдалечена конфигурация“, поставете адреса и щракнете върху „Зареди“.
  4. След успешно зареждане и проверка на формата разширението показва прозорец за потвърждение и името на отдалечения хост. Щракнете върху „Преглед на конфигурацията“, за да проверите целия действително изтеглен JSON. Потвърждението обновява настройките по същите правила като локалния импорт; отказът не импортира.
  5. След промяна на файла на сървъра въведете адреса отново, заредете и потвърдете, за да използвате новото съдържание. При повторно отваряне на панела адресът не се запазва автоматично.

Приемат се само директни HTTPS връзки; не се приемат HTTP, потребителско име или парола в адреса и фрагменти на URL, а пренасочванията не се следват. Заявката не съдържа бисквитки на браузъра или данни за вход, не изпраща Referer и заобикаля кеша; затова услуги, изискващи бисквитка за вход, не са подходящи. UA Pro не прилага към заявката правилата за UA, зададени в това разширение, но други разширения или мрежови устройства все още могат да я променят. Адресът може да съдържа параметри на заявката; пазете адрес с токен за достъп като парола. Използвайте доверен адрес и се уверете, че отговорът е директно JSON файл, а не страница за вход или HTML страница, показваща код.

Локалните файлове и отдалечените отговори са ограничени до 128 KiB всеки; отдалеченото четене е ограничено до 10 секунди и се отчита действително прочетеното съдържание. Синхронизираното хранилище на браузъра има и по-малка квота за отделен елемент, така че файл под 128 KiB пак може да не се запише, ако правилата или отделна библиотека са твърде големи. При грешка проверете дали сървърът връща статус 200 и валиден JSON, дали сертификатът е валиден, дали адресът пренасочва и дали мрежата е достъпна.

04Пълен пример в JSON

Следният пример може да се запази като config.json с кодиране UTF-8. Примерните домейни и стойности на UA са само за пояснение; архивирайте текущата конфигурация преди замяната ѝ. JSON различава главни и малки букви: използвайте двойни кавички за низовете, не поставяйте запетая след последния елемент и не пишете коментари в 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 от правило за раздел, домейн или глобално правило. Това не означава, че всички ресурси от други домейни имат предимство пред правилото на основната страница.

06Как се записват обекти на правила

Глобалното правило и всяко правило по домейн използват една и съща структура:

JSON
{
  "enabled": true,
  "mode": "custom",
  "params": {
    "category": "常用",
    "value": "ExampleAgent/1.0"
  }
}

enabled: true означава включено, а false — поставено на пауза. mode определя полетата на params:

6.1 Вграден UA: builtin

JSON
{
  "enabled": true,
  "mode": "builtin",
  "params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}

os и uaKey трябва да съвпадат точно с вътрешните ключове на предварителните настройки в тази версия на разширението; те не са непременно еднакви с преведените имена в интерфейса. Най-сигурно е да изберете предварителната настройка в интерфейса, да експортирате конфигурацията и да копирате съответния params. Проверявайте отново при промяна на списъка между версиите.

6.2 Потребителски UA: custom

JSON
{
  "enabled": true,
  "mode": "custom",
  "params": { "category": "常用", "value": "ExampleAgent/1.0" }
}

value е пълният низ на UA. category се използва за категоризиране и редактиране в интерфейса; препоръчително е стойността да присъства и в едноименната категория в userCustomData. Действащото правило чете собствения си value; ръчният импорт на правило не добавя автоматично стойността в потребителската библиотека.

6.3 Добавяне на текст: append

JSON
{
  "enabled": true,
  "mode": "append",
  "params": { "category": "应用标记", "value": "MyApp/1.0" }
}

Разширението добавя интервал след оригиналния UA на текущия браузър и след това добавя value. Препоръчително е текстът да се запази и в едноименната категория в userAppendData; импортът на правило не попълва списъка автоматично.

6.4 Случаен UA: random

JSON
{
  "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 сертификата, директната връзка, мрежата и съдържанието на отговора. Пренасочвания, вход с бисквитки и HTTP не са разрешени.
След импорта липсват правила Правилата по домейн и двете библиотеки се заменят като цели набори. Възстановете копието отпреди импорта или добавете в новия файл всички елементи, които искате да запазите.
Импортирано е празно глобално правило, но страницата все още използва друг UA Проверете съществуващите правила за раздели или съвпадащите правила по домейн; те може да имат предимство пред глобалното правило.
Импортът е успешен, но UA е грешен Проверете дали правилото е включено, съдържанието му е валидно, случайният набор има налични елементи и дали има правило за раздел или домейн с по-висок приоритет; след това презаредете страницата.
Грешка в хранилището при импорт на много данни Файлът и синхронизираното хранилище на браузъра имат ограничения на размера. Намалете правилата или списъците и опитайте отново, след което проверете съществуващата конфигурация.
Разширението не се променя след промяна на отдалечения файл Отдалеченото зареждане е еднократен ръчен импорт. Въведете адреса отново, заредете и потвърдете.