Guia de configuració d’UA Pro

Importació, exportació i configuració remota

Feu còpies de seguretat, migreu i escriviu configuracions manualment, o carregueu-les des d’una adreça remota.

Versió aplicable: UA Pro 1.5.0

Aquesta guia s’aplica a UA Pro 1.5.0 i explica com fer còpies de seguretat, migrar i escriure configuracions manualment, i carregar-les des d’una adreça remota. La nova versió utilitza un format d’instantània completa: el version del fitxer de configuració és 2.

Abans d’importar, exporteu una còpia de seguretat al navegador de destinació. Cada importació substitueix la regla global, tot el conjunt de regles de domini, les dues biblioteques d’UA i l’interruptor d’alternativa pel domini del recurs per la instantània completa del fitxer; no combina les entrades individualment. "globalRule": null indica que s’esborrarà la regla global del navegador de destinació.

01Exportar la configuració

  1. Feu clic a la icona d’UA Pro a la barra d’eines del navegador.
  2. Obriu «Més» → «Importar o exportar la configuració».
  3. Feu clic a «Exportar la configuració» i deseu el fitxer .json descarregat.
  4. El nom del fitxer és semblant a ua-switcher-config-2026-11-16.json. La data del nom es genera en UTC i pot diferir un dia de la data local.

El fitxer conté la configuració persistent següent:

  • La regla global i el seu estat activat o en pausa.
  • Tot el conjunt de regles de domini i el seu estat activat o en pausa.
  • Categories i entrades d’UA personalitzats.
  • Categories i entrades de text afegit.
  • L’interruptor «Alternativa pel domini del recurs».

El fitxer no inclou les regles de pestanya, les vinculacions d’UA aleatori ja seleccionades, les pestanyes obertes, l’idioma de la interfície, el tema ni la configuració de la superposició. Aquests elements no es restauraran de la còpia després d’importar; les regles de pestanya existents al navegador de destinació tampoc no s’esborren amb la importació i poden continuar prevalent sobre les regles de domini o globals.

El fitxer exportat és JSON llegible en text pla. Deseu la còpia amb cura si els UA personalitzats o les categories contenen informació que no voleu divulgar.

02Importar des d’un fitxer local

  1. Al navegador de destinació, obriu UA Pro → «Més» → «Importar o exportar la configuració».
  2. Primer feu clic a «Exportar la configuració» per conservar la configuració original del navegador de destinació i poder-la restaurar si cal.
  3. Feu clic a «Importar la configuració» i seleccioneu el fitxer .json.
  4. Llegiu l’avís de substitució i les quantitats de regles i llistes. Feu clic a «Mostra la configuració» per examinar el JSON complet abans de confirmar. Si trieu «Cancel·la» no s’escriu res. Després de confirmar, espereu el missatge «Configuració importada!». Si la configuració canvia durant la confirmació, l’extensió demanarà que repetiu l’operació.
  5. Comproveu les regles globals i de domini, les llistes personalitzades i l’interruptor d’alternativa pel domini del recurs; comproveu també si alguna regla de pestanya existent hi preval. Actualitzeu les pàgines que vulgueu provar i verifiqueu l’UA.

L’extensió primer comprova el fitxer, després intenta instal·lar les regles i finalment escriu la configuració persistent. Si falla la instal·lació o l’escriptura, intenta restaurar les regles desades actualment al navegador. Si indica que no pot restaurar-les, comproveu la configuració real. Quan la sincronització del navegador o una altra finestra modifica la configuració alhora, aquest procés no s’ha d’entendre com una transacció entre dispositius.

03Carregar des d’una adreça remota

La configuració remota utilitza el mateix contingut JSON que una còpia local. És una càrrega i importació manual puntual, no una subscripció que s’actualitza automàticament.

  1. Primer exporteu una còpia de seguretat de la configuració o prepareu un fitxer JSON com s’explica a continuació.
  2. Poseu el fitxer en un servei HTTPS accessible des del navegador de destinació i obteniu una adreça completa que retorni directament el contingut JSON, per exemple https://example.com/ua-pro/config.json. Aquesta adreça és només un exemple; substituïu-la per la vostra adreça real.
  3. A UA Pro, obriu «Més» → «Importar o exportar la configuració», desplegueu «Configuració remota», enganxeu l’adreça i feu clic a «Carrega».
  4. Un cop superades la càrrega i la comprovació del format, l’extensió mostra un quadre de confirmació i el nom de l’amfitrió remot. Feu clic a «Mostra la configuració» per examinar el JSON complet realment descarregat. En confirmar s’actualitza la configuració amb les mateixes regles que en una importació local; en cancel·lar no s’importa.
  5. Quan el fitxer canviï al servidor, torneu a introduir l’adreça, carregueu i confirmeu per fer servir el contingut nou. L’adreça no es conserva automàticament quan torneu a obrir el tauler.

Només s’accepten enllaços HTTPS directes; no s’accepten HTTP, noms d’usuari o contrasenyes a l’adreça ni fragments d’URL, i no se segueixen redireccions. La sol·licitud no porta galetes del navegador ni credencials d’inici de sessió, no envia Referer i evita la memòria cau; per tant, no són adequats els serveis que requereixen galetes d’inici de sessió. UA Pro no aplica a aquesta sol·licitud les regles d’UA configurades en aquesta extensió, però altres extensions o dispositius de xarxa encara poden modificar-la. L’adreça pot contenir paràmetres de consulta; protegiu com una contrasenya les adreces que continguin un token d’accés. Feu servir una adreça de confiança i assegureu-vos que la resposta sigui directament un fitxer JSON, no una pàgina d’inici de sessió ni una pàgina HTML que mostri codi.

Els fitxers locals i les respostes remotes tenen un límit de 128 KiB cadascun; la lectura remota té un límit de 10 segons i compta el contingut realment llegit. L’emmagatzematge sincronitzat del navegador també té una quota menor per element, de manera que un fitxer inferior a 128 KiB pot no desar-se si les regles o una biblioteca són massa grans. Si hi ha un error, comproveu que el servidor retorni l’estat 200 i JSON vàlid, que el certificat sigui vàlid, que l’adreça no redirigeixi i que la xarxa sigui accessible.

04Exemple JSON complet

L’exemple següent es pot desar com a config.json codificat en UTF-8. Els dominis i valors d’UA de l’exemple són només il·lustratius; feu una còpia de la configuració actual abans de substituir-la. JSON distingeix majúscules i minúscules: utilitzeu cometes dobles per a les cadenes, no afegiu cap coma després de l’últim element i no escriviu comentaris dins del 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
  }
}

Aquest exemple estableix un UA global integrat i quatre regles de domini. Les regles de subdomini més específiques, com app.example.com, tenen prioritat sobre example.com. Les regles en pausa no participen en la cerca de coincidències actives, de manera que encara es pot aplicar una regla del domini pare o global. Que un lloc real reconegui l’UA d’exemple depèn del lloc mateix.

05Camps de nivell superior i substitució

Camp Exemple Funció
version 2 Obligatori. La nova versió només accepta el valor numèric 2.
type "ua-switcher-config" Obligatori. Identificador del tipus de configuració; ha de coincidir exactament amb aquesta cadena.
timestamp "2026-11-16T06:00:00.000Z" Obligatori. Hora UTC amb mil·lisegons i Z; només serveix de registre i no determina quan entren en vigor les regles.
data { ... } Obligatori. Objecte que conté la configuració completa, inclosos tots els camps de la taula següent.
Camps de data Format correcte Comportament en importar en aquesta versió
globalRule Un objecte de regla o null Un objecte de regla substitueix la regla global existent; null l’esborra.
domainRules { "域名": 规则对象 } L’objecte sencer substitueix les regles de domini anteriors; {} les buida.
userCustomData { "分类": ["UA", ...] } L’objecte sencer substitueix la biblioteca anterior d’UA personalitzats; {} la buida.
userAppendData { "分类": ["追加文本", ...] } L’objecte sencer substitueix la biblioteca anterior de text afegit; {} la buida.
resourceDomainFallback true o false Valor booleà JSON: activa o desactiva l’alternativa pel domini del recurs.

Tots cinc camps són obligatoris; no es pot fer servir null excepte per a globalRule. Es rebutgen els camps absents o desconeguts i les claus JSON duplicades; tampoc no s’importen configuracions parcials o de versions antigues. Les regles de domini i les dues biblioteques se substitueixen com a conjunts complets: per exemple, un domainRules amb un sol domini substituirà les altres regles de domini existents al navegador de destinació. Es recomana editar un fitxer realment exportat per la nova versió i conservar íntegrament els elements necessaris.

L’alternativa pel domini del recurs només pot aplicar una regla segons el domini de destinació de la sol·licitud del recurs quan la pàgina principal no té cap UA de pestanya, domini o global actiu. Això no significa que tots els recursos d’altres dominis prevalguin sobre la regla de la pàgina principal.

06Com s’escriuen els objectes de regla

La regla global i cada regla de domini utilitzen la mateixa estructura:

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

enabled: true vol dir activada i false vol dir en pausa. mode determina els camps de params:

6.1 UA integrat: builtin

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

os i uaKey han de coincidir exactament amb les claus internes predefinides d’aquesta versió de l’extensió; no han de ser necessàriament iguals als textos traduïts de la interfície. El més segur és seleccionar el valor predefinit a la interfície, exportar la configuració i copiar el params corresponent. Torneu-ho a comprovar quan canviï la llista de valors predefinits entre versions.

6.2 UA personalitzat: custom

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

value és la cadena d’UA completa. category s’utilitza per classificar i editar a la interfície; es recomana incloure també el valor a la categoria del mateix nom de userCustomData. Quan s’aplica, la regla llegeix el seu propi value; importar una regla manualment no afegeix automàticament aquest valor a la biblioteca personalitzada.

6.3 Afegir text: append

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

L’extensió afegeix un espai després de l’UA original del navegador actual i després afegeix value. Es recomana conservar també aquest text a la categoria del mateix nom de userAppendData; importar la regla no emplena automàticament la llista.

6.4 UA aleatori: random

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

strategy ha de ser "page" (se selecciona a cada càrrega completa de pàgina) o "tab" (es manté per regla i pestanya). Les seleccions aleatòries es poden repetir; dos resultats iguals consecutius no volen dir necessàriament que no s’hagi tornat a seleccionar.

Valors habituals de pool:

Valor Origen aleatori
all Tots els UA integrats, personalitzats i generats a partir del text afegit
builtin Tots els UA integrats
builtin_desktop, builtin_mobile, builtin_legacy Categories integrades d’escriptori, mòbil o dispositius antics
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social La categoria integrada corresponent
custom UA de totes les categories personalitzades
custom:分类名 UA de la categoria indicada a userCustomData
append_all UA corresponents a tots els textos afegits
append:分类名 UA corresponents al text afegit a la categoria indicada a userAppendData

El nom de categoria després dels dos punts ha de coincidir amb una clau de la biblioteca. Una regla aleatòria activada ha de tenir candidats disponibles; altrament, es rebutjarà el fitxer.

07Comprovacions en editar manualment

  • Utilitzeu noms de domini com a claus de domainRules, per exemple example.com o shop.example.com; no hi inclogueu https://, camins, ports ni espais. Les regles de domini també coincideixen amb subdominis. En aquesta versió, *.example.com també inclou example.com mateix; no vol dir «només subdominis».
  • Els noms de categoria poden contenir caràcters xinesos i han de ser cadenes no buides sense caràcters de control ni controls bidireccionals perillosos; __proto__, prototype i constructor no poden ser noms de categoria. Es recomana utilitzar caràcters ASCII imprimibles per als UA i el text afegit. Els UA i el text afegit no han de contenir salts de línia, tabulacions ni altres caràcters de control. Cada UA pot tenir com a màxim 4096 caràcters. Les cometes dobles i les barres inverses del text s’han d’escapar segons les regles JSON.
  • Cada categoria correspon a una matriu de cadenes, per exemple "常用": ["Agent/1.0", "Agent/2.0"]. Conserveu els claudàtors encara que només hi hagi un element. Una categoria buida es pot escriure com [].
  • No poseu cometes dobles al voltant de true, false ni null; "false" és una cadena, no un booleà.
  • El fitxer ha de ser UTF-8 i JSON vàlids, sense claus duplicades. L’extensió també comprova l’estructura, els tipus de camp, les regles, els noms predefinits i els conjunts aleatoris; una sintaxi correcta no garanteix que una regla sigui utilitzable.

Un fitxer de configuració pot canviar l’UA que el navegador envia als llocs web. HTTPS protegeix la transmissió, però no garanteix que la configuració del servidor coincideixi amb el que voleu. Importeu només fitxers de fonts fiables, reviseu-ne el contingut abans de confirmar i comproveu l’efecte real després d’actualitzar la pàgina de destinació.

08Preguntes freqüents

Problema Què cal comprovar
S’indica que el format del fitxer és incorrecte Comproveu UTF-8, sintaxi JSON, claus duplicades, versió, camps obligatoris i tipus de regla. Utilitzeu com a plantilla un fitxer exportat per la nova versió.
Falla la càrrega remota Comproveu el certificat HTTPS, l’enllaç directe, la xarxa i el contingut de la resposta. No es permeten redireccions, inici de sessió amb galetes ni HTTP.
Falten regles després d’importar Les regles de domini i les dues biblioteques se substitueixen com a conjunts complets. Restaureu la còpia anterior a la importació o afegiu al fitxer nou tots els elements que vulgueu conservar.
S’ha importat una regla global buida, però la pàgina encara utilitza un altre UA Comproveu les regles de pestanya existents o les regles de domini coincidents; poden tenir prioritat sobre la regla global.
La importació ha tingut èxit, però l’UA és incorrecte Comproveu que la regla estigui activada, que el contingut sigui vàlid, que el conjunt aleatori tingui elements disponibles i que no hi hagi cap regla de pestanya o domini de prioritat superior; després actualitzeu la pàgina.
Error d’emmagatzematge en importar moltes dades Tant el fitxer com l’emmagatzematge sincronitzat del navegador tenen límits de mida. Reduïu les regles o les llistes i torneu-ho a provar; comproveu la configuració existent.
L’extensió no canvia després de modificar el fitxer remot La càrrega remota és una importació manual puntual. Torneu a introduir l’adreça, carregueu i confirmeu.