> ## 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. # Octoparse CLIのトラブルシューティング > 認証エラー、Chromeの問題、Linux arm64の制限、エクスポートエラーなど、よくあるOctoparse CLIエラーの解決方法です。 コマンドが失敗した原因がわからない場合にこのページを参照してください。まず `octoparse doctor --json` を実行して、環境の状態を構造化された形で確認してください。 ## 環境を診断する ```bash theme={null} octoparse doctor --json octoparse browser status --json ``` `"ok": false` のチェック項目を見つけ、再試行前に問題の依存関係を解決してください。 ## 認証エラー **`AUTH_REQUIRED` または `AUTH_INVALID`** CLIが有効な認証情報を見つけられませんでした。以下を実行してください。 ```bash theme={null} octoparse auth login octoparse auth status --json ``` CIの場合は `OCTO_ENGINE_API_KEY` または `OCTO_ENGINE_ACCESS_TOKEN` が設定されており、期限切れでないことを確認してください。 **APIキーが保存されない** CLIはキーを保存前に検証します。キーが拒否される場合は、[Octoparseコンソール](https://www.octoparse.com/console/account-center/api-keys)でキーが有効かどうかを確認してください。`--stdin` を使用している場合は、キーに余分な空白や改行が含まれていないことを確認してください。 **OAuthセッションの期限切れ** `octoparse auth login --oauth` を再実行してトークンを更新してください。 ## Chromeおよびブラウザエラー **Chromeのダウンロードが失敗する** CLIはChrome for Testingを自動でダウンロードします。失敗した場合： * ネットワーク、プロキシ、VPN設定を確認します。 * ローカルにインストール済みのChromeを使用します：`octoparse doctor --chrome-path /path/to/chrome` * Linuxサーバーの場合は、CDNへのアクセスを確認して再試行します。 **`LINUX_ARM64_UNSUPPORTED`** ローカル抽出（`run`、`detect`）はLinux arm64をサポートしていません。Chrome for TestingにはLinux arm64パッケージが存在しないためです。 対処方法： * Linux x64環境またはコンテナを使用する。 * クラウド抽出に切り替える：`octoparse cloud start ` **Linuxサーバーでブラウザが起動しない** ディスプレイのないヘッドレスLinuxサーバーでは、手動モード以外の `detect` が利用可能な場合にXvfbを自動的に使用します。必要に応じてインストールしてください。 ```bash theme={null} apt-get install -y xvfb ``` 手動detect（`--manual`）はインタラクティブなディスプレイが必要です。Linux上での手動ワークフローにはデスクトップまたはVNCセッションを使用してください。 ## タスクと実行のエラー **`TASK_INVALID` または終了コード 3** タスクがCLI v1でサポートされていないkernel browserまたはlegacy workflowを使用しています。現在のOctoparseデスクトップアプリでタスクを再作成し、次のコマンドで検証してください。 ```bash theme={null} octoparse task validate ``` **ローカル実行がすでに実行中** タスクIDごとに同時に実行できるローカル実行は1つのみです。まず既存の実行を停止してください。 ```bash theme={null} octoparse local stop octoparse local cleanup ``` **デタッチした実行が失われた、または古い状態になっている** 孤立した実行状態をクリーンアップします。 ```bash theme={null} octoparse local cleanup ``` 次に履歴を確認します。 ```bash theme={null} octoparse local history ``` **実行は完了したがデータが見つからない** エクスポートのソースを確認してください。ローカルデータとクラウドデータは別々です。 ```bash theme={null} octoparse data history --source local --json octoparse data history --source cloud --json ``` 抽出時に `--output ./runs` を使用した場合は、履歴とエクスポートにも同じパスを渡してください。 ```bash theme={null} octoparse data history --source local --output ./runs octoparse data export --source local --output ./runs --format xlsx ``` ## エクスポートエラー **`UNSUPPORTED_EXPORT_FORMAT`** サポートされている形式は `xlsx`、`csv`、`html`、`json`、`xml` です。`--format` の値を確認してください。 **エクスポートファイルが空** エクスポート前にタスクが行を収集しているか確認します。 ```bash theme={null} octoparse local history --json ``` 最新の実行エントリに `savedRows > 0` があるかを確認してください。 ## detectエラー **`DETECT_PAGE_BLOCKED`** 対象ページがCAPTCHA、セキュリティ検証、アクセス制限、またはサービスエラーページと判定されました。検証画面やエラー画面を内容とするタスクを生成しないよう、タスク作成前に停止します。 * CAPTCHAまたはアクセス制限を解決して再試行する。 * ブラウザ上で必要な操作を完了できる場合は `--manual` を使用する。 * 現在のURLが常にブロックページへリダイレクトされる場合は、直接アクセス可能なURLを指定する。 **`DETECT_FAILED` または候補が見つからない** ページが自動アクセスをブロックしているか、ログインゲートを表示しているか、コンテンツを動的に読み込んでいる可能性があります。試してください： * `--manual` で自分でログインやポップアップを処理する。 * `--goal` でより明確な抽出対象を指定する。 * エージェントコンテキストで生成されたスクリーンショット（`context.screenshot.path`）を確認する。 **`LOGIN_SESSION_REQUIRED`** セッション保存付きの手動detectを使用してください。 ```bash theme={null} octoparse detect --manual --save-session --session-name my-session ``` ## ヘルプを取得する `octoparse --help` または `octoparse --help` で使用方法の詳細を確認できます。 環境の問題を報告する際は、`octoparse doctor --json` の出力をOctoparseサポートに共有してください。 CLIバージョン（`octoparse --version`）と `octoparse doctor --json` の出力を含めてください。