用途:提供腾讯 CloudBase 平台的基础知识与最佳实践,适用于 Web、小程序或后端服务等各类 CloudBase 项目,帮助理解存储、托管、认证、云函数、数据库权限与数据模型。
主要能力:区分静态托管与云存储(静态托管提供公开访问地址并支持自定义域名,云存储适合隐私文件并通过临时 URL 访问);说明环境与认证差异(Web 使用 SDK 内置认证,如短信登录 auth.getVerification(),登录后用 auth.getCurrentUser() 获取用户;小程序天然免登录,云函数中通过 wx-server-sdk 获取 wxContext.OPENID);云函数使用(Node.js 函数需含 package.json,可用 createFunction 创建、updateFunctionCode 部署,优先云端安装依赖,不上传 node_modules);数据库权限模型(READONLY、PRIVATE、ADMINWRITE、ADMINONLY、CUSTOM,Web SDK 写入不能用 ADMINWRITE/ADMINONLY,用户生成内容用 CUSTOM,管理员数据用 READONLY,云函数拥有完整访问权限);数据模型调用(MySQL 模型必须用 models SDK,如 app.models.model_name.list({ filter: { where: {} } }),不能用 collection API)。
使用方式:SDK 初始化需环境 ID,可通过 envQuery 工具查询;Web 同步初始化 import cloudbase from "@cloudbase/js-sdk"; const app = cloudbase.init({ env: "xxxx-yyy" }); 权限配置流程为创建集合、配置安全规则、编写代码、测试,用 writeSecurityRule 配置后等待 2-5 分钟缓存清除。控制台地址遵循 https://tcb.cloud.tencent.com/dev?envId=${envId}#/{path} 模式。
适用场景:需要跨平台认证配置、云函数部署、数据库权限与数据模型管理的 CloudBase 项目。
限制:不同平台认证方式必须严格区分,不得混用;Web 禁止用云函数实现登录逻辑,小程序禁止生成登录页面;MySQL 数据库需先在控制台启用;跨集合操作建议通过云函数实现。具体收费、价格与效果暂未提供。