> ## 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. # Risoluzione dei problemi della CLI di Octoparse > Correggi gli errori della CLI di Octoparse relativi ad autenticazione, Chrome, profilo browser, esecuzione attività, rilevamento di pagine bloccate, Linux arm64 ed esportazione dati. Usa questa pagina quando un comando non riesce e non sai perché. Inizia con `octoparse doctor --json` per ottenere una vista strutturata del tuo ambiente. ## Diagnostica l'ambiente ```bash theme={null} octoparse doctor --json octoparse browser status --json ``` Cerca qualsiasi controllo con `"ok": false` e risolvi la dipendenza segnalata prima di riprovare. ## Errori di autenticazione **`AUTH_REQUIRED` o `AUTH_INVALID`** La CLI non ha trovato credenziali valide. Esegui: ```bash theme={null} octoparse auth login octoparse auth status --json ``` Se operi in CI, controlla che `OCTO_ENGINE_API_KEY` o `OCTO_ENGINE_ACCESS_TOKEN` sia impostato e non scaduto. **La chiave API non viene salvata** La CLI verifica le chiavi prima di salvarle. Se la chiave viene rifiutata, verifica che sia attiva nella [console Octoparse](https://www.octoparse.it/console/account-center/api-keys). Se usi `--stdin`, verifica che la chiave non contenga spazi vuoti o nuove righe aggiuntivi. **Sessione OAuth scaduta** Esegui nuovamente `octoparse auth login --oauth` per aggiornare i token. ## Errori di Chrome e del browser **Download di Chrome non riuscito** La CLI scarica automaticamente Chrome for Testing da una CDN. Se il download non riesce: * Controlla le impostazioni di rete, Proxy o VPN. * Usa un Chrome installato localmente: `octoparse doctor --chrome-path /path/to/chrome` * Sui server Linux, verifica che la CDN sia raggiungibile e riprova. **`LINUX_ARM64_UNSUPPORTED`** L'estrazione locale (`run`, `detect`) non è supportata su Linux arm64. Chrome for Testing non dispone di un pacchetto per Linux arm64. Opzioni: * Usa un ambiente o un container Linux x64. * Usa invece l'estrazione cloud: `octoparse cloud start `. **Chrome non si avvia sui server Linux** Sui server Linux headless senza display, `detect` in modalità non manuale usa automaticamente Xvfb quando disponibile. Installalo se necessario: ```bash theme={null} apt-get install -y xvfb ``` Il rilevamento manuale (`--manual`) richiede un display interattivo. Usa una sessione desktop o VNC per i flussi di lavoro manuali su Linux. ## Errori delle attività e delle esecuzioni **`TASK_INVALID` o codice di uscita 3** L'attività usa il browser kernel o un flusso di lavoro legacy non supportato dalla CLI v1. Ricrea l'attività nell'app desktop Octoparse corrente, quindi convalidala con: ```bash theme={null} octoparse task validate ``` **Esecuzione locale già in corso** Può essere attiva una sola esecuzione locale per ciascun ID attività. Interrompi prima l'esecuzione esistente: ```bash theme={null} octoparse local stop octoparse local cleanup ``` **Esecuzione scollegata persa o obsoleta** Pulisci lo stato delle esecuzioni orfane: ```bash theme={null} octoparse local cleanup ``` Quindi controlla la cronologia: ```bash theme={null} octoparse local history ``` **L'esecuzione termina ma alcuni dati sembrano mancanti** Controlla la sorgente dell'esportazione. I dati locali e cloud sono separati: ```bash theme={null} octoparse data history --source local --json octoparse data history --source cloud --json ``` Se hai usato `--output ./runs` durante l'estrazione, passa lo stesso percorso alla cronologia e all'esportazione: ```bash theme={null} octoparse data history --source local --output ./runs octoparse data export --source local --output ./runs --format xlsx ``` ## Errori di esportazione **`UNSUPPORTED_EXPORT_FORMAT`** I formati supportati sono `xlsx`, `csv`, `html`, `json` e `xml`. Controlla il valore di `--format`. **Il file esportato è vuoto** Prima dell'esportazione, verifica che l'attività abbia raccolto delle righe. Controlla la cronologia delle esecuzioni locali: ```bash theme={null} octoparse local history --json ``` Cerca `savedRows > 0` nella voce dell'esecuzione più recente. ## Errori di detect **`DETECT_PAGE_BLOCKED`** La CLI ha identificato la destinazione come CAPTCHA, verifica di sicurezza, pagina con accesso limitato o pagina di errore del servizio. Si interrompe prima di creare un'attività, affinché il file risultante non descriva la schermata di verifica o di errore. * Risolvi il CAPTCHA o la limitazione di accesso e riprova. * Usa `--manual` quando l'interazione richiesta può essere completata nel browser. * Fornisci un URL direttamente accessibile quando quello corrente reindirizza sempre a una pagina bloccata. **`DETECT_FAILED` o nessun candidato trovato** La pagina potrebbe aver bloccato l'accesso automatizzato, mostrato una schermata di accesso o caricato il contenuto in modo dinamico. Prova: * `--manual` per gestire personalmente l'accesso o i popup. * `--goal` per fornire alla CLI un obiettivo di estrazione più chiaro. * Controllare lo screenshot generato nel contesto dell'agente (`context.screenshot.path`). **`LOGIN_SESSION_REQUIRED`** Usa il rilevamento manuale con salvataggio della sessione: ```bash theme={null} octoparse detect --manual --save-session --session-name my-session ``` ## Ottieni assistenza Esegui `octoparse --help` o `octoparse --help` per i dettagli sull'utilizzo. Quando segnali problemi dell'ambiente, condividi con l'assistenza Octoparse l'output di `octoparse doctor --json`. Includi la versione della CLI (`octoparse --version`) e l'output di `octoparse doctor --json`.