Konfigurationsguide för UA Pro

Import, export och fjärrkonfiguration

Säkerhetskopiera, flytta och skriva konfiguration manuellt samt ladda den från en fjärradress.

Gäller UA Pro 1.5.0

Guiden gäller UA Pro 1.5.0 och beskriver säkerhetskopiering, flytt, manuell konfiguration och laddning från en fjärradress. Den nya versionen använder en fullständig ögonblicksbild: konfigurationsfilens version är 2.

Exportera en säkerhetskopia i målbläddraren före import. Varje import ersätter den globala regeln, hela uppsättningen domänregler, båda UA-biblioteken och omkopplaren för reservregel för resursens domän med filens fullständiga ögonblicksbild. Enskilda poster slås inte samman. "globalRule": null tar bort den globala regeln i målbläddraren.

01Exportera konfiguration

  1. Klicka på UA Pro-ikonen i webbläsarens verktygsfält.
  2. Öppna ”Mer” → ”Importera eller exportera konfiguration”.
  3. Klicka på ”Exportera konfiguration” och spara den nedladdade .json-filen.
  4. Filnamnet liknar ua-switcher-config-2026-11-16.json. Datumet i namnet skapas enligt UTC och kan skilja sig en dag från det lokala datumet.

Filen innehåller följande beständiga konfiguration:

  • Den globala regeln och om den är aktiverad eller pausad.
  • Hela uppsättningen domänregler och om de är aktiverade eller pausade.
  • Anpassade UA-kategorier och poster.
  • Kategorier och poster för tillagd text.
  • Omkopplaren ”Reservregel för resursens domän”.

Filen innehåller inte flikregler, redan dragna slumpmässiga UA-bindningar, öppna flikar, gränssnittsspråk, tema eller inställningar för den flytande panelen. Dessa återställs inte från säkerhetskopian vid import. Befintliga flikregler i målbläddraren tas inte heller bort och kan därför fortsätta att ha företräde framför domänregler eller den globala regeln.

Exportfilen är läsbar JSON i klartext. Förvara säkerhetskopian säkert om anpassade UA eller kategorier innehåller uppgifter som du inte vill offentliggöra.

02Importera från lokal fil

  1. Öppna UA Pro → ”Mer” → ”Importera eller exportera konfiguration” i målbläddraren.
  2. Klicka först på ”Exportera konfiguration” för att spara målbläddrarens ursprungliga konfiguration för eventuell återställning.
  3. Klicka på ”Importera konfiguration” och välj .json-filen.
  4. Läs varningen om ersättning och antalet regler och listposter. Klicka på ”Visa konfigurationens innehåll” för att granska hela JSON-innehållet före bekräftelse. ”Avbryt” skriver inget. Vänta efter bekräftelse på ”Konfiguration importerad!”. Om inställningarna ändras under bekräftelsen ber tillägget dig att göra om åtgärden.
  5. Kontrollera globala regler och domänregler, anpassade listor och omkopplaren för reservregel för resursens domän. Kontrollera även om befintliga flikregler har företräde. Uppdatera sidan som ska testas och kontrollera UA.

Tillägget kontrollerar först filen, försöker sedan installera reglerna och skriver slutligen den beständiga konfigurationen. Om installation eller skrivning misslyckas försöker det återställa reglerna som för närvarande är sparade i webbläsaren. Kontrollera de faktiska inställningarna om återställning inte är möjlig. Vid samtidiga ändringar genom webbläsarsynkronisering eller andra fönster är processen inte en transaktion mellan enheter.

03Ladda från fjärradress

Fjärrkonfigurationen använder samma JSON-innehåll som en lokal säkerhetskopia. Laddning och import sker manuellt en gång; det är inte en prenumeration som uppdateras automatiskt.

  1. Exportera först en säkerhetskopia eller skapa en JSON-fil enligt nedan.
  2. Placera filen på en HTTPS-tjänst som målbläddraren kan nå och hämta den fullständiga adressen som direkt returnerar JSON-innehållet, exempelvis https://example.com/ua-pro/config.json. Adressen är bara ett exempel; ersätt den med din faktiska adress.
  3. Gå till ”Mer” → ”Importera eller exportera konfiguration” i UA Pro, fäll ut ”Fjärrkonfiguration”, klistra in adressen och klicka på ”Ladda”.
  4. Efter laddning och formatkontroll visar tillägget en bekräftelseruta och fjärrvärdens namn. Klicka på ”Visa konfigurationens innehåll” för att granska hela JSON-innehållet som faktiskt laddats ned. Bekräftelse uppdaterar inställningarna enligt samma regler som lokal import; avbrytande importerar inget.
  5. Om filen på servern ändras måste du ange adressen igen, ladda och bekräfta för att använda det nya innehållet. Adressen behålls inte automatiskt när panelen öppnas igen.

Endast direkta HTTPS-länkar godtas; HTTP, användarnamn eller lösenord i adressen och URL-fragment godtas inte, och omdirigeringar följs inte. Begäran innehåller inga webbläsarkakor eller inloggningsuppgifter, skickar ingen Referer och går förbi cacheminnet. Tjänster som kräver inloggningskakor fungerar därför inte. UA Pro tillämpar inte UA-reglerna som konfigurerats i detta tillägg på begäran, men andra tillägg eller nätverksenheter kan ändå ändra den. Adressen kan innehålla frågeparametrar; skydda adresser med åtkomsttoken som lösenord. Använd en betrodd adress och se till att svaret direkt är en JSON-fil, inte en inloggningssida eller HTML-sida som visar kod.

Lokala filer och fjärrsvar är vardera begränsade till 128 KiB; fjärrläsning är begränsad till 10 sekunder och faktiskt läst innehåll räknas. Webbläsarens synkroniserade lagring har dessutom en mindre kvot per post: även under 128 KiB kan lagring misslyckas om reglerna eller ett bibliotek är för stort. Kontrollera vid fel att servern returnerar status 200 och giltig JSON, att certifikatet är giltigt, om adressen omdirigerar och om nätverket kan nås.

04Fullständigt JSON-exempel

Exemplet kan sparas som config.json med UTF-8-kodning. Exempeldomäner och UA-värden är bara illustrationer; säkerhetskopiera befintlig konfiguration före ersättning. JSON skiljer på stora och små bokstäver: använd raka dubbla citattecken för strängar, sätt inte komma efter sista elementet och skriv inga 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
  }
}

Exemplet anger en inbyggd global UA och fyra domänregler. Mer specifika underdomänregler som app.example.com har företräde framför example.com. Pausade regler deltar inte i aktiv matchning; en regel för överordnad domän eller den globala regeln kan i stället gälla. Om en verklig webbplats känner igen exempel-UA beror på webbplatsen.

05Fält på översta nivån och ersättning

Fält Exempel Funktion
version 2 Obligatoriskt. Den nya versionen accepterar endast talvärdet 2.
type "ua-switcher-config" Obligatoriskt. Identifierare för konfigurationstyp; måste exakt motsvara strängen.
timestamp "2026-11-16T06:00:00.000Z" Obligatoriskt. UTC-tid med millisekunder och Z; endast för dokumentation och avgör inte när regler träder i kraft.
data { ... } Obligatoriskt. Objekt med hela konfigurationen och alla fält i följande tabell.
Fält i data Korrekt format Importbeteende i denna version
globalRule Ett regelobjekt eller null Regelobjektet ersätter den befintliga globala regeln; null tar bort den.
domainRules { "域名": 规则对象 } Hela objektet ersätter tidigare domänregler; {} tömmer dem.
userCustomData { "分类": ["UA", ...] } Hela objektet ersätter det tidigare anpassade UA-biblioteket; {} tömmer det.
userAppendData { "分类": ["追加文本", ...] } Hela objektet ersätter det tidigare biblioteket för tillagd text; {} tömmer det.
resourceDomainFallback true eller false Booleskt JSON-värde: aktiverar eller inaktiverar reservregel för resursens domän.

Alla fem fält är obligatoriska; null är bara tillåtet för globalRule. Saknade eller okända fält och dubbla JSON-nycklar avvisas; äldre versioner och partiella konfigurationer importeras inte heller. Domänreglerna och båda biblioteken ersätts var för sig i sin helhet: exempelvis ersätter domainRules med bara en domän målbläddrarens övriga befintliga domänregler. Redigera helst en fil som faktiskt exporterats av den nya versionen och behåll alla nödvändiga poster fullständigt.

Reservregel för resursens domän kan tillämpa en regel utifrån resursbegärans måldomän endast när huvudsidan saknar giltig UA för flik, domän eller globalt. Det innebär inte att alla resurser över domängränser har företräde framför huvudsidans regel.

06Skriva regelobjekt

Den globala regeln och varje domänregel har samma struktur:

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

enabled: true betyder aktiverad och false pausad. mode avgör fälten i params:

6.1 Inbyggd UA: builtin

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

os och uaKey måste exakt motsvara de interna förinställda nycklarna i denna tilläggsversion; de behöver inte vara samma som den översatta texten i gränssnittet. Välj säkrast förinställningen i gränssnittet, exportera konfigurationen och kopiera motsvarande params. Kontrollera igen när listan över förinställningar ändras mellan versioner.

6.2 Anpassad UA: custom

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

value är den fullständiga UA-strängen. category används för kategorisering och redigering i gränssnittet; inkludera gärna värdet även i kategorin med samma namn i userCustomData. Den aktiva regeln läser sitt eget value; manuell import av en regel lägger inte automatiskt till värdet i det anpassade biblioteket.

6.3 Tillagd text: append

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

Tillägget lägger ett blanksteg efter den aktuella webbläsarens ursprungliga UA och därefter value. Behåll gärna texten även i kategorin med samma namn i userAppendData; import av en regel fyller inte listan automatiskt.

6.4 Slumpmässig UA: random

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

strategy måste vara "page" (val vid varje fullständig sidladdning) eller "tab" (behålls per regel och flik). Slumpmässiga val får upprepas; två lika resultat i följd innebär inte nödvändigtvis att inget nytt val gjordes.

Vanliga värden för pool:

Värde Slumpkälla
all Alla inbyggda och anpassade UA samt UA som skapas från tillagd text
builtin Alla inbyggda UA
builtin_desktop, builtin_mobile, builtin_legacy Inbyggda kategorier för stationära, mobila eller äldre enheter
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social Motsvarande inbyggda kategorier
custom UA i alla anpassade kategorier
custom:分类名 UA i kategorin som anges i userCustomData
append_all UA som motsvarar all tillagd text
append:分类名 UA som motsvarar tillagd text i kategorin som anges i userAppendData

Kategorinamnet efter kolon måste motsvara nyckeln i biblioteket. En aktiverad slumpregel måste ha tillgängliga kandidater, annars avvisas filen.

07Kontroll vid manuell redigering

  • Ange domännamn som nycklar i domainRules, exempelvis example.com eller shop.example.com, utan https://, sökväg, port eller blanksteg. Domänregler matchar även underdomäner; *.example.com omfattar i denna version också själva example.com, inte bara underdomäner.
  • Kategorinamn får vara kinesiska och måste vara icke-tomma strängar utan kontrolltecken eller farliga dubbelriktade textkontrolltecken. __proto__, prototype och constructor får inte användas som kategorinamn. Använd gärna utskrivbara ASCII-tecken för UA och tillagd text. UA och tillagd text får inte innehålla radbrytningar, tabbar eller andra kontrolltecken. En UA får vara högst 4096 tecken. Raka dubbla citattecken och omvända snedstreck i text måste escape-kodas enligt JSON-reglerna.
  • Varje kategori motsvarar en strängarray, exempelvis "常用": ["Agent/1.0", "Agent/2.0"]. Behåll hakparenteserna även med en enda post. En tom kategori kan skrivas [].
  • true, false och null får inte omges av dubbla citattecken; "false" är en sträng, inte ett booleskt värde.
  • Filen måste innehålla giltig UTF-8 och JSON utan dubbla nycklar. Tillägget kontrollerar även struktur, fälttyper, regler, förinställningsnamn och slumppooler. Korrekt syntax garanterar inte att en regel kan användas.

En konfigurationsfil kan ändra den UA som webbläsaren skickar till webbplatser. HTTPS skyddar överföringen men garanterar inte att serverns konfiguration motsvarar din avsikt. Importera bara filer från betrodda källor, granska innehållet före bekräftelse och kontrollera den faktiska effekten efter att målsidan uppdaterats.

08Vanliga frågor

Problem Kontroll
Ogiltigt filformat rapporteras Kontrollera UTF-8, JSON-syntax, dubbla nycklar, version, obligatoriska fält och regeltyper; använd en export från den nya versionen som mall.
Fjärrladdning misslyckas Kontrollera HTTPS-certifikat, direktlänk, nätverk och svarsinnehåll; omdirigeringar, kakbaserad inloggning och HTTP är inte tillåtna.
Regler saknas efter import Domänreglerna och båda biblioteken ersätts var för sig i sin helhet. Återställ säkerhetskopian från före importen eller lägg till de poster som ska behållas i den nya filen.
Efter import av en tom global regel använder sidan fortfarande en annan UA Kontrollera befintliga flikregler eller matchande domänregler; de kan ha företräde framför den globala regeln.
Åtgärden lyckas men UA är fel Kontrollera att regeln är aktiverad, innehållet giltigt, slumppoolen har tillgängliga poster och att inga flik- eller domänregler med högre prioritet finns. Uppdatera sedan sidan.
Lagringsfel vid import av mycket data Filen och webbläsarens synkroniserade lagring har storleksgränser. Minska regler eller listor, försök igen och kontrollera befintlig konfiguration.
Tillägget ändras inte efter ändring av fjärrfilen Fjärrladdning är en manuell engångsimport; ange adressen igen, ladda och bekräfta.