跳到主要内容

安装

npm (tag)

@cloudbase/cli 是云开发官方提供的命令行工具，安装后提供 tcb 命令，用于部署和管理云开发资源。

前置条件​

  • Node.js 18 及以上。
  • 腾讯云账号。子账号需要主账号先授权，见子账号授权。

安装 CLI​

用任意一种包管理器全局安装：

npm i -g @cloudbase/cli

安装过程中出现 ETIMEOUT、network request failed 等网络超时错误时，临时指定腾讯云 npm 镜像源：

npm i -g @cloudbase/cli --registry=http://mirrors.cloud.tencent.com/npm/

验证安装​

tcb -v

输出 CLI 版本号即表示安装成功。如果提示 Node.js 版本过低，升级 Node.js 后重新安装。

登录​

tcb login

tcb login 默认使用设备码授权：终端输出授权链接和用户码，同时尝试打开浏览器，点击同意授权即可完成登录。

  • 国际站账号：tcb login --intl true。
  • 本机浏览器回调：tcb login --flow web。
  • CI/CD、环境级 API Key、自定义 Endpoint：见登录认证。

登录后用 tcb env list 确认能列出环境。

查看命令​

tcb -h

查看单个命令的参数用 tcb <命令> -h，例如 tcb pull -h。

子账号授权​

子账号访问云开发资源前，需要主账号授予对应策略。

授权步骤​

  1. 登录腾讯云访问管理控制台。
  2. 在左侧菜单选择用户 > 用户列表。
  3. 点击新建用户，填写用户信息并完成创建。
  4. 在策略列表中选择下方的 CloudBase 预设策略。
  5. 点击完成。

已有子账号可直接关联策略，操作见授权管理。

预设策略​

策略说明
QcloudAccessForTCBRole云开发对云资源的访问权限
QcloudAccessForTCBRoleInAccessCloudBaseRun云开发访问 VPC、CVM 等云服务资源的权限，用于云托管

⚠️ 这两个策略包含对象存储、云函数、日志、监控、VPC 等资源的全读写权限，并自动覆盖后续新增的资源。只授予确实需要的子账号。

CLI 网页授权​

子账号使用网页授权登录 CLI 时，还需要 CAM 只读权限：

策略说明
QcloudCamReadOnlyAccess访问管理（CAM）只读访问权限

未授予该策略时，子账号只能用 API 密钥方式登录 CLI。

网络代理​

终端无法直连公网时，通过 HTTP 代理让 CLI 正常工作。CLI 读取 http_proxy 或 HTTP_PROXY 环境变量。

# 当前终端会话有效
export HTTP_PROXY=http://127.0.0.1:8000

把上面的命令写入 ~/.bashrc 或 ~/.zshrc，代理在每次打开终端时生效。代理地址和端口按实际网络环境填写。

下一步​