> ## 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.
# Installation
> Installieren Sie Octoparse CLI mit npm, prüfen Sie Node.js und Plattformanforderungen und testen Sie lokale Engine, Chrome und Benutzerbrowserbereitschaft.
Octoparse CLI wird als npm-Paket bereitgestellt und läuft mit Node.js 20 oder neuer.
## Anforderungen
Stellen Sie vor der Installation von Octoparse CLI sicher, dass Ihre Umgebung Folgendes enthält:
* Node.js 20 oder neuer
* npm 8 oder neuer
* Ein Terminal oder eine Befehlszeilen-Shell
Prüfen Sie Ihre Node.js- und npm-Versionen:
```bash theme={null}
node -v
npm -v
```
Wenn Ihre Node.js-Version älter als 20 ist, aktualisieren Sie sie, bevor Sie fortfahren.
Installieren Sie Node.js 20 oder neuer für Ihr Betriebssystem.
### Unterstützte Plattformen für die lokale Extraktion
Die lokale Extraktion verwendet eine unabhängige Chrome-Laufzeit. Unterstützte Plattformen:
* macOS (x64 und arm64)
* Windows (x64)
* Linux (x64)
Linux arm64 wird für die lokale Extraktion nicht unterstützt. Chrome for Testing stellt kein Paket für Linux arm64 bereit. Wenn Sie einen ARM-Server oder einen Apple-Silicon-Container mit einem Linux-arm64-Image verwenden, schlagen die lokalen Befehle `run` und `detect` fehl. Die Cloud-Extraktion (`octoparse cloud start`) funktioniert auf jeder Plattform.
## Mit npm installieren
Installieren Sie Octoparse CLI global:
```bash theme={null}
npm install -g @octoparse-ai/octoparse-cli
```
Nach der Installation ist der Befehl `octoparse` global verfügbar.
## Installation überprüfen
### Schnellprüfungen
Prüfen Sie die installierte Version:
```bash theme={null}
octoparse --version
```
Öffnen Sie die Hilfeausgabe:
```bash theme={null}
octoparse --help
```
### Ausgabe von doctor verstehen
Führen Sie die Diagnose aus:
```bash theme={null}
octoparse doctor
```
`octoparse doctor` prüft Node.js, die integrierte Octoparse-Engine, Laufzeiterweiterungen, die Verfügbarkeit von Chrome und den Browsermodus.
Ein erfolgreiches Ergebnis gibt `"ok": true` zurück:
```json theme={null}
{
"ok": true,
"checks": [
{ "name": "node", "ok": true, "message": "v24.0.0" },
{ "name": "engine", "ok": true, "message": "..." },
{ "name": "electron-client", "ok": true, "message": "not required" },
{ "name": "browser-mode", "ok": true, "message": "independent Chrome only" }
]
}
```
* `electron-client: not required` – die Octoparse-Desktop-App wird für die Ausführung per CLI nicht benötigt.
* `browser-mode: independent Chrome only` – die lokale Extraktion verwendet eine unabhängige Chrome-Laufzeit und nicht den Browser des Desktop-Clients.
Wenn `chrome` den Wert `ok: false` anzeigt, lesen Sie unten den Abschnitt [Fehlerbehebung](#troubleshooting).
Verwenden Sie bei Bedarf einen benutzerdefinierten Chrome-Pfad:
```bash theme={null}
octoparse doctor --chrome-path /path/to/chrome
```
### Bereitschaft des Benutzerbrowsers prüfen
```bash theme={null}
octoparse browser status
```
Verwenden Sie die JSON-Ausgabe für strukturierte Umgebungs- und Benutzerbrowserprüfungen:
```bash theme={null}
octoparse doctor --json
octoparse browser status --json
```
## Installation verwalten
### Octoparse CLI aktualisieren
Führen Sie den npm-Installationsbefehl erneut aus, um die CLI zu aktualisieren:
```bash theme={null}
npm install -g @octoparse-ai/octoparse-cli
octoparse --version
```
### Octoparse CLI deinstallieren
```bash theme={null}
npm uninstall -g @octoparse-ai/octoparse-cli
```
Wenn die Shell `octoparse: command not found` zurückgibt, wurde der Befehl entfernt.
## Fehlerbehebung
| Problem | Zu prüfen |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `octoparse: command not found` | Stellen Sie sicher, dass sich das globale npm-Binärverzeichnis in Ihrem `PATH` befindet |
| Berechtigungsfehler bei der Installation | Prüfen Sie die Berechtigungen für globale npm-Pakete oder verwenden Sie einen Node.js-Versionsmanager. [npm-Leitfaden ansehen →](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally) |
| Node.js-Version ist zu alt | Aktualisieren Sie auf Node.js 20 oder neuer |
| npm-Installation überschreitet das Zeitlimit | Prüfen Sie Ihre npm-Registry sowie Proxy-, VPN- oder Firewall-Einstellungen |
| Chrome kann nicht heruntergeladen werden | Prüfen Sie Ihren Netzwerkzugriff auf das CDN von Chrome for Testing. Versuchen Sie, mit `--chrome-path` ein lokal installiertes Chrome zu verwenden |
| Linux arm64 wird nicht unterstützt | Verwenden Sie eine Linux-x64-Umgebung oder wechseln Sie mit `octoparse cloud start` zur Cloud-Extraktion |
| `doctor` zeigt eine fehlgeschlagene Prüfung | Beheben Sie die markierte Abhängigkeit (Node.js, Chrome, Engine-Dateien) und führen Sie `octoparse doctor` erneut aus. Teilen Sie die Ausgabe `ok: false` mit dem Octoparse-Support, falls das Problem fortbesteht |
## Wie geht es weiter?
Erstellen Sie einen Octoparse-API-Schlüssel und authentifizieren Sie die CLI.
Listen und prüfen Sie Aufgaben, führen Sie eine Aufgabe lokal aus und exportieren Sie Daten.
Informieren Sie sich über häufige CLI-Befehle für Aufgaben, lokale Läufe, Cloud-Läufe und Exporte.