绑定域名

为存储桶绑定自定义域名，通过该域名直接访问桶内文件，并可配合媒体处理参数实时处理图片、视频等。

入口

在桶详情页进入 存储桶设置 → 绑定域名 Tab。

绑定类型

根据存储桶所在区域的配置，域名绑定支持两种类型：

普通绑定

直接将域名解析到系统资源访问地址，适用于无需 CDN 加速的场景。

1. 点击「添加域名」，选择「普通绑定」类型。
2. 输入要绑定的域名。
3. 在 DNS 服务商处配置 CNAME 解析，指向区域配置的资源访问地址。
4. 保存后，通过该域名访问的请求会自动路由到当前存储桶。

CDN 加速

通过 CDN 通道加速域名访问（商业版功能），适用于需要全球加速、边缘缓存的场景。

1. 点击「添加域名」，选择「CDN 加速」类型。
2. 输入要绑定的域名。
3. 系统会自动向 CDN 通道提交域名创建请求，并返回验证信息。

验证流程：

1. 域名验证 TXT 记录：在 DNS 服务商处添加 TXT 记录验证域名归属权。

   • 主机记录：如 _esa_custom_hostname.www
   • 记录值：系统生成的验证码

2. CNAME 记录：将域名解析到 CDN 提供的 CNAME 目标地址。

3. 点击「验证」按钮触发 CDN 验证，验证通过后域名状态变为「已激活」。

证书配置：

• 免费证书：系统自动申请和续签 SSL 证书。申请时需添加证书验证 TXT 记录，申请成功后该记录可删除。
• 自定义证书：上传自有证书（公钥 + 私钥），系统会校验证书有效性和过期时间。

DNS 检测

点击域名卡片上的「DNS」按钮，可一键检测 TXT 和 CNAME 记录是否已正确配置，无需在外部网站验证。

域名配置

每个绑定域名支持以下配置项：

配置	说明
HTTPS	是否强制 HTTPS 访问
自定义 IP 头	指定从哪个请求头获取客户端真实 IP（如 X-Real-IP、CF-Connecting-IP），用于日志记录和访问控制
默认首页	访问根路径时返回的默认文件（如 index.html）

域名状态

状态	说明
待验证	等待完成域名验证（CDN 绑定）
已激活	域名已正常工作
已下线	域名因配置问题或违规被下线
已挂起	域名被暂停使用
已删除	域名已在 CDN 侧删除

证书状态（CDN 绑定）

状态	说明
未配置	未启用 SSL 证书
申请中	免费证书正在申请
已激活	证书已生效
申请失败	证书申请失败，请检查 TXT 记录配置
已过期	证书已过期，需重新申请或上传

数量限制

每个存储桶可绑定的域名数量受系统配置限制，可在 系统管理 → 系统配置 → 存储桶设置 中查看或修改上限。

使用场景

• 将 img.example.com 绑定到图片桶，通过 https://img.example.com/photo.jpg 直接访问图片
• 配合 媒体处理 参数，如 https://img.example.com/photo.jpg?x-oss-process=image/resize,w_200 实时缩放
• 使用 CDN 加速，为全球用户提供低延迟的文件访问体验

相关：回源、访问控制、CORS。