Šī pamācība paredzēta UA Pro 1.5.0 un skaidro konfigurācijas dublēšanu, pārvietošanu, rakstīšanu ar roku un ielādi no attālas adreses. Jaunajā versijā tiek izmantots pilna momentuzņēmuma formāts: konfigurācijas faila version ir 2.
Pirms importēšanas eksportējiet mērķa pārlūkprogrammas dublējumu. Katrā importēšanas reizē globālais noteikums, visi domēnu noteikumi, abas UA bibliotēkas un resursa domēna rezerves noteikuma slēdzis tiek aizstāti ar failā saglabāto pilno momentuzņēmumu; ieraksti netiek apvienoti pa vienam. "globalRule": null dzēš mērķa pārlūkprogrammas globālo noteikumu.
01Konfigurācijas eksportēšana
- Pārlūkprogrammas rīkjoslā noklikšķiniet uz UA Pro ikonas.
- Atveriet “Vairāk” → “Importēt/eksportēt konfigurāciju”.
- Noklikšķiniet uz “Eksportēt konfigurāciju” un saglabājiet lejupielādēto
.jsonfailu. - Faila nosaukums līdzinās
ua-switcher-config-2026-11-16.json. Datums nosaukumā tiek veidots pēc UTC un var par vienu dienu atšķirties no vietējā datuma.
Failā ir šādi pastāvīgie iestatījumi:
- Globālais noteikums un tā ieslēgtais vai apturētais stāvoklis.
- Visi domēnu noteikumi un to ieslēgtais vai apturētais stāvoklis.
- Pielāgoto UA kategorijas un ieraksti.
- Pievienojamā teksta kategorijas un ieraksti.
- Slēdzis “Resursa domēna rezerves noteikums”.
Failā nav ciļņu noteikumu, jau izlozēto nejaušo UA piesaistījumu, atvērto ciļņu, saskarnes valodas, motīva un peldošā slāņa iestatījumu. Importējot tie netiek atjaunoti no dublējuma. Importēšana nedzēš arī esošos mērķa pārlūkprogrammas ciļņu noteikumus, tādēļ tie var turpināt ignorēt domēna vai globālo noteikumu.
Eksportētais fails ir lasāms JSON vienkāršais teksts. Ja pielāgotie UA vai kategorijas satur informāciju, ko nevēlaties atklāt, rūpīgi glabājiet dublējumu.
02Importēšana no lokāla faila
- Mērķa pārlūkprogrammā atveriet UA Pro → “Vairāk” → “Importēt/eksportēt konfigurāciju”.
- Vispirms noklikšķiniet uz “Eksportēt konfigurāciju”, lai saglabātu mērķa pārlūkprogrammas sākotnējo konfigurāciju iespējamai atjaunošanai.
- Noklikšķiniet uz “Importēt konfigurāciju” un atlasiet
.jsonfailu. - Izlasiet aizstāšanas brīdinājumu un pārbaudiet noteikumu un sarakstu skaitu. Izvēloties “Rādīt konfigurācijas saturu”, pirms apstiprināšanas var pārbaudīt visu JSON. Izvēloties “Atcelt”, nekas netiek ierakstīts. Pēc apstiprināšanas gaidiet paziņojumu “Konfigurācija ir importēta!”. Ja apstiprināšanas laikā iestatījumi mainās, paplašinājums lūgs darbību atkārtot.
- Pārbaudiet globālos un domēnu noteikumus, pielāgotos sarakstus un resursa domēna rezerves noteikuma slēdzi. Pārbaudiet, vai esoši ciļņu noteikumi tos neaizstāj. Atsvaidziniet pārbaudāmās lapas un pārbaudiet UA.
Paplašinājums vispirms pārbauda failu, tad mēģina instalēt noteikumus un beidzot ieraksta pastāvīgo konfigurāciju. Ja instalēšana vai ierakstīšana neizdodas, tas mēģina atjaunot pārlūkprogrammā pašlaik saglabātos noteikumus; ja atjaunošana neizdodas, pārbaudiet faktiskos iestatījumus. Ja pārlūkprogrammas sinhronizācija vai cits logs vienlaikus maina konfigurāciju, tas nav starpierīču darījums.
03Ielāde no attālas adreses
Attālajā konfigurācijā tiek izmantots tāds pats JSON saturs kā lokālajā dublējumā. Tā ir vienreizēja manuāla ielāde un importēšana, nevis automātiski atjaunināms abonements.
- Vispirms eksportējiet dublējumu vai sagatavojiet JSON failu saskaņā ar tālāk sniegtajām norādēm.
- Novietojiet failu HTTPS pakalpojumā, kuram mērķa pārlūkprogramma var piekļūt, un iegūstiet pilnu adresi, kas tieši atgriež JSON saturu, piemēram,
https://example.com/ua-pro/config.json. Tā ir tikai paraugadrese; aizstājiet to ar savu faktisko adresi. - UA Pro izvēlieties “Vairāk” → “Importēt/eksportēt konfigurāciju”, izvērsiet “Attālā konfigurācija”, ielīmējiet adresi un noklikšķiniet uz “Ielādēt”.
- Pēc sekmīgas ielādes un formāta pārbaudes paplašinājums parāda apstiprinājumu un attālā servera nosaukumu. Izvēloties “Rādīt konfigurācijas saturu”, var pārbaudīt visu faktiski lejupielādēto JSON. Apstiprinot iestatījumi tiek atjaunināti tāpat kā lokāli importējot; atceļot nekas netiek importēts.
- Kad fails serverī mainās, ja vēlaties izmantot jauno saturu, vēlreiz ievadiet adresi, ielādējiet un apstipriniet. Atkārtoti atverot paneli, adrese automātiski netiek saglabāta.
Tiek pieņemtas tikai tiešas HTTPS saites; HTTP, lietotājvārds vai parole adresē un URL fragments nav atļauti, un pāradresācijām neseko. Pieprasījumā nav pārlūkprogrammas sīkdatņu vai pieteikšanās datu, netiek sūtīta Referer galvene un tiek apieta kešatmiņa. Tāpēc neder pakalpojums, kam vajadzīga pieteikšanās sīkdatne. UA Pro šim pieprasījumam nepiemēro paplašinājuma UA noteikumus, taču citi paplašinājumi vai tīkla ierīces var pieprasījumu mainīt. Adrese var saturēt vaicājuma parametrus; adresi ar piekļuves pilnvaru glabājiet kā paroli. Izmantojiet uzticamu adresi un pārliecinieties, ka atbilde ir tieši JSON fails, nevis pieteikšanās vai kodu attēlojoša HTML lapa.
Lokālā faila un attālās atbildes ierobežojums ir 128 KiB; attālās lasīšanas laika limits ir 10 sekundes, un tiek skaitīts faktiski nolasītais saturs. Pārlūkprogrammas sinhronizētajā krātuvē viena vienuma kvota ir mazāka, tāpēc arī failu zem 128 KiB var neizdoties saglabāt noteikumu vai vienas bibliotēkas lieluma dēļ. Kļūdas gadījumā pārbaudiet, vai serveris atgriež statusu 200 un derīgu JSON, sertifikātu, pāradresāciju un tīkla pieejamību.
04Pilns JSON piemērs
Tālāk redzamo piemēru var saglabāt kā UTF-8 kodētu config.json failu. Domēni un UA vērtības ir tikai piemēri; pirms aizstāšanas dublējiet esošo konfigurāciju. JSON atšķir lielos un mazos burtus; virknēs lietojiet taisnās dubultpēdiņas, nelieciet komatu pēc pēdējā elementa un nerakstiet JSON komentārus.
{
"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
}
}
Piemērā iestatīts viens iebūvēts globālais UA un četri domēnu noteikumi. Konkrētākiem apakšdomēnu noteikumiem, piemēram, app.example.com, ir priekšroka pār example.com. Apturētie noteikumi netiek piemēroti, tāpēc spēkā var stāties augstāka domēna vai globālais noteikums. Tas, vai vietne atpazīst UA piemēru, ir atkarīgs no pašas vietnes.
05Augšējā līmeņa lauki un aizstāšana
| Lauks | Piemērs | Nozīme |
|---|---|---|
version |
2 |
Obligāts. Jaunajā versijā pieņemta tikai skaitliskā vērtība 2. |
type |
"ua-switcher-config" |
Obligāts konfigurācijas tipa identifikators; virknei precīzi jāsakrīt. |
timestamp |
"2026-11-16T06:00:00.000Z" |
Obligāts. UTC laiks ar milisekundēm un Z; tikai uzskaitei, nenosaka noteikumu spēkā stāšanās laiku. |
data |
{ ... } |
Obligāts. Objekts ar pilnu konfigurāciju un visiem nākamās tabulas laukiem. |
Lauki objektā data |
Pareizais formāts | Importēšanas darbība šajā versijā |
|---|---|---|
globalRule |
Viens noteikuma objekts vai null |
Noteikuma objekts aizstāj esošo globālo noteikumu; null to dzēš. |
domainRules |
{ "域名": 规则对象 } |
Viss objekts aizstāj iepriekšējos domēnu noteikumus; {} tos iztukšo. |
userCustomData |
{ "分类": ["UA", ...] } |
Viss objekts aizstāj iepriekšējo pielāgoto UA bibliotēku; {} to iztukšo. |
userAppendData |
{ "分类": ["追加文本", ...] } |
Viss objekts aizstāj iepriekšējo pievienojamā teksta bibliotēku; {} to iztukšo. |
resourceDomainFallback |
true vai false |
JSON loģiskā vērtība: ieslēdz vai izslēdz resursa domēna rezerves noteikumu. |
Visi pieci lauki ir obligāti, un null nav atļauts, izņemot laukā globalRule. Trūkstoši un nezināmi lauki un atkārtotas JSON atslēgas tiek noraidītas; arī vecu versiju vai daļējas konfigurācijas netiek importētas. Domēnu noteikumi un abas bibliotēkas tiek aizstātas pilnībā: piemēram, domainRules ar tikai vienu domēnu aizstās arī pārējos mērķa pārlūkprogrammas domēnu noteikumus. Ieteicams rediģēt no jaunās versijas eksportētu failu un saglabāt visus vajadzīgos ierakstus.
Resursa domēna rezerves noteikumu pēc resursa pieprasījuma mērķa domēna var piemērot tikai tad, ja galvenajai lapai nav derīga cilnes, domēna vai globālā UA. Tas nenozīmē, ka visi starpdomēnu resursi aizstās galvenās lapas noteikumu.
06Noteikuma objekta veidošana
Globālais noteikums un katrs domēna noteikums izmanto vienādu struktūru:
{
"enabled": true,
"mode": "custom",
"params": {
"category": "常用",
"value": "ExampleAgent/1.0"
}
}
enabled: true nozīmē ieslēgts, false – apturēts. mode nosaka params laukus:
6.1 Iebūvēts UA: builtin
{
"enabled": true,
"mode": "builtin",
"params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}
os un uaKey precīzi jāatbilst šī paplašinājuma versijas iekšējo sākotnējo iestatījumu atslēgām; tās ne vienmēr sakrīt ar saskarnē tulkotajiem nosaukumiem. Visdrošāk ir atlasīt iestatījumu saskarnē, eksportēt konfigurāciju un nokopēt atbilstošo params. Mainoties versijas iestatījumiem, pārbaudiet tos vēlreiz.
6.2 Pielāgots UA: custom
{
"enabled": true,
"mode": "custom",
"params": { "category": "常用", "value": "ExampleAgent/1.0" }
}
value ir pilna UA virkne. category paredzēts kategorizēšanai un rediģēšanai saskarnē; ieteicams šo vērtību iekļaut arī userCustomData tāda paša nosaukuma kategorijā. Noteikums izmanto savu value; manuāli importēts noteikums automātiski nepievieno vērtību pielāgoto UA bibliotēkai.
6.3 Pievienojams teksts: append
{
"enabled": true,
"mode": "append",
"params": { "category": "应用标记", "value": "MyApp/1.0" }
}
Paplašinājums pēc pārlūkprogrammas sākotnējā UA pievieno atstarpi un tad value. Ieteicams to pašu tekstu saglabāt arī userAppendData tāda paša nosaukuma kategorijā; noteikuma importēšana automātiski neaizpilda sarakstu.
6.4 Nejaušs UA: random
{
"enabled": true,
"mode": "random",
"params": { "pool": "custom:随机示例", "strategy": "page" }
}
strategy jābūt "page" (izloze katrā pilnā lapas ielādes reizē) vai "tab" (saglabāts pēc noteikuma un cilnes). Nejaušā izvēle var atkārtoties; divi vienādi rezultāti pēc kārtas ne vienmēr nozīmē, ka izloze nav atkārtota.
Biežas pool vērtības:
| Vērtība | Nejaušās izvēles avots |
|---|---|
all |
Visi iebūvētie un pielāgotie UA un no pievienojamā teksta veidotie UA |
builtin |
Visi iebūvētie UA |
builtin_desktop, builtin_mobile, builtin_legacy |
Iebūvētās galddatoru, mobilo vai veco ierīču kategorijas |
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social |
Atbilstošās iebūvētās kategorijas |
custom |
Visu pielāgoto kategoriju UA |
custom:分类名 |
Laukā userCustomData norādītās kategorijas UA |
append_all |
Visam pievienojamajam tekstam atbilstošie UA |
append:分类名 |
Laukā userAppendData norādītās kategorijas pievienojamajam tekstam atbilstošie UA |
Kategorijas nosaukumam pēc kola jāsakrīt ar bibliotēkas atslēgu. Ieslēgtam nejaušajam noteikumam jābūt pieejamām izvēlēm, citādi fails tiek noraidīts.
07Pārbaudes, rediģējot ar roku
- Kā
domainRulesatslēgas rakstiet domēnus, piemēram,example.com,shop.example.com, nevishttps://, ceļu, portu vai atstarpes. Domēnu noteikumi atbilst arī zemākiem apakšdomēniem;*.example.comšajā versijā ietver arī pašuexample.com, ne tikai apakšdomēnus. - Kategoriju nosaukumos drīkst izmantot ķīniešu valodu; nosaukumam jābūt netukšai virknei bez vadības rakstzīmēm un bīstamām divvirzienu teksta vadības rakstzīmēm.
__proto__,prototypeunconstructornedrīkst izmantot kā kategoriju nosaukumus. UA un pievienojamajā tekstā ieteicamas drukājamas ASCII rakstzīmes; nedrīkst iekļaut rindas pārtraukumus, tabulācijas vai citas vadības rakstzīmes. Viens UA drīkst būt ne garāks par 4096 rakstzīmēm. Taisnās dubultpēdiņas un atpakaļvērstās slīpsvītras tekstā jāekranē saskaņā ar JSON noteikumiem. - Katrai kategorijai atbilst virkņu masīvs, piemēram,
"常用": ["Agent/1.0", "Agent/2.0"]. Saglabājiet kvadrātiekavas arī vienam elementam. Tukšu kategoriju var rakstīt[]. true,falseunnullnedrīkst likt pēdiņās;"false"ir virkne, nevis loģiska vērtība.- Failam jābūt derīgam UTF-8 un JSON; atkārtotas atslēgas nav atļautas. Paplašinājums pārbauda arī struktūru, lauku tipus, noteikumus, sākotnējo iestatījumu nosaukumus un nejaušās izvēles kopas; pareiza sintakse negarantē, ka noteikums darbosies.
Konfigurācijas fails var mainīt pārlūkprogrammas vietnēm sūtīto UA. HTTPS aizsargā pārsūtīšanu, bet negarantē, ka servera konfigurācija atbilst jūsu vēlmēm. Importējiet tikai no uzticama avota, pirms apstiprināšanas pārbaudiet saturu un pēc mērķa lapas atsvaidzināšanas pārbaudiet faktisko rezultātu.
08Biežākie jautājumi
| Problēma | Pārbaude |
|---|---|
| Paziņojums par nederīgu faila formātu | Pārbaudiet UTF-8, JSON sintaksi, atkārtotas atslēgas, versiju, obligātos laukus un noteikumu tipus; kā veidni izmantojiet jaunās versijas eksportēto failu. |
| Attālā ielāde neizdodas | Pārbaudiet HTTPS sertifikātu, tiešo saiti, tīklu un atbildes saturu; pāradresācijas, pieteikšanās ar sīkdatnēm un HTTP nav atļauti. |
| Pēc importēšanas ir mazāk noteikumu | Domēnu noteikumi un abas bibliotēkas tiek aizstātas pilnībā; atjaunojiet no pirms importēšanas izveidota dublējuma vai pievienojiet jaunajam failam saglabājamos ierakstus. |
| Importēts tukšs globālais noteikums, bet lapa joprojām izmanto citu UA | Pārbaudiet esošos ciļņu vai atbilstošos domēnu noteikumus; tiem var būt priekšroka pār globālo noteikumu. |
| Parādās sekmīgs rezultāts, bet UA ir nepareizs | Pārbaudiet, vai noteikums ir ieslēgts, saturs ir derīgs, nejaušās izvēles kopā ir pieejamas vērtības un vai nav augstākas prioritātes cilnes vai domēna noteikuma, pēc tam atsvaidziniet lapu. |
| Importējot daudz datu, rodas krātuves kļūda | Gan failam, gan pārlūkprogrammas sinhronizētajai krātuvei ir lieluma ierobežojumi; samaziniet noteikumu vai sarakstu apjomu, mēģiniet vēlreiz un pārbaudiet esošo konfigurāciju. |
| Pēc attālā faila maiņas paplašinājums nemainās | Attālā ielāde ir vienreizēja manuāla importēšana; vēlreiz ievadiet adresi, ielādējiet un apstipriniet. |