Skip to main content
通过 npm 安装八爪鱼 CLI，并确认 bazhuayu 命令、浏览器依赖与本地运行环境可用。
八爪鱼 CLI 以 npm 包形式发布。v0.1.32 将命令入口从 octopus 统一为 bazhuayu；既有子命令、Agent 契约、任务管理、云定时和数据检查接口保持兼容。本地运行时包名仍为 @octopus/browser-runtime。

​
环境要求

安装前请确认：
  • Node.js 20 或更高（推荐 22 LTS）
  • npm 8 或更高
  • 可用终端：PowerShell、CMD、macOS 终端或 Linux Shell
  • 默认独立模式由 CLI 管理 Chrome for Testing；用户模式需要系统已安装 Chrome 或 Edge
检查版本：

​
平台支持

​
安装 Node.js

​
Windows

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

​
macOS

可从 Node.js 官网 下载 macOS 安装包，或使用 Homebrew：

​
Linux / 服务器

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

​
安装八爪鱼 CLI

安装或更新到 v0.1.32：
安装完成后，命令名为：
查看版本与帮助：
v0.1.32 应能看到 browser、detect、task-group、template、schedule 和 data preview 等命令：

​
从 octopus 迁移

v0.1.32 已删除 octopus 可执行命令。请将脚本、CI、Agent 配置和日常终端命令中的 octopus 全部替换为 bazhuayu；子命令和参数不变。
环境变量 OCTOPUS_API_KEY、OCTOPUS_ACCESS_TOKEN、OCTOPUS_API_BASE_URL 及配置目录 ~/.octopus 仍保持原名。过渡期间可在 PowerShell 当前会话中使用：

​
运行环境诊断

doctor 会检查 Node.js、本地运行时、Chrome for Testing 和认证/API 环境，并在 Windows / macOS 上报告可选用户浏览器的扩展状态。browser status --json 用于检查 Chrome / Edge、Profile 与扩展是否达到 readyForUserBrowserRun: true。

​
更新与卸载

更新到指定版本：
卸载：

​
常见问题

​
下一步

获取 API Key 并登录

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

运行第一个任务

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

浏览器管理

配置 Chrome / Edge 用户 Profile 和登录状态复用。