Instalación
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:
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
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:
Ejecutar más de 100 perfiles en paralelo
Cuando ejecutes muchos perfiles a la vez en un servidor:- 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
- Código fuente: https://github.com/gologinapp/gologin
- Registro de cambios