Saltar para o conteúdo principal

Instalação

Requer Node.js 20 ou superior. A versão 3 do SDK é somente ESM: carregue-a com import, pois require('gologin') não funciona.

Uso básico

Iniciar com o GologinApi

O GologinApi inicia um perfil e conecta o Puppeteer para você. O launch() retorna um browser do Puppeteer. Passe cloud: true para executar o perfil no Gologin Cloud Browser em vez de usar um navegador Orbita local:
Sem profileId, o launch() cria um novo perfil primeiro. O GologinApi também tem funções auxiliares, como createProfileRandomFingerprint(), addGologinProxyToProfile(), addCookiesToProfile() e deleteProfile(). Veja o Quickstart para um exemplo completo.

Principais parâmetros

Parar perfis

Feche primeiro o navegador na sua ferramenta de automação, por exemplo com browser.close(). O stop() não aceita opções e sempre envia o perfil para o Gologin. O stopLocal({ posting: false }) encerra a sessão sem enviar os dados do perfil. Use-o em servidores em que você não quer a sincronização com a nuvem. Os cookies ainda são enviados se você definir uploadCookiesToServer: true.

Gerenciar versões do navegador Orbita

Quando um perfil é iniciado, o SDK verifica qual versão do Orbita o user agent do perfil exige. Se essa versão ainda não estiver em ~/.gologin/browser, o SDK a baixa; caso contrário, reutiliza a cópia instalada. Para executar uma build específica, passe executablePath. As opções autoUpdateBrowser (padrão false) e checkBrowserUpdate ainda são aceitas, mas, no SDK atual (3.0.7), elas não alteram esse comportamento. Para baixar o Orbita com antecedência, chame checkAndDownloadBrowserByOpts() em uma instância de GoLogin. Trata-se de um método, não de uma exportação separada:
Sem opções, ele baixa as 5 versões mais recentes. Use-o antes de iniciar perfis em paralelo para evitar vários downloads simultâneos.

Executar mais de 100 perfis em paralelo

Ao executar muitos perfis simultaneamente em um servidor:
Importante para servidores:
  • Limite as inicializações simultâneas de perfis (recomendamos começar com 10 a 20)
  • Baixe as versões do Orbita antes de iniciar os perfis
  • No Linux: instale o Xvfb e defina DISPLAY=:99
  • Aumente os limites de descritores de arquivo: ulimit -n 65536
  • Monitore a RAM: cada perfil usa ~300-500 MB

Depuração

Defina a variável de ambiente para ativar logs detalhados:

GitHub e Changelog