UA Pro konfigurációs útmutató

Importálás, exportálás és távoli konfiguráció

Konfiguráció biztonsági mentése, átvitele, kézi elkészítése és betöltése távoli címről.

Érintett verzió: UA Pro 1.5.0

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

  1. Kattintson az UA Pro ikonjára a böngésző eszköztárán.
  2. Nyissa meg a „Továbbiak” → „Konfiguráció importálása és exportálása” menüpontot.
  3. Kattintson a „Konfiguráció exportálása” gombra, és mentse a letöltött .json fájlt.
  4. A fájlnév például ua-switcher-config-2026-11-16.json lehet. 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

  1. A célböngészőben nyissa meg az UA Pro → „Továbbiak” → „Konfiguráció importálása és exportálása” menüpontot.
  2. 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.
  3. Kattintson a „Konfiguráció importálása” gombra, és válassza ki a .json fájlt.
  4. 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.
  5. 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.

  1. Először exportáljon biztonsági mentést, vagy készítsen JSON-fájlt az alábbiak szerint.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

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

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:

JSON
{
  "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

JSON
{
  "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

JSON
{
  "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

JSON
{
  "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

JSON
{
  "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) domainRules kulcsaiként tartományneveket adjon meg, például example.com vagy shop.example.com; ne írjon be https:// értéket, útvonalat, portot vagy szóközt. A tartományszabályok az altartományokra is illeszkednek. Ebben a verzióban a *.example.com magát a example.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 és constructor nem 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 és null é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.