通过自定义域名访问桶
当您将文件上传至OBS桶后，OBS会使用桶的默认域名自动生成文件的访问地址，使用浏览器访问该地址时，会强制下载文件。如果您不希望暴露桶的默认域名或希望在浏览器中可以在线预览文件，那么您可以为桶绑定自定义域名，通过自定义域名访问桶中的文件。
使用场景
- 文件预览：如果您不想强制下载文件，可以通过将自定义域名绑定至OBS桶实现在线预览文件。
- 防止域名被拦截：一些应用平台可能会拦截桶默认域名，为桶绑定自定义域名后，确保桶中的文件能够被正常访问。
- 保持访问链接不变：迁移网站文件或文件存储位置发生变化时，想保持网站各页面或各文件访问链接不变，可以将文件上传至OBS桶并为桶绑定自定义域名，实现网站域名和桶默认域名之间的映射，从而继续使用原链接访问文件。
- 提升品牌形象和专业度：使用固定的个性化的域名访问企业网站，可以增强企业形象和专业度，提升企业客户体验及对企业的信任度。
- 方便访问：使用简单便于记忆的自定义域名访问桶及桶中的文件，更轻松友好。
原理介绍
使用自定义域名访问桶中对象和使用桶默认域名访问桶中对象的具体请求流程如下所示。
使用自定义域名访问桶中对象的具体请求流程如图1 使用自定义域名访问桶中对象的请求流程所示：
- 用户在浏览器中输入文件访问地址（带有自定义域名的地址）来发起访问请求。
- DNS将请求解析到桶默认域名。
- DNS通过桶默认域名解析请求到OBS服务器的IP地址。
- OBS返回服务器的IP地址给客户端。
- 客户端向OBS服务器IP地址发起Host为自定义域名的请求。
- OBS识别请求的Host为自定义域名，向客户端返回不带下载响应头的响应（Content-Disposition字段设置为inline）。
使用桶默认域名（bucketName.obs.endpoint.myhuaweicloud.com）访问桶中对象的请求流程如图2所示：
- 用户在浏览器中输入文件访问地址（带有桶默认域名的地址）来发起访问请求。
- DNS通过桶默认域名解析请求到OBS服务器的IP地址。
- OBS返回服务器的IP地址给客户端。
- 客户端向OBS服务器IP地址发起Host为桶默认域名的请求。
- OBS识别请求的Host为桶默认域名，向客户端返回带下载响应头的响应（Content-Disposition字段设置为attachment）。
约束与限制
|
限制类别 |
具体限制 |
|---|---|
|
桶版本限制 |
桶版本号为3.0及以上的桶支持配置自定义域名。桶版本号可以在OBS管理控制台上，进入桶概览页后，在“基本信息”中查看。 |
|
域名数量限制 |
每个桶默认最多配置20个自定义域名，部分区域支持最多配置100个自定义域名，各区域支持配置的最大值请以控制台自定义域名配置页面的实际规格为准。 |
|
功能限制 |
说明：
如果使用了加速域名，为防止访问OBS桶中对象变成强制下载，配置自定义域名和加速域名后还需要参考CDN加速场景下访问OBS桶内对象变成强制下载进行处理。 |
前提条件
配置自定义域名
OBS支持通过控制台、API、SDK方式配置自定义域名，不支持通过OBS Browser+、obsutil方式配置自定义域名。
使用OBS控制台
使用OBS控制台配置自定义域名分为两步：
步骤一：配置自定义域名
- 在OBS管理控制台左侧导航栏选择“桶列表”。
- 在OBS管理控制台桶列表中，单击待操作的桶，进入“对象”页面。
- 在左侧导航栏选择“域名管理”，进入“域名管理”界面。
图3 域名管理界面
- 单击页面上方的“配置自定义域名”，也可以在下方的配置自定义域名卡片中单击“配置自定义域名”，在用户域名中输入需要配置的自定义域名，然后单击“确定”。
如果您在填写用户域名时，需要OBS控制台为您呈现已有华为云域名，便于您在下拉列表中直接点选，则您需要拥有域名注册服务（Domains）的Domains:domains:getDetails权限，请联系管理员使用统一身份认证服务（IAM）为您授权。授权操作请参见给IAM用户授权。
域名后缀目前支持的范围为2~6个英文大小写字母。如：.com、.cn。
图4 配置自定义域名
步骤二：解析CNAME
配置解析CNAME，将自定义域名映射为被绑定桶的默认域名。
- 如果填写的用户域名为华为云域名，请单击“一键解析”。云解析DNS会根据填写的域名自动添加一条CNAME记录。
如果填写的用户域名非华为云域名，那么忽略本步骤而执行2手动配置解析规则。
- 手动配置解析CNAME。
不同DNS服务商的CNAME配置方式不同，此处以华为云云解析服务为例。其他DNS服务商的CNAME配置方法可参考配置CNAME域名解析。
如果您使用的是DNS服务商为华为云，您可通过如下步骤配置CNAME记录。- 登录华为云控制台，在控制台首页选择“网络 > 云解析服务 DNS”，进入云解析服务页面。
- 在左侧菜单栏中，选择“公网域名”，进入域名列表页面。
- 在待添加记录集的域名（为桶绑定的自定义域名）所在行，单击“域名”列的域名名称。
- 进入“解析记录”页面，单击“添加记录集”，进入“添加记录集”页面。
- 根据界面提示填写参数配置，参数信息如下所示。下表中未提到的参数可保持默认值。更多参数配置请参见添加CNAME类型记录集。
表2 参数说明 参数
参数说明
取值样例
主机记录
解析域名的前缀。
例如创建的域名为“example.com”，其“主机记录”设置包括：
置空
类型
记录集的类型，此处为CNAME类型。
添加记录集时，如果提示解析记录集已经存在，说明待添加的记录集与已有的记录集存在限制关系或者冲突。
详细内容请参见为什么会提示解析记录集已经存在？。
CNAME-将域名指向另外一个域名
别名
用于是否将此记录集关联至云服务资源实例。
该类型记录集仅支持设置为“否”。
否
线路类型
解析的线路类型用于DNS服务器在解析域名时，根据访问者的来源，返回对应的服务器IP地址。
默认值为“全网默认”。
仅支持为公网域名的记录集配置此参数。
全网默认
TTL(秒)
解析记录在本地DNS服务器的缓存时间，以秒为单位。
默认值为“300秒”。取值范围为：1~2147483647
如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。
更多TTL相关内容请参见什么是TTL值？。
默认为“5分钟”，即300s。
值
填写您要指向的别名，只能填写一个域名。
说明：- 如果没有使用CDN加速，该值为桶访问域名；
- 如果使用CDN加速后，该值为CDN分配的CNAME域名。
webserver01.example.com
- 单击“确定”，完成添加。
- 验证CNAME配置是否生效。
nslookup -qt=cname 桶配置的自定义域名
- 没有使用CDN加速：如果回显OBS桶域名，则表示CNAME配置已经生效。
- 使用CDN加速：如果回显CDN分配的CNAME域名，则表示CNAME配置已经生效，如下图所示。
图5 使用CDN加速
