跳到主要内容

安装 CLI 工具

CloudBase CLI 是云开发官方提供的命令行工具，让您可以通过命令行快速管理云开发资源、部署应用、管理数据库等。

🌟 CLI 工具的优势​

  • 🚀 快速部署：一键部署云函数、静态网站
  • 📊 资源管理：管理数据库、存储、环境配置
  • 🔄 自动化：支持 CI/CD 集成
  • 💻 跨平台：支持 Windows、macOS、Linux
  • 🛠️ 丰富功能：涵盖云开发所有核心功能

📋 系统要求​

  • Node.js：版本 ≥ 12.0.0（推荐 LTS 版本）
  • npm：版本 ≥ 6.0.0
  • 操作系统：Windows、macOS、Linux

🚀 第 1 步：安装 Node.js​

如果您还没有安装 Node.js，请先安装：

方式一：官网下载（推荐）​

  1. 访问 Node.js 官网
  2. 下载 LTS 版本（长期支持版本）
  3. 按照安装向导完成安装

方式二：使用包管理器​

macOS（使用 Homebrew）：

brew install node

Windows（使用 Chocolatey）：

choco install nodejs

Ubuntu/Debian：

sudo apt update
sudo apt install nodejs npm

验证安装​

node --version
npm --version

⚡ 第 2 步：安装 CloudBase CLI​

打开命令行终端，执行以下命令：

npm install -g @cloudbase/cli

安装问题解决​

权限错误（macOS/Linux）：

sudo npm install -g @cloudbase/cli

网络问题：

# 使用淘宝镜像
npm install -g @cloudbase/cli --registry=https://registry.npmmirror.com

Windows 权限问题： 以管理员身份运行命令提示符或 PowerShell

安装建议
  • 推荐使用 LTS 版本的 Node.js
  • 如果安装失败，可能需要修改 npm 权限
  • 企业网络环境可能需要配置代理

✅ 第 3 步：验证安装​

安装完成后，验证 CLI 是否正常工作：

# 查看版本号
cloudbase --version

# 或使用简写命令
tcb --version

如果看到版本号输出，说明安装成功！

🎯 第 4 步：了解基本命令​

CloudBase CLI 提供了丰富的命令，以下是一些常用命令：

查看帮助​

# 查看所有命令
cloudbase --help

# 查看特定命令的帮助
cloudbase login --help

登录和环境管理​

# 登录到云开发
cloudbase login

# 查看环境列表
cloudbase env:list

# 切换环境
cloudbase env:switch

部署相关​

# 部署云函数
cloudbase functions:deploy

# 部署静态网站
cloudbase hosting:deploy

# 一键部署（根据配置文件）
cloudbase deploy
命令简写

为了简化输入，cloudbase 命令可以简写成 tcb：

  • cloudbase login = tcb login
  • cloudbase deploy = tcb deploy

tcb 是云开发产品英文的简称：Tencent CloudBase

🔧 第 5 步：配置代理（可选）​

如果您的网络环境需要代理才能访问外网，可以配置 HTTP 代理：

临时设置​

# macOS/Linux
export HTTP_PROXY=http://127.0.0.1:8000
export HTTPS_PROXY=http://127.0.0.1:8000

# Windows
set HTTP_PROXY=http://127.0.0.1:8000
set HTTPS_PROXY=http://127.0.0.1:8000

永久设置​

将代理配置添加到系统环境变量或终端配置文件中（如 .bashrc、.zshrc）。

🚀 第 6 步：开始使用​

现在您可以开始使用 CLI 工具了！

首次使用流程​

  1. 登录：cloudbase login
  2. 选择环境：cloudbase env:list 查看环境，cloudbase env:switch 切换
  3. 初始化项目：cloudbase init 创建项目模板
  4. 部署应用：cloudbase deploy 一键部署

常用场景​

📚 深入学习​

CLI 完整文档​

实践教程​

🆘 获取帮助​

如果在使用过程中遇到问题：

  1. 查看帮助：cloudbase --help 或 cloudbase <command> --help
  2. 查看文档：CLI 文档
  3. 提交 Issue：GitHub Issues
  4. 社区讨论：开发者社区

🎉 恭喜！ 您已经成功安装了 CloudBase CLI 工具。现在可以开始高效的云开发之旅了！