跳转到主要内容
通过 npm 安装八爪鱼 CLI，并确认 octopus 命令、浏览器依赖与本地运行环境可用。
八爪鱼 CLI 以 npm 包形式发布。v0.1.24 增强了 octopus detect 的 Agent 视觉审查与样品采集流程。

​
环境要求

安装前请确认：
  • Node.js 20 或更高（推荐 22 LTS）
  • npm 8 或更高
  • 可用终端：PowerShell、CMD、macOS 终端或 Linux Shell
  • 网页 detect 与本地 run 需要可用 Chrome 环境
检查版本： 
node -v
npm -v

​
平台支持

平台本地采集云端采集备注
Windows x64支持支持Windows 10 / 11
macOS x64支持支持需 Node.js 20+
macOS arm64支持支持需 Node.js 20+
Linux x64支持支持v0.1.22 新增
Linux arm64暂不支持支持Chrome for Testing 暂无 Linux arm64 浏览器包

​
安装 Node.js

​
Windows

  1. 访问 Node.js 官网 下载 LTS 安装包。
  2. 使用默认选项安装，并确认勾选加入 PATH。
  3. 打开 PowerShell 或 CMD，执行：
node --version
npm --version

​
macOS

可从 Node.js 官网 下载 macOS 安装包，或使用 Homebrew： 
brew install node
node --version
npm --version

​
Linux / 服务器

推荐使用 nvm 安装 Node.js 20+： 
node -v
npm -v
Linux x64 从 CLI v0.1.22 起支持本地采集；Linux arm64 目前仅建议使用云采集相关能力。

​
安装八爪鱼 CLI

安装或更新到 v0.1.24： 
npm install -g bazhuayu-cli@0.1.24
安装完成后，命令名为： 
octopus
查看版本与帮助： 
octopus --version
octopus --help
v0.1.24 应能看到 detect 命令： 
octopus detect --help

​
运行环境诊断

octopus doctor
octopus browser doctor
doctor 会检查 Node.js、内置引擎、Chrome 可用性及浏览器模式。成功时通常返回 "ok": true。

​
更新与卸载

更新到指定版本： 
npm install -g bazhuayu-cli@0.1.24
octopus --version
卸载： 
npm uninstall -g bazhuayu-cli

​
常见问题

现象处理建议
octopus: command not found将 Node.js 目录和 npm 全局 bin 目录加入系统 PATH
PowerShell 中文参数被拆开给中文参数加双引号，例如 --goal "提取电影名称、评分"
PowerShell 多行命令报错使用反引号 ` 续行，或优先写成单行
URL 无法打开检查是否写完整协议，例如 https://example.com
--output task.json 写到意外目录先 cd 到工作目录，或使用绝对路径
npm install -g ...@latest 卡住或被终止使用固定版本：npm install -g bazhuayu-cli@0.1.24
doctor 某项失败根据 ok: false 的检查项修复 Chrome、引擎文件或浏览器依赖

​
下一步

获取 API Key 并登录

创建 Key，或使用 OAuth / 环境变量完成 CLI 认证。

运行第一个任务

从新 URL 生成任务并运行，或运行已有任务并导出数据。