跳到主要内容

静态网站托管

云开发为开发者提供静态网页托管能力，支持 HTML、CSS、JavaScript、字体等静态资源的分发。底层基于腾讯云对象存储 COS 和全球 CDN 网络，为您的网站提供高性能、高可用的访问体验。

适用场景：文件级操作

tcb hosting 是文件维度的操作工具，适合以下场景：

  • 手动上传 / 同步静态文件（HTML、CSS、JS、图片、字体等）
  • 纯静态内容，无构建流程（如文档站产物、设计稿导出页面）
  • 需要精细控制云端文件路径

如果你的项目有构建步骤（React / Vue / Next.js / Vite / Angular / Nuxt 等前端框架），推荐使用 应用部署（tcb app deploy），它会自动完成安装依赖 → 构建 → 上传产物 → 绑定路由的完整流程。

前置条件​

在使用 CLI 操作静态网站服务前，请确保：

  1. 拥有腾讯云账号并完成实名认证
  2. 前往云开发平台，创建云开发环境

部署网站​

全量部署​

使用 tcb hosting deploy 命令可以将当前目录下的所有文件部署到静态网站。

# 进入构建目录
cd docs

# 部署当前目录下的所有文件
tcb hosting deploy -e envId

指定文件部署​

您可以指定特定的文件或文件夹进行部署：

# 基本语法
tcb hosting deploy <localPath> [cloudPath] -e envId

参数说明：

  • localPath：本地文件或文件夹路径
  • cloudPath：云端目标路径（可选，默认为根目录）
  • envId：环境 ID

示例：

# 将 hosting 目录下的所有文件部署到根目录
tcb hosting deploy hosting -e envId

# 将本地 index.html 部署到云端根目录
tcb hosting deploy ./index.html -e envId

# 将 static 目录下的 index.js 部署到云端 static/index.js
tcb hosting deploy ./static/index.js static/index.js -e envId

部署限制​

  • 文件大小：单个文件最大支持 50TB
  • 文件数量：无限制
  • 网络优化：如遇到大量文件上传报错 { message: 'socket hang up', code: 'ECONNRESET' }，请先执行：
    export COS_SDK_KEEPALIVE=false

SPA 应用配置​

Vue History 模式

使用 Vue Router 的 history 模式时，需要在 静态网站控制台 的设置页面配置错误页面为应用的入口页面（通常是 index.html）。

管理网站​

查看服务信息​

查看静态网站的状态、访问域名等详细信息：

tcb hosting detail -e envId

查看文件列表​

列出静态网站存储空间中的所有文件：

tcb hosting list -e envId

删除文件​

删除静态网站中的指定文件或文件夹：

# 删除指定文件或文件夹
tcb hosting delete <cloudPath> -e envId

# 删除所有文件（cloudPath 为空）
tcb hosting delete -e envId

命令参数:

参数说明必填
cloudPath云端文件或文件夹路径否（不指定则删除所有文件）
-e, --env-id <envId>环境 ID是
--dir删除目标是文件夹（递归删除）否
--force强制删除，跳过确认提示否
--dry-run模拟运行，仅预览将要删除的文件，不实际执行否

示例：

# 删除根目录下的 index.html
tcb hosting delete index.html -e envId

# 删除 static 文件夹及其所有内容
tcb hosting delete static --dir -e envId

# 预览将要删除的文件（不实际执行）
tcb hosting delete static --dir --dry-run -e envId

# 清空整个静态网站
tcb hosting delete -e envId

# 强制删除，跳过确认
tcb hosting delete static --dir --force -e envId

路径说明​

路径格式​

  • localPath：本地文件或文件夹路径

    • 格式：目录/文件名
    • 示例：./index.js、static/css/index.css

  • cloudPath：云端文件或文件夹的相对路径

    • 格式：目录/文件名（相对于根目录）
    • 示例：index.js、static/css/index.js

跨平台注意事项​

Windows 系统
  • localPath：使用系统路径格式，通常使用 \ 分隔符
  • cloudPath：统一使用 / 分隔符，与操作系统无关

常见问题​

上传失败处理​

如果遇到网络连接问题导致上传失败，可以尝试：

# 关闭 SDK 长连接
export COS_SDK_KEEPALIVE=false

# 然后重新执行部署命令
tcb hosting deploy -e envId

域名访问​

部署完成后，您可以通过以下方式访问网站：

  • 在控制台查看分配的默认域名
  • 配置自定义域名（需要 ICP 备案）