UA Pro seadistusjuhend

Konfiguratsiooni import, eksport ja kaugkonfiguratsioon

Konfiguratsiooni varundamine, ülekandmine ja käsitsi koostamine ning kaugelt laadimine.

Kehtib versioonile UA Pro 1.5.0

See juhend kehtib UA Pro 1.5.0 kohta ja selgitab konfiguratsiooni varundamist, ülekandmist, käsitsi koostamist ja kaugelt laadimist. Uus versioon kasutab täielikku hetkeseisu: konfiguratsioonifaili version on 2.

Ekspordi enne importimist sihtbrauseri konfiguratsioonist varukoopia. Iga import asendab üldreegli, kõik domeenireeglid, mõlemad UA-teegid ja ressursi domeeni varureegli lüliti faili täieliku hetkeseisuga; üksikuid kirjeid ei liideta. "globalRule": null kustutab sihtbrauseri üldreegli.

01Konfiguratsiooni eksport

  1. Klõpsa brauseri tööriistaribal UA Pro ikooni.
  2. Ava „Rohkem” → „Konfiguratsiooni import/eksport”.
  3. Klõpsa „Konfiguratsiooni eksport” ja salvesta allalaaditud .json-fail.
  4. Failinimi on näiteks ua-switcher-config-2026-11-16.json. Nime kuupäev põhineb UTC-l ja võib kohalikust kuupäevast ühe päeva võrra erineda.

Fail sisaldab järgmisi püsisätteid:

  • Üldreegel ja selle aktiivne või peatatud olek.
  • Kõik domeenireeglid ja nende aktiivne või peatatud olek.
  • Kohandatud UA-de kategooriad ja kirjed.
  • Lisatava teksti kategooriad ja kirjed.
  • Lüliti „Ressursi domeeni varureegel”.

Fail ei sisalda vahelehereegleid, juba loositud juhuslike UA-de seoseid, avatud vahelehti, kasutajaliidese keelt, teemat ega ujuva kihi seadeid. Neid ei taastata importimisel varukoopiast. Import ei kustuta ka sihtbrauseri olemasolevaid vahelehereegleid, mistõttu need võivad jätkuvalt domeeni- või üldreegli üle kirjutada.

Eksporditud fail on loetav JSON-lihttekst. Hoia varukoopiat hoolikalt, kui kohandatud UA-d või kategooriad sisaldavad teavet, mida ei soovi avaldada.

02Kohalikust failist importimine

  1. Ava sihtbrauseris UA Pro → „Rohkem” → „Konfiguratsiooni import/eksport”.
  2. Esmalt klõpsa „Konfiguratsiooni eksport”, et säilitada sihtbrauseri senine konfiguratsioon võimaliku taastamise jaoks.
  3. Klõpsa „Konfiguratsiooni import” ja vali .json-fail.
  4. Loe asendamise hoiatust ning reeglite ja loendite arve. Kogu JSON-i saad enne kinnitamist kontrollida valikuga „Kuva konfiguratsiooni sisu”. „Tühista” ei kirjuta muudatusi. Pärast kinnitamist oota teadet „Konfiguratsioon imporditud!”. Kui seaded kinnitamise ajal muutuvad, palub laiendus toimingut korrata.
  5. Kontrolli üld- ja domeenireegleid, kohandatud loendeid ning ressursi domeeni varureegli lülitit. Kontrolli, kas olemasolevad vahelehereeglid neid ei asenda. Värskenda testitavaid lehti ja kontrolli UA-d.

Laiendus kontrollib esmalt faili, proovib seejärel reeglid paigaldada ja kirjutab lõpuks püsisätted. Paigaldamise või kirjutamise ebaõnnestumisel proovib see taastada brauserisse parajasti salvestatud reeglid; kui taastamine ei õnnestu, kontrolli tegelikke seadeid. Brauseri sünkroonimise või teise akna samaaegsete muudatuste korral ei ole see seadmeteülene transaktsioon.

03Kaugelt laadimine

Kaugkonfiguratsioon kasutab sama JSON-sisu nagu kohalik varukoopia. See on ühekordne käsitsi laadimine ja import, mitte automaatselt uuenev tellimus.

  1. Esmalt ekspordi varukoopia või valmista JSON-fail alloleva juhendi järgi.
  2. Paiguta fail HTTPS-teenusesse, millele sihtbrauser pääseb ligi, ja hangi täielik aadress, mis tagastab otse JSON-sisu, näiteks https://example.com/ua-pro/config.json. See on näidisaadress; asenda see enda tegeliku aadressiga.
  3. Ava UA Pros „Rohkem” → „Konfiguratsiooni import/eksport”, laienda „Kaugkonfiguratsioon”, kleebi aadress ja klõpsa „Laadi”.
  4. Pärast edukat laadimist ja vormingukontrolli kuvab laiendus kinnituse ja kaughosti nime. Valikuga „Kuva konfiguratsiooni sisu” saad kontrollida kogu tegelikult alla laaditud JSON-i. Kinnitamine uuendab seadeid nagu kohalik import; tühistamine ei impordi midagi.
  5. Kui serveris olev fail muutub ja soovid uut sisu kasutada, sisesta aadress uuesti, laadi ja kinnita. Paneeli taasavamisel aadress automaatselt ei säili.

Lubatud on ainult otsesed HTTPS-aadressid. HTTP, kasutajanimi või parool aadressis ja URL-i fragment ei ole lubatud ning ümbersuunamisi ei järgita. Päring ei sisalda brauseri küpsiseid ega sisselogimisandmeid, ei saada Referer-päist ja väldib vahemälu. Seega ei sobi teenus, mis nõuab sisselogimisküpsist. UA Pro ei rakenda sellele päringule laienduse UA-reegleid, kuid teised laiendused või võrguseadmed võivad päringut muuta. Aadress võib sisaldada päringuparameetreid; juurdepääsutokeniga aadressi hoia nagu parooli. Kasuta usaldusväärset aadressi ja veendu, et vastus oleks otse JSON-fail, mitte sisselogimisleht ega koodi näitav HTML-leht.

Kohaliku faili ja kaugvastuse piir on 128 KiB; kauglaadimise ajalimiit on 10 sekundit ja arvestatakse tegelikult loetud sisu. Brauseri sünkroonmälus on ühe kirje kvoot väiksem, mistõttu võib ka alla 128 KiB fail jääda reeglite või ühe teegi suuruse tõttu salvestamata. Vea korral kontrolli, et server tagastaks oleku 200 ja kehtiva JSON-i, sertifikaati, ümbersuunamist ja võrguühendust.

04Täielik JSON-i näide

Järgmise näite võib salvestada UTF-8-kodeeringus config.json-failina. Näidisdomeenid ja UA väärtused on illustratiivsed; enne asendamist varunda senine konfiguratsioon. JSON eristab suur- ja väiketähti, stringides kasutatakse sirgeid jutumärke; ära lisa viimase elemendi järele koma ega JSON-i kommentaare.

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

Näide määrab ühe sisseehitatud üldise UA ja neli domeenireeglit. Täpsemad alamdomeenireeglid nagu app.example.com on reeglist example.com kõrgema prioriteediga. Peatatud reegleid sobitamisel ei kasutata; nende asemel võib rakenduda ülemise domeeni või üldreegel. Kas veebisait näidis-UA ära tunneb, sõltub saidist.

05Ülataseme väljad ja asendamine

Väli Näide Otstarve
version 2 Kohustuslik. Uus versioon aktsepteerib ainult arvväärtust 2.
type "ua-switcher-config" Kohustuslik konfiguratsioonitüübi tunnus, mis peab täpselt selle stringiga ühtima.
timestamp "2026-11-16T06:00:00.000Z" Kohustuslik. UTC-aeg millisekundite ja tähisega Z; ainult kirje jaoks, ei määra reegli jõustumise aega.
data { ... } Kohustuslik. Täielikku konfiguratsiooni sisaldav objekt koos kõigi järgmise tabeli väljadega.
Objekti data väljad Õige vorming Impordi käitumine selles versioonis
globalRule Üks reegliobjekt või null Reegliobjekt asendab senise üldreegli; null kustutab selle.
domainRules { "域名": 规则对象 } Kogu objekt asendab senised domeenireeglid; {} tühjendab need.
userCustomData { "分类": ["UA", ...] } Kogu objekt asendab senise kohandatud UA-de teegi; {} tühjendab selle.
userAppendData { "分类": ["追加文本", ...] } Kogu objekt asendab senise lisatava teksti teegi; {} tühjendab selle.
resourceDomainFallback true või false JSON-i tõeväärtus: ressursi domeeni varureegel sisse või välja.

Kõik viis välja on kohustuslikud ja null on lubatud ainult väljal globalRule. Puuduvad ja tundmatud väljad ning korduvad JSON-võtmed lükatakse tagasi; vanu või osalisi konfiguratsioone ei impordita. Domeenireeglid ja mõlemad teegid asendatakse tervikuna: näiteks ainult üht domeeni sisaldav domainRules asendab ka sihtbrauseri teised domeenireeglid. Soovitatav on muuta uuest versioonist eksporditud faili ja säilitada kõik vajalikud kirjed.

Ressursi domeeni varureeglit saab ressursipäringu sihtdomeeni põhjal rakendada ainult siis, kui põhilehel pole kehtivat vahelehe-, domeeni- ega üldist UA-d. See ei tähenda, et kõik domeenidevahelised ressursid põhilehe reeglit asendavad.

06Reegliobjekti koostamine

Üldreegel ja iga domeenireegel kasutavad sama struktuuri:

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

enabled: true tähendab aktiivset ja false peatatud olekut. mode määrab objekti params väljad:

6.1 Sisseehitatud UA: builtin

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

os ja uaKey peavad täpselt vastama selle laiendusversiooni sisemistele eelseadistusvõtmetele; need ei pruugi ühtida kasutajaliidese tõlgitud nimedega. Kõige kindlam on valida eelseadistus liideses, eksportida konfiguratsioon ja kopeerida vastav params. Kui eelseadistused versiooniga muutuvad, kontrolli need uuesti üle.

6.2 Kohandatud UA: custom

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

value on täielik UA-string. category on mõeldud liigitamiseks ja kasutajaliideses muutmiseks; sama väärtus soovitatakse lisada ka teegi userCustomData samanimelisse kategooriasse. Reegel kasutab oma välja value; käsitsi imporditud reegel ei lisa väärtust automaatselt kohandatud teeki.

6.3 Lisatav tekst: append

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

Laiendus lisab brauseri algse UA järele tühiku ja seejärel teksti value. Soovitatav on hoida sama tekst ka teegi userAppendData samanimelises kategoorias; reegli import ei täida loendit automaatselt.

6.4 Juhuslik UA: random

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

strategy peab olema "page" (loosimine igal täielikul lehelaadimisel) või "tab" (säilitatakse reegli ja vahelehe kaupa). Juhuslik valik võib korduda; kaks sama tulemust järjest ei tähenda tingimata, et uut loosimist ei toimunud.

Levinud pool väärtused:

Väärtus Juhusliku valiku allikas
all Kõik sisseehitatud ja kohandatud UA-d ning lisatavast tekstist moodustatud UA-d
builtin Kõik sisseehitatud UA-d
builtin_desktop, builtin_mobile, builtin_legacy Sisseehitatud laua-, mobiili- või vanade seadmete kategooriad
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social Vastavad sisseehitatud kategooriad
custom Kõigi kohandatud kategooriate UA-d
custom:分类名 Väljas userCustomData määratud kategooria UA-d
append_all Kõigile lisatavatele tekstidele vastavad UA-d
append:分类名 Väljas userAppendData määratud kategooria lisatavale tekstile vastavad UA-d

Koolonijärgne kategoorianimi peab vastama teegi võtmele. Aktiivsel juhuslikul reeglil peavad olema kasutatavad valikud, muidu fail lükatakse tagasi.

07Käsitsi muutmise kontroll

  • Välja domainRules võtmeteks kirjuta domeenid, näiteks example.com ja shop.example.com, mitte https://, tee, port ega tühikud. Domeenireeglid sobivad ka alamdomeenidele; *.example.com hõlmab selles versioonis ka domeeni example.com ennast ega tähenda ainult alamdomeene.
  • Kategoorianimed võivad sisaldada hiina keelt; nimi peab olema mittetühi string ega tohi sisaldada juhtmärke ega ohtlikke kahesuunalise teksti juhtmärke. __proto__, prototype ja constructor ei sobi kategoorianimedeks. UA-s ja lisatavas tekstis soovitatakse kasutada prinditavaid ASCII-märke; reavahetusi, tabulatsioone ega muid juhtmärke ei tohi sisalduda. Üks UA võib olla kuni 4096 märki pikk. Tekstis olevad sirged jutumärgid ja kurakaldkriipsud tuleb JSON-i reeglite järgi paomärkida.
  • Iga kategooria vastab stringimassiivile, näiteks "常用": ["Agent/1.0", "Agent/2.0"]. Säilita nurksulud ka ühe elemendi puhul. Tühja kategooria võib kirjutada [].
  • true, false ja null ei tohi olla jutumärkides; "false" on string, mitte tõeväärtus.
  • Fail peab olema kehtiv UTF-8 ja JSON ning korduvad võtmed pole lubatud. Laiendus kontrollib ka struktuuri, väljatüüpe, reegleid, eelseadistuste nimesid ja juhusliku valiku kogumeid; korrektne süntaks ei taga reegli kasutatavust.

Konfiguratsioonifail võib muuta brauseri veebisaitidele saadetavat UA-d. HTTPS kaitseb edastust, kuid ei taga, et serveri konfiguratsioon vastab sinu soovidele. Impordi ainult usaldusväärsest allikast, vaata sisu enne kinnitamist üle ning kontrolli tegelikku mõju pärast sihtlehe värskendamist.

08Korduma kippuvad küsimused

Probleem Kontroll
Teade vigase failivormingu kohta Kontrolli UTF-8 kodeeringut, JSON-i süntaksit, korduvaid võtmeid, versiooni, kohustuslikke välju ja reeglitüüpe; kasuta mallina uuest versioonist eksporditud faili.
Kauglaadimine ebaõnnestub Kontrolli HTTPS-sertifikaati, otselinki, võrku ja vastuse sisu; ümbersuunamised, küpsisega sisselogimine ja HTTP pole lubatud.
Pärast importi on reegleid vähem Domeenireeglid ja mõlemad teegid asendatakse tervikuna; taasta enne importimist tehtud varukoopiast või lisa säilitatavad kirjed uude faili.
Imporditi tühi üldreegel, kuid leht kasutab teist UA-d Kontrolli olemasolevaid vahelehereegleid ja sobivaid domeenireegleid; need võivad olla üldreeglist kõrgema prioriteediga.
Edukas tulemus, kuid UA on vale Kontrolli, kas reegel on aktiivne, sisu kehtiv, juhusliku valiku kogumis on sobivaid väärtusi ja kas leidub kõrgema prioriteediga vahelehe- või domeenireegleid; seejärel värskenda lehte.
Suure andmemahu import annab salvestusvea Nii failil kui ka brauseri sünkroonmälul on suuruse piirangud. Vähenda reegleid või loendeid, proovi uuesti ja kontrolli senist konfiguratsiooni.
Pärast kaugfaili muutmist laiendus ei muutu Kauglaadimine on ühekordne käsitsi import; sisesta aadress uuesti, laadi ja kinnita.