Ez az útmutató az UA Pro 1.5.0 verziójára vonatkozik. Bemutatja a konfiguráció biztonsági mentését, átvitelét, kézi elkészítését és távoli címről történő betöltését. Az új verzió teljes pillanatképformátumot használ: a konfigurációs fájl version értéke 2.
Importálás előtt exportáljon biztonsági mentést a célböngészőben. Minden importálás a fájl teljes pillanatképével helyettesíti a globális szabályt, a tartományszabályok teljes készletét, mindkét UA-könyvtárat és az erőforrás-tartalék tartományszabály kapcsolóját; az egyes bejegyzések nem egyesülnek. A "globalRule": null a célböngésző globális szabályának törlését jelenti.
01Konfiguráció exportálása
- Kattintson az UA Pro ikonjára a böngésző eszköztárán.
- Nyissa meg a „Továbbiak” → „Konfiguráció importálása és exportálása” menüpontot.
- Kattintson a „Konfiguráció exportálása” gombra, és mentse a letöltött
.jsonfájlt. - A fájlnév például
ua-switcher-config-2026-11-16.jsonlehet. A fájlnév dátuma UTC szerint készül, és egy nappal eltérhet a helyi dátumtól.
A fájl a következő tartós beállításokat tartalmazza:
- A globális szabályt és annak engedélyezett vagy szüneteltetett állapotát.
- A tartományszabályok teljes készletét és azok engedélyezett vagy szüneteltetett állapotát.
- Az egyéni UA-kategóriákat és -bejegyzéseket.
- A hozzáfűzött szövegek kategóriáit és bejegyzéseit.
- Az „Erőforrás-tartalék tartományszabály” kapcsolót.
A fájl nem tartalmazza a lapszabályokat, a már kisorsolt véletlen UA-kötéseket, az éppen nyitott lapokat, a felület nyelvét, a témát és a lebegő panel beállításait. Ezek az importáláskor nem állnak helyre a mentésből; az importálás a célböngésző meglévő lapszabályait sem törli, ezért azok továbbra is felülírhatják a tartomány- vagy globális szabályokat.
Az exportált fájl olvasható, egyszerű szöveges JSON. Ha az egyéni UA-k vagy kategóriák nem nyilvános információt tartalmaznak, őrizze biztonságosan a mentést.
02Importálás helyi fájlból
- A célböngészőben nyissa meg az UA Pro → „Továbbiak” → „Konfiguráció importálása és exportálása” menüpontot.
- Először kattintson a „Konfiguráció exportálása” gombra, hogy szükség esetére megőrizze a célböngésző eredeti konfigurációját.
- Kattintson a „Konfiguráció importálása” gombra, és válassza ki a
.jsonfájlt. - Olvassa el a felülírásra figyelmeztető üzenetet, és ellenőrizze a szabályok és listák számát. A „Konfiguráció tartalmának megtekintése” gombbal megerősítés előtt megvizsgálhatja a teljes JSON-t. A „Mégse” választása nem ír ki adatot. Megerősítés után várja meg a „Konfiguráció importálva!” üzenetet. Ha a beállítások a megerősítés során megváltoznak, a bővítmény a művelet megismétlését kéri.
- Ellenőrizze a globális és tartományszabályokat, az egyéni listákat és az erőforrás-tartalék tartományszabály kapcsolóját; azt is ellenőrizze, hogy meglévő lapszabályok nem írják-e felül őket. Frissítse a tesztelendő oldalakat, majd ellenőrizze az UA-t.
A bővítmény először ellenőrzi a fájlt, majd megpróbálja telepíteni a szabályokat, végül kiírja a tartós konfigurációt. Ha a telepítés vagy az írás sikertelen, megpróbálja visszaállítani a böngészőben jelenleg mentett szabályokat. Ha a visszaállítás sikertelenségét jelzi, ellenőrizze a tényleges beállításokat. Ha a böngésző szinkronizálása vagy egy másik ablak egyidejűleg módosítja a konfigurációt, a folyamat nem tekinthető eszközök közötti tranzakciónak.
03Betöltés távoli címről
A távoli konfiguráció ugyanazt a JSON-tartalmat használja, mint a helyi biztonsági mentés. Ez egyszeri kézi betöltés és importálás, nem automatikusan frissülő előfizetés.
- Először exportáljon biztonsági mentést, vagy készítsen JSON-fájlt az alábbiak szerint.
- Helyezze a fájlt a célböngészőből elérhető HTTPS-szolgáltatásra, és szerezze meg a JSON-tartalmat közvetlenül visszaadó teljes címet, például
https://example.com/ua-pro/config.json. Ez csak példa; helyettesítse a saját tényleges címével. - Az UA Pro alkalmazásban nyissa meg a „Továbbiak” → „Konfiguráció importálása és exportálása” menüpontot, bontsa ki a „Távoli konfiguráció” részt, illessze be a címet, majd kattintson a „Betöltés” gombra.
- A sikeres betöltés és formátumellenőrzés után a bővítmény megerősítő ablakot és a távoli kiszolgáló nevét jeleníti meg. A „Konfiguráció tartalmának megtekintése” gombbal ellenőrizheti a ténylegesen letöltött teljes JSON-t. A megerősítés a helyi importálással azonos szabályok szerint frissíti a beállításokat; a megszakítás nem importál.
- Ha a fájl megváltozik a kiszolgálón, az új tartalom használatához adja meg újra a címet, töltse be, és erősítse meg. A panel újbóli megnyitásakor a cím nem marad meg automatikusan.
Csak közvetlen HTTPS-hivatkozás fogadható el; HTTP, a címben szereplő felhasználónév vagy jelszó és URL-töredék nem megengedett, az átirányításokat pedig nem követi. A kérés nem tartalmaz böngészős sütiket vagy bejelentkezési adatokat, nem küld Referer fejlécet, és megkerüli a gyorsítótárat; ezért a bejelentkezési sütit igénylő szolgáltatások nem használhatók. Az UA Pro nem alkalmazza erre a kérésre az e bővítményben beállított UA-szabályokat, de más bővítmények vagy hálózati eszközök módosíthatják a kérést. A cím lekérdezési paramétereket tartalmazhat; a hozzáférési tokent tartalmazó címet jelszóként őrizze. Megbízható címet használjon, és ellenőrizze, hogy a válasz közvetlenül JSON-fájl, nem pedig bejelentkezési oldal vagy kódot megjelenítő HTML-oldal.
A helyi fájl és a távoli válasz egyaránt legfeljebb 128 KiB lehet; a távoli olvasás időkorlátja 10 másodperc, és a ténylegesen olvasott tartalom számít. A böngésző szinkronizált tárhelyén az egyes elemekre kisebb kvóta is vonatkozik, így egy 128 KiB alatti fájl mentése is sikertelen lehet, ha a szabályok vagy egy könyvtár túl nagy. Hiba esetén ellenőrizze, hogy a kiszolgáló 200-as állapotot és érvényes JSON-t ad-e vissza, érvényes-e a tanúsítvány, átirányít-e a cím, és elérhető-e a hálózat.
04Teljes JSON-példa
Az alábbi példa UTF-8 kódolású config.json fájlként menthető. A példában szereplő tartományok és UA-értékek csak szemléltetésre szolgálnak; a meglévő konfiguráció lecserélése előtt készítsen mentést. A JSON megkülönbözteti a kis- és nagybetűket: a karakterláncokat dupla idézőjelbe tegye, az utolsó elem után ne írjon vesszőt, és ne írjon megjegyzést a JSON-ba.
{
"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
}
}
A példa egy beépített globális UA-t és négy tartományszabályt állít be. A pontosabb altartomány-szabályok, például a app.example.com, elsőbbséget élveznek a example.com szabállyal szemben. A szüneteltetett szabályok nem vesznek részt az aktív egyeztetésben, így a szülőtartomány vagy a globális szabály léphet érvénybe. Hogy egy valós webhely felismeri-e a példa UA-ját, a webhelytől függ.
05Felső szintű mezők és felülírás
| Mező | Példa | Szerep |
|---|---|---|
version |
2 |
Kötelező. Az új verzió csak a 2 számértéket fogadja el. |
type |
"ua-switcher-config" |
Kötelező. A konfiguráció típusazonosítója; pontosan meg kell egyeznie ezzel a karakterlánccal. |
timestamp |
"2026-11-16T06:00:00.000Z" |
Kötelező. UTC-idő ezredmásodpercekkel és Z jelöléssel; csak nyilvántartásra szolgál, nem határozza meg a szabályok érvénybe lépésének idejét. |
data |
{ ... } |
Kötelező. A teljes konfigurációt tartalmazó objektum, benne az alábbi táblázat összes mezőjével. |
Mezők a(z) data objektumban |
Helyes formátum | Az importálás működése ebben a verzióban |
|---|---|---|
globalRule |
Egy szabályobjektum vagy null |
A szabályobjektum helyettesíti a meglévő globális szabályt; a null törli azt. |
domainRules |
{ "域名": 规则对象 } |
A teljes objektum helyettesíti a korábbi tartományszabályokat; a {} törli őket. |
userCustomData |
{ "分类": ["UA", ...] } |
A teljes objektum helyettesíti a korábbi egyéni UA-könyvtárat; a {} kiüríti azt. |
userAppendData |
{ "分类": ["追加文本", ...] } |
A teljes objektum helyettesíti a korábbi hozzáfűzöttszöveg-könyvtárat; a {} kiüríti azt. |
resourceDomainFallback |
true vagy false |
JSON logikai érték: be- vagy kikapcsolja az erőforrás-tartalék tartományszabályt. |
Mind az öt mező kötelező; a null csak a(z) globalRule esetében használható. A hiányzó és ismeretlen mezőket és az ismétlődő JSON-kulcsokat elutasítja; a régi verziójú vagy részleges konfigurációkat sem importálja. A tartományszabályok és a két könyvtár teljes készletként cserélődnek: például az egyetlen tartományt tartalmazó domainRules felváltja a célböngésző többi meglévő tartományszabályát. Javasolt az új verzióval ténylegesen exportált fájlt szerkeszteni, és minden szükséges elemet teljes egészében megtartani.
Az erőforrás-tartalék tartományszabály csak akkor alkalmazhat szabályt az erőforráskérés céltartománya szerint, ha a főoldalnak nincs érvényes lap-, tartomány- vagy globális UA-ja. Ez nem jelenti azt, hogy minden más tartományból származó erőforrás felülírja a főoldal szabályát.
06Szabályobjektumok létrehozása
A globális szabály és minden tartományszabály szerkezete azonos:
{
"enabled": true,
"mode": "custom",
"params": {
"category": "常用",
"value": "ExampleAgent/1.0"
}
}
A enabled: true engedélyezett, a false szüneteltetett állapotot jelent. A mode határozza meg a(z) params mezőit:
6.1 Beépített UA: builtin
{
"enabled": true,
"mode": "builtin",
"params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}
A os és uaKey értéknek pontosan meg kell egyeznie a bővítmény ezen verziójának belső előbeállítási kulcsaival; ezek nem feltétlenül azonosak a felületen látható lefordított nevekkel. A legbiztosabb, ha kiválasztja az előbeállítást a felületen, exportálja a konfigurációt, majd átmásolja a megfelelő params értéket. Ha az előbeállítások listája verzióváltáskor változik, ellenőrizze újra.
6.2 Egyéni UA: custom
{
"enabled": true,
"mode": "custom",
"params": { "category": "常用", "value": "ExampleAgent/1.0" }
}
A value a teljes UA-karakterlánc. A category a kategorizálásra és a felületen történő szerkesztésre szolgál; javasolt az értéket a(z) userCustomData azonos nevű kategóriájában is szerepeltetni. Az érvényesülő szabály a saját value értékét olvassa; a szabály kézi importálása nem adja hozzá automatikusan az értéket az egyéni könyvtárhoz.
6.3 Szöveg hozzáfűzése: append
{
"enabled": true,
"mode": "append",
"params": { "category": "应用标记", "value": "MyApp/1.0" }
}
A bővítmény szóközt tesz az aktuális böngésző eredeti UA-ja után, majd hozzáfűzi a value értéket. Javasolt a szöveget a(z) userAppendData azonos nevű kategóriájában is megtartani; a szabály importálása nem tölti fel automatikusan a listát.
6.4 Véletlenszerű UA: random
{
"enabled": true,
"mode": "random",
"params": { "pool": "custom:随机示例", "strategy": "page" }
}
A strategy értéke "page" (választás minden teljes oldalbetöltéskor) vagy "tab" (megtartás szabály és lap szerint) kell legyen. A véletlen választás ismétlődhet; két egymást követő azonos eredmény nem feltétlenül jelenti azt, hogy nem történt új választás.
Gyakori pool értékek:
| Érték | A véletlen választás forrása |
|---|---|
all |
Minden beépített és egyéni UA, valamint a hozzáfűzött szövegből létrehozott UA-k |
builtin |
Minden beépített UA |
builtin_desktop, builtin_mobile, builtin_legacy |
Beépített asztali, mobil vagy régebbi eszközkategóriák |
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social |
A megfelelő beépített kategória |
custom |
Az összes egyéni kategória UA-i |
custom:分类名 |
A(z) userCustomData által megadott kategória UA-i |
append_all |
Az összes hozzáfűzött szövegnek megfelelő UA-k |
append:分类名 |
A(z) userAppendData által megadott kategória hozzáfűzött szövegének megfelelő UA-k |
A kettőspont utáni kategórianévnek egyeznie kell a könyvtár egyik kulcsával. Az engedélyezett véletlen szabálynak rendelkezésre álló jelöltekkel kell rendelkeznie, különben a fájlt elutasítja.
07Ellenőrzések kézi szerkesztéskor
- A(z)
domainRuleskulcsaiként tartományneveket adjon meg, példáulexample.comvagyshop.example.com; ne írjon behttps://értéket, útvonalat, portot vagy szóközt. A tartományszabályok az altartományokra is illeszkednek. Ebben a verzióban a*.example.commagát aexample.comértéket is tartalmazza; nem azt jelenti, hogy „csak altartományok”. - A kategórianevek tartalmazhatnak kínai karaktereket; nem üres karakterláncoknak kell lenniük, vezérlőkarakterek és veszélyes kétirányú szövegvezérlő karakterek nélkül. A
__proto__,prototypeésconstructornem lehet kategórianév. Az UA-hoz és a hozzáfűzött szöveghez nyomtatható ASCII-karakterek használata javasolt; új sort, tabulátort vagy más vezérlőkaraktert nem tartalmazhatnak. Egy UA legfeljebb 4096 karakterből állhat. A szövegben lévő dupla idézőjeleket és fordított perjeleket a JSON szabályai szerint escape-elni kell. - Minden kategóriához karakterláncok tömbje tartozik, például
"常用": ["Agent/1.0", "Agent/2.0"]. A szögletes zárójeleket egyetlen elem esetén is tartsa meg. Üres kategória így írható:[]. - A
true,falseésnullértéket ne tegye dupla idézőjelbe; a"false"karakterlánc, nem logikai érték. - A fájlnak érvényes UTF-8-nak és JSON-nak kell lennie, ismétlődő kulcsok nélkül. A bővítmény a szerkezetet, a mezőtípusokat, a szabályokat, az előbeállítások nevét és a véletlen készleteket is ellenőrzi; a helyes szintaxis nem garantálja a szabály használhatóságát.
A konfigurációs fájl módosíthatja a böngésző által a webhelyeknek küldött UA-t. A HTTPS védi az átvitelt, de nem garantálja, hogy a kiszolgáló konfigurációja megfelel a szándékainak. Csak megbízható forrásból importáljon fájlt, megerősítés előtt vizsgálja meg a tartalmat, és a céloldal frissítése után ellenőrizze a tényleges hatást.
08Gyakori kérdések
| Jelenség | Ellenőrzés |
|---|---|
| Hibás fájlformátumot jelez | Ellenőrizze az UTF-8 kódolást, a JSON szintaxisát, az ismétlődő kulcsokat, a verziót, a kötelező mezőket és a szabálytípusokat. Sablonként az új verzióból exportált fájlt használjon. |
| A távoli betöltés sikertelen | Ellenőrizze a HTTPS-tanúsítványt, a közvetlen hivatkozást, a hálózatot és a válasz tartalmát. Átirányítás, sütis bejelentkezés és HTTP nem engedélyezett. |
| Importálás után kevesebb a szabály | A tartományszabályok és mindkét könyvtár teljes készletként cserélődik. Állítsa vissza az importálás előtti mentést, vagy egészítse ki az új fájlt minden megtartandó elemmel. |
| Üres globális szabályt importált, de az oldal továbbra is más UA-t használ | Ellenőrizze a meglévő lapszabályokat vagy az illeszkedő tartományszabályokat; ezek elsőbbséget élvezhetnek a globális szabállyal szemben. |
| A művelet sikeres, de az UA helytelen | Ellenőrizze, hogy a szabály engedélyezett-e, tartalma érvényes-e, a véletlen készletben van-e használható elem, és van-e magasabb prioritású lap- vagy tartományszabály; majd frissítse az oldalt. |
| Sok adat importálásakor tárhelyhiba jelentkezik | A fájlra és a böngésző szinkronizált tárhelyére is méretkorlát vonatkozik. Csökkentse a szabályok vagy listák méretét, próbálja újra, és ellenőrizze a meglévő konfigurációt. |
| A távoli fájl módosítása után a bővítmény nem változik | A távoli betöltés egyszeri kézi importálás. Adja meg újra a címet, töltse be, és erősítse meg. |