跳到主要内容

通过 HTTP 访问静态托管

本文档介绍如何通过 HTTP 网关配置域名关联，实现对静态网站托管资源的访问。

自定义域名

如果您需要为静态托管实例绑定自定义域名（生产环境推荐），除了下方「方式一：详情页就地绑定」外，完整的自定义域名流程（添加域名、配置 SSL 证书、CDN 选择、域名所有权校验、DNS 解析等）请参考 自定义域名配置。所有通过任意入口添加的域名，都可以在 HTTP 网关 中统一查看和管理。

基础配置​

您可以在静态托管详情页直接绑定域名（推荐），也可以在 HTTP 网关统一配置。

方式一：详情页就地绑定（推荐）​

  1. 前往 静态网站托管，进入目标静态托管实例的详情页

  2. 在「自定义域名」模块点击「添加域名」按钮，弹出绑定窗口

  3. 选择绑定模式：

    • 应用模式：将整个静态托管服务映射到该域名，访问域名根路径即可进入静态托管，无需配置触发路径。适合「一个域名/路径只服务一个静态站点」的场景
    • 路径模式：将静态托管服务挂在某个路径前缀下访问，需在「触发路径」中填写具体路径（如 /test）。适合「同一域名下挂多个资源」的场景

  4. 选择自定义域名后确认，已绑定的所有域名会展示在详情页的「域名管理」列表中

方式二：在 HTTP 网关绑定​

如果您更习惯从全局视角管理域名与资源的关系，也可以在 HTTP 网关统一配置：

  1. 前往 HTTP 网关
  2. 在「域名关联资源」模块点击「新建」按钮
  3. 配置以下信息：
配置项说明示例
关联资源类型选择「静态网站托管」，然后选择静态托管实例-
域名选择默认域名、自定义域名或 *（匹配所有域名）默认域名
触发路径设置 HTTP 访问路径，支持 / 或自定义路径/test

💡 提示：生产环境建议绑定已备案的自定义域名，以获得完整的服务能力。配置方法请参考 自定义域名配置。

自定义根路径访问​

配置说明​

如果需要通过自定义路径访问静态托管资源，可以在「触发路径」中设置自定义根路径。

配置示例：

  • 触发路径设置为 /test
  • 访问 https://your-domain/test 时，将映射到静态网站托管的 / 目录

代码调整​

使用自定义根路径时，需要调整静态资源中的相对路径引用，在所有资源路径前添加自定义根路径前缀。

调整示例：

<!-- 原路径 -->
<script src="/js/index.js"></script>
<link rel="stylesheet" href="/css/style.css">
<img src="/images/logo.png" alt="Logo">

<!-- 调整后（触发路径为 /test）-->
<script src="/test/js/index.js"></script>
<link rel="stylesheet" href="/test/css/style.css">
<img src="/test/images/logo.png" alt="Logo">

⚠️ 注意：使用自定义根路径时，需要确保静态资源中的所有绝对路径引用都添加了对应的路径前缀，否则会导致资源加载失败。

相关文档​