Zum Hauptinhalt springen

Installation

Erfordert Node.js 20 oder höher. Version 3 des SDK ist ausschließlich ESM: Laden Sie es mit import, require('gologin') funktioniert nicht.

Grundlegende Verwendung

Start mit GologinApi

GologinApi startet ein Profil und verbindet Puppeteer automatisch. launch() gibt einen Puppeteer-browser zurück. Übergeben Sie cloud: true, um das Profil im Gologin Cloud Browser statt in einem lokalen Orbita-Browser auszuführen:
Ohne profileId erstellt launch() zunächst ein neues Profil. GologinApi bietet außerdem Hilfsfunktionen wie createProfileRandomFingerprint(), addGologinProxyToProfile(), addCookiesToProfile() und deleteProfile(). Ein vollständiges Beispiel finden Sie im Quickstart.

Wichtige Parameter

Profile beenden

Schließen Sie zuerst den Browser in Ihrem Automatisierungstool, zum Beispiel mit browser.close(). stop() akzeptiert keine Optionen und lädt das Profil immer zu Gologin hoch. stopLocal({ posting: false }) beendet die Sitzung, ohne Profildaten hochzuladen. Verwenden Sie diese Methode auf Servern, auf denen Sie keine Cloud-Synchronisierung wünschen. Cookies werden weiterhin hochgeladen, wenn Sie uploadCookiesToServer: true gesetzt haben.

Orbita-Browserversionen verwalten

Beim Start eines Profils prüft das SDK, welche Orbita-Version der User-Agent des Profils benötigt. Ist diese Version noch nicht in ~/.gologin/browser vorhanden, lädt das SDK sie herunter, andernfalls verwendet es die installierte Kopie. Um einen bestimmten Build auszuführen, übergeben Sie executablePath. Die Optionen autoUpdateBrowser (Standardwert false) und checkBrowserUpdate werden weiterhin akzeptiert, ändern dieses Verhalten im aktuellen SDK (3.0.7) jedoch nicht. Um Orbita im Voraus herunterzuladen, rufen Sie checkAndDownloadBrowserByOpts() auf einer GoLogin-Instanz auf. Dies ist eine Methode und kein separater Export:
Ohne Optionen werden die 5 neuesten Versionen heruntergeladen. Verwenden Sie die Methode, bevor Sie Profile parallel starten, um mehrere gleichzeitige Downloads zu vermeiden.

Mehr als 100 Profile parallel ausführen

Wenn Sie viele Profile gleichzeitig auf einem Server ausführen:
Wichtig für Server:
  • Begrenzen Sie die Anzahl gleichzeitiger Profilstarts (zum Einstieg werden 10-20 empfohlen)
  • Laden Sie Orbita-Versionen vor dem Start herunter
  • Unter Linux: Installieren Sie Xvfb und setzen Sie DISPLAY=:99
  • Erhöhen Sie die Limits für Dateideskriptoren: ulimit -n 65536
  • Überwachen Sie den Arbeitsspeicher: Jedes Profil benötigt ca. 300-500 MB

Debugging

Setzen Sie die Umgebungsvariable für ausführliche Protokollierung:

GitHub & Changelog