Tämä opas koskee UA Pro 1.5.0 -versiota. Se käsittelee konfiguraation varmuuskopiointia, siirtoa, kirjoittamista käsin ja lataamista etäosoitteesta. Uusi versio käyttää täydellistä tilannekuvaa: konfiguraatiotiedoston version on 2.
Vie kohdeselaimen konfiguraatiosta varmuuskopio ennen tuontia. Jokainen tuonti korvaa yleissäännön, kaikki verkkotunnussäännöt, molemmat UA-kirjastot ja resurssin verkkotunnuksen varasäännön kytkimen tiedoston täydellisellä tilannekuvalla. Niitä ei yhdistetä yksitellen. "globalRule": null poistaa kohdeselaimen yleissäännön.
01Konfiguraation vienti
- Napsauta selaimen työkalurivin UA Pro -kuvaketta.
- Avaa ”Lisää” → ”Tuo tai vie konfiguraatio”.
- Napsauta ”Vie konfiguraatio” ja tallenna ladattu
.json-tiedosto. - Tiedostonimi on esimerkiksi
ua-switcher-config-2026-11-16.json. Nimen päivämäärä muodostetaan UTC-ajan mukaan, joten se voi poiketa paikallisesta päivämäärästä yhdellä päivällä.
Tiedosto sisältää seuraavat pysyvät asetukset:
- Yleissääntö ja sen käytössä- tai taukotila.
- Kaikki verkkotunnussäännöt ja niiden käytössä- tai taukotilat.
- Omien UA-arvojen luokat ja kohteet.
- Lisättävän tekstin luokat ja kohteet.
- ”Resurssin verkkotunnuksen varasääntö” -kytkin.
Tiedosto ei sisällä välilehtisääntöjä, jo arvottuja satunnaisten UA-arvojen sidoksia, avoimia välilehtiä, käyttöliittymän kieltä, teemaa eikä kelluvan näkymän asetuksia. Niitä ei palauteta varmuuskopiosta tuonnissa. Kohdeselaimen olemassa olevia välilehtisääntöjä ei myöskään poisteta, joten ne voivat edelleen ohittaa verkkotunnus- tai yleissäännön.
Viety tiedosto on luettavaa JSON-selvätekstiä. Säilytä varmuuskopio huolellisesti, jos omat UA-arvot tai luokat sisältävät tietoja, joita et halua julkistaa.
02Tuonti paikallisesta tiedostosta
- Avaa kohdeselaimessa UA Pro → ”Lisää” → ”Tuo tai vie konfiguraatio”.
- Vie ensin kohdeselaimen nykyinen konfiguraatio valitsemalla ”Vie konfiguraatio”, jotta voit palauttaa sen tarvittaessa.
- Napsauta ”Tuo konfiguraatio” ja valitse
.json-tiedosto. - Lue korvaamista koskeva ilmoitus sekä sääntöjen ja luetteloiden määrät. Valitsemalla ”Näytä määrityksen sisältö” voit tarkistaa koko JSON-sisällön ennen vahvistusta. ”Peruuta” ei kirjoita muutoksia. Vahvista ja odota ilmoitusta ”Konfiguraatio tuotu!”. Jos asetukset muuttuvat vahvistuksen aikana, laajennus pyytää aloittamaan uudelleen.
- Tarkista yleis- ja verkkotunnussäännöt, omat luettelot ja resurssin verkkotunnuksen varasäännön kytkin. Tarkista myös, ohittavatko olemassa olevat välilehtisäännöt ne. Päivitä testattavat sivut ja tarkista UA.
Laajennus tarkistaa ensin tiedoston, yrittää sitten asentaa säännöt ja kirjoittaa lopuksi pysyvät asetukset. Jos asennus tai kirjoitus epäonnistuu, se yrittää palauttaa selaimeen sillä hetkellä tallennetut säännöt. Jos palautus ei onnistu, tarkista todelliset asetukset. Prosessi ei ole laitteiden välinen transaktio, kun selaimen synkronointi tai toinen ikkuna muuttaa asetuksia samanaikaisesti.
03Lataaminen etäosoitteesta
Etäkonfiguraatiossa käytetään samaa JSON-sisältöä kuin paikallisessa varmuuskopiossa. Lataus ja tuonti tehdään käsin kertaluonteisesti; kyseessä ei ole automaattisesti päivittyvä tilaus.
- Vie ensin varmuuskopio tai valmistele JSON-tiedosto alla olevien ohjeiden mukaan.
- Sijoita tiedosto HTTPS-palveluun, jota kohdeselain voi käyttää, ja hanki täydellinen osoite, joka palauttaa suoraan JSON-sisällön, esimerkiksi
https://example.com/ua-pro/config.json. Tämä on vain esimerkki: korvaa se omalla osoitteellasi. - Siirry UA Prossa kohtaan ”Lisää” → ”Tuo tai vie konfiguraatio”, laajenna ”Etäkonfiguraatio”-osio, liitä osoite ja napsauta ”Lataa”.
- Kun lataus ja muodon tarkistus onnistuvat, laajennus näyttää vahvistusikkunan ja etäpalvelimen nimen. Valitsemalla ”Näytä määrityksen sisältö” voit tarkistaa koko ladatun JSON-sisällön. Vahvistus päivittää asetukset samoin kuin paikallinen tuonti; peruutus ei tuo mitään.
- Kun palvelimen tiedosto muuttuu, syötä osoite uudelleen, lataa ja vahvista, jos haluat käyttää uutta sisältöä. Osoitetta ei säilytetä automaattisesti, kun paneeli avataan uudelleen.
Vain suorat HTTPS-osoitteet hyväksytään. HTTP, osoitteen käyttäjätunnus tai salasana ja fragmentti eivät ole sallittuja, eikä uudelleenohjauksia seurata. Pyyntö ei sisällä selaimen evästeitä tai kirjautumistietoja eikä lähetä Referer-otsaketta, ja se ohittaa välimuistin. Evästekirjautumista vaativa palvelu ei siis sovellu. UA Pro ei sovella tämän laajennuksen UA-sääntöjä pyyntöön, mutta muut laajennukset tai verkkolaitteet voivat muuttaa sitä. Osoite voi sisältää kyselyparametreja; säilytä käyttöoikeustunnuksen sisältävä osoite kuin salasana. Käytä luotettua osoitetta ja varmista, että vastaus on suoraan JSON-tiedosto eikä kirjautumissivu tai koodia näyttävä HTML-sivu.
Paikallisen tiedoston ja etävastauksen raja on 128 KiB. Etälatauksen aikaraja on 10 sekuntia, ja tosiasiallisesti luettu sisältö lasketaan mukaan. Selaimen synkronointitallennuksessa yksittäisen kohteen kiintiö on pienempi, joten alle 128 KiB:n tiedosto voi silti olla liian suuri tallennettavaksi sääntöjen tai yksittäisen kirjaston koon vuoksi. Tarkista virhetilanteessa palvelimen 200-vastaus ja kelvollinen JSON, varmenne, mahdollinen uudelleenohjaus ja verkkoyhteys.
04Täydellinen JSON-esimerkki
Seuraavan esimerkin voi tallentaa UTF-8-koodattuna config.json-tiedostona. Verkkotunnukset ja UA-arvot ovat vain esimerkkejä. Varmuuskopioi nykyinen konfiguraatio ennen korvaamista. JSON erottaa isot ja pienet kirjaimet; merkkijonoissa käytetään suoria lainausmerkkejä. Älä lisää pilkkua viimeisen alkion jälkeen tai kommentteja JSONiin.
{
"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
}
}
Esimerkissä asetetaan yksi sisäänrakennettu yleinen UA ja neljä verkkotunnussääntöä. Tarkemmat aliverkkotunnussäännöt, kuten app.example.com, ovat etusijalla sääntöön example.com nähden. Tauolla olevia sääntöjä ei käytetä täsmäytyksessä, joten ylemmän verkkotunnuksen tai yleissääntö voi tulla voimaan. Esimerkki-UA:n tunnistaminen riippuu sivustosta.
05Ylimmän tason kentät ja korvaaminen
| Kenttä | Esimerkki | Tarkoitus |
|---|---|---|
version |
2 |
Pakollinen. Uusi versio hyväksyy vain numeroarvon 2. |
type |
"ua-switcher-config" |
Pakollinen konfiguraatiotyypin tunniste. Merkkijonon on vastattava tätä täsmälleen. |
timestamp |
"2026-11-16T06:00:00.000Z" |
Pakollinen. UTC-aika millisekunteineen ja Z-merkintöineen; vain kirjanpitoa varten, ei määrää sääntöjen voimaantuloa. |
data |
{ ... } |
Pakollinen. Koko konfiguraation sisältävä olio, jossa ovat kaikki seuraavan taulukon kentät. |
Kentät kohteessa data |
Oikea muoto | Tuonnin toiminta tässä versiossa |
|---|---|---|
globalRule |
Yksi sääntöolio tai null |
Sääntöolio korvaa nykyisen yleissäännön; null poistaa sen. |
domainRules |
{ "域名": 规则对象 } |
Koko olio korvaa aiemmat verkkotunnussäännöt; {} tyhjentää ne. |
userCustomData |
{ "分类": ["UA", ...] } |
Koko olio korvaa aiemman oman UA-kirjaston; {} tyhjentää sen. |
userAppendData |
{ "分类": ["追加文本", ...] } |
Koko olio korvaa aiemman lisättävien tekstien kirjaston; {} tyhjentää sen. |
resourceDomainFallback |
true tai false |
JSON-totuusarvo: resurssin verkkotunnuksen varasääntö päälle tai pois. |
Kaikki viisi kenttää ovat pakollisia, eikä null ole sallittu muissa kuin kentässä globalRule. Puuttuvat ja tuntemattomat kentät sekä toistuvat JSON-avaimet hylätään; myöskään vanhan version tai osittaisia konfiguraatioita ei tuoda. Verkkotunnussäännöt ja molemmat kirjastot korvataan kokonaisina: esimerkiksi vain yhden verkkotunnuksen sisältävä domainRules korvaa kohdeselaimen muutkin verkkotunnussäännöt. Muokkaa mieluiten uudesta versiosta vietyä tiedostoa ja säilytä kaikki tarvitsemasi kohteet.
Resurssin verkkotunnuksen varasääntö voi soveltaa sääntöä resurssipyynnön kohdeverkkotunnuksen mukaan vain, jos pääsivulla ei ole voimassa olevaa välilehti-, verkkotunnus- tai yleistä UA:ta. Se ei tarkoita, että kaikki verkkotunnusten väliset resurssit ohittaisivat pääsivun säännön.
06Sääntöolion kirjoittaminen
Yleissäännöllä ja jokaisella verkkotunnussäännöllä on sama rakenne:
{
"enabled": true,
"mode": "custom",
"params": {
"category": "常用",
"value": "ExampleAgent/1.0"
}
}
enabled: true tarkoittaa käytössä ja false tauolla. mode määrää kohteen params kentät:
6.1 Sisäänrakennettu UA: builtin
{
"enabled": true,
"mode": "builtin",
"params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}
os ja uaKey on kirjoitettava täsmälleen tämän laajennusversion sisäisten esiasetusavainten mukaan; ne eivät välttämättä vastaa käyttöliittymän käännettyjä nimiä. Varminta on valita esiasetus käyttöliittymässä, viedä konfiguraatio ja kopioida vastaava params. Tarkista arvot uudelleen, jos esiasetukset muuttuvat version mukana.
6.2 Oma UA: custom
{
"enabled": true,
"mode": "custom",
"params": { "category": "常用", "value": "ExampleAgent/1.0" }
}
value on täydellinen UA-merkkijono. category on luokittelua ja käyttöliittymässä muokkaamista varten. Sama arvo kannattaa sisällyttää myös kohteen userCustomData samannimiseen luokkaan. Käytössä oleva sääntö lukee oman kenttänsä value; käsin tuotu sääntö ei lisää arvoa automaattisesti omaan kirjastoon.
6.3 Lisättävä teksti: append
{
"enabled": true,
"mode": "append",
"params": { "category": "应用标记", "value": "MyApp/1.0" }
}
Laajennus lisää selaimen alkuperäisen UA:n perään välilyönnin ja sitten tekstin value. Sama teksti kannattaa säilyttää myös kohteen userAppendData samannimisessä luokassa; säännön tuonti ei täytä luetteloa automaattisesti.
6.4 Satunnainen UA: random
{
"enabled": true,
"mode": "random",
"params": { "pool": "custom:随机示例", "strategy": "page" }
}
Kohteen strategy on oltava "page" (arvonta jokaisella täydellä sivulatauksella) tai "tab" (säilytetään säännön ja välilehden mukaan). Arvonnassa sama arvo voi toistua; kaksi samaa peräkkäistä tulosta ei välttämättä tarkoita, ettei uutta arvontaa tehty.
Yleisiä pool-arvoja:
| Arvo | Satunnaisten arvojen lähde |
|---|---|
all |
Kaikki sisäänrakennetut UA:t, omat UA:t ja lisättävästä tekstistä muodostetut UA:t |
builtin |
Kaikki sisäänrakennetut UA:t |
builtin_desktop, builtin_mobile, builtin_legacy |
Sisäänrakennetut työpöytä-, mobiili- tai vanhojen laitteiden luokat |
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social |
Vastaavat sisäänrakennetut luokat |
custom |
Kaikkien omien luokkien UA:t |
custom:分类名 |
Kohteessa userCustomData määritellyn luokan UA:t |
append_all |
Kaikkia lisättäviä tekstejä vastaavat UA:t |
append:分类名 |
Kohteessa userAppendData määritellyn luokan lisättäviä tekstejä vastaavat UA:t |
Kaksoispisteen jälkeisen luokan nimen on vastattava kirjaston avainta. Käytössä olevalla satunnaissäännöllä on oltava käytettävissä olevia vaihtoehtoja, muuten tiedosto hylätään.
07Tarkistukset käsin muokattaessa
- Kirjoita kohteen
domainRulesavaimiksi verkkotunnuksia, esimerkiksiexample.comjashop.example.com, älähttps://-osaa, polkua, porttia tai välilyöntejä. Verkkotunnussäännöt vastaavat myös alempia aliverkkotunnuksia;*.example.comsisältää tässä versiossa myös itse verkkotunnuksenexample.com, eikä tarkoita vain aliverkkotunnuksia. - Luokkien nimissä voi käyttää kiinaa. Nimen on oltava epätyhjä merkkijono, eikä se saa sisältää ohjausmerkkejä tai vaarallisia kaksisuuntaisen tekstin ohjausmerkkejä.
__proto__,prototypejaconstructoreivät kelpaa luokkien nimiksi. UA-arvoissa ja lisättävässä tekstissä suositellaan tulostettavia ASCII-merkkejä; niissä ei saa olla rivinvaihtoja, sarkaimia tai muita ohjausmerkkejä. Yksi UA saa olla enintään 4096 merkkiä. Tekstin suorat lainausmerkit ja kenoviivat on suojattava JSON-sääntöjen mukaisesti. - Jokaista luokkaa vastaa merkkijonotaulukko, esimerkiksi
"常用": ["Agent/1.0", "Agent/2.0"]. Säilytä hakasulkeet myös silloin, kun alkioita on vain yksi. Tyhjän luokan voi kirjoittaa[]. true,falsejanullkirjoitetaan ilman lainausmerkkejä;"false"on merkkijono, ei totuusarvo.- Tiedoston on oltava kelvollista UTF-8:aa ja JSONia eikä siinä saa olla toistuvia avaimia. Laajennus tarkistaa myös rakenteen, kenttien tyypit, säännöt, esiasetusten nimet ja satunnaisjoukot; oikea syntaksi ei yksin takaa säännön käyttökelpoisuutta.
Konfiguraatiotiedosto voi muuttaa selaimen sivustoille lähettämää UA:ta. HTTPS suojaa siirtoa, mutta ei takaa palvelimen konfiguraation vastaavan toiveitasi. Tuo vain luotetuista lähteistä, tarkista sisältö ennen vahvistusta ja tarkista todellinen vaikutus päivitettyäsi kohdesivun.
08Usein kysytyt kysymykset
| Ongelma | Tarkistukset |
|---|---|
| Ilmoitus virheellisestä tiedostomuodosta | Tarkista UTF-8, JSON-syntaksi, toistuvat avaimet, versio, pakolliset kentät ja sääntötyypit. Käytä uuden version vientitiedostoa mallina. |
| Etälataus epäonnistuu | Tarkista HTTPS-varmenne, suora osoite, verkkoyhteys ja vastauksen sisältö. Uudelleenohjaukset, evästekirjautuminen ja HTTP eivät ole sallittuja. |
| Sääntöjä on vähemmän tuonnin jälkeen | Verkkotunnussäännöt ja molemmat kirjastot korvataan kokonaisina. Palauta ennen tuontia tehdystä varmuuskopiosta tai lisää säilytettävät kohteet uuteen tiedostoon. |
| Tyhjä yleissääntö tuotiin, mutta sivu käyttää toista UA:ta | Tarkista olemassa olevat välilehtisäännöt ja täsmäävät verkkotunnussäännöt; ne voivat olla yleissääntöä etusijalla. |
| Onnistumisilmoitus näkyy, mutta UA on väärä | Tarkista, että sääntö on käytössä ja sen sisältö kelvollinen, satunnaisjoukossa on vaihtoehtoja eikä ylemmän etusijan välilehti- tai verkkotunnussääntöä ole. Päivitä sitten sivu. |
| Suuren tietomäärän tuonnissa tulee tallennusvirhe | Sekä tiedoston koolla että selaimen synkronointitallennuksella on rajoitukset. Karsi sääntöjä tai luetteloita, yritä uudelleen ja tarkista nykyinen konfiguraatio. |
| Laajennus ei muutu etätiedoston muokkaamisen jälkeen | Etälataus on käsin tehtävä kertaluonteinen tuonti. Syötä osoite uudelleen, lataa ja vahvista. |