Šis vadovas skirtas „UA Pro 1.5.0“ ir paaiškina, kaip kurti atsargines kopijas, perkelti ir rankiniu būdu kurti konfigūraciją bei įkelti ją iš nuotolinio adreso. Naujoji versija naudoja visos būsenos formatą: konfigūracijos failo version yra 2.
Prieš importuodami eksportuokite tikslinės naršyklės atsarginę kopiją. Kiekvieną kartą importuojant bendroji taisyklė, visos domenų taisyklės, abi UA bibliotekos ir atsarginės ištekliaus domeno taisyklės jungiklis pakeičiami visa faile esančia būsena; atskiri įrašai nesujungiami. "globalRule": null pašalina tikslinės naršyklės bendrąją taisyklę.
01Konfigūracijos eksportavimas
- Naršyklės įrankių juostoje spustelėkite „UA Pro“ piktogramą.
- Atverkite „Daugiau“ → „Importuoti/eksportuoti konfigūraciją“.
- Spustelėkite „Eksportuoti konfigūraciją“ ir išsaugokite atsisiųstą
.jsonfailą. - Failo pavadinimas panašus į
ua-switcher-config-2026-11-16.json. Data pavadinime sudaroma pagal UTC, todėl nuo vietinės datos gali skirtis viena diena.
Faile yra šie išliekantys nustatymai:
- Bendroji taisyklė ir jos įjungta arba pristabdyta būsena.
- Visos domenų taisyklės ir jų įjungta arba pristabdyta būsena.
- Pasirinktinių UA kategorijos ir įrašai.
- Pridedamo teksto kategorijos ir įrašai.
- Jungiklis „Atsarginė ištekliaus domeno taisyklė“.
Faile nėra kortelių taisyklių, jau parinktų atsitiktinių UA susiejimų, atvertų kortelių, sąsajos kalbos, temos ir slankiojo sluoksnio nustatymų. Importuojant jie neatkuriami iš kopijos. Esamos tikslinės naršyklės kortelių taisyklės taip pat neištrinamos, todėl jos gali ir toliau nustelbti domenų ar bendrąją taisyklę.
Eksportuotas failas yra skaitomas grynasis JSON tekstas. Jei pasirinktiniai UA ar kategorijos turi neviešintinos informacijos, saugokite atsarginę kopiją.
02Importavimas iš vietinio failo
- Tikslinėje naršyklėje atverkite „UA Pro“ → „Daugiau“ → „Importuoti/eksportuoti konfigūraciją“.
- Pirmiausia pasirinkite „Eksportuoti konfigūraciją“, kad prireikus galėtumėte atkurti ankstesnę tikslinės naršyklės konfigūraciją.
- Spustelėkite „Importuoti konfigūraciją“ ir pasirinkite
.jsonfailą. - Perskaitykite įspėjimą apie pakeitimą ir patikrinkite taisyklių bei sąrašų skaičių. Pasirinkę „Rodyti konfigūracijos turinį“, prieš patvirtindami galite peržiūrėti visą JSON. Pasirinkus „Atšaukti“, niekas neįrašoma. Patvirtinę palaukite pranešimo „Konfigūracija importuota!“. Jei patvirtinant nustatymai pasikeičia, plėtinys paprašys veiksmą pakartoti.
- Patikrinkite bendrąją ir domenų taisykles, pasirinktinius sąrašus bei atsarginės ištekliaus domeno taisyklės jungiklį. Patikrinkite, ar jų nenustelbia esamos kortelių taisyklės. Atnaujinkite tikrinamus puslapius ir patikrinkite UA.
Plėtinys pirmiausia patikrina failą, tada bando įdiegti taisykles ir galiausiai įrašo išliekančią konfigūraciją. Jei įdiegti ar įrašyti nepavyksta, jis bando atkurti tuo metu naršyklėje saugomas taisykles; jei pranešama, kad atkurti nepavyko, patikrinkite faktinius nustatymus. Kai naršyklės sinchronizavimas ar kitas langas tuo pat metu keičia konfigūraciją, šis procesas nėra tarp įrenginių vykdoma transakcija.
03Įkėlimas iš nuotolinio adreso
Nuotolinėje konfigūracijoje naudojamas toks pats JSON turinys kaip vietinėje atsarginėje kopijoje. Tai vienkartinis rankinis įkėlimas ir importavimas, o ne automatiškai atnaujinama prenumerata.
- Pirmiausia eksportuokite atsarginę kopiją arba paruoškite JSON failą pagal toliau pateiktas instrukcijas.
- Įkelkite failą į HTTPS tarnybą, pasiekiamą tikslinei naršyklei, ir gaukite visą adresą, tiesiogiai grąžinantį JSON turinį, pavyzdžiui,
https://example.com/ua-pro/config.json. Tai tik pavyzdys: pakeiskite jį savo tikruoju adresu. - Programoje UA Pro pasirinkite „Daugiau“ → „Importuoti/eksportuoti konfigūraciją“, išskleiskite „Nuotolinė konfigūracija“, įklijuokite adresą ir spustelėkite „Įkelti“.
- Sėkmingai įkėlus ir patikrinus formatą, plėtinys parodys patvirtinimo langą ir nuotolinio serverio vardą. Pasirinkę „Rodyti konfigūracijos turinį“ galite patikrinti visą atsisiųstą JSON. Patvirtinus nustatymai pakeičiami kaip importuojant vietinį failą; atšaukus niekas neimportuojama.
- Pakeitus failą serveryje, norėdami naudoti naują turinį dar kartą įveskite adresą, įkelkite ir patvirtinkite. Vėl atvėrus skydelį adresas automatiškai neišsaugomas.
Priimamos tik tiesioginės HTTPS nuorodos; HTTP, naudotojo vardas ar slaptažodis adrese ir URL fragmentas neleidžiami, peradresavimų nesekama. Užklausoje nesiunčiami naršyklės slapukai ar prisijungimo duomenys, nesiunčiama „Referer“ antraštė ir apeinama podėlio atmintis. Todėl slapuko prisijungimui reikalaujanti tarnyba netinka. „UA Pro“ šiai užklausai netaiko plėtinio UA taisyklių, tačiau kiti plėtiniai ar tinklo įrenginiai ją gali pakeisti. Adrese gali būti užklausos parametrų; adresą su prieigos raktu saugokite kaip slaptažodį. Naudokite patikimą adresą ir įsitikinkite, kad atsakas yra tiesiogiai JSON failas, o ne prisijungimo ar kodą rodantis HTML puslapis.
Vietinio failo ir nuotolinio atsako riba yra 128 KiB; nuotolinio skaitymo laiko riba – 10 sekundžių, skaičiuojamas faktiškai perskaitytas turinys. Naršyklės sinchronizuojamoje saugykloje vieno elemento kvota mažesnė, todėl ir mažesnio nei 128 KiB failo gali nepavykti išsaugoti dėl taisyklių ar vienos bibliotekos dydžio. Įvykus klaidai patikrinkite, ar serveris grąžina būseną 200 ir tinkamą JSON, ar galioja sertifikatas, ar nėra peradresavimo ir ar pasiekiamas tinklas.
04Visas JSON pavyzdys
Toliau pateiktą pavyzdį galima išsaugoti kaip UTF-8 koduotės config.json failą. Domenai ir UA reikšmės pateikti tik pavyzdžiui; prieš keisdami sukurkite esamos konfigūracijos kopiją. JSON skiria didžiąsias ir mažąsias raides, eilutėms naudojamos tiesios dvigubos kabutės; po paskutinio elemento nedėkite kablelio ir nerašykite komentarų JSON viduje.
{
"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
}
}
Pavyzdyje nustatytas vienas integruotas bendrasis UA ir keturios domenų taisyklės. Konkretesnės padomenių taisyklės, pavyzdžiui, app.example.com, turi pirmenybę prieš example.com. Pristabdytos taisyklės netaikomos, todėl gali įsigalioti aukštesnio domeno arba bendroji taisyklė. Ar svetainė atpažins pavyzdinį UA, priklauso nuo jos pačios.
05Aukščiausio lygio laukai ir pakeitimas
| Laukas | Pavyzdys | Paskirtis |
|---|---|---|
version |
2 |
Privalomas. Naujoji versija priima tik skaitinę reikšmę 2. |
type |
"ua-switcher-config" |
Privalomas konfigūracijos tipo identifikatorius; eilutė turi tiksliai sutapti. |
timestamp |
"2026-11-16T06:00:00.000Z" |
Privalomas. UTC laikas su milisekundėmis ir Z; tik įrašui, nenustato taisyklės įsigaliojimo laiko. |
data |
{ ... } |
Privalomas. Visos konfigūracijos objektas su visais toliau pateiktos lentelės laukais. |
Objekto data laukai |
Tinkamas formatas | Importavimo veiksena šioje versijoje |
|---|---|---|
globalRule |
Vienas taisyklės objektas arba null |
Taisyklės objektas pakeičia esamą bendrąją taisyklę; null ją pašalina. |
domainRules |
{ "域名": 规则对象 } |
Visas objektas pakeičia ankstesnes domenų taisykles; {} jas išvalo. |
userCustomData |
{ "分类": ["UA", ...] } |
Visas objektas pakeičia ankstesnę pasirinktinių UA biblioteką; {} ją išvalo. |
userAppendData |
{ "分类": ["追加文本", ...] } |
Visas objektas pakeičia ankstesnę pridedamo teksto biblioteką; {} ją išvalo. |
resourceDomainFallback |
true arba false |
JSON loginė reikšmė: įjungia arba išjungia atsarginę ištekliaus domeno taisyklę. |
Visi penki laukai privalomi; null negalima naudoti, išskyrus lauką globalRule. Trūkstami ir nežinomi laukai bei pasikartojantys JSON raktai atmetami; senos versijos ar dalinės konfigūracijos taip pat neimportuojamos. Domenų taisyklės ir abi bibliotekos pakeičiamos visos: pavyzdžiui, tik vieną domeną turintis domainRules pakeis ir kitas tikslinės naršyklės domenų taisykles. Rekomenduojama redaguoti naujos versijos eksportuotą failą ir išsaugoti visus reikalingus įrašus.
Atsarginė ištekliaus domeno taisyklė gali pritaikyti taisyklę pagal ištekliaus užklausos tikslinį domeną tik tada, kai pagrindiniame puslapyje nėra galiojančio kortelės, domeno ar bendrojo UA. Tai nereiškia, kad visi kitų domenų ištekliai nustelbs pagrindinio puslapio taisyklę.
06Taisyklės objekto kūrimas
Bendroji ir kiekviena domeno taisyklė naudoja tą pačią struktūrą:
{
"enabled": true,
"mode": "custom",
"params": {
"category": "常用",
"value": "ExampleAgent/1.0"
}
}
enabled: true reiškia įjungta, false – pristabdyta. mode nustato params laukus:
6.1 Integruotas UA: builtin
{
"enabled": true,
"mode": "builtin",
"params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}
os ir uaKey turi tiksliai sutapti su šios plėtinio versijos vidiniais išankstinių nustatymų raktais; jie nebūtinai sutampa su išverstais sąsajos pavadinimais. Patikimiausia pasirinkti nustatymą sąsajoje, eksportuoti konfigūraciją ir nukopijuoti atitinkamą params. Pasikeitus versijos nustatymų sąrašui patikrinkite dar kartą.
6.2 Pasirinktinis UA: custom
{
"enabled": true,
"mode": "custom",
"params": { "category": "常用", "value": "ExampleAgent/1.0" }
}
value yra visa UA eilutė. category naudojamas kategorijai ir redagavimui sąsajoje; rekomenduojama tą pačią reikšmę įtraukti į userCustomData to paties pavadinimo kategoriją. Taisyklė naudoja savo value; rankiniu būdu importuota taisyklė automatiškai neįtraukia reikšmės į pasirinktinių UA biblioteką.
6.3 Pridedamas tekstas: append
{
"enabled": true,
"mode": "append",
"params": { "category": "应用标记", "value": "MyApp/1.0" }
}
Plėtinys po pradinio naršyklės UA prideda tarpą, o tada value. Rekomenduojama tą patį tekstą išsaugoti ir userAppendData to paties pavadinimo kategorijoje; importuojant taisyklę sąrašas automatiškai neužpildomas.
6.4 Atsitiktinis UA: random
{
"enabled": true,
"mode": "random",
"params": { "pool": "custom:随机示例", "strategy": "page" }
}
strategy turi būti "page" (parenkama kiekvieną kartą visiškai įkeliant puslapį) arba "tab" (išlaikoma pagal taisyklę ir kortelę). Atsitiktinis parinkimas gali kartotis; du vienodi rezultatai iš eilės nebūtinai reiškia, kad nebuvo parinkta iš naujo.
Dažnos pool reikšmės:
| Reikšmė | Atsitiktinio pasirinkimo šaltinis |
|---|---|
all |
Visi integruoti UA, pasirinktiniai UA ir iš pridedamo teksto sudaryti UA |
builtin |
Visi integruoti UA |
builtin_desktop, builtin_mobile, builtin_legacy |
Integruotos stalinių, mobiliųjų arba senų įrenginių kategorijos |
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social |
Atitinkamos integruotos kategorijos |
custom |
Visų pasirinktinių kategorijų UA |
custom:分类名 |
Lauke userCustomData nurodytos kategorijos UA |
append_all |
Visą pridedamą tekstą atitinkantys UA |
append:分类名 |
Lauke userAppendData nurodytos kategorijos pridedamą tekstą atitinkantys UA |
Kategorijos pavadinimas po dvitaškio turi sutapti su bibliotekos raktu. Įjungta atsitiktinė taisyklė turi turėti tinkamų pasirinkimų, kitaip failas atmetamas.
07Tikrinimas redaguojant rankiniu būdu
domainRulesraktams rašykite domenus, pavyzdžiui,example.com,shop.example.com, bet nehttps://, kelią, prievadą ar tarpus. Domenų taisyklės atitinka ir žemesnius padomenius;*.example.comšioje versijoje apima ir patįexample.com, ne tik padomenius.- Kategorijų pavadinimuose galima naudoti kinų kalbą; pavadinimas turi būti netuščia eilutė be valdymo ženklų ir pavojingų dvikrypčio teksto valdymo ženklų.
__proto__,prototypeirconstructornegali būti kategorijų pavadinimai. UA ir pridedamame tekste rekomenduojami spausdinami ASCII ženklai; negalima naudoti eilučių lūžių, tabuliacijų ar kitų valdymo ženklų. Vieną UA gali sudaryti ne daugiau kaip 4096 ženklai. Tiesias dvigubas kabutes ir atvirkštinius pasviruosius brūkšnius tekste reikia apsaugoti pagal JSON taisykles. - Kiekviena kategorija atitinka eilučių masyvą, pavyzdžiui,
"常用": ["Agent/1.0", "Agent/2.0"]. Laužtinius skliaustus palikite net ir vienam elementui. Tuščią kategoriją galima rašyti[]. true,falseirnullnegalima rašyti kabutėse;"false"yra eilutė, o ne loginė reikšmė.- Failas turi būti galiojantis UTF-8 ir JSON; pasikartojantys raktai neleidžiami. Plėtinys taip pat tikrina struktūrą, laukų tipus, taisykles, išankstinių nustatymų pavadinimus ir atsitiktinių reikšmių rinkinius; taisyklinga sintaksė negarantuoja, kad taisyklė veiks.
Konfigūracijos failas gali pakeisti naršyklės svetainėms siunčiamą UA. HTTPS apsaugo perdavimą, bet negarantuoja, kad serverio konfigūracija atitinka jūsų pageidavimus. Importuokite tik iš patikimų šaltinių, prieš patvirtindami patikrinkite turinį ir atnaujinę tikslinį puslapį patikrinkite faktinį poveikį.
08Dažniausi klausimai
| Požymis | Tikrinimas |
|---|---|
| Pranešama apie netinkamą failo formatą | Patikrinkite UTF-8, JSON sintaksę, pasikartojančius raktus, versiją, privalomus laukus ir taisyklių tipus; kaip šabloną naudokite naujos versijos eksportuotą failą. |
| Nepavyksta įkelti nuotoliniu būdu | Patikrinkite HTTPS sertifikatą, tiesioginę nuorodą, tinklą ir atsako turinį; peradresavimai, prisijungimo slapukai ir HTTP neleidžiami. |
| Po importavimo sumažėjo taisyklių | Domenų taisyklės ir abi bibliotekos pakeičiamos visos; atkurkite iš prieš importavimą sukurtos atsarginės kopijos arba papildykite naują failą norimais išsaugoti įrašais. |
| Importuota tuščia bendroji taisyklė, bet puslapis vis tiek naudoja kitą UA | Patikrinkite esamas kortelių arba atitinkančias domenų taisykles; jos gali turėti pirmenybę prieš bendrąją taisyklę. |
| Rodoma sėkmė, bet UA neteisingas | Patikrinkite, ar taisyklė įjungta, turinys tinkamas, atsitiktinių reikšmių rinkinyje yra pasirinkimų ir ar nėra aukštesnio prioriteto kortelės ar domeno taisyklės, tada atnaujinkite puslapį. |
| Importuojant daug duomenų pranešama apie saugyklos klaidą | Tiek failo, tiek naršyklės sinchronizuojamos saugyklos dydis ribojamas; sumažinkite taisyklių ar sąrašų skaičių, bandykite dar kartą ir patikrinkite esamą konfigūraciją. |
| Pakeitus nuotolinį failą plėtinys nepasikeitė | Nuotolinis įkėlimas yra vienkartinis rankinis importas; dar kartą įveskite adresą, įkelkite ir patvirtinkite. |