> ## Documentation Index > Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Fehlerbehebung für die Octoparse CLI > Beheben Sie Fehler der Octoparse CLI bei Authentifizierung, Chrome, Browserprofilen, Aufgabenausführung, blockierten Seiten, Linux arm64 und Datenexport. Verwenden Sie diese Seite, wenn ein Befehl fehlschlägt und die Ursache unklar ist. Beginnen Sie mit `octoparse doctor --json`, um eine strukturierte Übersicht Ihrer Umgebung zu erhalten. ## Umgebung diagnostizieren ```bash theme={null} octoparse doctor --json octoparse browser status --json ``` Suchen Sie nach Prüfungen mit `"ok": false` und beheben Sie die markierte Abhängigkeit, bevor Sie es erneut versuchen. ## Authentifizierungsfehler **`AUTH_REQUIRED` oder `AUTH_INVALID`** Die CLI konnte keine gültigen Anmeldedaten finden. Führen Sie Folgendes aus: ```bash theme={null} octoparse auth login octoparse auth status --json ``` Prüfen Sie in CI-Umgebungen, ob `OCTO_ENGINE_API_KEY` oder `OCTO_ENGINE_ACCESS_TOKEN` gesetzt und nicht abgelaufen ist. **API-Schlüssel wird nicht gespeichert** Die CLI überprüft Schlüssel vor dem Speichern. Wird Ihr Schlüssel abgelehnt, bestätigen Sie, dass er in der [Octoparse-Konsole](https://www.octoparse.de/console/account-center/api-keys) aktiv ist. Prüfen Sie bei Verwendung von `--stdin`, dass dem Schlüssel keine zusätzlichen Leerzeichen oder Zeilenumbrüche angefügt sind. **OAuth-Sitzung abgelaufen** Führen Sie `octoparse auth login --oauth` erneut aus, um die Token zu aktualisieren. ## Chrome- und Browserfehler **Chrome kann nicht heruntergeladen werden** Die CLI lädt Chrome for Testing automatisch von einem CDN herunter. Wenn der Download fehlschlägt: * Prüfen Sie Ihre Netzwerk-, Proxy- oder VPN-Einstellungen. * Verwenden Sie ein lokal installiertes Chrome: `octoparse doctor --chrome-path /path/to/chrome` * Stellen Sie auf Linux-Servern sicher, dass das CDN erreichbar ist, und versuchen Sie es erneut. **`LINUX_ARM64_UNSUPPORTED`** Lokale Extraktion (`run`, `detect`) wird unter Linux arm64 nicht unterstützt. Für Chrome for Testing gibt es kein Linux-arm64-Paket. Optionen: * Verwenden Sie eine Linux-x64-Umgebung oder einen entsprechenden Container. * Verwenden Sie stattdessen die Cloud-Extraktion: `octoparse cloud start `. **Chrome startet auf Linux-Servern nicht** Auf monitorlosen Linux-Servern ohne Anzeige verwendet `detect` im nicht manuellen Modus automatisch Xvfb, sofern verfügbar. Installieren Sie es bei Bedarf: ```bash theme={null} apt-get install -y xvfb ``` Die manuelle Erkennung (`--manual`) erfordert eine interaktive Anzeige. Verwenden Sie für manuelle Workflows unter Linux einen Desktop oder eine VNC-Sitzung. ## Aufgaben- und Lauffehler **`TASK_INVALID` oder Exit-Code 3** Die Aufgabe verwendet einen Kernel-Browser oder einen älteren Workflow, der von CLI v1 nicht unterstützt wird. Erstellen Sie die Aufgabe in der aktuellen Octoparse-Desktop-App neu und validieren Sie sie anschließend mit: ```bash theme={null} octoparse task validate ``` **Lokaler Lauf wird bereits ausgeführt** Pro Aufgaben-ID kann jeweils nur ein lokaler Lauf aktiv sein. Stoppen Sie zuerst den vorhandenen Lauf: ```bash theme={null} octoparse local stop octoparse local cleanup ``` **Losgelöster Lauf verloren oder veraltet** Bereinigen Sie verwaiste Laufzustände: ```bash theme={null} octoparse local cleanup ``` Prüfen Sie danach den Verlauf: ```bash theme={null} octoparse local history ``` **Lauf wird abgeschlossen, aber Daten scheinen zu fehlen** Prüfen Sie die Exportquelle. Lokale und Cloud-Daten sind getrennt: ```bash theme={null} octoparse data history --source local --json octoparse data history --source cloud --json ``` Wenn Sie während der Extraktion `--output ./runs` verwendet haben, geben Sie für Verlauf und Export denselben Pfad an: ```bash theme={null} octoparse data history --source local --output ./runs octoparse data export --source local --output ./runs --format xlsx ``` ## Exportfehler **`UNSUPPORTED_EXPORT_FORMAT`** Unterstützte Formate sind `xlsx`, `csv`, `html`, `json` und `xml`. Prüfen Sie den Wert für `--format`. **Exportdatei ist leer** Vergewissern Sie sich vor dem Export, dass die Aufgabe Zeilen erfasst hat. Prüfen Sie den Verlauf lokaler Läufe: ```bash theme={null} octoparse local history --json ``` Suchen Sie im neuesten Laufeintrag nach `savedRows > 0`. ## Erkennungsfehler **`DETECT_PAGE_BLOCKED`** Die CLI hat das Ziel als CAPTCHA, Sicherheitsabfrage, zugriffsbeschränkte Seite oder Dienstfehlerseite erkannt. Sie stoppt vor der Aufgabenerstellung, damit die resultierende Datei nicht den Verifizierungs- oder Fehlerbildschirm beschreibt. * Lösen Sie das CAPTCHA oder die Zugriffsbeschränkung und versuchen Sie es erneut. * Verwenden Sie `--manual`, wenn die erforderliche Interaktion im Browser abgeschlossen werden kann. * Geben Sie eine direkt zugängliche URL an, wenn die aktuelle URL immer auf eine blockierte Seite weiterleitet. **`DETECT_FAILED` oder keine Kandidaten gefunden** Möglicherweise hat die Seite den automatisierten Zugriff blockiert, eine Anmeldeschranke angezeigt oder Inhalte dynamisch geladen. Versuchen Sie Folgendes: * Verwenden Sie `--manual`, um Anmeldung oder Pop-ups selbst zu bearbeiten. * Geben Sie mit `--goal` ein klareres Extraktionsziel vor. * Prüfen Sie den erzeugten Screenshot im Agentenkontext (`context.screenshot.path`). **`LOGIN_SESSION_REQUIRED`** Verwenden Sie die manuelle Erkennung mit Sitzungsspeicherung: ```bash theme={null} octoparse detect --manual --save-session --session-name my-session ``` ## Hilfe erhalten Führen Sie `octoparse --help` oder `octoparse --help` aus, um Nutzungsdetails anzuzeigen. Geben Sie bei der Meldung von Umgebungsproblemen die Ausgabe von `octoparse doctor --json` an den Octoparse-Support weiter. Geben Sie Ihre CLI-Version (`octoparse --version`) und die Ausgabe von `octoparse doctor --json` an.