一、控制台结构
顶部导航包含以下功能页：
·网站部署 — 应用部署与管理
·基础配置 — 域名、路由、缓存等配置
·文件管理 — 托管文件的浏览与管理
二、1.1 部署方式
控制台提供三种部署方式：
| 方式 | 说明 |
| 本地项目部署 | 从本地上传站点静态资源，包括 HTML、CSS 和 JS 文件等 |
| 模板部署 | 选择预置模板快速创建项目，当前提供 React Web 应用模板（基于 React + Vite + CloudBase）和 Vue Web 应用模板（基于 Vue 3 + Vite + CloudBase） |
| Git 仓库部署 | 支持 Git 个人仓库部署及公开仓库部署 |
三、1.2 构建配置
通过模板或 Git 仓库部署时，可配置以下构建参数：
| 配置项 | 说明 |
| 安装命令 | npm / yarn / pnpm 安装依赖 |
| 构建命令 | 如 npm run build、vite build |
| Node.js 版本 | 16.x / 18.x / 20.x / 22.x / 24.x |
| 环境变量 | key-value 形式 |
| 输出目录 | 如 dist、build |
| 构建缓存 | 开启后可加快构建速度 |
也可通过 CloudBase CLI 命令行工具执行部署操作。
四、1.3 应用部署列表
部署完成后，应用显示在部署列表中，列表字段如下：
| 字段 | 说明 |
| 应用名称 | 部署的应用名称 |
| 应用版本 ID | 应用版本标识路径 |
| 应用框架 | 所使用的前端框架（如 React） |
| 应用状态 | 当前状态：成功 / 失败 |
| 更新时间 | 最近一次部署时间 |
| 创建时间 | 应用首次部署时间 |
| 操作 | 访问应用 / 删除 |
列表顶部提供「安全管理」入口和按服务名称搜索功能。
五、1.4 数值总览
页面右侧显示当前环境的资源使用情况：
·静态托管容量 — 已使用的存储空间
·静态托管流量 — 已消耗的 CDN 流量
六、1.5 高级配置
页面右侧同时提供以下快捷入口：
·应用部署指南 — 静态网站托管支持三种在线应用部署方式：上传代码包/文件夹、从模板创建、Git 仓库部署
·CLI 管理静态资源 — 通过 CLI 命令行工具管理静态网站托管资源，包括文件的上传、查看、删除等
·静态托管安全配置 — 静态托管安全配置为云开发静态托管服务提供安全防护机制，防止恶意访问和资源盗用
七、2.1 配置信息
| 字段 | 说明 |
| 默认域名 | 系统分配的访问域名（*.tcloudbaseapp.com），基于安全性需要，默认域名仅用于开发与测试场景 |
| 自定义域名 | 点击「绑定自定义域名」添加自有域名，建议在生产环境使用自定义域名 |
| 默认首页文档 | 默认为 index.html |
默认域名存在访问频率限制和安全性风险，建议面向正式用户时使用自定义域名。
八、2.2 路由配置
| 配置项 | 说明 |
| 首页文档 | 网站首页文件，默认 index.html |
| 省略 HTML 扩展名 | 开启后访问路径可省略 .html 后缀，默认关闭 |
| 重定向规则 | 可添加自定义重定向规则，包含类型、描述、模板、路径等字段 |
九、2.3 节点缓存配置
缓存规则变更后约 1-3 分钟生效。在此期间，若因刷新页面看到配置未更新属于正常现象，避免重复保存操作。
操作入口：刷新缓存 / 新增。
缓存规则表包含以下字段：
| 字段 | 说明 |
| 类型 | 文件类型 / 文件夹 / 全部 |
| 内容 | 匹配规则，如 .js;.css;.less;.png;.jpg;.jpeg;.webp 或 /resources 或 所有文件 |
| 缓存时间 | 如 2 天、2 分钟 |
| 操作 | 修改缓存时间 / 删除 |
示例配置：
| 类型 | 内容 | 缓存时间 |
| 文件类型 | .js;.css;.less;.png;.jpg;.jpeg;.webp | 2 天 |
| 文件夹 | /resources | 2 天 |
| 全部 | 所有文件 | 2 分钟 |
优先级说明： 列表中靠下的规则优先级高于靠上的规则，多条策略按从上至下匹配，以最后一次匹配结果为准。
十、2.4 浏览器缓存配置
浏览器缓存与节点缓存独立配置，字段结构相同（类型 / 内容 / 缓存时间 / 操作）。可通过「复制缓存规则」将节点缓存配置同步至浏览器缓存。
十一、三、文件管理
进入「文件管理」页面可浏览和管理已部署的静态资源文件。
十二、四、适用场景
| 场景 | 示例 |
| 单页应用 | React、Vue、Angular 等框架构建的应用 |
| 静态网站 | 博客、企业页面、产品展示页 |
| 文档站点 | VitePress、Docusaurus、Hexo 生成的站点 |
| 静态资源 | 图片、视频、字体等文件托管 |
十三、五、注意事项
1. 默认域名仅用于开发测试，生产环境应绑定自定义域名
2. 节点缓存规则变更后约 1-3 分钟生效，期间避免重复操作
3. 缓存时间设为 0 表示不缓存，所有请求直接回源
4. 缓存时间上限为 365 天
5. 通过控制台上传文件会自动刷新 CDN 节点缓存
6. 浏览器缓存与节点缓存为独立配置，需分别设置
参考链接：静态托管