Guía de configuración de UA Pro

Importación, exportación y configuración remota

Crea copias de seguridad, migra y redacta configuraciones manualmente, o cárgalas desde una dirección remota.

Versión aplicable: UA Pro 1.5.0

Esta guía se aplica a UA Pro 1.5.0 y explica cómo hacer copias de seguridad, migrar y redactar configuraciones manualmente, y cargarlas desde una dirección remota. La nueva versión utiliza un formato de instantánea completa: el version del archivo de configuración es 2.

Antes de importar, exporta una copia de seguridad en el navegador de destino. Cada importación sustituye la regla global, el conjunto completo de reglas de dominio, las dos bibliotecas de UA y el interruptor de alternativa por dominio del recurso por la instantánea completa del archivo; no combina las entradas una a una. "globalRule": null indica que se borrará la regla global del navegador de destino.

01Exportar configuración

  1. Haz clic en el icono de UA Pro en la barra de herramientas del navegador.
  2. Abre «Más» → «Importar o exportar configuración».
  3. Haz clic en «Exportar configuración» y guarda el archivo .json descargado.
  4. El nombre del archivo es similar a ua-switcher-config-2026-11-16.json. La fecha del nombre se genera en UTC y puede diferir un día de la fecha local.

El archivo contiene la siguiente configuración persistente:

  • La regla global y su estado activado o en pausa.
  • El conjunto completo de reglas de dominio y su estado activado o en pausa.
  • Categorías y entradas de UA personalizados.
  • Categorías y entradas de texto añadido.
  • El interruptor «Alternativa por dominio del recurso».

El archivo no incluye reglas de pestaña, vinculaciones de UA aleatorio ya seleccionadas, pestañas abiertas, idioma de la interfaz, tema ni ajustes de la capa flotante. Estos elementos no se restauran desde la copia al importar; las reglas de pestaña existentes en el navegador de destino tampoco se borran al importar y pueden seguir prevaleciendo sobre las reglas de dominio o globales.

El archivo exportado es JSON legible en texto sin cifrar. Guarda la copia de forma segura si los UA personalizados o las categorías contienen información que no deseas divulgar.

02Importar desde un archivo local

  1. En el navegador de destino, abre UA Pro → «Más» → «Importar o exportar configuración».
  2. Primero haz clic en «Exportar configuración» para conservar la configuración original del navegador de destino y poder restaurarla si es necesario.
  3. Haz clic en «Importar configuración» y selecciona el archivo .json.
  4. Lee el aviso de sustitución y las cantidades de reglas y listas. Haz clic en «Ver contenido de la configuración» para revisar el JSON completo antes de confirmar. Al elegir «Cancelar» no se escribe nada. Tras confirmar, espera el mensaje «¡Configuración importada!». Si los ajustes cambian durante la confirmación, la extensión pedirá repetir la operación.
  5. Verifica las reglas globales y de dominio, las listas personalizadas y el interruptor de alternativa por dominio del recurso; verifica también si alguna regla de pestaña existente prevalece sobre ellas. Actualiza las páginas que quieras probar y verifica el UA.

La extensión verifica primero el archivo, después intenta instalar las reglas y finalmente escribe la configuración persistente. Si falla la instalación o la escritura, intenta restaurar las reglas guardadas actualmente en el navegador. Si indica que no puede restaurarlas, verifica los ajustes reales. Si la sincronización del navegador u otra ventana modifica la configuración al mismo tiempo, no debe entenderse este proceso como una transacción entre dispositivos.

03Cargar desde una dirección remota

La configuración remota usa el mismo contenido JSON que una copia local. Es una carga e importación manual única, no una suscripción que se actualiza automáticamente.

  1. Primero exporta una copia de seguridad o prepara un archivo JSON como se indica a continuación.
  2. Coloca el archivo en un servicio HTTPS accesible desde el navegador de destino y obtén una dirección completa que devuelva directamente el contenido JSON, por ejemplo https://example.com/ua-pro/config.json. Esta dirección es solo un ejemplo; sustitúyela por tu dirección real.
  3. En UA Pro, abre «Más» → «Importar o exportar configuración», despliega «Configuración remota», pega la dirección y haz clic en «Cargar».
  4. Una vez superadas la carga y la verificación del formato, la extensión muestra un cuadro de confirmación y el nombre del host remoto. Haz clic en «Ver contenido de la configuración» para revisar el JSON completo realmente descargado. Al confirmar se actualizan los ajustes con las mismas reglas que en una importación local; al cancelar no se importa.
  5. Cuando cambie el archivo en el servidor, vuelve a introducir la dirección, cargar y confirmar para usar el nuevo contenido. La dirección no se conserva automáticamente al volver a abrir el panel.

Solo se aceptan enlaces HTTPS directos; no se aceptan HTTP, nombres de usuario o contraseñas en la dirección ni fragmentos de URL, y no se siguen redirecciones. La solicitud no lleva cookies del navegador ni credenciales de inicio de sesión, no envía Referer y evita la caché; por tanto, no sirven los servicios que requieren cookies de inicio de sesión. UA Pro no aplica a esta solicitud las reglas de UA configuradas en esta extensión, aunque otras extensiones o dispositivos de red podrían modificarla. La dirección puede incluir parámetros de consulta; protege como una contraseña cualquier dirección que contenga un token de acceso. Usa una dirección de confianza y asegúrate de que la respuesta sea directamente un archivo JSON, no una página de inicio de sesión ni una página HTML que muestre código.

Los archivos locales y las respuestas remotas están limitados a 128 KiB cada uno; la lectura remota tiene un límite de 10 segundos y cuenta el contenido realmente leído. El almacenamiento sincronizado del navegador tiene además una cuota menor por elemento, por lo que un archivo inferior a 128 KiB puede no guardarse si las reglas o una biblioteca son demasiado grandes. Si aparece un error, verifica que el servidor devuelva el estado 200 y JSON válido, que el certificado sea válido, que la dirección no redirija y que la red sea accesible.

04Ejemplo JSON completo

El siguiente ejemplo puede guardarse como config.json con codificación UTF-8. Los dominios y valores UA de ejemplo son solo ilustrativos; haz una copia de la configuración actual antes de sustituirla. JSON distingue mayúsculas de minúsculas: usa comillas dobles para las cadenas, no añadas una coma tras el último elemento y no escribas comentarios dentro de 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
  }
}

Este ejemplo establece un UA global integrado y cuatro reglas de dominio. Las reglas de subdominio más específicas, como app.example.com, tienen prioridad sobre example.com. Las reglas en pausa no participan en la búsqueda de coincidencias activas, por lo que aún puede aplicarse una regla del dominio principal o global. Que un sitio real reconozca el UA de ejemplo depende del propio sitio.

05Campos de nivel superior y sustitución

Campo Ejemplo Función
version 2 Obligatorio. La nueva versión solo acepta el valor numérico 2.
type "ua-switcher-config" Obligatorio. Identificador del tipo de configuración; debe coincidir exactamente con esta cadena.
timestamp "2026-11-16T06:00:00.000Z" Obligatorio. Hora UTC con milisegundos y Z; solo sirve como registro y no determina cuándo se aplican las reglas.
data { ... } Obligatorio. Objeto que contiene la configuración completa, incluidos todos los campos de la siguiente tabla.
Campos de data Formato correcto Comportamiento al importar en esta versión
globalRule Un objeto de regla, o null Un objeto de regla sustituye la regla global existente; null la borra.
domainRules { "域名": 规则对象 } El objeto completo sustituye las reglas de dominio anteriores; {} las vacía.
userCustomData { "分类": ["UA", ...] } El objeto completo sustituye la biblioteca anterior de UA personalizados; {} la vacía.
userAppendData { "分类": ["追加文本", ...] } El objeto completo sustituye la biblioteca anterior de texto añadido; {} la vacía.
resourceDomainFallback true o false Valor booleano JSON: activa o desactiva la alternativa por dominio del recurso.

Los cinco campos son obligatorios; no se puede usar null salvo para globalRule. Se rechazan los campos ausentes o desconocidos y las claves JSON duplicadas; tampoco se importan configuraciones de versiones anteriores o parciales. Las reglas de dominio y las dos bibliotecas se sustituyen por conjuntos completos: por ejemplo, un domainRules con un solo dominio sustituirá las demás reglas de dominio existentes en el navegador de destino. Se recomienda editar un archivo realmente exportado por la nueva versión y conservar íntegramente los elementos necesarios.

La alternativa por dominio del recurso solo puede aplicar una regla según el dominio de destino de la solicitud del recurso cuando la página principal no tiene un UA de pestaña, dominio o global activo. No significa que todos los recursos de otros dominios prevalezcan sobre la regla de la página principal.

06Cómo escribir objetos de regla

La regla global y cada regla de dominio usan la misma estructura:

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

enabled: true significa activada y false significa en pausa. mode determina los campos de params:

6.1 UA integrado: builtin

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

os y uaKey deben coincidir exactamente con las claves de los valores predefinidos internos de esta versión de la extensión; no tienen por qué coincidir con los textos traducidos de la interfaz. Lo más seguro es seleccionar el valor predefinido en la interfaz, exportar la configuración y copiar el params correspondiente. Vuelve a verificarlo cuando cambie la lista de valores predefinidos entre versiones.

6.2 UA personalizado: custom

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

value es la cadena UA completa. category se usa para clasificar y editar en la interfaz; se recomienda incluir también el valor en la categoría del mismo nombre de userCustomData. Al aplicarse, la regla lee su propio value; importar una regla manualmente no añade automáticamente ese valor a la biblioteca personalizada.

6.3 Añadir texto: append

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

La extensión añade un espacio después del UA original del navegador actual y luego añade value. Se recomienda conservar también ese texto en la categoría del mismo nombre de userAppendData; importar la regla no rellena automáticamente la lista.

6.4 UA aleatorio: random

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

strategy debe ser "page" (se selecciona en cada carga completa de página) o "tab" (se mantiene por regla y pestaña). Las selecciones aleatorias pueden repetirse; dos resultados iguales seguidos no significan necesariamente que no se haya vuelto a seleccionar.

Valores habituales de pool:

Valor Origen aleatorio
all Todos los UA integrados, personalizados y generados a partir del texto añadido
builtin Todos los UA integrados
builtin_desktop, builtin_mobile, builtin_legacy Categorías integradas de escritorio, móvil o dispositivos antiguos
builtin_gaming, builtin_smarttv, builtin_communication, builtin_social La categoría integrada correspondiente
custom UA de todas las categorías personalizadas
custom:分类名 UA de la categoría indicada en userCustomData
append_all UA correspondientes a todos los textos añadidos
append:分类名 UA correspondientes al texto añadido en la categoría indicada en userAppendData

El nombre de categoría después de los dos puntos debe coincidir con una clave de la biblioteca. Una regla aleatoria activada debe tener candidatos disponibles; de lo contrario, se rechazará el archivo.

07Verificaciones al editar manualmente

  • Usa nombres de dominio como claves de domainRules, por ejemplo example.com o shop.example.com; no incluyas https://, rutas, puertos ni espacios. Las reglas de dominio también coinciden con subdominios. En esta versión, *.example.com también incluye example.com en sí; no significa «solo subdominios».
  • Los nombres de categoría pueden contener caracteres chinos y deben ser cadenas no vacías sin caracteres de control ni controles bidireccionales peligrosos; __proto__, prototype y constructor no pueden ser nombres de categoría. Se recomienda usar caracteres ASCII imprimibles para los UA y el texto añadido. No incluyas saltos de línea, tabulaciones ni otros caracteres de control. Cada UA puede tener hasta 4096 caracteres. Las comillas dobles y las barras invertidas del texto deben escaparse según las reglas JSON.
  • Cada categoría corresponde a una matriz de cadenas, por ejemplo "常用": ["Agent/1.0", "Agent/2.0"]. Conserva los corchetes incluso si solo hay un elemento. Una categoría vacía puede escribirse como [].
  • No pongas comillas dobles alrededor de true, false ni null; "false" es una cadena, no un valor booleano.
  • El archivo debe ser UTF-8 y JSON válidos, sin claves duplicadas. La extensión también verifica la estructura, los tipos de campo, las reglas, los nombres predefinidos y los conjuntos aleatorios; una sintaxis correcta no garantiza que una regla se pueda usar.

Un archivo de configuración puede cambiar el UA que el navegador envía a los sitios web. HTTPS protege la transmisión, pero no garantiza que la configuración del servidor corresponda a lo que deseas. Importa solo archivos de fuentes confiables, revisa el contenido antes de confirmar y verifica el efecto real tras actualizar la página de destino.

08Preguntas frecuentes

Problema Qué verificar
Se indica que el formato del archivo es incorrecto Verifica UTF-8, sintaxis JSON, claves duplicadas, versión, campos obligatorios y tipos de regla. Usa como plantilla un archivo exportado por la nueva versión.
Falla la carga remota Verifica el certificado HTTPS, el enlace directo, la red y el contenido de la respuesta. No se permiten redirecciones, inicio de sesión con cookies ni HTTP.
Faltan reglas después de importar Las reglas de dominio y las dos bibliotecas se sustituyen por conjuntos completos. Restaura la copia anterior a la importación o añade al nuevo archivo todos los elementos que necesites conservar.
Se importó una regla global vacía, pero la página sigue usando otro UA Verifica las reglas de pestaña existentes o las reglas de dominio coincidentes; pueden tener prioridad sobre la regla global.
Se indica que la importación tuvo éxito, pero el UA es incorrecto Verifica que la regla esté activada, que su contenido sea válido, que el conjunto aleatorio tenga entradas disponibles y que no exista una regla de pestaña o dominio con mayor prioridad; después actualiza la página.
Error de almacenamiento al importar muchos datos Tanto el archivo como el almacenamiento sincronizado del navegador tienen límites de tamaño. Reduce las reglas o listas y vuelve a intentarlo; verifica la configuración existente.
La extensión no cambia después de modificar el archivo remoto La carga remota es una importación manual única. Vuelve a introducir la dirección, cargar y confirmar.