UA Pro-konfigurationsvejledning

Import, eksport og ekstern konfiguration

Sikkerhedskopiér, flyt og skriv konfiguration manuelt, og indlæs den fra en ekstern adresse.

Gælder UA Pro 1.5.0

Vejledningen gælder UA Pro 1.5.0 og beskriver sikkerhedskopiering, flytning, manuel skrivning af konfiguration og indlæsning fra en ekstern adresse. Den nye version bruger et fuldstændigt øjebliksbillede: Konfigurationsfilens version er 2.

Eksportér en sikkerhedskopi i målbrowseren før import. Hver import erstatter den globale regel, hele sættet af domæneregler, begge UA-biblioteker og kontakten for reserve med ressourcens domæne med filens fuldstændige øjebliksbillede. Elementerne flettes ikke enkeltvis. "globalRule": null sletter den globale regel i målbrowseren.

01Eksportér konfiguration

  1. Klik på UA Pro-ikonet i browserens værktøjslinje.
  2. Åbn ”Mere” → ”Importér eller eksportér konfiguration”.
  3. Klik på ”Eksportér konfiguration”, og gem den downloadede .json-fil.
  4. Filnavnet ligner ua-switcher-config-2026-11-16.json. Datoen i navnet dannes efter UTC og kan afvige én dag fra den lokale dato.

Filen indeholder følgende vedvarende konfiguration:

  • Den globale regel og dens aktiverede eller pausede tilstand.
  • Hele sættet af domæneregler og deres aktiverede eller pausede tilstand.
  • Tilpassede UA-kategorier og -poster.
  • Kategorier og poster for tilføjet tekst.
  • Kontakten ”Reserve med ressourcens domæne”.

Filen indeholder ikke faneregler, allerede udtrukne tilfældige UA-bindinger, åbne faner, grænsefladesprog, tema eller indstillinger for det flydende panel. Disse gendannes ikke fra sikkerhedskopien ved import. Eksisterende faneregler i målbrowseren slettes heller ikke og kan derfor fortsat have forrang for domæneregler eller den globale regel.

Den eksporterede fil er læsbar JSON i klartekst. Opbevar sikkerhedskopien sikkert, hvis tilpassede UA'er eller kategorier indeholder oplysninger, du ikke ønsker offentliggjort.

02Importér fra lokal fil

  1. Åbn UA Pro → ”Mere” → ”Importér eller eksportér konfiguration” i målbrowseren.
  2. Klik først på ”Eksportér konfiguration” for at gemme målbrowserens oprindelige konfiguration til eventuel gendannelse.
  3. Klik på ”Importér konfiguration”, og vælg .json-filen.
  4. Læs advarslen om erstatning og antallet af regler og listeelementer. Klik på ”Vis konfigurationens indhold” for at kontrollere hele JSON-indholdet før bekræftelse. ”Annuller” skriver intet. Vent efter bekræftelsen på ”Konfigurationen er importeret!”. Hvis indstillingerne ændres under bekræftelsen, beder udvidelsen dig gentage handlingen.
  5. Kontrollér globale regler og domæneregler, tilpassede lister og kontakten for reserve med ressourcens domæne. Kontrollér også, om eksisterende faneregler har forrang. Genindlæs den side, der skal testes, og kontrollér UA.

Udvidelsen kontrollerer først filen, forsøger derefter at installere reglerne og skriver til sidst den vedvarende konfiguration. Hvis installation eller skrivning mislykkes, forsøger den at gendanne de regler, der aktuelt er gemt i browseren. Kontrollér de faktiske indstillinger, hvis gendannelse ikke er mulig. Ved samtidige ændringer via browsersynkronisering eller andre vinduer er processen ikke en transaktion på tværs af enheder.

03Indlæs fra ekstern adresse

Ekstern konfiguration bruger samme JSON-indhold som en lokal sikkerhedskopi. Indlæsning og import sker manuelt én gang; det er ikke et automatisk opdateret abonnement.

  1. Eksportér først en sikkerhedskopi af konfigurationen, eller opret en JSON-fil som beskrevet nedenfor.
  2. Placér filen på en HTTPS-tjeneste, som målbrowseren kan nå, og få den fulde adresse, der returnerer JSON-indholdet direkte, for eksempel https://example.com/ua-pro/config.json. Adressen er kun et eksempel; erstat den med din egen faktiske adresse.
  3. Gå til ”Mere” → ”Importér eller eksportér konfiguration” i UA Pro, udvid ”Ekstern konfiguration”, indsæt adressen, og klik på ”Indlæs”.
  4. Efter indlæsning og formatkontrol viser udvidelsen en bekræftelsesboks og det eksterne værtsnavn. Klik på ”Vis konfigurationens indhold” for at kontrollere hele det faktisk downloadede JSON-indhold. Bekræftelse opdaterer indstillingerne efter samme regler som lokal import; annullering importerer intet.
  5. Når filen på serveren ændres, skal du indtaste adressen igen, indlæse og bekræfte for at bruge det nye indhold. Adressen bevares ikke automatisk, når panelet åbnes igen.

Kun direkte HTTPS-links accepteres; HTTP, brugernavn eller adgangskode i adressen og URL-fragmenter accepteres ikke, og omdirigeringer følges ikke. Anmodningen medtager hverken browsercookies eller loginoplysninger, sender ingen Referer og omgår cachen. Tjenester, der kræver en logincookie, er derfor uegnede. UA Pro anvender ikke de UA-regler, der er konfigureret i denne udvidelse, på anmodningen, men andre udvidelser eller netværksenheder kan stadig ændre den. Adressen kan indeholde forespørgselsparametre; beskyt adresser med adgangstokens som adgangskoder. Brug en betroet adresse, og sørg for, at svaret direkte er en JSON-fil, ikke en loginside eller HTML-side, der viser kode.

Lokale filer og eksterne svar er hver begrænset til 128 KiB; ekstern læsning er begrænset til 10 sekunder, og det faktisk læste indhold tælles. Browserens synkroniserede lager har desuden en mindre kvote pr. element: Selv under 128 KiB kan lagring mislykkes, hvis reglerne eller ét bibliotek er for stort. Kontrollér ved fejl, om serveren returnerer status 200 og gyldig JSON, om certifikatet er gyldigt, om adressen omdirigerer, og om netværket kan nås.

04Fuldt JSON-eksempel

Eksemplet kan gemmes som config.json med UTF-8-kodning. Eksempeldomæner og UA-værdier er kun til illustration; sikkerhedskopiér den eksisterende konfiguration før erstatning. JSON skelner mellem store og små bogstaver: Brug lige dobbelte anførselstegn til strenge, sæt ikke komma efter sidste element, og skriv ikke kommentarer i JSON.

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 angiver én indbygget global UA og fire domæneregler. Mere specifikke underdomæneregler som app.example.com har forrang for example.com. Pausede regler deltager ikke i aktiv matchning; en regel for det overordnede domæne eller den globale regel kan i stedet gælde. Om et faktisk websted genkender eksempel-UA'en afhænger af webstedet.

05Felter på øverste niveau og erstatning

Felt Eksempel Formål
version 2 Påkrævet. Den nye version accepterer kun den numeriske værdi 2.
type "ua-switcher-config" Påkrævet. Identifikator for konfigurationstypen; skal svare nøjagtigt til denne streng.
timestamp "2026-11-16T06:00:00.000Z" Påkrævet. UTC-tid med millisekunder og Z; kun til registrering og bestemmer ikke, hvornår regler træder i kraft.
data { ... } Påkrævet. Objekt med hele konfigurationen og alle felter i følgende tabel.
Felter i data Korrekt format Importadfærd i denne version
globalRule Et regelobjekt eller null Regelobjektet erstatter den eksisterende globale regel; null sletter den.
domainRules { "域名": 规则对象 } Hele objektet erstatter de tidligere domæneregler; {} tømmer dem.
userCustomData { "分类": ["UA", ...] } Hele objektet erstatter det tidligere tilpassede UA-bibliotek; {} tømmer det.
userAppendData { "分类": ["追加文本", ...] } Hele objektet erstatter det tidligere bibliotek med tilføjet tekst; {} tømmer det.
resourceDomainFallback true eller false Boolesk JSON-værdi: slår reserve med ressourcens domæne til eller fra.

Alle fem felter er påkrævede; null er kun tilladt for globalRule. Manglende eller ukendte felter og gentagne JSON-nøgler afvises; gamle versioner og delvise konfigurationer importeres heller ikke. Domænereglerne og begge biblioteker erstattes hver især i deres helhed: Eksempelvis erstatter domainRules med kun ét domæne de øvrige eksisterende domæneregler i målbrowseren. Redigér helst en fil, der faktisk er eksporteret fra den nye version, og bevar alle nødvendige elementer fuldstændigt.

Reserve med ressourcens domæne kan kun anvende en regel ud fra ressourceanmodningens destinationsdomæne, når hovedsiden ikke har en gyldig fane-, domæne- eller global UA. Det betyder ikke, at alle ressourcer på tværs af domæner tilsidesætter hovedsidens regel.

06Skriv et regelobjekt

Den globale regel og hver domæneregel bruger samme struktur:

JSON
{
  "enabled": true,
  "mode": "custom",
  "params": {
    "category": "常用",
    "value": "ExampleAgent/1.0"
  }
}

enabled: true betyder aktiveret, false pauset. mode bestemmer felterne i params:

6.1 Indbygget UA: builtin

JSON
{
  "enabled": true,
  "mode": "builtin",
  "params": { "os": "Windows", "uaKey": "Edge 125 (Latest)" }
}

os og uaKey skal svare nøjagtigt til de interne forudindstillede nøgler i denne udvidelsesversion; de er ikke nødvendigvis lig med den oversatte tekst i grænsefladen. Vælg sikrest forudindstillingen i grænsefladen, eksportér konfigurationen, og kopiér den tilsvarende params. Kontrollér igen, når listen over forudindstillinger ændres mellem versioner.

6.2 Tilpasset UA: custom

JSON
{
  "enabled": true,
  "mode": "custom",
  "params": { "category": "常用", "value": "ExampleAgent/1.0" }
}

value er den fulde UA-streng. category bruges til kategorisering og redigering i grænsefladen; det anbefales også at medtage værdien i kategorien med samme navn i userCustomData. Den aktive regel læser sit eget value; manuel import af en regel tilføjer ikke automatisk værdien til det tilpassede bibliotek.

6.3 Tilføjet tekst: append

JSON
{
  "enabled": true,
  "mode": "append",
  "params": { "category": "应用标记", "value": "MyApp/1.0" }
}

Udvidelsen tilføjer et mellemrum efter den aktuelle browsers oprindelige UA og derefter value. Behold gerne teksten også i kategorien med samme navn i userAppendData; import af en regel udfylder ikke listen automatisk.

6.4 Tilfældig UA: random

JSON
{
  "enabled": true,
  "mode": "random",
  "params": { "pool": "custom:随机示例", "strategy": "page" }
}

strategy skal være "page" (udtræk ved hver fuld sideindlæsning) eller "tab" (bevares pr. regel og fane). Tilfældige udtræk kan gentages; to ens resultater i træk betyder ikke nødvendigvis, at der ikke blev trukket igen.

Almindelige værdier for pool:

Værdi Tilfældig kilde
all Alle indbyggede og tilpassede UA'er samt UA'er dannet af tilføjet tekst
builtin Alle indbyggede UA'er
builtin_desktop, builtin_mobile, builtin_legacy Indbyggede kategorier for stationære, mobile eller ældre enheder
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social De tilsvarende indbyggede kategorier
custom UA'er i alle tilpassede kategorier
custom:分类名 UA'er i kategorien angivet i userCustomData
append_all UA'er svarende til al tilføjet tekst
append:分类名 UA'er svarende til tilføjet tekst i kategorien angivet i userAppendData

Kategorienavnet efter kolon skal svare til nøglen i biblioteket. En aktiveret tilfældig regel skal have tilgængelige kandidater, ellers afvises filen.

07Kontrol ved manuel redigering

  • Brug domænenavne som nøgler i domainRules, for eksempel example.com eller shop.example.com, uden https://, sti, port eller mellemrum. Domæneregler matcher også underdomæner; *.example.com omfatter i denne version også selve example.com, ikke kun underdomæner.
  • Kategorienavne må være kinesiske og skal være ikke-tomme strenge uden kontroltegn eller farlige kontroltegn for tovejs tekst. __proto__, prototype og constructor må ikke bruges som kategorinavne. Brug helst udskrivbare ASCII-tegn til UA og tilføjet tekst. De må ikke indeholde linjeskift, tabulatorer eller andre kontroltegn; én UA må højst være 4096 tegn. Lige dobbelte anførselstegn og omvendte skråstreger i tekst skal escapes efter JSON-reglerne.
  • Hver kategori svarer til et array af strenge, for eksempel "常用": ["Agent/1.0", "Agent/2.0"]. Behold de firkantede parenteser også ved ét element. En tom kategori kan skrives som [].
  • true, false og null må ikke sættes i dobbelte anførselstegn; "false" er en streng, ikke en boolesk værdi.
  • Filen skal indeholde gyldig UTF-8 og JSON uden gentagne nøgler. Udvidelsen kontrollerer også struktur, felttyper, regler, navne på forudindstillinger og tilfældige puljer. Korrekt syntaks garanterer ikke, at en regel kan bruges.

En konfigurationsfil kan ændre den UA, browseren sender til websteder. HTTPS beskytter overførslen, men garanterer ikke, at serverens konfiguration svarer til dine ønsker. Importér kun filer fra betroede kilder, kontrollér indholdet før bekræftelse, og kontrollér den faktiske virkning efter genindlæsning af målsiden.

08Ofte stillede spørgsmål

Problem Kontrol
Ugyldigt filformat rapporteres Kontrollér UTF-8, JSON-syntaks, gentagne nøgler, version, påkrævede felter og regeltyper; brug en eksport fra den nye version som skabelon.
Ekstern indlæsning mislykkes Kontrollér HTTPS-certifikat, direkte link, netværk og svarindhold; omdirigeringer, cookiebaseret login og HTTP er ikke tilladt.
Regler mangler efter import Domænereglerne og begge biblioteker erstattes hver især i deres helhed. Gendan sikkerhedskopien fra før importen, eller tilføj de elementer, der skal bevares, til den nye fil.
Efter import af en tom global regel bruger siden stadig en anden UA Kontrollér eksisterende faneregler eller matchende domæneregler; de kan have forrang for den globale regel.
Handlingen lykkes, men UA er forkert Kontrollér, om reglen er aktiveret, indholdet gyldigt, den tilfældige pulje har tilgængelige elementer, og om der findes fane- eller domæneregler med højere prioritet. Genindlæs derefter siden.
Lagerfejl ved import af mange data Filen og browserens synkroniserede lager har størrelsesgrænser. Reducér regler eller lister, prøv igen, og kontrollér den eksisterende konfiguration.
Udvidelsen ændres ikke efter ændring af den eksterne fil Ekstern indlæsning er en manuel engangsimport; indtast adressen igen, indlæs og bekræft.