UA Pro-configuratiehandleiding

Configuratie importeren, exporteren en extern laden

Maak een back-up, draag configuraties over, stel ze handmatig op en laad ze vanaf een extern adres.

Van toepassing op UA Pro 1.5.0

Deze handleiding geldt voor UA Pro 1.5.0 en beschrijft het maken van back-ups, overdragen en handmatig opstellen van configuraties en laden vanaf een extern adres. De nieuwe versie gebruikt een volledige momentopname; version in het configuratiebestand is 2.

Exporteer vóór het importeren een back-up in de doelbrowser. Elke import vervangt de globale regel, de volledige set domeinregels, beide UA-bibliotheken en de schakelaar voor terugval op het brondomein door de volledige momentopname uit het bestand. Er worden geen afzonderlijke items samengevoegd. "globalRule": null verwijdert de globale regel in de doelbrowser.

01Configuratie exporteren

  1. Klik op het UA Pro-pictogram in de werkbalk van de browser.
  2. Open ‘Meer’ → ‘Configuratie importeren of exporteren’.
  3. Klik op ‘Configuratie exporteren’ en sla het gedownloade .json-bestand op.
  4. De bestandsnaam lijkt op ua-switcher-config-2026-11-16.json. De datum in de naam wordt in UTC gegenereerd en kan een dag afwijken van de lokale datum.

Het bestand bevat de volgende blijvend opgeslagen configuratie:

  • De globale regel en of deze actief of gepauzeerd is.
  • De volledige set domeinregels en of deze actief of gepauzeerd zijn.
  • Aangepaste UA-categorieën en -items.
  • Categorieën en items voor toegevoegde tekst.
  • De schakelaar ‘Terugval op brondomein’.

Het bestand bevat geen tabbladregels, eerder gekozen willekeurige UA-bindingen, open tabbladen, interfacetaal, thema of instellingen voor het zwevende venster. Deze worden bij import niet uit de back-up hersteld. Bestaande tabbladregels in de doelbrowser worden door de import evenmin verwijderd en kunnen dus voorrang blijven krijgen op domeinregels of de globale regel.

Het exportbestand is leesbare JSON in platte tekst. Bewaar de back-up zorgvuldig als aangepaste UA’s of categorieën informatie bevatten die je niet openbaar wilt maken.

02Importeren uit een lokaal bestand

  1. Open in de doelbrowser UA Pro → ‘Meer’ → ‘Configuratie importeren of exporteren’.
  2. Klik eerst op ‘Configuratie exporteren’ om de oorspronkelijke configuratie van de doelbrowser zo nodig te kunnen herstellen.
  3. Klik op ‘Configuratie importeren’ en selecteer het .json-bestand.
  4. Lees de waarschuwing over vervanging en de aantallen regels en lijstitems. Klik op ‘Configuratie-inhoud bekijken’ om de volledige JSON vóór bevestiging te controleren. ‘Annuleer’ schrijft niets weg. Wacht na bevestiging op ‘Configuratie geïmporteerd!’. Als de instellingen tijdens de bevestiging veranderen, vraagt de extensie je de handeling te herhalen.
  5. Controleer de globale en domeinregels, aangepaste lijsten en de schakelaar voor terugval op het brondomein; controleer ook of bestaande tabbladregels voorrang hebben. Vernieuw de te testen pagina en controleer de UA.

De extensie controleert eerst het bestand, probeert dan de regels te installeren en schrijft ten slotte de blijvende configuratie weg. Als installatie of schrijven mislukt, probeert zij de momenteel in de browser opgeslagen regels te herstellen. Controleer de werkelijke instellingen als herstel onmogelijk blijkt. Wanneer browsersynchronisatie of andere vensters tegelijk wijzigingen aanbrengen, is dit proces geen transactie tussen apparaten.

03Laden vanaf een extern adres

De externe configuratie gebruikt dezelfde JSON-inhoud als een lokale back-up. Het laden en importeren gebeurt eenmalig en handmatig; het is geen automatisch bijgewerkt abonnement.

  1. Exporteer eerst een configuratieback-up of stel een JSON-bestand op volgens de instructies hieronder.
  2. Plaats het bestand op een HTTPS-dienst die bereikbaar is voor de doelbrowser en verkrijg het volledige adres dat de JSON-inhoud direct teruggeeft, bijvoorbeeld https://example.com/ua-pro/config.json. Dit adres is slechts een voorbeeld; vervang het door je eigen adres.
  3. Ga in UA Pro naar ‘Meer’ → ‘Configuratie importeren of exporteren’, klap ‘Externe configuratie’ uit, plak het adres en klik op ‘Laden’.
  4. Na het laden en controleren van de indeling toont de extensie een bevestigingsvenster en de externe hostnaam. Klik op ‘Configuratie-inhoud bekijken’ om de daadwerkelijk gedownloade volledige JSON te controleren. Bevestigen werkt de instellingen bij volgens dezelfde regels als lokale import; annuleren importeert niets.
  5. Als het bestand op de server verandert, moet je het adres opnieuw invoeren, laden en bevestigen om de nieuwe inhoud te gebruiken. Bij het opnieuw openen van het paneel blijft het adres niet automatisch bewaard.

Alleen directe HTTPS-links zijn toegestaan; HTTP, gebruikersnamen of wachtwoorden in het adres en URL-fragmenten zijn niet toegestaan en omleidingen worden niet gevolgd. Het verzoek bevat geen browsercookies of inloggegevens, verstuurt geen Referer en omzeilt de cache. Een dienst die een inlogcookie vereist is daarom ongeschikt. UA Pro past de in deze extensie ingestelde UA-regels niet toe op dit verzoek, maar andere extensies of netwerkapparaten kunnen het verzoek nog wijzigen. Het adres mag queryparameters bevatten; bewaar adressen met toegangstokens als wachtwoorden. Gebruik een betrouwbaar adres en zorg dat het antwoord direct een JSON-bestand is, geen inlogpagina of HTML-pagina die code toont.

Lokale bestanden en externe antwoorden zijn elk beperkt tot 128 KiB. Extern lezen is beperkt tot 10 seconden en de werkelijk gelezen inhoud wordt geteld. De gesynchroniseerde browseropslag heeft ook een kleiner quotum per item: zelfs onder 128 KiB kan opslaan mislukken als regels of één bibliotheek te groot zijn. Controleer bij fouten of de server status 200 en geldige JSON teruggeeft, het certificaat geldig is, het adres omleidt en het netwerk bereikbaar is.

04Volledig JSON-voorbeeld

Het volgende voorbeeld kan worden opgeslagen als config.json met UTF-8-codering. Voorbeelddomeinen en UA-waarden dienen alleen ter illustratie; maak vóór vervanging een back-up van de bestaande configuratie. JSON is hoofdlettergevoelig: gebruik rechte dubbele aanhalingstekens voor tekenreeksen, plaats geen komma na het laatste element en schrijf geen opmerkingen in 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
  }
}

Dit voorbeeld stelt één ingebouwde globale UA en vier domeinregels in. Specifiekere subdomeinregels zoals app.example.com hebben voorrang op example.com. Gepauzeerde regels doen niet mee aan de actieve overeenkomst; een regel van het bovenliggende domein of de globale regel kan dan gelden. Of een echte website de voorbeeld-UA herkent, hangt af van de website.

05Velden op het hoogste niveau en vervanging

Veld Voorbeeld Functie
version 2 Verplicht. De nieuwe versie accepteert alleen de numerieke waarde 2.
type "ua-switcher-config" Verplicht. Identificatie van het configuratietype; moet exact overeenkomen met deze tekenreeks.
timestamp "2026-11-16T06:00:00.000Z" Verplicht. UTC-tijd met milliseconden en Z; alleen ter registratie en bepaalt niet wanneer regels ingaan.
data { ... } Verplicht. Object met de volledige configuratie en alle velden in de onderstaande tabel.
Velden in data Juiste indeling Gedrag bij import in deze versie
globalRule Een regelobject of null Het regelobject vervangt de bestaande globale regel; null verwijdert die regel.
domainRules { "域名": 规则对象 } Het hele object vervangt de eerdere domeinregels; {} maakt ze leeg.
userCustomData { "分类": ["UA", ...] } Het hele object vervangt de eerdere aangepaste UA-bibliotheek; {} maakt die leeg.
userAppendData { "分类": ["追加文本", ...] } Het hele object vervangt de eerdere bibliotheek met toegevoegde tekst; {} maakt die leeg.
resourceDomainFallback true of false JSON-booleaanse waarde: schakelt terugval op het brondomein in of uit.

Alle vijf velden zijn verplicht; null is alleen toegestaan voor globalRule. Ontbrekende of onbekende velden en dubbele JSON-sleutels worden afgewezen; oude versies en gedeeltelijke configuraties worden evenmin geïmporteerd. Domeinregels en beide bibliotheken worden elk volledig vervangen: een domainRules met slechts één domein vervangt bijvoorbeeld ook de andere bestaande domeinregels in de doelbrowser. Bewerk bij voorkeur een bestand dat daadwerkelijk uit de nieuwe versie is geëxporteerd en behoud alle benodigde items volledig.

Terugval op het brondomein kan alleen een regel toepassen op basis van het doeldomein van een bronverzoek als de hoofdpagina geen geldige tabblad-, domein- of globale UA heeft. Dit betekent niet dat alle domeinoverschrijdende bronnen voorrang hebben op de regel van de hoofdpagina.

06Regelobjecten schrijven

De globale regel en elke domeinregel gebruiken dezelfde structuur:

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

enabled: true betekent ingeschakeld, false gepauzeerd. mode bepaalt de velden van params:

6.1 Ingebouwde UA: builtin

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

os en uaKey moeten exact overeenkomen met de interne voorgedefinieerde sleutels van deze extensieversie; ze hoeven niet gelijk te zijn aan de vertaalde tekst in de interface. Kies bij voorkeur de voorinstelling in de interface, exporteer de configuratie en kopieer de bijbehorende params. Controleer opnieuw wanneer de lijst met voorinstellingen tussen versies verandert.

6.2 Aangepaste UA: custom

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

value is de volledige UA-tekenreeks. category dient voor indeling en bewerking in de interface; neem deze waarde bij voorkeur ook op in de gelijknamige categorie van userCustomData. De actieve regel leest zijn eigen value; een handmatig geïmporteerde regel voegt de waarde niet automatisch toe aan de aangepaste bibliotheek.

6.3 Toegevoegde tekst: append

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

De extensie voegt na de oorspronkelijke UA van de huidige browser een spatie toe, gevolgd door value. Bewaar deze tekst bij voorkeur ook in de gelijknamige categorie van userAppendData; import van een regel vult de lijst niet automatisch.

6.4 Willekeurige UA: random

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

strategy moet "page" zijn (kiezen bij elke volledige paginalading) of "tab" (behouden per regel en tabblad). Willekeurige keuzes mogen zich herhalen; twee gelijke resultaten achter elkaar betekenen niet noodzakelijk dat er niet opnieuw is gekozen.

Veelvoorkomende waarden voor pool:

Waarde Bron van willekeurige keuze
all Alle ingebouwde en aangepaste UA’s en UA’s gegenereerd uit toegevoegde tekst
builtin Alle ingebouwde UA’s
builtin_desktop, builtin_mobile, builtin_legacy Ingebouwde categorieën voor desktop, mobiel of oudere apparaten
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social De overeenkomstige ingebouwde categorieën
custom UA’s uit alle aangepaste categorieën
custom:分类名 UA’s uit de in userCustomData opgegeven categorie
append_all UA’s die bij alle toegevoegde teksten horen
append:分类名 UA’s die horen bij toegevoegde teksten in de in userAppendData opgegeven categorie

De categorienaam na de dubbele punt moet overeenkomen met de sleutel in de bibliotheek. Een ingeschakelde willekeurige regel moet bruikbare kandidaten hebben, anders wordt het bestand afgewezen.

07Controles bij handmatig bewerken

  • Gebruik domeinnamen als sleutels van domainRules, bijvoorbeeld example.com of shop.example.com, zonder https://, pad, poort of spaties. Domeinregels gelden ook voor onderliggende subdomeinen; *.example.com omvat in deze versie ook example.com zelf en betekent niet ‘alleen subdomeinen’.
  • Categorienamen mogen Chinees bevatten en moeten niet-lege tekenreeksen zijn zonder besturingstekens of gevaarlijke bidirectionele tekstbesturingstekens. __proto__, prototype en constructor mogen geen categorienamen zijn. Gebruik voor UA’s en toegevoegde tekst bij voorkeur afdrukbare ASCII-tekens; gebruik geen regeleinden, tabs of andere besturingstekens. Eén UA mag maximaal 4096 tekens bevatten. Rechte dubbele aanhalingstekens en backslashes in tekst moeten volgens de JSON-regels worden geëscapet.
  • Elke categorie hoort bij een array met tekenreeksen, bijvoorbeeld "常用": ["Agent/1.0", "Agent/2.0"]. Behoud de vierkante haken ook bij één item. Een lege categorie kan worden geschreven als [].
  • Zet true, false en null niet tussen dubbele aanhalingstekens; "false" is een tekenreeks, geen booleaanse waarde.
  • Het bestand moet geldige UTF-8 en JSON bevatten, zonder dubbele sleutels. De extensie controleert ook structuur, veldtypen, regels, namen van voorinstellingen en willekeurige pools. Correcte syntaxis garandeert niet dat een regel bruikbaar is.

Een configuratiebestand kan de UA wijzigen die de browser naar websites stuurt. HTTPS beschermt het transport, maar garandeert niet dat de configuratie van de server overeenkomt met je bedoeling. Importeer alleen bestanden uit betrouwbare bronnen, controleer de inhoud vóór bevestiging en controleer het werkelijke effect na het vernieuwen van de doelpagina.

08Veelgestelde vragen

Probleem Controle
Ongeldige bestandsindeling gemeld Controleer UTF-8, JSON-syntaxis, dubbele sleutels, versie, verplichte velden en regeltypen; gebruik een export uit de nieuwe versie als sjabloon.
Extern laden mislukt Controleer HTTPS-certificaat, directe link, netwerk en antwoordinhoud; omleidingen, inloggen met cookies en HTTP zijn niet toegestaan.
Na import ontbreken regels Domeinregels en beide bibliotheken worden elk volledig vervangen. Herstel de back-up van vóór de import of vul het nieuwe bestand aan met de te behouden items.
Na import van een lege globale regel gebruikt de pagina nog een andere UA Controleer bestaande tabbladregels of overeenkomende domeinregels; deze kunnen voorrang hebben op de globale regel.
Succesmelding maar onjuiste UA Controleer of de regel actief en de inhoud geldig is, of de willekeurige pool bruikbare items bevat en of er tabblad- of domeinregels met hogere prioriteit zijn. Vernieuw daarna de pagina.
Opslagfout bij import van veel gegevens Voor het bestand en de gesynchroniseerde browseropslag gelden groottelimieten. Maak regels of lijsten kleiner, probeer opnieuw en controleer de bestaande configuratie.
De extensie verandert niet na wijziging van het externe bestand Extern laden is een eenmalige handmatige import; voer het adres opnieuw in, laad en bevestig.