Vodnik za konfiguracijo UA Pro

Uvoz, izvoz in oddaljena konfiguracija

Varnostno kopiranje, prenos in ročno pisanje konfiguracije ter nalaganje z oddaljenega naslova.

Velja za: UA Pro 1.5.0

Ta vodnik velja za UA Pro 1.5.0. Opisuje varnostno kopiranje, prenos in ročno pisanje konfiguracije ter nalaganje z oddaljenega naslova. Nova različica uporablja obliko celotnega posnetka: version konfiguracijske datoteke je 2.

Pred uvozom izvozite varnostno kopijo v ciljnem brskalniku. Vsak uvoz nadomesti globalno pravilo, celoten nabor domenskih pravil, obe knjižnici UA in stikalo nadomestnega pravila domene vira s celotnim posnetkom iz datoteke; posamezni vnosi se ne združujejo. "globalRule": null pomeni izbris globalnega pravila v ciljnem brskalniku.

01Izvoz konfiguracije

  1. Kliknite ikono UA Pro v orodni vrstici brskalnika.
  2. Odprite »Več« → »Uvoz/izvoz konfiguracije«.
  3. Kliknite »Izvoz konfiguracije« in shranite preneseno datoteko .json.
  4. Ime datoteke je podobno ua-switcher-config-2026-11-16.json. Datum v imenu je ustvarjen po UTC in se lahko za en dan razlikuje od lokalnega datuma.

Datoteka vsebuje naslednje trajne nastavitve:

  • Globalno pravilo in njegovo stanje: omogočeno ali začasno ustavljeno.
  • Celoten nabor domenskih pravil in njihovo stanje: omogočena ali začasno ustavljena.
  • Kategorije in vnose UA po meri.
  • Kategorije in vnose dodanega besedila.
  • Stikalo »Nadomestno pravilo domene vira«.

Datoteka ne vsebuje pravil zavihkov, že izžrebanih vezav naključnega UA, trenutno odprtih zavihkov, jezika vmesnika, teme in nastavitev prekrivnega prikaza. Ti elementi se po uvozu ne obnovijo iz varnostne kopije; uvoz tudi ne izbriše obstoječih pravil zavihkov v ciljnem brskalniku, zato imajo lahko še naprej prednost pred domenskimi ali globalnim pravilom.

Izvožena datoteka je berljiv JSON v navadnem besedilu. Če UA po meri ali kategorije vsebujejo podatke, ki jih ne želite razkriti, kopijo varno shranite.

02Uvoz iz lokalne datoteke

  1. V ciljnem brskalniku odprite UA Pro → »Več« → »Uvoz/izvoz konfiguracije«.
  2. Najprej kliknite »Izvoz konfiguracije«, da ohranite prvotno konfiguracijo ciljnega brskalnika za morebitno obnovitev.
  3. Kliknite »Uvoz konfiguracije« in izberite datoteko .json.
  4. Preberite opozorilo o nadomestitvi ter preverite število pravil in seznamov. Kliknite »Prikaži vsebino konfiguracije«, da pred potrditvijo pregledate celoten JSON. Izbira »Prekliči« ničesar ne zapiše. Po potrditvi počakajte na sporočilo »Konfiguracija je uvožena!«. Če se nastavitve med potrjevanjem spremenijo, bo razširitev zahtevala ponovitev postopka.
  5. Preverite globalno in domenska pravila, sezname po meri ter stikalo nadomestnega pravila domene vira; preverite tudi, ali imajo obstoječa pravila zavihkov prednost pred njimi. Osvežite strani, ki jih želite preskusiti, in preverite UA.

Razširitev najprej preveri datoteko, nato poskusi namestiti pravila in nazadnje zapiše trajno konfiguracijo. Če namestitev ali zapis ne uspe, poskusi obnoviti pravila, trenutno shranjena v brskalniku. Če sporoči, da obnovitev ni mogoča, preverite dejanske nastavitve. Če sinhronizacija brskalnika ali drugo okno sočasno spreminja konfiguracijo, tega postopka ne razumite kot transakcije med napravami.

03Nalaganje z oddaljenega naslova

Oddaljena konfiguracija uporablja enako vsebino JSON kot lokalna varnostna kopija. Gre za enkratno ročno nalaganje in uvoz, ne za samodejno posodabljano naročnino.

  1. Najprej izvozite varnostno kopijo konfiguracije ali pripravite datoteko JSON po spodnjih navodilih.
  2. Datoteko namestite v storitev HTTPS, dostopno ciljnemu brskalniku, in pridobite celoten naslov, ki neposredno vrne vsebino JSON, na primer https://example.com/ua-pro/config.json. Ta naslov je le primer; zamenjajte ga s svojim dejanskim naslovom.
  3. V UA Pro odprite »Več« → »Uvoz/izvoz konfiguracije«, razširite »Oddaljena konfiguracija«, prilepite naslov in kliknite »Naloži«.
  4. Po uspešnem nalaganju in preverjanju oblike razširitev prikaže potrditveno okno in ime oddaljenega gostitelja. Kliknite »Prikaži vsebino konfiguracije«, da pregledate celoten dejansko preneseni JSON. Potrditev posodobi nastavitve po enakih pravilih kot lokalni uvoz; preklic ne uvozi ničesar.
  5. Ko se datoteka na strežniku spremeni, znova vnesite naslov, naložite in potrdite, če želite uporabiti novo vsebino. Ob ponovnem odprtju plošče se naslov ne ohrani samodejno.

Sprejete so samo neposredne povezave HTTPS; HTTP, uporabniško ime ali geslo v naslovu in fragmenti URL niso dovoljeni, preusmeritve pa se ne sledijo. Zahteva ne vsebuje piškotkov brskalnika ali prijavnih poverilnic, ne pošlje Referer in obide predpomnilnik; storitve, ki zahtevajo prijavni piškotek, zato niso primerne. UA Pro za to zahtevo ne uporabi pravil UA, nastavljenih v tej razširitvi, vendar jo lahko druge razširitve ali omrežne naprave še vedno spremenijo. Naslov lahko vsebuje parametre poizvedbe; naslov z dostopnim žetonom varujte kot geslo. Uporabite zaupanja vreden naslov in preverite, da je odgovor neposredno datoteka JSON, ne prijavna stran ali stran HTML, ki prikazuje kodo.

Lokalne datoteke in oddaljeni odgovori so omejeni na 128 KiB; oddaljeno branje je omejeno na 10 sekund in šteje se dejansko prebrana vsebina. Sinhronizirana shramba brskalnika ima tudi manjšo omejitev za posamezno postavko, zato se datoteka pod 128 KiB še vedno morda ne shrani, če so pravila ali posamezna knjižnica preveliki. Ob napaki preverite, ali strežnik vrne stanje 200 in veljaven JSON, ali je potrdilo veljavno, ali naslov preusmerja in ali je omrežje dostopno.

04Celoten primer JSON

Naslednji primer lahko shranite kot config.json s kodiranjem UTF-8. Primeri domen in vrednosti UA so samo za ponazoritev; pred zamenjavo obstoječe konfiguracije ustvarite varnostno kopijo. JSON razlikuje velike in male črke: nize zapišite v dvojnih narekovajih, za zadnjim elementom ne dodajte vejice in v JSON ne pišite komentarjev.

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

Ta primer nastavi en vgrajeni globalni UA in štiri domenska pravila. Natančnejša pravila poddomen, kot je app.example.com, imajo prednost pred example.com. Začasno ustavljena pravila ne sodelujejo pri aktivnem ujemanju, zato lahko začne veljati pravilo nadrejene domene ali globalno pravilo. Ali dejansko spletno mesto prepozna primer UA, je odvisno od spletnega mesta.

05Polja najvišje ravni in nadomeščanje

Polje Primer Namen
version 2 Obvezno. Nova različica sprejme le številsko vrednost 2.
type "ua-switcher-config" Obvezno. Identifikator vrste konfiguracije; natančno se mora ujemati s tem nizom.
timestamp "2026-11-16T06:00:00.000Z" Obvezno. Čas UTC z milisekundami in Z; služi samo za evidenco in ne določa časa veljavnosti pravil.
data { ... } Obvezno. Objekt s celotno konfiguracijo, ki vsebuje vsa polja iz spodnje preglednice.
Polja v data Pravilna oblika Vedenje pri uvozu v tej različici
globalRule En objekt pravila ali null Objekt pravila nadomesti obstoječe globalno pravilo; null ga izbriše.
domainRules { "域名": 规则对象 } Celoten objekt nadomesti obstoječa domenska pravila; {} jih izbriše.
userCustomData { "分类": ["UA", ...] } Celoten objekt nadomesti obstoječo knjižnico UA po meri; {} jo izprazni.
userAppendData { "分类": ["追加文本", ...] } Celoten objekt nadomesti obstoječo knjižnico dodanega besedila; {} jo izprazni.
resourceDomainFallback true ali false Logična vrednost JSON: vklopi ali izklopi nadomestno pravilo domene vira.

Vseh pet polj je obveznih; null je dovoljen samo pri globalRule. Manjkajoča in neznana polja ter podvojeni ključi JSON so zavrnjeni; delne konfiguracije in konfiguracije starih različic se prav tako ne uvozijo. Domenska pravila in obe knjižnici se nadomestijo kot celotni nabori: na primer domainRules z eno samo domeno nadomesti druga obstoječa domenska pravila v ciljnem brskalniku. Priporočamo urejanje dejanske datoteke, izvožene z novo različico, in popolno ohranitev potrebnih elementov.

Nadomestno pravilo domene vira lahko uporabi pravilo glede na ciljno domeno zahteve za vir samo, če glavna stran nima aktivnega UA iz pravila zavihka, domene ali globalnega pravila. To ne pomeni, da vsi viri iz drugih domen preglasijo pravilo glavne strani.

06Kako zapisati objekte pravil

Globalno pravilo in vsako domensko pravilo uporabljata enako strukturo:

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

enabled: true pomeni omogočeno, false pa začasno ustavljeno. mode določa polja objekta params:

6.1 Vgrajeni UA: builtin

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

os in uaKey se morata natančno ujemati z notranjimi ključi prednastavitev te različice razširitve; ni nujno, da sta enaka prevedenim prikaznim imenom v vmesniku. Najvarneje je izbrati prednastavitev v vmesniku, izvoziti konfiguracijo in kopirati ustrezni params. Ob spremembi seznama prednastavitev med različicami to znova preverite.

6.2 UA po meri: custom

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

value je celoten niz UA. category se uporablja za razvrščanje in urejanje v vmesniku; priporočamo, da vrednost vključite tudi v istoimensko kategorijo v userCustomData. Veljavno pravilo bere svoj value; ročni uvoz pravila vrednosti ne doda samodejno v knjižnico po meri.

6.3 Dodajanje besedila: append

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

Razširitev za izvirnim UA trenutnega brskalnika doda presledek in nato doda value. Priporočamo, da besedilo ohranite tudi v istoimenski kategoriji v userAppendData; uvoz pravila ne napolni seznama samodejno.

6.4 Naključni UA: random

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

strategy mora biti "page" (izbira ob vsakem celotnem nalaganju strani) ali "tab" (ohranitev glede na pravilo in zavihek). Naključna izbira se lahko ponovi; dva enaka zaporedna rezultata ne pomenita nujno, da nove izbire ni bilo.

Pogoste vrednosti pool:

Vrednost Vir naključne izbire
all Vsi vgrajeni UA, UA po meri in UA, ustvarjeni iz dodanega besedila
builtin Vsi vgrajeni UA
builtin_desktop, builtin_mobile, builtin_legacy Vgrajene kategorije namiznih, mobilnih ali starejših naprav
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social Ustrezna vgrajena kategorija
custom UA iz vseh kategorij po meri
custom:分类名 UA iz kategorije, določene v userCustomData
append_all UA, ki ustrezajo vsem dodanim besedilom
append:分类名 UA, ki ustrezajo dodanemu besedilu v kategoriji, določeni v userAppendData

Ime kategorije za dvopičjem se mora ujemati s ključem v knjižnici. Omogočeno naključno pravilo mora imeti razpoložljive kandidate, sicer bo datoteka zavrnjena.

07Preverjanje pri ročnem urejanju

  • Kot ključe v domainRules zapišite imena domen, na primer example.com ali shop.example.com; ne vpisujte https://, poti, vrat ali presledkov. Domenska pravila se ujemajo tudi s poddomenami. V tej različici *.example.com vključuje tudi sam example.com; ne pomeni »samo poddomene«.
  • Imena kategorij lahko vsebujejo kitajske znake in morajo biti neprazni nizi brez krmilnih znakov ali nevarnih krmilnih znakov za dvosmerno besedilo; __proto__, prototype in constructor ne smejo biti imena kategorij. Za UA in dodano besedilo priporočamo tiskljive znake ASCII; ne smejo vsebovati novih vrstic, tabulatorjev ali drugih krmilnih znakov. Posamezni UA lahko vsebuje največ 4096 znakov. Dvojne narekovaje in obrnjene poševnice v besedilu je treba ubežati po pravilih JSON.
  • Vsaki kategoriji ustreza polje nizov, na primer "常用": ["Agent/1.0", "Agent/2.0"]. Oglate oklepaje ohranite tudi pri enem samem elementu. Prazno kategorijo lahko zapišete kot [].
  • true, false in null ne postavljajte v dvojne narekovaje; "false" je niz, ne logična vrednost.
  • Datoteka mora biti veljaven UTF-8 in JSON brez podvojenih ključev. Razširitev preveri tudi strukturo, vrste polj, pravila, imena prednastavitev in naključne nabore; pravilna skladnja ne zagotavlja uporabnosti pravila.

Konfiguracijska datoteka lahko spremeni UA, ki ga brskalnik pošilja spletnim mestom. HTTPS varuje prenos, vendar ne zagotavlja, da konfiguracija strežnika ustreza vašim željam. Uvažajte le datoteke iz zaupanja vrednih virov, pred potrditvijo preglejte vsebino in po osvežitvi ciljne strani preverite dejanski učinek.

08Pogosta vprašanja

Težava Kaj preveriti
Sporočilo o nepravilni obliki datoteke Preverite UTF-8, skladnjo JSON, podvojene ključe, različico, obvezna polja in vrste pravil. Kot predlogo uporabite datoteko, izvoženo z novo različico.
Oddaljeno nalaganje ni uspelo Preverite potrdilo HTTPS, neposredno povezavo, omrežje in vsebino odgovora. Preusmeritve, prijava s piškotki in HTTP niso dovoljeni.
Po uvozu manjka nekaj pravil Domenska pravila in obe knjižnici se nadomestijo kot celotni nabori. Obnovite varnostno kopijo, ustvarjeno pred uvozom, ali v novo datoteko dodajte vse elemente, ki jih želite ohraniti.
Uvoženo je bilo prazno globalno pravilo, vendar stran še vedno uporablja drug UA Preverite obstoječa pravila zavihkov ali ujemajoča se domenska pravila; lahko imajo prednost pred globalnim pravilom.
Uvoz je uspel, vendar je UA napačen Preverite, ali je pravilo omogočeno, njegova vsebina veljavna, naključni nabor vsebuje razpoložljive elemente in ali obstaja pravilo zavihka ali domene z višjo prednostjo; nato osvežite stran.
Napaka shrambe pri uvozu velike količine podatkov Datoteka in sinhronizirana shramba brskalnika imata omejitve velikosti. Zmanjšajte pravila ali sezname in poskusite znova ter preverite obstoječo konfiguracijo.
Po spremembi oddaljene datoteke se razširitev ne spremeni Oddaljeno nalaganje je enkratni ročni uvoz. Znova vnesite naslov, naložite in potrdite.