Máquinas y navegadores

Objetivo

Crear máquinas e instancias de navegador, y mantener las versiones de los paquetes de ejecución del navegador para acceso remoto, inicio de sesión en sitios y espacios de trabajo.

Requisitos previos

• Ha iniciado sesión en la consola.
• La cuenta actual tiene permisos relacionados con «Gestión de navegadores».
• Hay preparado un nodo de máquina o entorno de ejecución de navegador.
• El servicio de administración tiene configurado app.keeperbase para guardar paquetes client y engine del navegador.

Pasos

1. Vaya a «Gestión de navegadores > Lista de máquinas».

2. Haga clic en «Agregar máquina» y complete la dirección de máquina y el puerto.

   • Dirección de máquina: introduzca la dirección del servicio keeper. Por defecto keeper está en el servidor de instalación; normalmente use la dirección intranet del servidor.
   • Puerto: el valor predeterminado es 7000.
   • Versión integrada: al agregar o actualizar una máquina, el sistema llama a la interfaz bind de keeper para obtenerla y guardarla automáticamente. No se introduce manualmente en la página.

3. Guarde y confirme que existe el registro de máquina y que el servicio keeper es accesible y puede programarse.

4. Vaya a «Gestión de navegadores > Lista de navegadores».

5. Cree una instancia de navegador, seleccione la máquina, rellene el identificador del navegador y seleccione la versión del navegador.

   • Máquina: el navegador creado se ejecutará en la máquina seleccionada.
   • Identificador del navegador: use un contenido fácil de recordar, único, formado por letras o caracteres y sin espacios, por ejemplo chrome100.
   • Versión del navegador: seleccione una versión proporcionada por la gestión de versiones o seleccione «Versión integrada». En ese caso se usará la versión integrada guardada en la máquina seleccionada.
   • Modo de red:
     • Red normal: usa la red normal del navegador. Permite configurar proxy HTTP/SOCKS5 y es adecuada para escenarios generales.
     • Red aislada: crea un entorno de red independiente para el navegador, toma el control del tráfico de red del navegador y ofrece aislamiento más completo de DNS, UDP, WebRTC y otros comportamientos de red. Úsela en escenarios que requieren mayor aislamiento.
   • Ranura de red: obligatoria solo para Red aislada. Introduzca un número único mayor que 0.
   • Configuración DNS: obligatoria solo para Red aislada. Seleccione tcp o udp, introduzca la IP y el puerto DNS, y elija si DNS usa el proxy con direct o proxy. direct envía las solicitudes DNS directamente; proxy las envía a través del proxy.
   • Configuración de proxy: obligatoria solo para Red aislada. Seleccione socks5 o http, y luego introduzca el host y el puerto del proxy. Usuario y contraseña son opcionales.

6. Después de crear el navegador, puede editar el modo de red y la configuración de red aislada desde la lista de navegadores.

7. Haga clic en el botón «Iniciar» para arrancar el navegador hasta que el estado cambie a running.

Configuración del navegador

Desde la lista de navegadores, haga clic en la acción de configuración de una instancia para ajustar cómo se inicia e identifica ese navegador.

• Configuración básica:
  • Versión del kernel: seleccione la versión de runtime Chromium usada por la instancia. Use «Editar» junto al campo para mantener las versiones Chromium disponibles.
  • Sistema operativo: seleccione el perfil de sistema operativo. Use «Editar» para mantener la lista de sistemas operativos.
  • Marca y versión de marca: elija la marca del navegador, como Google Chrome, Microsoft Edge, Opera o Vivaldi, y luego seleccione una versión compatible. Al cambiar la marca se borra la versión seleccionada.
  • Modelo móvil: seleccione un perfil de dispositivo móvil cuando el navegador deba emular un entorno móvil. Use «Editar» para mantener las opciones de modelo.
  • Zona horaria: busque y seleccione la zona horaria del navegador, o restablézcala a la zona local.
• Configuración avanzada:
  • Opciones de arranque: agregue, edite o elimine argumentos de inicio de Chromium como pares clave-valor. Los valores predeterminados comunes incluyen disable-gpu, no-sandbox, ignore-certificate-errors, lang y autoplay-policy. Para más switches de línea de comandos de Chromium, consulte List of Chromium Command Line Switches.
  • Directorio temporal y directorio de caché: defina dónde escribe el navegador archivos temporales y datos de caché.
  • Tamaño máximo de imagen: defina el tamaño máximo de imagen, en píxeles, usado al obtener imágenes desde el navegador.
  • Aceleración por hardware: actívela solo cuando el entorno de ejecución admita aceleración GPU estable.
  • Borrar datos de usuario: borre los datos del usuario del navegador cuando se requiera una sesión limpia.

Haga clic en «Guardar» después de cambiar la configuración del navegador. Reinicie la instancia si los cambios deben aplicarse en un nuevo proceso del navegador.

Gestión de versiones del navegador

En «Gestión de navegadores > Lista de navegadores», haga clic en «Gestión de versiones» para abrir la página de versiones del navegador.

La página muestra nombre de versión, estado de engine, estado de client y acción de descarga.

Estado	Significado
No descargado	El servicio de licencias devolvió esta versión, pero no existe un paquete de este tipo en app.keeperbase
Actualización disponible	Existe un paquete local, pero el servicio de licencias tiene una versión de compilación superior
Última versión	La compilación local es mayor o igual que la del servicio de licencias, o la versión local no aparece en la respuesta del servicio

Las descargas se ejecutan en segundo plano y la página muestra el progreso. La descarga admite reanudación mediante HTTP Range. El archivo se guarda primero en un directorio temporal; al finalizar, se mueve a app.keeperbase/<version>/ y se eliminan los paquetes antiguos del mismo tipo en ese directorio.

Los nombres de archivo siguen este formato:

client_<version>_<buildVersion>.tar.gz
engine_<version>_<buildVersion>.tar.gz

APIs internas de Keeper

El servicio de administración expone APIs internas para que los nodos engine y client consulten versiones y descarguen paquetes. Estas APIs requieren JWT token interno.

API	Descripción
GET /internal/navi/keepers	Recoge paquetes locales desde app.keeperbase y devuelve versión, tipo, buildVersion y nombre de archivo
GET /internal/navi/downKeeper?version=<version>&type=<type>	Descarga el paquete local de la versión y tipo especificados, con soporte de HTTP Range

Los nodos engine y client consultan periódicamente /internal/navi/keepers, comparan el archivo BUILD de la versión local y, si falta la versión o la compilación local es menor, llaman a /internal/navi/downKeeper para descargar y descomprimir el paquete.

Validación

• La nueva máquina aparece en la lista.
• La lista de máquinas muestra la versión integrada obtenida desde keeper bind.
• La nueva instancia aparece en la lista de navegadores.
• La lista de navegadores muestra la versión del navegador. Si se usa «Versión integrada», también muestra la versión integrada de la máquina relacionada.
• La lista de navegadores muestra el modo de red y la ranura de red. Para navegadores de red aislada, haga clic en «Detalles de red» para revisar DNS, si DNS usa el proxy, y los detalles del proxy.
• La gestión de versiones muestra el estado de client y engine tras comparar paquetes locales con el servicio de licencias.
• Cuando un usuario accede a un sitio o espacio de trabajo, puede asignarse un entorno de navegador disponible.

Problemas frecuentes

• La instancia de navegador debe coincidir con el nodo de máquina; si la máquina o keeper no están disponibles, el acceso remoto se ve afectado.
• Versión del navegador, versión de marca y sistema operativo influyen en identificación y compatibilidad del sitio.
• Si la página de versiones muestra siempre «No descargado», revise permisos de app.keeperbase, conectividad con el servicio de licencias y estado de descarga.
• Si la actualización automática no funciona, confirme que los nodos puedan acceder a /internal/navi/keepers y /internal/navi/downKeeper, y que el JWT token sea correcto.
• La lista de ventanas sirve para observar ventanas activas y diagnosticar ocupaciones.