Sprievodca konfiguráciou UA Pro

Import, export a vzdialená konfigurácia

Zálohovanie, prenos a ručné vytváranie konfigurácie a jej načítanie zo vzdialenej adresy.

Platí pre: UA Pro 1.5.0

Tento sprievodca platí pre UA Pro 1.5.0. Opisuje zálohovanie, prenos a ručné vytváranie konfigurácie a jej načítanie zo vzdialenej adresy. Nová verzia používa formát úplnej snímky: version konfiguračného súboru má hodnotu 2.

Pred importom exportujte zálohu v cieľovom prehliadači. Každý import nahradí globálne pravidlo, celú súpravu pravidiel domén, obe knižnice UA a prepínač náhradného pravidla domény zdroja úplnou snímkou zo súboru; jednotlivé položky sa nezlučujú. "globalRule": null znamená odstránenie globálneho pravidla v cieľovom prehliadači.

01Export konfigurácie

  1. Kliknite na ikonu UA Pro na paneli nástrojov prehliadača.
  2. Otvorte „Viac“ → „Importovať/exportovať konfiguráciu“.
  3. Kliknite na „Exportovať konfiguráciu“ a uložte stiahnutý súbor .json.
  4. Názov súboru vyzerá napríklad ako ua-switcher-config-2026-11-16.json. Dátum v názve sa vytvára podľa UTC a môže sa o jeden deň líšiť od miestneho dátumu.

Súbor obsahuje tieto trvalé nastavenia:

  • Globálne pravidlo a jeho zapnutý alebo pozastavený stav.
  • Celú súpravu pravidiel domén a ich zapnutý alebo pozastavený stav.
  • Kategórie a položky vlastných UA.
  • Kategórie a položky pripájaného textu.
  • Prepínač „Náhradné pravidlo domény zdroja“.

Súbor neobsahuje pravidlá kariet, už vyžrebované priradenia náhodných UA, práve otvorené karty, jazyk rozhrania, motív ani nastavenia prekryvného panela. Tieto položky sa po importe zo zálohy neobnovia; import tiež neodstráni pravidlá kariet už existujúce v cieľovom prehliadači, takže môžu mať naďalej prednosť pred pravidlami domén alebo globálnym pravidlom.

Exportovaný súbor je čitateľný JSON v obyčajnom texte. Ak vlastné UA alebo kategórie obsahujú údaje, ktoré nechcete zverejniť, zálohu bezpečne uložte.

02Import z lokálneho súboru

  1. V cieľovom prehliadači otvorte UA Pro → „Viac“ → „Importovať/exportovať konfiguráciu“.
  2. Najprv kliknite na „Exportovať konfiguráciu“, aby ste pôvodnú konfiguráciu cieľového prehliadača zachovali na prípadné obnovenie.
  3. Kliknite na „Importovať konfiguráciu“ a vyberte súbor .json.
  4. Prečítajte si upozornenie na nahradenie a skontrolujte počty pravidiel a zoznamov. Kliknutím na „Zobraziť obsah konfigurácie“ si pred potvrdením prezriete celý JSON. Voľba „Zrušiť“ nič nezapíše. Po potvrdení počkajte na správu „Konfigurácia je importovaná!“. Ak sa nastavenia počas potvrdzovania zmenia, rozšírenie vás požiada o zopakovanie postupu.
  5. Skontrolujte globálne pravidlo a pravidlá domén, vlastné zoznamy a prepínač náhradného pravidla domény zdroja; overte tiež, či pred nimi nemajú prednosť existujúce pravidlá kariet. Obnovte stránky, ktoré chcete otestovať, a overte UA.

Rozšírenie najprv skontroluje súbor, potom sa pokúsi nainštalovať pravidlá a napokon zapíše trvalú konfiguráciu. Ak inštalácia alebo zápis zlyhá, pokúsi sa obnoviť pravidlá aktuálne uložené v prehliadači. Ak oznámi, že obnovenie nie je možné, skontrolujte skutočné nastavenia. Ak synchronizácia prehliadača alebo iné okno súčasne mení konfiguráciu, tento postup nemožno chápať ako transakciu medzi zariadeniami.

03Načítanie zo vzdialenej adresy

Vzdialená konfigurácia používa rovnaký obsah JSON ako lokálna záloha. Ide o jednorazové ručné načítanie a import, nie o automaticky aktualizované predplatné.

  1. Najprv exportujte zálohu konfigurácie alebo pripravte súbor JSON podľa nasledujúcich pokynov.
  2. Umiestnite súbor na službu HTTPS dostupnú cieľovému prehliadaču a získajte úplnú adresu, ktorá priamo vracia obsah JSON, napríklad https://example.com/ua-pro/config.json. Táto adresa je iba príklad; nahraďte ju svojou skutočnou adresou.
  3. V UA Pro otvorte „Viac“ → „Importovať/exportovať konfiguráciu“, rozbaľte „Vzdialená konfigurácia“, vložte adresu a kliknite na „Načítať“.
  4. Po úspešnom načítaní a kontrole formátu rozšírenie zobrazí potvrdzovacie okno a názov vzdialeného hostiteľa. Kliknutím na „Zobraziť obsah konfigurácie“ skontrolujete celý skutočne stiahnutý JSON. Potvrdenie aktualizuje nastavenia podľa rovnakých pravidiel ako lokálny import; zrušenie import nevykoná.
  5. Po zmene súboru na serveri znova zadajte adresu, načítajte ju a potvrďte, ak chcete použiť nový obsah. Po opätovnom otvorení panela sa adresa automaticky nezachová.

Prijímajú sa iba priame odkazy HTTPS; HTTP, používateľské meno alebo heslo v adrese ani fragmenty URL nie sú povolené a presmerovania sa nenasledujú. Požiadavka neobsahuje súbory cookie prehliadača ani prihlasovacie údaje, neposiela Referer a obchádza vyrovnávaciu pamäť; služby vyžadujúce prihlasovacie cookie preto nie sú vhodné. UA Pro na túto požiadavku nepoužije pravidlá UA nastavené v tomto rozšírení, iné rozšírenia alebo sieťové zariadenia ju však môžu zmeniť. Adresa môže obsahovať parametre dopytu; adresu s prístupovým tokenom chráňte ako heslo. Použite dôveryhodnú adresu a overte, že odpoveďou je priamo súbor JSON, nie prihlasovacia stránka alebo stránka HTML zobrazujúca kód.

Lokálne súbory aj vzdialené odpovede sú obmedzené na 128 KiB; vzdialené čítanie má limit 10 sekúnd a počíta sa skutočne prečítaný obsah. Synchronizované úložisko prehliadača má aj menšiu kvótu na jednotlivú položku, takže súbor menší ako 128 KiB sa napriek tomu nemusí uložiť, ak sú pravidlá alebo jedna knižnica príliš veľké. Pri chybe overte, či server vracia stav 200 a platný JSON, či je certifikát platný, či adresa nepresmerúva a či je sieť dostupná.

04Úplný príklad JSON

Nasledujúci príklad možno uložiť ako config.json v kódovaní UTF-8. Príkladové domény a hodnoty UA slúžia iba na ilustráciu; pred nahradením súčasnej konfigurácie ju zálohujte. JSON rozlišuje malé a veľké písmená: reťazce zapisujte do dvojitých úvodzoviek, za poslednú položku nedávajte čiarku a do JSON nevkladajte komentáre.

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
  }
}

Tento príklad nastaví jeden vstavaný globálny UA a štyri pravidlá domén. Konkrétnejšie pravidlá subdomén, napríklad app.example.com, majú prednosť pred example.com. Pozastavené pravidlá sa nezúčastňujú aktívneho vyhodnocovania, takže môže nastúpiť pravidlo nadradenej domény alebo globálne pravidlo. Či skutočný web príkladový UA rozpozná, závisí od daného webu.

05Polia najvyššej úrovne a nahrádzanie

Pole Príklad Účel
version 2 Povinné. Nová verzia prijíma iba číselnú hodnotu 2.
type "ua-switcher-config" Povinné. Identifikátor typu konfigurácie; musí presne zodpovedať tomuto reťazcu.
timestamp "2026-11-16T06:00:00.000Z" Povinné. Čas UTC s milisekundami a Z; slúži iba ako záznam, neurčuje čas účinnosti pravidiel.
data { ... } Povinné. Objekt s úplnou konfiguráciou obsahujúci všetky polia nasledujúcej tabuľky.
Polia v data Správny formát Správanie importu v tejto verzii
globalRule Jeden objekt pravidla alebo null Objekt pravidla nahradí existujúce globálne pravidlo; null ho odstráni.
domainRules { "域名": 规则对象 } Celý objekt nahradí doterajšie pravidlá domén; {} ich vymaže.
userCustomData { "分类": ["UA", ...] } Celý objekt nahradí doterajšiu knižnicu vlastných UA; {} ju vyprázdni.
userAppendData { "分类": ["追加文本", ...] } Celý objekt nahradí doterajšiu knižnicu pripájaného textu; {} ju vyprázdni.
resourceDomainFallback true alebo false Logická hodnota JSON: zapína alebo vypína náhradné pravidlo domény zdroja.

Všetkých päť polí je povinných; null možno použiť iba pri globalRule. Chýbajúce a neznáme polia aj duplicitné kľúče JSON sa odmietnu; neimportujú sa ani čiastočné konfigurácie alebo konfigurácie starších verzií. Pravidlá domén a obe knižnice sa nahrádzajú ako celé súpravy: napríklad domainRules obsahujúci jedinú doménu nahradí ostatné existujúce pravidlá domén v cieľovom prehliadači. Odporúčame upravovať skutočný súbor exportovaný novou verziou a úplne zachovať potrebné položky.

Náhradné pravidlo domény zdroja môže použiť pravidlo podľa cieľovej domény požiadavky na zdroj iba vtedy, keď hlavná stránka nemá aktívny UA z pravidla karty, domény ani globálneho pravidla. Neznamená to, že všetky zdroje z iných domén prepíšu pravidlo hlavnej stránky.

06Ako zapísať objekty pravidiel

Globálne pravidlo aj každé pravidlo domény používajú rovnakú štruktúru:

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

enabled: true znamená zapnuté a false pozastavené. mode určuje polia objektu params:

6.1 Vstavaný UA: builtin

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

os a uaKey musia presne zodpovedať interným kľúčom predvolieb tejto verzie rozšírenia; nemusia byť rovnaké ako preložené názvy v rozhraní. Najbezpečnejšie je vybrať predvoľbu v rozhraní, exportovať konfiguráciu a skopírovať príslušný params. Pri zmene zoznamu predvolieb medzi verziami ich znova overte.

6.2 Vlastný UA: custom

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

value je úplný reťazec UA. category slúži na kategorizáciu a úpravy v rozhraní; odporúčame hodnotu zahrnúť aj do rovnomennej kategórie v userCustomData. Účinné pravidlo číta vlastné value; ručný import pravidla hodnotu automaticky nepridá do vlastnej knižnice.

6.3 Pripojenie textu: append

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

Rozšírenie pridá medzeru za pôvodný UA aktuálneho prehliadača a potom pripojí value. Odporúčame tento text ponechať aj v rovnomennej kategórii v userAppendData; import pravidla zoznam automaticky nenaplní.

6.4 Náhodný UA: random

JSON
{
  "enabled": true,
  "mode": "random",
  "params": { "pool": "custom:随机示例", "strategy": "page" }
}

strategy musí byť "page" (výber pri každom úplnom načítaní stránky) alebo "tab" (zachovanie podľa pravidla a karty). Náhodný výber sa môže opakovať; dva rovnaké výsledky po sebe nemusia znamenať, že nedošlo k novému výberu.

Bežné hodnoty pool:

Hodnota Zdroj náhodného výberu
all Všetky vstavané a vlastné UA a UA vytvorené z pripájaného textu
builtin Všetky vstavané UA
builtin_desktop, builtin_mobile, builtin_legacy Vstavané kategórie počítačov, mobilných alebo starších zariadení
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social Príslušná vstavaná kategória
custom UA zo všetkých vlastných kategórií
custom:分类名 UA z kategórie určenej v userCustomData
append_all UA zodpovedajúce všetkým pripájaným textom
append:分类名 UA zodpovedajúce pripájanému textu v kategórii určenej v userAppendData

Názov kategórie za dvojbodkou musí zodpovedať kľúču v knižnici. Zapnuté náhodné pravidlo musí mať dostupných kandidátov, inak bude súbor odmietnutý.

07Kontrola pri ručných úpravách

  • Ako kľúče v domainRules zapisujte názvy domén, napríklad example.com alebo shop.example.com; neuvádzajte https://, cesty, porty ani medzery. Pravidlá domén sa vzťahujú aj na subdomény. V tejto verzii *.example.com zahŕňa aj samotné example.com; neznamená „iba subdomény“.
  • Názvy kategórií môžu obsahovať čínske znaky a musia byť neprázdnymi reťazcami bez riadiacich znakov a nebezpečných riadiacich znakov obojsmerného textu; __proto__, prototype a constructor nemožno použiť ako názvy kategórií. Pre UA a pripájaný text odporúčame tlačiteľné znaky ASCII. UA a pripájaný text nesmú obsahovať znaky nového riadka, tabulátory ani iné riadiace znaky. Jeden UA môže mať najviac 4096 znakov. Dvojité úvodzovky a spätné lomky v texte treba escapovať podľa pravidiel JSON.
  • Každej kategórii zodpovedá pole reťazcov, napríklad "常用": ["Agent/1.0", "Agent/2.0"]. Hranaté zátvorky zachovajte aj pri jedinej položke. Prázdnu kategóriu možno zapísať ako [].
  • Hodnoty true, false a null neuzatvárajte do dvojitých úvodzoviek; "false" je reťazec, nie logická hodnota.
  • Súbor musí byť platný UTF-8 a JSON bez duplicitných kľúčov. Rozšírenie kontroluje aj štruktúru, typy polí, pravidlá, názvy predvolieb a náhodné množiny; správna syntax nezaručuje použiteľnosť pravidla.

Konfiguračný súbor môže zmeniť UA, ktorý prehliadač odosiela webom. HTTPS chráni prenos, ale nezaručuje, že konfigurácia poskytovaná serverom zodpovedá vášmu zámeru. Importujte iba súbory z dôveryhodných zdrojov, pred potvrdením skontrolujte obsah a po obnovení cieľovej stránky overte skutočný účinok.

08Časté otázky

Problém Čo skontrolovať
Hlásenie o nesprávnom formáte súboru Skontrolujte UTF-8, syntax JSON, duplicitné kľúče, verziu, povinné polia a typy pravidiel. Ako šablónu použite súbor exportovaný novou verziou.
Vzdialené načítanie zlyhalo Skontrolujte certifikát HTTPS, priamy odkaz, sieť a obsah odpovede. Presmerovania, prihlásenie pomocou cookie ani HTTP nie sú povolené.
Po importe chýbajú pravidlá Pravidlá domén a obe knižnice sa nahrádzajú ako celé súpravy. Obnovte zálohu vytvorenú pred importom alebo do nového súboru doplňte všetky položky, ktoré chcete zachovať.
Bolo importované prázdne globálne pravidlo, ale stránka stále používa iný UA Skontrolujte existujúce pravidlá kariet alebo zodpovedajúce pravidlá domén; môžu mať prednosť pred globálnym pravidlom.
Import bol úspešný, ale UA je nesprávny Skontrolujte, či je pravidlo zapnuté, jeho obsah platný, náhodná množina obsahuje dostupné položky a či neexistuje pravidlo karty alebo domény s vyššou prioritou; potom stránku obnovte.
Pri importe veľkého množstva údajov nastala chyba úložiska Súbor aj synchronizované úložisko prehliadača majú obmedzenia veľkosti. Zmenšite pravidlá alebo zoznamy a skúste to znova; skontrolujte existujúcu konfiguráciu.
Po zmene vzdialeného súboru sa rozšírenie nezmení Vzdialené načítanie je jednorazový ručný import. Znova zadajte adresu, načítajte ju a potvrďte.