Veiledningen gjelder UA Pro 1.5.0 og beskriver sikkerhetskopiering, flytting, manuell skriving av konfigurasjon og lasting fra en ekstern adresse. Den nye versjonen bruker et fullstendig øyeblikksbilde: Konfigurasjonsfilens version er 2.
Eksporter en sikkerhetskopi i målnettleseren før import. Hver import erstatter den globale regelen, hele settet med domeneregler, begge UA-bibliotekene og bryteren for reserve med ressursens domene med filens fullstendige øyeblikksbilde. Elementene flettes ikke enkeltvis. "globalRule": null sletter den globale regelen i målnettleseren.
01Eksporter konfigurasjon
- Klikk på UA Pro-ikonet i nettleserens verktøylinje.
- Åpne «Mer» → «Importer eller eksporter konfigurasjon».
- Klikk på «Eksporter konfigurasjon» og lagre den nedlastede
.json-filen. - Filnavnet ligner
ua-switcher-config-2026-11-16.json. Datoen i navnet genereres etter UTC og kan avvike én dag fra lokal dato.
Filen inneholder følgende varige konfigurasjon:
- Den globale regelen og om den er aktivert eller satt på pause.
- Hele settet med domeneregler og om de er aktivert eller satt på pause.
- Egendefinerte UA-kategorier og oppføringer.
- Kategorier og oppføringer for tilleggstekst.
- Bryteren «Reserve med ressursens domene».
Filen inneholder ikke faneregler, allerede trukne tilfeldige UA-bindinger, åpne faner, grensesnittspråk, tema eller innstillinger for det flytende panelet. Disse gjenopprettes ikke fra sikkerhetskopien ved import. Eksisterende faneregler i målnettleseren slettes heller ikke og kan derfor fortsatt ha forrang foran domeneregler eller den globale regelen.
Den eksporterte filen er lesbar JSON i klartekst. Oppbevar sikkerhetskopien trygt hvis egendefinerte UA-er eller kategorier inneholder opplysninger du ikke vil offentliggjøre.
02Importer fra lokal fil
- Åpne UA Pro → «Mer» → «Importer eller eksporter konfigurasjon» i målnettleseren.
- Klikk først på «Eksporter konfigurasjon» for å lagre målnettleserens opprinnelige konfigurasjon for eventuell gjenoppretting.
- Klikk på «Importer konfigurasjon» og velg
.json-filen. - Les advarselen om erstatning og antallet regler og listeelementer. Klikk på «Vis konfigurasjonsinnhold» for å kontrollere hele JSON-innholdet før bekreftelse. «Avbryt» skriver ingenting. Vent etter bekreftelsen på «Konfigurasjonen er importert!». Hvis innstillingene endres under bekreftelsen, ber utvidelsen deg gjenta handlingen.
- Kontroller globale regler og domeneregler, egendefinerte lister og bryteren for reserve med ressursens domene. Kontroller også om eksisterende faneregler har forrang. Last inn testsiden på nytt og kontroller UA.
Utvidelsen kontrollerer først filen, forsøker deretter å installere reglene og skriver til slutt den varige konfigurasjonen. Hvis installasjon eller skriving mislykkes, forsøker den å gjenopprette reglene som nå er lagret i nettleseren. Kontroller de faktiske innstillingene hvis gjenoppretting ikke er mulig. Ved samtidige endringer gjennom nettlesersynkronisering eller andre vinduer er prosessen ikke en transaksjon på tvers av enheter.
03Last inn fra ekstern adresse
Ekstern konfigurasjon bruker samme JSON-innhold som en lokal sikkerhetskopi. Lasting og import skjer manuelt én gang; det er ikke et automatisk oppdatert abonnement.
- Eksporter først en sikkerhetskopi av konfigurasjonen, eller opprett en JSON-fil som beskrevet nedenfor.
- Plasser filen på en HTTPS-tjeneste som målnettleseren kan nå, og finn den fullstendige adressen som returnerer JSON-innholdet direkte, for eksempel
https://example.com/ua-pro/config.json. Adressen er bare et eksempel; erstatt den med din faktiske adresse. - Gå til «Mer» → «Importer eller eksporter konfigurasjon» i UA Pro, utvid «Ekstern konfigurasjon», lim inn adressen og klikk på «Last inn».
- Etter lasting og formatkontroll viser utvidelsen en bekreftelsesboks og det eksterne vertsnavnet. Klikk på «Vis konfigurasjonsinnhold» for å kontrollere hele JSON-innholdet som faktisk ble lastet ned. Bekreftelse oppdaterer innstillingene etter samme regler som lokal import; avbrytelse importerer ingenting.
- Når filen på serveren endres, må du angi adressen på nytt, laste inn og bekrefte for å bruke det nye innholdet. Adressen beholdes ikke automatisk når panelet åpnes igjen.
Bare direkte HTTPS-lenker godtas; HTTP, brukernavn eller passord i adressen og URL-fragmenter er ikke tillatt, og omdirigeringer følges ikke. Forespørselen inneholder verken nettleserkapsler eller påloggingsopplysninger, sender ingen Referer og omgår hurtigbufferen. Tjenester som krever en påloggingskapsel, er derfor uegnet. UA Pro bruker ikke UA-reglene som er konfigurert i denne utvidelsen på forespørselen, men andre utvidelser eller nettverksenheter kan likevel endre den. Adressen kan inneholde spørreparametere; beskytt adresser med tilgangstokener som passord. Bruk en pålitelig adresse og sørg for at svaret er direkte en JSON-fil, ikke en påloggingsside eller HTML-side som viser kode.
Lokale filer og eksterne svar er hver begrenset til 128 KiB; ekstern lesing er begrenset til 10 sekunder, og faktisk lest innhold telles. Nettleserens synkroniserte lagring har dessuten en mindre kvote per element: Selv under 128 KiB kan lagring mislykkes hvis reglene eller ett bibliotek er for stort. Kontroller ved feil om serveren returnerer status 200 og gyldig JSON, om sertifikatet er gyldig, om adressen omdirigerer og om nettverket er tilgjengelig.
04Fullstendig JSON-eksempel
Eksemplet kan lagres som config.json med UTF-8-koding. Eksempeldomener og UA-verdier er bare illustrasjoner; sikkerhetskopier eksisterende konfigurasjon før erstatning. JSON skiller mellom store og små bokstaver: Bruk rette doble anførselstegn for strenger, ikke sett komma etter siste element og ikke skriv kommentarer i 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
}
}
Eksemplet angir én innebygd global UA og fire domeneregler. Mer spesifikke underdomeneregler som app.example.com har forrang foran example.com. Regler på pause deltar ikke i aktiv matching; en regel for overordnet domene eller den globale regelen kan i stedet gjelde. Om et faktisk nettsted gjenkjenner eksempel-UA-en, avhenger av nettstedet.
05Felt på øverste nivå og erstatning
| Felt | Eksempel | Formål |
|---|---|---|
version |
2 |
Påkrevd. Den nye versjonen godtar bare tallverdien 2. |
type |
"ua-switcher-config" |
Påkrevd. Identifikator for konfigurasjonstype; må samsvare nøyaktig med denne strengen. |
timestamp |
"2026-11-16T06:00:00.000Z" |
Påkrevd. UTC-tid med millisekunder og Z; bare for registrering og bestemmer ikke når regler trer i kraft. |
data |
{ ... } |
Påkrevd. Objekt med hele konfigurasjonen og alle feltene i følgende tabell. |
Felt i data |
Riktig format | Importatferd i denne versjonen |
|---|---|---|
globalRule |
Et regelobjekt eller null |
Regelobjektet erstatter den eksisterende globale regelen; null sletter den. |
domainRules |
{ "域名": 规则对象 } |
Hele objektet erstatter tidligere domeneregler; {} tømmer dem. |
userCustomData |
{ "分类": ["UA", ...] } |
Hele objektet erstatter det tidligere egendefinerte UA-biblioteket; {} tømmer det. |
userAppendData |
{ "分类": ["追加文本", ...] } |
Hele objektet erstatter det tidligere biblioteket med tilleggstekst; {} tømmer det. |
resourceDomainFallback |
true eller false |
Boolsk JSON-verdi: slår reserve med ressursens domene på eller av. |
Alle fem felt er påkrevd; null er bare tillatt for globalRule. Manglende eller ukjente felt og dupliserte JSON-nøkler avvises; gamle versjoner og delvise konfigurasjoner importeres heller ikke. Domenereglene og begge bibliotekene erstattes hver for seg i sin helhet: Eksempelvis erstatter domainRules med bare ett domene de øvrige eksisterende domenereglene i målnettleseren. Rediger helst en fil som faktisk er eksportert fra den nye versjonen, og behold alle nødvendige elementer fullstendig.
Reserve med ressursens domene kan bare bruke en regel basert på ressursforespørselens måldomene når hovedsiden ikke har en gyldig fane-, domene- eller global UA. Det betyr ikke at alle ressurser på tvers av domener overstyrer hovedsidens regel.
06Skriv et regelobjekt
Den globale regelen og hver domeneregel bruker samme struktur:
{
"enabled": true,
"mode": "custom",
"params": {
"category": "常用",
"value": "ExampleAgent/1.0"
}
}
enabled: true betyr aktivert og false satt på pause. mode bestemmer feltene i params:
6.1 Innebygd UA: builtin
{
"enabled": true,
"mode": "builtin",
"params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}
os og uaKey må samsvare nøyaktig med de interne forhåndsinnstilte nøklene i denne utvidelsesversjonen; de er ikke nødvendigvis lik den oversatte teksten i grensesnittet. Velg helst forhåndsinnstillingen i grensesnittet, eksporter konfigurasjonen og kopier tilsvarende params. Kontroller på nytt når listen over forhåndsinnstillinger endres mellom versjoner.
6.2 Egendefinert UA: custom
{
"enabled": true,
"mode": "custom",
"params": { "category": "常用", "value": "ExampleAgent/1.0" }
}
value er den fullstendige UA-strengen. category brukes til kategorisering og redigering i grensesnittet; det anbefales også å ta med verdien i kategorien med samme navn i userCustomData. Den aktive regelen leser sitt eget value; manuell import av en regel legger ikke automatisk verdien til i det egendefinerte biblioteket.
6.3 Tilleggstekst: append
{
"enabled": true,
"mode": "append",
"params": { "category": "应用标记", "value": "MyApp/1.0" }
}
Utvidelsen legger til et mellomrom etter den gjeldende nettleserens opprinnelige UA og deretter value. Behold gjerne teksten også i kategorien med samme navn i userAppendData; import av en regel fyller ikke listen automatisk.
6.4 Tilfeldig UA: random
{
"enabled": true,
"mode": "random",
"params": { "pool": "custom:随机示例", "strategy": "page" }
}
strategy må være "page" (trekk ved hver fullstendige sidelasting) eller "tab" (beholdes per regel og fane). Tilfeldige trekk kan gjentas; to like resultater på rad betyr ikke nødvendigvis at det ikke ble trukket på nytt.
Vanlige verdier for pool:
| Verdi | Tilfeldig kilde |
|---|---|
all |
Alle innebygde og egendefinerte UA-er samt UA-er laget av tilleggstekst |
builtin |
Alle innebygde UA-er |
builtin_desktop, builtin_mobile, builtin_legacy |
Innebygde kategorier for stasjonære, mobile eller eldre enheter |
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social |
De tilsvarende innebygde kategoriene |
custom |
UA-er i alle egendefinerte kategorier |
custom:分类名 |
UA-er i kategorien angitt i userCustomData |
append_all |
UA-er som svarer til all tilleggstekst |
append:分类名 |
UA-er som svarer til tilleggstekst i kategorien angitt i userAppendData |
Kategorinavnet etter kolon må samsvare med nøkkelen i biblioteket. En aktivert tilfeldig regel må ha tilgjengelige kandidater, ellers avvises filen.
07Kontroll ved manuell redigering
- Bruk domenenavn som nøkler i
domainRules, for eksempelexample.comellershop.example.com, utenhttps://, sti, port eller mellomrom. Domeneregler matcher også underdomener;*.example.comomfatter i denne versjonen også selveexample.com, ikke bare underdomener. - Kategorinavn kan være kinesiske og må være ikke-tomme strenger uten kontrolltegn eller farlige kontrolltegn for toveis tekst.
__proto__,prototypeogconstructorkan ikke brukes som kategorinavn. Bruk helst utskrivbare ASCII-tegn for UA og tilleggstekst. De må ikke inneholde linjeskift, tabulatorer eller andre kontrolltegn; én UA kan ha høyst 4096 tegn. Rette doble anførselstegn og omvendte skråstreker i tekst må escapes etter JSON-reglene. - Hver kategori svarer til en strengmatrise, for eksempel
"常用": ["Agent/1.0", "Agent/2.0"]. Behold hakeparentesene også ved ett element. En tom kategori kan skrives som[]. true,falseognullskal ikke settes i doble anførselstegn;"false"er en streng, ikke en boolsk verdi.- Filen må inneholde gyldig UTF-8 og JSON uten dupliserte nøkler. Utvidelsen kontrollerer også struktur, felttyper, regler, navn på forhåndsinnstillinger og tilfeldige utvalg. Riktig syntaks garanterer ikke at en regel kan brukes.
En konfigurasjonsfil kan endre UA-en nettleseren sender til nettsteder. HTTPS beskytter overføringen, men garanterer ikke at serverens konfigurasjon samsvarer med ønskene dine. Importer bare filer fra pålitelige kilder, kontroller innholdet før bekreftelse og den faktiske virkningen etter at målsiden er lastet på nytt.
08Vanlige spørsmål
| Problem | Kontroll |
|---|---|
| Ugyldig filformat rapporteres | Kontroller UTF-8, JSON-syntaks, dupliserte nøkler, versjon, påkrevde felt og regeltyper; bruk en eksport fra den nye versjonen som mal. |
| Ekstern lasting mislykkes | Kontroller HTTPS-sertifikat, direkte lenke, nettverk og svarinnhold; omdirigeringer, kapselbasert pålogging og HTTP er ikke tillatt. |
| Regler mangler etter import | Domenereglene og begge bibliotekene erstattes hver for seg i sin helhet. Gjenopprett sikkerhetskopien fra før importen, eller legg til elementene som skal beholdes i den nye filen. |
| Etter import av en tom global regel bruker siden fortsatt en annen UA | Kontroller eksisterende faneregler eller matchende domeneregler; de kan ha forrang foran den globale regelen. |
| Handlingen lykkes, men UA er feil | Kontroller at regelen er aktivert, innholdet gyldig, det tilfeldige utvalget har tilgjengelige elementer og at ingen fane- eller domeneregler har høyere prioritet. Last deretter siden på nytt. |
| Lagringsfeil ved import av mye data | Filen og nettleserens synkroniserte lagring har størrelsesgrenser. Reduser regler eller lister, prøv igjen og kontroller eksisterende konfigurasjon. |
| Utvidelsen endres ikke etter endring av den eksterne filen | Ekstern lasting er en manuell engangsimport; angi adressen på nytt, last inn og bekreft. |