Przejdź do głównej treści

Instalacja

Wymaga Node.js w wersji 20 lub nowszej. Wersja 3 pakietu SDK jest dostępna wyłącznie jako ESM: ładuj ją za pomocą import, ponieważ require('gologin') nie działa.

Podstawowe użycie

Uruchamianie za pomocą GologinApi

GologinApi uruchamia profil i automatycznie podłącza Puppeteer. Metoda launch() zwraca obiekt browser z Puppeteera. Przekaż cloud: true, aby uruchomić profil w Gologin Cloud Browser zamiast w lokalnej przeglądarce Orbita:
Jeśli nie podasz profileId, launch() najpierw utworzy nowy profil. GologinApi udostępnia również funkcje pomocnicze, takie jak createProfileRandomFingerprint(), addGologinProxyToProfile(), addCookiesToProfile() i deleteProfile(). Pełny przykład znajdziesz w Quickstart.

Najważniejsze parametry

Zatrzymywanie profili

Najpierw zamknij przeglądarkę w narzędziu do automatyzacji, na przykład za pomocą browser.close(). Metoda stop() nie przyjmuje żadnych opcji i zawsze przesyła profil do Gologin. Metoda stopLocal({ posting: false }) kończy sesję bez przesyłania danych profilu. Używaj jej na serwerach, na których nie chcesz synchronizacji z chmurą. Pliki cookie nadal zostaną przesłane, jeśli ustawisz uploadCookiesToServer: true.

Zarządzanie wersjami przeglądarki Orbita

Przy uruchamianiu profilu SDK sprawdza, jakiej wersji Orbita wymaga user agent danego profilu. Jeśli tej wersji nie ma jeszcze w ~/.gologin/browser, SDK ją pobiera, a w przeciwnym razie używa zainstalowanej kopii. Aby uruchomić konkretną wersję, przekaż executablePath. Opcje autoUpdateBrowser (domyślnie false) i checkBrowserUpdate są nadal akceptowane, ale w obecnej wersji SDK (3.0.7) nie zmieniają tego zachowania. Aby pobrać Orbita z wyprzedzeniem, wywołaj checkAndDownloadBrowserByOpts() na instancji GoLogin. To metoda, a nie osobny eksport:
Bez podania opcji metoda pobiera 5 najnowszych wersji. Użyj jej przed równoległym uruchamianiem profili, aby uniknąć wielu jednoczesnych pobrań.

Równoległe uruchamianie ponad 100 profili

Gdy na serwerze uruchamiasz jednocześnie wiele profili:
Ważne w przypadku serwerów:
  • Ogranicz liczbę jednocześnie uruchamianych profili (na początek zalecamy 10-20)
  • Pobierz wersje Orbita przed uruchomieniem profili
  • W systemie Linux: zainstaluj Xvfb i ustaw DISPLAY=:99
  • Zwiększ limity deskryptorów plików: ulimit -n 65536
  • Monitoruj pamięć RAM: każdy profil zajmuje ok. 300-500 MB

Debugowanie

Ustaw zmienną środowiskową, aby włączyć szczegółowe logowanie:

GitHub i Changelog