概述
静态网站托管为 Web 应用及静态资源提供托管服务，集成 CDN 加速与 HTTPS，支持多种部署方式和自定义域名。
控制台结构
顶部导航包含以下功能页：
网站部署 — 应用部署与管理
基础配置 — 域名、路由、缓存等配置
文件管理 — 托管文件的浏览与管理
一、网站部署
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. 浏览器缓存与节点缓存为独立配置，需分别设置
