@crawlee-cloud/cli

中文文档
1.7.0发布于 2026/11/09MITTypeScriptES Module构建来源已验证近 30 天下载 2661

Crawlee Cloud - 运行和部署演员

中文使用文档
文档目录9 节
  1. 安装
  2. 使用量
  3. 图标
  4. 示例
  5. 配置
  6. 简介(多环境)
  7. 环境变量
  8. 文档
  9. 出版(维护者)

克劳利云CLI

官方 CLI 工具用于 克劳利云。 。 。 .

管理 Crawlee Cloud 资源, 部署演员, 从终端直接查看日志 .

安装

npm install -g @crawlee-cloud/cli

或直接使用 npx :

npx @crawlee-cloud/cli <command>

使用量

crawlee-cloud <command> [options]
# Alias
crc <command> [options]

图标

  • login - 登录您的 Crawlee 云账户( 支持) --profile (多环境设置)
  • info - 显示活动配置文件、 API URL、 服务器状态和认证用户
  • profile - 管理已保存的登录配置文件( E)list, (中文(简体) ), use, (中文(简体) ), rm(中文(简体) )
  • init - 脚手架从一个认证模板中推出一个新的演员项目
  • push - 向云层部署一个演员
  • run - 在当地运行一个演员
  • call - 在平台上运行一个演员(可选) --wait(中文(简体) )
  • list - 列出演员和运行
  • logs - 流出运行中的演员的日志
  • status - 检查运行状态
  • dev - 在当地运行一个演员,热重装

示例

# Login
crc login

# Push the current directory as an Actor (name comes from .actor/actor.json)
crc push

# Run the Actor
crc call my-actor

配置

连接到您的 Crawlee Cloud 服务器 :

# Login to your server
crc login --url https://your-server.com

你会因为你的API信使而被激怒的 全权证书存于 ~/.crawlee-cloud/config.json。 。 。 .

简介(多环境)

在本地、中转和生产之间切换有命名的剖面图。 每个配置文件都持有自己的API URL + 令牌.

# Save credentials under a named profile
crc login --profile local   --url http://localhost:3000     --token <T>
crc login --profile staging --url https://crc.staging.com   --token <T>
crc login --profile prod    --url https://crc.prod.com      --token <T>

# List all profiles (active marked with *)
crc profile list

# Switch the active profile
crc profile use staging

# Remove a profile
crc profile rm staging

# Check what's currently active and reachable
crc info
crc info --json   # for scripts / CI healthchecks

对于不改变活动配置文件的每次调用操作,请使用 CRAWLEE_CLOUD_PROFILE (原始内容存档于2018-09-21) (英语). env var:

CRAWLEE_CLOUD_PROFILE=prod crc push    # one-off push to prod, no `profile use` needed

crc info 如果服务器无法到达或信使无效, 则退出非零, 使其在之前适合作为 CI 门 crc push数字 :

crc info --json >/dev/null && crc push

环境变量

变量说明
CRAWLEE_CLOUD_API_URL覆盖活动配置文件的 API 基础 URL
CRAWLEE_CLOUD_TOKEN覆盖活动配置文件的 API 令牌
CRAWLEE_CLOUD_PROFILE覆盖此引用的当前配置文件名称
CRAWLEE_CLOUD_REGISTRY_URL嵌入器注册 URL crc push 用于图像推, 可选
GHCR_TOKENGitHub 集装箱登记标志 crc push --ghcr 路径
GHCR_USERGHCR 用户名 crc push --ghcr (默认 : github(中文(简体) )

文档

欲获取完整文件,请访问 Crawlee 云文档。 。 。 .

出版(维护者)

CLI 发布为 npm @crawlee-cloud/cli 自动当 a v* 标记被推入回波,通过 .github/workflows/publish-cli.yml。 。 。 .

发行流量为:

  1. 打开 a chore(release): vX.Y.Z 公关撞出 全部5个 工作空间 package.json 文件(root + api + cli + 仪表板 + 跑取器)和锁口文件.
  2. 合并它.
  3. 标记合并承诺 vX.Y.Z 并按下标签.
  4. 发布工作流程验证标记匹配 packages/cli/package.json,通过 npm 信任的出版建立并用出处出版(否) NPM_TOKEN 需要保密).

手动发布( 逃生舱口—— 只有在工作流程被打破时使用 ) :

cd packages/cli
npm login            # interactive
npm publish --access public   # `prepack` builds dist/ automatically

版本与发布记录

@crawlee-cloud/cli 共发布 27 个版本,首次发布于 2025/12/26;过去 12 个月发布了 27 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.7.0latest2026/11/091 天前
1.6.02026/08/053 个月前
1.5.02026/07/273 个月前
1.0.12026/07/064 个月前
1.0.02026/06/075 个月前
0.9.92026/06/065 个月前

关于 @crawlee-cloud/cli 的常见问题

@crawlee-cloud/cli 是什么?

Crawlee Cloud - 运行和部署演员

如何安装 @crawlee-cloud/cli?

在项目目录运行 npm install @crawlee-cloud/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 crc、crawlee-cloud,可以用 npx crc 直接运行。

@crawlee-cloud/cli 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@crawlee-cloud/cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@crawlee-cloud/cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@crawlee-cloud/cli 可以商用吗?

@crawlee-cloud/cli 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@crawlee-cloud/cli 的下载量有多少?

根据 npm 官方下载统计,@crawlee-cloud/cli 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,661 次,日均约 89 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@crawlee-cloud/cli 还在维护吗?

最新版本 1.7.0 发布于 2026/11/09(1 天前);至今共发布 27 个版本,其中过去 12 个月发布了 27 个;首次发布于 2025/12/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。