Saltar al contenido principal

Instalación

Requiere Node.js 20 o posterior. La versión 3 del SDK es solo ESM: cárgala con import; require('gologin') no funciona.

Uso básico

Lanzar con GologinApi

GologinApi inicia un perfil y conecta Puppeteer por ti. launch() devuelve un browser de Puppeteer. Pasa cloud: true para ejecutar el perfil en Gologin Cloud Browser en lugar de un navegador Orbita local:
Si no indicas profileId, launch() crea primero un perfil nuevo. GologinApi también incluye funciones auxiliares como createProfileRandomFingerprint(), addGologinProxyToProfile(), addCookiesToProfile() y deleteProfile(). Consulta el Quickstart para ver un ejemplo completo.

Parámetros principales

Detener perfiles

Primero cierra el navegador en tu herramienta de automatización, por ejemplo con browser.close(). stop() no acepta opciones y siempre sube el perfil a Gologin. stopLocal({ posting: false }) finaliza la sesión sin subir los datos del perfil. Úsalo en servidores donde no quieras la sincronización con la nube. Las cookies se siguen subiendo si configuras uploadCookiesToServer: true.

Gestión de versiones del navegador Orbita

Cuando se inicia un perfil, el SDK comprueba qué versión de Orbita necesita el user agent del perfil. Si esa versión aún no está en ~/.gologin/browser, el SDK la descarga; de lo contrario, reutiliza la copia instalada. Para ejecutar una compilación concreta, pasa executablePath. Las opciones autoUpdateBrowser (por defecto false) y checkBrowserUpdate se siguen aceptando, pero en el SDK actual (3.0.7) no cambian este comportamiento. Para descargar Orbita con antelación, llama a checkAndDownloadBrowserByOpts() en una instancia de GoLogin. Es un método, no una exportación independiente:
Sin opciones, descarga las 5 últimas versiones. Úsalo antes de lanzar perfiles en paralelo para evitar varias descargas simultáneas.

Ejecutar más de 100 perfiles en paralelo

Cuando ejecutes muchos perfiles a la vez en un servidor:
Importante para servidores:
  • Limita los lanzamientos simultáneos de perfiles (se recomienda empezar con 10-20)
  • Descarga las versiones de Orbita antes de lanzar los perfiles
  • En Linux: instala Xvfb y configura DISPLAY=:99
  • Aumenta los límites de descriptores de archivo: ulimit -n 65536
  • Supervisa la RAM: cada perfil usa ~300-500 MB

Depuración

Configura la variable de entorno para obtener registros detallados:

GitHub y registro de cambios