Průvodce konfigurací UA Pro

Import, export a vzdálená konfigurace

Zálohování, přenos a ruční vytváření konfigurace a její načítání ze vzdálené adresy.

Platí pro: UA Pro 1.5.0

Tento průvodce platí pro UA Pro 1.5.0. Popisuje zálohování, přenos a ruční vytváření konfigurace a její načítání ze vzdálené adresy. Nová verze používá formát úplného snímku: version konfiguračního souboru má hodnotu 2.

Před importem exportujte zálohu v cílovém prohlížeči. Každý import nahradí globální pravidlo, celou sadu doménových pravidel, obě knihovny UA a přepínač náhradního pravidla domény zdroje úplným snímkem ze souboru; jednotlivé položky se neslučují. "globalRule": null znamená odstranění globálního pravidla v cílovém prohlížeči.

01Export konfigurace

  1. Klikněte na ikonu UA Pro na panelu nástrojů prohlížeče.
  2. Otevřete „Více“ → „Import a export konfigurace“.
  3. Klikněte na „Exportovat konfiguraci“ a uložte stažený soubor .json.
  4. Název souboru vypadá například jako ua-switcher-config-2026-11-16.json. Datum v názvu se vytváří podle UTC a může se o jeden den lišit od místního data.

Soubor obsahuje tato trvalá nastavení:

  • Globální pravidlo a jeho zapnutý nebo pozastavený stav.
  • Celou sadu doménových pravidel a jejich zapnutý nebo pozastavený stav.
  • Kategorie a položky vlastních UA.
  • Kategorie a položky připojovaného textu.
  • Přepínač „Náhradní pravidlo domény zdroje“.

Soubor neobsahuje pravidla karet, již vylosované vazby náhodných UA, právě otevřené karty, jazyk rozhraní, motiv ani nastavení překryvného panelu. Tyto položky se po importu ze zálohy neobnoví; import také neodstraní pravidla karet již existující v cílovém prohlížeči, takže mohou mít nadále přednost před doménovými nebo globálním pravidlem.

Exportovaný soubor je čitelný JSON v prostém textu. Pokud vlastní UA nebo kategorie obsahují údaje, které nechcete zveřejnit, zálohu bezpečně uložte.

02Import z místního souboru

  1. V cílovém prohlížeči otevřete UA Pro → „Více“ → „Import a export konfigurace“.
  2. Nejprve klikněte na „Exportovat konfiguraci“, abyste původní konfiguraci cílového prohlížeče zachovali pro případné obnovení.
  3. Klikněte na „Importovat konfiguraci“ a vyberte soubor .json.
  4. Přečtěte si upozornění na nahrazení a zkontrolujte počty pravidel a seznamů. Kliknutím na „Zobrazit obsah konfigurace“ si před potvrzením prohlédnete celý JSON. Volba „Zrušit“ nic nezapíše. Po potvrzení vyčkejte na zprávu „Konfigurace importována!“. Pokud se nastavení během potvrzování změní, rozšíření vás požádá o opakování.
  5. Zkontrolujte globální a doménová pravidla, vlastní seznamy a přepínač náhradního pravidla domény zdroje; ověřte také, zda před nimi nemají přednost existující pravidla karet. Obnovte stránky, které chcete otestovat, a ověřte UA.

Rozšíření nejprve zkontroluje soubor, poté se pokusí nainstalovat pravidla a nakonec zapíše trvalou konfiguraci. Pokud instalace nebo zápis selže, pokusí se obnovit pravidla aktuálně uložená v prohlížeči. Pokud oznámí, že obnovení není možné, zkontrolujte skutečná nastavení. Pokud synchronizace prohlížeče nebo jiné okno současně mění konfiguraci, nelze tento postup chápat jako transakci mezi zařízeními.

03Načtení ze vzdálené adresy

Vzdálená konfigurace používá stejný obsah JSON jako místní záloha. Jde o jednorázové ruční načtení a import, nikoli o automaticky aktualizované předplatné.

  1. Nejprve exportujte zálohu konfigurace nebo připravte soubor JSON podle následujících pokynů.
  2. Umístěte soubor na službu HTTPS přístupnou cílovému prohlížeči a získejte úplnou adresu, která přímo vrací obsah JSON, například https://example.com/ua-pro/config.json. Tato adresa je pouze příklad; nahraďte ji svou skutečnou adresou.
  3. V UA Pro otevřete „Více“ → „Import a export konfigurace“, rozbalte „Vzdálená konfigurace“, vložte adresu a klikněte na „Načíst“.
  4. Po úspěšném načtení a kontrole formátu rozšíření zobrazí potvrzovací dialog a název vzdáleného hostitele. Kliknutím na „Zobrazit obsah konfigurace“ zkontrolujete celý skutečně stažený JSON. Potvrzení aktualizuje nastavení podle stejných pravidel jako místní import; zrušení import neprovede.
  5. Po změně souboru na serveru znovu zadejte adresu, načtěte ji a potvrďte, chcete-li použít nový obsah. Po opětovném otevření panelu se adresa automaticky nezachová.

Přijímají se pouze přímé odkazy HTTPS; HTTP, uživatelské jméno nebo heslo v adrese ani fragmenty URL nejsou povoleny a přesměrování se nenásledují. Požadavek neobsahuje soubory cookie prohlížeče ani přihlašovací údaje, neposílá Referer a obchází mezipaměť; služby vyžadující přihlašovací cookie proto nejsou vhodné. UA Pro na tento požadavek nepoužije pravidla UA nastavená v tomto rozšíření, jiná rozšíření nebo síťová zařízení jej však mohou změnit. Adresa může obsahovat parametry dotazu; adresu s přístupovým tokenem chraňte jako heslo. Použijte důvěryhodnou adresu a ověřte, že odpovědí je přímo soubor JSON, nikoli přihlašovací stránka nebo stránka HTML zobrazující kód.

Místní soubory i vzdálené odpovědi jsou omezeny na 128 KiB; vzdálené čtení má limit 10 sekund a počítá se skutečně přečtený obsah. Synchronizované úložiště prohlížeče má také menší kvótu na jednotlivou položku, takže soubor menší než 128 KiB se přesto nemusí uložit, pokud jsou pravidla nebo jedna knihovna příliš velké. Při chybě ověřte, zda server vrací stav 200 a platný JSON, zda je certifikát platný, zda adresa nepřesměrovává a zda je síť dostupná.

04Úplný příklad JSON

Následující příklad lze uložit jako config.json v kódování UTF-8. Příkladové domény a hodnoty UA slouží pouze pro ilustraci; před nahrazením stávající konfigurace ji zálohujte. JSON rozlišuje malá a velká písmena: řetězce zapisujte do dvojitých uvozovek, za poslední položku nedávejte čárku a do JSON nevkládejte komentáře.

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 příklad nastaví jeden vestavěný globální UA a čtyři doménová pravidla. Konkrétnější pravidla subdomén, například app.example.com, mají přednost před example.com. Pozastavená pravidla se neúčastní aktivního vyhodnocování, takže může nastoupit pravidlo nadřazené domény nebo globální pravidlo. Zda skutečný web příkladový UA rozpozná, závisí na daném webu.

05Pole nejvyšší úrovně a nahrazování

Pole Příklad Účel
version 2 Povinné. Nová verze přijímá pouze číselnou hodnotu 2.
type "ua-switcher-config" Povinné. Identifikátor typu konfigurace; musí přesně odpovídat tomuto řetězci.
timestamp "2026-11-16T06:00:00.000Z" Povinné. Čas UTC s milisekundami a Z; slouží pouze jako záznam, neurčuje dobu účinnosti pravidel.
data { ... } Povinné. Objekt s úplnou konfigurací obsahující všechna pole následující tabulky.
Pole v data Správný formát Chování importu v této verzi
globalRule Jeden objekt pravidla nebo null Objekt pravidla nahradí stávající globální pravidlo; null jej odstraní.
domainRules { "域名": 规则对象 } Celý objekt nahradí dosavadní doménová pravidla; {} je vymaže.
userCustomData { "分类": ["UA", ...] } Celý objekt nahradí dosavadní knihovnu vlastních UA; {} ji vyprázdní.
userAppendData { "分类": ["追加文本", ...] } Celý objekt nahradí dosavadní knihovnu připojovaného textu; {} ji vyprázdní.
resourceDomainFallback true nebo false Logická hodnota JSON: zapíná nebo vypíná náhradní pravidlo domény zdroje.

Všech pět polí je povinných; null lze použít pouze u globalRule. Chybějící a neznámá pole i duplicitní klíče JSON jsou odmítnuty; neimportují se ani částečné konfigurace nebo konfigurace starších verzí. Doménová pravidla a obě knihovny se nahrazují jako celé sady: například domainRules obsahující jedinou doménu nahradí ostatní existující doménová pravidla v cílovém prohlížeči. Doporučujeme upravovat skutečný soubor exportovaný novou verzí a úplně zachovat potřebné položky.

Náhradní pravidlo domény zdroje může použít pravidlo podle cílové domény požadavku na zdroj pouze tehdy, když hlavní stránka nemá aktivní UA z pravidla karty, domény ani globálního pravidla. Neznamená to, že všechny zdroje z jiných domén přepíší pravidlo hlavní stránky.

06Jak zapsat objekty pravidel

Globální pravidlo i každé doménové pravidlo používají stejnou strukturu:

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

enabled: true znamená zapnuto a false pozastaveno. mode určuje pole objektu params:

6.1 Vestavěný UA: builtin

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

os a uaKey musí přesně odpovídat interním klíčům předvoleb této verze rozšíření; nemusí být shodné s přeloženými názvy v rozhraní. Nejbezpečnější je vybrat předvolbu v rozhraní, exportovat konfiguraci a zkopírovat odpovídající params. Při změně seznamu předvoleb mezi verzemi je znovu ověřte.

6.2 Vlastní UA: custom

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

value je úplný řetězec UA. category slouží ke kategorizaci a úpravám v rozhraní; doporučujeme hodnotu rovněž zahrnout do stejnojmenné kategorie v userCustomData. Účinné pravidlo čte vlastní value; ruční import pravidla hodnotu automaticky nepřidá do vlastní knihovny.

6.3 Připojení textu: append

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

Rozšíření přidá mezeru za původní UA aktuálního prohlížeče a pak připojí value. Doporučujeme tento text ponechat také ve stejnojmenné kategorii v userAppendData; import pravidla seznam automaticky nenaplní.

6.4 Náhodný UA: random

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

strategy musí být "page" (losování při každém úplném načtení stránky) nebo "tab" (zachování podle pravidla a karty). Náhodný výběr se může opakovat; dva stejné výsledky po sobě nutně neznamenají, že nedošlo k novému losování.

Běžné hodnoty pool:

Hodnota Zdroj náhodného výběru
all Všechny vestavěné a vlastní UA a UA vytvořené z připojovaného textu
builtin Všechny vestavěné UA
builtin_desktop, builtin_mobile, builtin_legacy Vestavěné kategorie počítačů, mobilních nebo starších zařízení
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social Odpovídající vestavěná kategorie
custom UA ze všech vlastních kategorií
custom:分类名 UA z kategorie určené v userCustomData
append_all UA odpovídající všem připojovaným textům
append:分类名 UA odpovídající připojovanému textu v kategorii určené v userAppendData

Název kategorie za dvojtečkou musí odpovídat klíči v knihovně. Zapnuté náhodné pravidlo musí mít dostupné kandidáty, jinak bude soubor odmítnut.

07Kontrola při ručních úpravách

  • Jako klíče v domainRules zapisujte názvy domén, například example.com nebo shop.example.com; neuvádějte https://, cesty, porty ani mezery. Doménová pravidla odpovídají i subdoménám. V této verzi *.example.com zahrnuje také samotné example.com; neznamená „pouze subdomény“.
  • Názvy kategorií mohou obsahovat čínské znaky a musí být neprázdnými řetězci bez řídicích znaků a nebezpečných řídicích znaků obousměrného textu; __proto__, prototype a constructor nelze použít jako názvy kategorií. Pro UA a připojovaný text doporučujeme tisknutelné znaky ASCII. UA a připojovaný text nesmí obsahovat znaky nového řádku, tabulátory ani jiné řídicí znaky. Jeden UA může mít nejvýše 4096 znaků. Dvojité uvozovky a zpětná lomítka v textu je nutné escapovat podle pravidel JSON.
  • Každé kategorii odpovídá pole řetězců, například "常用": ["Agent/1.0", "Agent/2.0"]. Hranaté závorky zachovejte i u jediné položky. Prázdnou kategorii lze zapsat jako [].
  • Hodnoty true, false a null neuzavírejte do dvojitých uvozovek; "false" je řetězec, nikoli logická hodnota.
  • Soubor musí být platný UTF-8 a JSON bez duplicitních klíčů. Rozšíření kontroluje také strukturu, typy polí, pravidla, názvy předvoleb a náhodné množiny; správná syntaxe nezaručuje použitelnost pravidla.

Konfigurační soubor může změnit UA, který prohlížeč odesílá webům. HTTPS chrání přenos, ale nezaručuje, že konfigurace poskytovaná serverem odpovídá vašemu záměru. Importujte pouze soubory z důvěryhodných zdrojů, před potvrzením zkontrolujte obsah a po obnovení cílové stránky ověřte skutečný účinek.

08Časté otázky

Problém Co zkontrolovat
Hlášení o nesprávném formátu souboru Zkontrolujte UTF-8, syntaxi JSON, duplicitní klíče, verzi, povinná pole a typy pravidel. Jako šablonu použijte soubor exportovaný novou verzí.
Vzdálené načtení selhalo Zkontrolujte certifikát HTTPS, přímý odkaz, síť a obsah odpovědi. Přesměrování, přihlášení pomocí cookie ani HTTP nejsou povoleny.
Po importu chybí pravidla Doménová pravidla a obě knihovny se nahrazují jako celé sady. Obnovte zálohu pořízenou před importem nebo do nového souboru doplňte všechny položky, které chcete zachovat.
Bylo importováno prázdné globální pravidlo, ale stránka stále používá jiný UA Zkontrolujte existující pravidla karet nebo odpovídající doménová pravidla; mohou mít přednost před globálním pravidlem.
Import byl úspěšný, ale UA je nesprávný Zkontrolujte, zda je pravidlo zapnuté, jeho obsah platný, náhodná množina obsahuje dostupné položky a zda neexistuje pravidlo karty nebo domény s vyšší prioritou; potom stránku obnovte.
Při importu velkého množství dat nastala chyba úložiště Soubor i synchronizované úložiště prohlížeče mají omezení velikosti. Zmenšete pravidla nebo seznamy a zkuste to znovu; zkontrolujte stávající konfiguraci.
Po změně vzdáleného souboru se rozšíření nezmění Vzdálené načtení je jednorázový ruční import. Znovu zadejte adresu, načtěte ji a potvrďte.