Ovaj vodič vrijedi za UA Pro 1.5.0. Objašnjava sigurnosno kopiranje, premještanje i ručno pisanje konfiguracije te učitavanje s udaljene adrese. Nova verzija upotrebljava format potpune snimke: version konfiguracijske datoteke ima vrijednost 2.
Prije uvoza izvezite sigurnosnu kopiju u odredišnom pregledniku. Svaki uvoz zamjenjuje globalno pravilo, cijeli skup pravila domena, obje biblioteke UA-a i prekidač rezervnog pravila domene resursa potpunom snimkom iz datoteke; pojedinačni se zapisi ne spajaju. "globalRule": null označava brisanje globalnog pravila u odredišnom pregledniku.
01Izvoz konfiguracije
- Kliknite ikonu UA Pro na alatnoj traci preglednika.
- Otvorite „Više” → „Uvoz/izvoz konfiguracije”.
- Kliknite „Izvoz konfiguracije” i spremite preuzetu datoteku
.json. - Naziv datoteke nalikuje na
ua-switcher-config-2026-11-16.json. Datum u nazivu stvara se prema UTC-u i može se razlikovati od lokalnog datuma za jedan dan.
Datoteka sadrži sljedeće trajne postavke:
- Globalno pravilo i njegovo uključeno ili pauzirano stanje.
- Cijeli skup pravila domena i njihovo uključeno ili pauzirano stanje.
- Kategorije i stavke prilagođenih UA-ova.
- Kategorije i stavke dodanog teksta.
- Prekidač „Rezervno pravilo domene resursa”.
Datoteka ne sadrži pravila kartica, već odabrane veze nasumičnog UA-a, trenutačno otvorene kartice, jezik sučelja, temu ni postavke preklopnog prikaza. Te se stavke nakon uvoza ne vraćaju iz sigurnosne kopije; uvoz također ne briše postojeća pravila kartica u odredišnom pregledniku pa ona i dalje mogu imati prednost pred pravilima domena ili globalnim pravilom.
Izvezena datoteka čitljiv je JSON u običnom tekstu. Ako prilagođeni UA-ovi ili kategorije sadrže podatke koje ne želite otkriti, sigurno čuvajte kopiju.
02Uvoz iz lokalne datoteke
- U odredišnom pregledniku otvorite UA Pro → „Više” → „Uvoz/izvoz konfiguracije”.
- Najprije kliknite „Izvoz konfiguracije” kako biste sačuvali izvornu konfiguraciju odredišnog preglednika za slučaj da je treba vratiti.
- Kliknite „Uvoz konfiguracije” i odaberite datoteku
.json. - Pročitajte upozorenje o zamjeni te provjerite broj pravila i popisa. Kliknite „Prikaži sadržaj konfiguracije” kako biste prije potvrde pregledali cijeli JSON. Odabir „Odustani” ništa ne zapisuje. Nakon potvrde pričekajte poruku „Konfiguracija je uvezena!”. Ako se postavke promijene tijekom potvrđivanja, proširenje će zatražiti ponavljanje postupka.
- Provjerite globalno pravilo i pravila domena, prilagođene popise i prekidač rezervnog pravila domene resursa; provjerite i imaju li postojeća pravila kartica prednost pred njima. Osvježite stranice koje želite testirati i provjerite UA.
Proširenje najprije provjerava datoteku, zatim pokušava instalirati pravila i naposljetku zapisuje trajnu konfiguraciju. Ako instalacija ili zapis ne uspije, pokušava vratiti pravila trenutačno spremljena u pregledniku. Ako javi da ih nije moguće vratiti, provjerite stvarne postavke. Kada sinkronizacija preglednika ili drugi prozor istodobno mijenja konfiguraciju, postupak se ne smije smatrati transakcijom između uređaja.
03Učitavanje s udaljene adrese
Udaljena konfiguracija upotrebljava isti JSON sadržaj kao lokalna sigurnosna kopija. To je jednokratno ručno učitavanje i uvoz, a ne pretplata koja se automatski ažurira.
- Najprije izvezite sigurnosnu kopiju konfiguracije ili pripremite JSON datoteku prema uputama u nastavku.
- Postavite datoteku na HTTPS uslugu dostupnu odredišnom pregledniku i pribavite punu adresu koja izravno vraća JSON sadržaj, primjerice
https://example.com/ua-pro/config.json. Adresa je samo primjer; zamijenite je svojom stvarnom adresom. - U UA Pro odaberite „Više” → „Uvoz/izvoz konfiguracije”, proširite odjeljak „Udaljena konfiguracija”, zalijepite adresu i kliknite „Učitajte”.
- Nakon uspješnog učitavanja i provjere formata proširenje prikazuje dijalog za potvrdu i naziv udaljenog poslužitelja. Kliknite „Prikaži sadržaj konfiguracije” kako biste pregledali cijeli stvarno preuzeti JSON. Potvrda ažurira postavke prema istim pravilima kao lokalni uvoz; odustajanje ne uvozi ništa.
- Nakon promjene datoteke na poslužitelju ponovno unesite adresu, učitajte i potvrdite za upotrebu novog sadržaja. Adresa se ne zadržava automatski kada ponovno otvorite ploču.
Prihvaćaju se samo izravne HTTPS poveznice; HTTP, korisničko ime ili lozinka u adresi i fragmenti URL-a nisu prihvaćeni, a preusmjeravanja se ne slijede. Zahtjev ne sadrži kolačiće preglednika ni vjerodajnice za prijavu, ne šalje Referer i zaobilazi predmemoriju; usluge koje zahtijevaju kolačić za prijavu stoga nisu prikladne. UA Pro ne primjenjuje na ovaj zahtjev UA pravila konfigurirana u ovom proširenju, ali druga proširenja ili mrežni uređaji i dalje ga mogu izmijeniti. Adresa može sadržavati parametre upita; adresu s pristupnim tokenom čuvajte kao lozinku. Upotrijebite pouzdanu adresu i provjerite je li odgovor izravno JSON datoteka, a ne stranica za prijavu ili HTML stranica koja prikazuje kod.
Lokalne datoteke i udaljeni odgovori ograničeni su svaki na 128 KiB; udaljeno čitanje ograničeno je na 10 sekundi i broji se stvarno pročitani sadržaj. Sinkronizirana pohrana preglednika ima i manju kvotu po pojedinoj stavci pa se datoteka manja od 128 KiB ipak možda neće spremiti ako su pravila ili pojedina biblioteka preveliki. U slučaju pogreške provjerite vraća li poslužitelj status 200 i valjan JSON, je li certifikat valjan, preusmjerava li adresa i je li mreža dostupna.
04Potpuni JSON primjer
Sljedeći primjer može se spremiti kao config.json s kodiranjem UTF-8. Primjeri domena i UA vrijednosti služe samo za ilustraciju; prije zamjene napravite sigurnosnu kopiju postojeće konfiguracije. JSON razlikuje velika i mala slova: nizove pišite u dvostrukim navodnicima, ne dodajte zarez nakon zadnje stavke i ne pišite komentare u JSON-u.
{
"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
}
}
Ovaj primjer postavlja jedan ugrađeni globalni UA i četiri pravila domena. Konkretnija pravila poddomena, poput app.example.com, imaju prednost pred example.com. Pauzirana pravila ne sudjeluju u aktivnom podudaranju pa može stupiti na snagu pravilo nadređene domene ili globalno pravilo. Hoće li stvarna stranica prepoznati primjer UA-a ovisi o samoj stranici.
05Polja najviše razine i zamjena
| Polje | Primjer | Svrha |
|---|---|---|
version |
2 |
Obvezno. Nova verzija prihvaća samo brojčanu vrijednost 2. |
type |
"ua-switcher-config" |
Obvezno. Identifikator vrste konfiguracije; mora se točno podudarati s ovim nizom. |
timestamp |
"2026-11-16T06:00:00.000Z" |
Obvezno. UTC vrijeme s milisekundama i Z; služi samo za evidenciju i ne određuje vrijeme primjene pravila. |
data |
{ ... } |
Obvezno. Objekt koji sadrži potpunu konfiguraciju, uključujući sva polja iz donje tablice. |
Polja u data |
Ispravan format | Ponašanje pri uvozu u ovoj verziji |
|---|---|---|
globalRule |
Jedan objekt pravila ili null |
Objekt pravila zamjenjuje postojeće globalno pravilo; null ga briše. |
domainRules |
{ "域名": 规则对象 } |
Cijeli objekt zamjenjuje prijašnja pravila domena; {} ih briše. |
userCustomData |
{ "分类": ["UA", ...] } |
Cijeli objekt zamjenjuje prijašnju biblioteku prilagođenih UA-ova; {} je prazni. |
userAppendData |
{ "分类": ["追加文本", ...] } |
Cijeli objekt zamjenjuje prijašnju biblioteku dodanog teksta; {} je prazni. |
resourceDomainFallback |
true ili false |
Logička vrijednost JSON-a: uključuje ili isključuje rezervno pravilo domene resursa. |
Svih pet polja obvezno je; null se smije upotrijebiti samo za globalRule. Nedostajuća i nepoznata polja te duplicirani JSON ključevi odbacuju se; ne uvoze se ni djelomične konfiguracije ili konfiguracije starih verzija. Pravila domena i obje biblioteke zamjenjuju se kao cijeli skupovi: primjerice, domainRules sa samo jednom domenom zamijenit će ostala postojeća pravila domena u odredišnom pregledniku. Preporučujemo uređivanje stvarne datoteke izvezene novom verzijom i potpuno očuvanje potrebnih stavki.
Rezervno pravilo domene resursa može primijeniti pravilo prema odredišnoj domeni zahtjeva za resurs samo kada glavna stranica nema aktivni UA iz pravila kartice, domene ili globalnog pravila. To ne znači da svi resursi s drugih domena nadjačavaju pravilo glavne stranice.
06Kako napisati objekte pravila
Globalno pravilo i svako pravilo domene imaju istu strukturu:
{
"enabled": true,
"mode": "custom",
"params": {
"category": "常用",
"value": "ExampleAgent/1.0"
}
}
enabled: true znači uključeno, a false pauzirano. mode određuje polja objekta params:
6.1 Ugrađeni UA: builtin
{
"enabled": true,
"mode": "builtin",
"params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}
os i uaKey moraju se točno podudarati s internim ključevima predložaka ove verzije proširenja; ne moraju biti jednaki prevedenim nazivima u sučelju. Najsigurnije je odabrati predložak u sučelju, izvesti konfiguraciju i kopirati odgovarajući params. Ponovno provjerite kada se popis predložaka promijeni među verzijama.
6.2 Prilagođeni UA: custom
{
"enabled": true,
"mode": "custom",
"params": { "category": "常用", "value": "ExampleAgent/1.0" }
}
value je potpuni UA niz. category služi za kategorizaciju i uređivanje u sučelju; preporučujemo uključiti vrijednost i u istoimenu kategoriju u userCustomData. Pravilo koje je na snazi čita vlastiti value; ručni uvoz pravila ne dodaje vrijednost automatski u prilagođenu biblioteku.
6.3 Dodavanje teksta: append
{
"enabled": true,
"mode": "append",
"params": { "category": "应用标记", "value": "MyApp/1.0" }
}
Proširenje dodaje razmak nakon izvornog UA-a trenutačnog preglednika, a zatim dodaje value. Preporučujemo sačuvati tekst i u istoimenoj kategoriji u userAppendData; uvoz pravila ne popunjava popis automatski.
6.4 Nasumični UA: random
{
"enabled": true,
"mode": "random",
"params": { "pool": "custom:随机示例", "strategy": "page" }
}
strategy mora biti "page" (odabir pri svakom potpunom učitavanju stranice) ili "tab" (zadržavanje po pravilu i kartici). Nasumični odabiri mogu se ponoviti; dva jednaka uzastopna rezultata ne znače nužno da nije bilo novog odabira.
Česte vrijednosti pool:
| Vrijednost | Izvor nasumičnog odabira |
|---|---|
all |
Svi ugrađeni i prilagođeni UA-ovi te UA-ovi stvoreni iz dodanog teksta |
builtin |
Svi ugrađeni UA-ovi |
builtin_desktop, builtin_mobile, builtin_legacy |
Ugrađene kategorije stolnih, mobilnih ili starijih uređaja |
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social |
Odgovarajuća ugrađena kategorija |
custom |
UA-ovi iz svih prilagođenih kategorija |
custom:分类名 |
UA-ovi iz kategorije određene u userCustomData |
append_all |
UA-ovi koji odgovaraju svim dodanim tekstovima |
append:分类名 |
UA-ovi koji odgovaraju dodanom tekstu u kategoriji određenoj u userAppendData |
Naziv kategorije nakon dvotočke mora odgovarati ključu u biblioteci. Uključeno nasumično pravilo mora imati dostupne kandidate, inače će datoteka biti odbijena.
07Provjere pri ručnom uređivanju
- Kao ključeve u
domainRulesupišite nazive domena, primjericeexample.comilishop.example.com; ne upisujtehttps://, putanje, priključke ni razmake. Pravila domena podudaraju se i s poddomenama. U ovoj verziji*.example.comuključuje i samexample.com; ne znači „samo poddomene”. - Nazivi kategorija mogu sadržavati kineske znakove i moraju biti neprazni nizovi bez kontrolnih znakova ili opasnih kontrolnih znakova dvosmjernog teksta;
__proto__,prototypeiconstructorne mogu biti nazivi kategorija. Za UA i dodani tekst preporučuju se ispisivi ASCII znakovi; novi redovi, tabulatori i drugi kontrolni znakovi nisu dopušteni. Pojedini UA može imati najviše 4096 znakova. Dvostruke navodnike i obrnute kose crte u tekstu treba escapirati obrnutom kosom crtom prema pravilima JSON-a. - Svakoj kategoriji odgovara polje nizova, primjerice
"常用": ["Agent/1.0", "Agent/2.0"]. Zadržite uglate zagrade i kada postoji samo jedna stavka. Prazna kategorija može se zapisati kao[]. - Ne stavljajte
true,falseninullu dvostruke navodnike;"false"je niz, a ne logička vrijednost. - Datoteka mora biti valjan UTF-8 i JSON bez dupliciranih ključeva. Proširenje provjerava i strukturu, vrste polja, pravila, nazive predložaka i skupove za nasumični odabir; ispravna sintaksa ne jamči da se pravilo može upotrijebiti.
Konfiguracijska datoteka može promijeniti UA koji preglednik šalje web-stranicama. HTTPS štiti prijenos, ali ne jamči da konfiguracija poslužitelja odgovara vašim namjerama. Uvozite samo datoteke iz pouzdanih izvora, prije potvrde pregledajte sadržaj i nakon osvježavanja odredišne stranice provjerite stvarni učinak.
08Česta pitanja
| Problem | Što provjeriti |
|---|---|
| Prikazuje se neispravan format datoteke | Provjerite UTF-8, JSON sintaksu, duplicirane ključeve, verziju, obvezna polja i vrste pravila. Kao predložak upotrijebite datoteku izvezenu novom verzijom. |
| Udaljeno učitavanje ne uspijeva | Provjerite HTTPS certifikat, izravnu poveznicu, mrežu i sadržaj odgovora. Preusmjeravanja, prijava kolačićima i HTTP nisu dopušteni. |
| Nakon uvoza nedostaju pravila | Pravila domena i obje biblioteke zamjenjuju se kao cijeli skupovi. Vratite sigurnosnu kopiju koju ste izradili prije uvoza ili u novu datoteku dodajte sve stavke koje želite zadržati. |
| Uvezeno je prazno globalno pravilo, ali stranica i dalje upotrebljava drugi UA | Provjerite postojeća pravila kartica ili odgovarajuća pravila domena; mogu imati prednost pred globalnim pravilom. |
| Uvoz je uspio, ali UA je pogrešan | Provjerite je li pravilo uključeno, sadržaj valjan, skup za nasumični odabir sadrži dostupne stavke te postoji li pravilo kartice ili domene s višim prioritetom; zatim osvježite stranicu. |
| Pogreška pohrane pri uvozu mnogo podataka | Datoteka i sinkronizirana pohrana preglednika imaju ograničenja veličine. Smanjite pravila ili popise i pokušajte ponovno te provjerite postojeću konfiguraciju. |
| Proširenje se ne mijenja nakon izmjene udaljene datoteke | Udaljeno učitavanje jednokratni je ručni uvoz. Ponovno unesite adresu, učitajte i potvrdite. |