06 静态托管

静态托管：前后端一体化部署

本章为静态托管专题的支柱页，讲解前端页面如何与云端能力组合成完整应用。

章节摘要：静态托管让云开发 CloudBase 能直接发布前端页面与静态资源，并与云函数、云数据库、云存储组成前后端一体化的应用。它消除了「前端放一处、后端放另一处」的割裂，使一次发布即可上线完整服务。本章讲解静态托管概念、前端 SDK 初始化、本地调试与自定义域名，帮你把前面各章的能力真正交付给用户。

学习目标

• 理解静态托管与 Serverless 后端的配合方式
• 掌握前端 SDK 初始化与云端资源调用
• 了解前后端一体化开发与本地调试思路
• 知道自定义域名与 HTTPS 的基础概念

本章小节关系：第 6.1 节建立托管概念与发布流程；第 6.2 节讲前端如何初始化并调用云端能力；第 6.3 节落到本地调试的一体化体验；第 6.4 节延伸到自定义域名与 HTTPS。四节从「发布什么」到「前端怎么连」再到「怎么对外提供」。

6.1 静态托管概念与发布流程

静态托管面向的是「不需要服务端渲染」的前端产物，是云开发把能力交付给用户的关键一环。

什么是静态托管

静态托管负责承载 HTML、CSS、JavaScript、图片、字体等前端构建产物。把这些产物上传到云开发 CloudBase 的托管空间后，平台会为其提供访问地址，用户通过浏览器即可打开应用。

构建与上传

典型流程是：在本地用前端框架构建出静态产物，经命令行工具或控制台上传到托管空间。平台负责把这些文件以可访问的方式组织起来，你无需自己搭建 Web 服务器。

访问地址

上传完成后，平台分配一个可访问地址。在绑定自定义域名之前，应用即可通过该地址对外提供服务，方便快速验证与分享。

与后端的关系

托管负责「门面」，云函数、数据库、存储负责「后台」。前端页面在浏览器加载后，通过 SDK 直接调用云端资源，整条链路都在同一环境内完成，无需额外搭建网关或独立服务器。

6.2 前端 SDK 初始化与调用云端资源

前端要调用云端能力，需要先完成 SDK 初始化。

初始化

在页面中引入前端 SDK，并指向所在环境。初始化之后，页面便具备读取数据库、上传文件、调用云函数、获取当前登录用户等能力。明确环境是第一步，也是所有后续调用的前提。

能力一览

同一份初始化配置，可同时支撑数据库读写、存储上传、函数调用与身份获取，无需为每个能力单独对接。这种「一次初始化、处处可用」的体验，是云开发降低接入成本的核心。

与身份联动

初始化后结合身份认证，前端调用会自动带上登录态，权限规则据此生效。例如前端读取「仅创建者可读写」的集合时，只能看到当前用户自己的数据，无需手动传用户标识。

调用思路

一个常见的前端面调用链路是：页面加载后先确认登录态，再根据登录用户拉取其数据、渲染列表；用户产生操作时，调用云函数完成写后端的复杂逻辑。前端专注于交互与渲染，重活交给云端。

6.3 前后端一体化开发与本地调试

云开发 CloudBase 的强项之一是「一体化」：前端页面、云函数、数据库、存储同处一个环境。

一体化体验

传统开发中，前端与后端往往分属不同仓库、不同运行环境，联调成本高。云开发把二者放进同一环境，调用关系是「同环境的内部调用」，配置与网络都更简单。

本地模拟云端

一体化调试的常见做法是：在本地启动前端开发服务，同时让云函数运行在模拟的云端环境里，前端请求被路由到本地函数与本地数据库，从而完整复现线上行为。

联调链路

通过本地联调，你可以在上线前捕获权限、数据结构、调用参数等问题。例如前端某次写入被权限规则拒绝，能在本地立即看到原因并修正，而不必等到发布后才排查。这种「写一行、验一行」的闭环，显著降低回归成本。

6.4 自定义域名与 HTTPS

当应用需要以自有品牌对外提供服务时，可以绑定自定义域名。

绑定域名

为托管空间绑定自定义域名后，用户访问的就是你自己的域名，而背后仍是云开发 CloudBase 统一托管的资源。域名解析需指向平台提供的地址，等待生效后即可切换流量。

HTTPS 与证书

平台通常内置证书管理能力，使域名默认以 HTTPS 提供安全访问，避免明文传输带来的安全风险。证书的申请与续期由平台协助处理，你无需手动维护。

对外提供

完成后，静态页面经自定义域名对外、前端 SDK 调用同环境函数与数据库、私有文件走临时授权——一个完整的应用就此成型。HTTPS 不仅关乎安全，也影响搜索引擎权重与浏览器对部分能力的支持，是上线的必选项。

下一章我们将进入实时数据推送，看看静态前端如何进一步获得「数据自动更新」的动态能力。

本章关键词：静态托管、CloudBase 静态网站、前后端一体化、前端部署、自定义域名。下一篇：第 7 章 · 实时数据推送。