绑定自定义域名至Bucket默认域名实现预览文件 - 对象存储 OSS

文件上传到OSS后，OSS会使用Bucket的默认域名生成文件访问地址。当您在浏览器中通过默认域名访问文件时，会触发强制下载行为。如果您希望在浏览器中预览文件，则需要为Bucket绑定自定义域名，并通过自定义域名访问Bucket中的文件。对于绑定自定义域名不会影响您对默认域名的使用，您仍然可以继续使用OSS提供的默认域名。

前提条件

已创建Bucket。具体步骤，请参见创建存储空间。
已注册域名。支持绑定非阿里云注册的域名。如果您还未注册域名，您可以在阿里云域名服务平台注册域名。具体步骤，请参见注册域名。
如果要绑定的Bucket在中国内地，确保域名已备案，且账号已实名认证。如何备案和实名认证，请参见ICP备案流程、阿里云账号实名登记常见问题。

使用场景

文件预览：通过自定义域名访问OSS Bucket，避免OSS强制增加下载响应头，实现在浏览器中预览文件。
访问.apk或者.ipa的文件：出于安全考虑，通过OSS默认公网域名访问2023年08月15日后创建的Bucket中后缀为.apk或者.ipa的文件，服务器返回400错误。使用自有域名访问后缀为.apk或者.ipa的文件时将不会被阻断。
品牌形象和专业性：将自定义域名绑定到OSS Bucket，提供个性化域名，增强品牌形象和专业性，增加用户信任度。
防止域名被拦截：一些应用或平台可能会对Bucket默认域名进行拦截。您可以为Bucket绑定自定义域名，以确保您的OSS Bucket中的资源能够被正常访问。
访问方便性：使用自定义域名访问OSS Bucket，方便易记，相比使用OSS默认域名，更简洁友好，轻松访问和分享资源。
用户体验优化：通过自定义域名，提高访问速度，结合CDN加速技术，实现快速内容分发和下载，减少延迟，提升用户体验。
链接的持久性：绑定自定义域名到OSS Bucket后，即使后续存储位置或服务有变化，用户仍可使用相同域名访问资源，确保链接的持久性，长期可访问和使用存储资源。

背景信息

访问Bucket默认域名或传输加速域名会默认下载文件，而访问自定义域名会默认预览文件的原因如下：

访问Bucket默认域名或传输加速域名

出于数据传输安全考虑，使用OSS提供的Bucket默认域名（<bucketName>.oss-<regionId>.aliyuncs.com）或传输加速域名（<bucketName>.oss-accelerate.aliyuncs.com）访问Bucket的文件（网页、图片）时，OSS会在返回中强制增加下载响应头（x-oss-force-download: true和Content-Disposition: attachment）。浏览器检测到Content-Disposition: attachment时，会触发强制下载行为。使用OSS提供的域名访问文件时，触发下载行为的请求流程如下：

关于使用OSS的默认Bucket域名或传输加速域名访问文件，触发自动下载的生效时间和生效对象，请参见附录：强制下载命中的x-oss-ec规则。

访问自定义域名

您可以在已注册的域名（例如example.com）上自定义一个子域名（例如static.example.com），并将其绑定至Bucket，然后使用自定义域名访问文件。此时，OSS不会在返回中强制增加下载响应头。由于OSS没有设置Content-Disposition字段，浏览器会默认将其设置为inline。浏览器会直接显示文件内容，而不是下载文件。使用自定义域名访问文件，默认预览行为的请求流程如下：

使用限制

不支持绑定中文域名。
每个域名只能绑定至一个Bucket。
每个Bucket最多可以绑定100个域名。
通过OSS管理控制台绑定自定义域名时，不允许绑定泛域名（将域名前缀设置为*，从而将主域名的所有子域名都指向Bucket默认域名）。通过CDN加速OSS时，允许绑定泛域名，但该域名不会在OSS管理控制台显示。

操作步骤

步骤一：绑定自定义域名

根据域名所属服务提供商和所属账号，参考对应的步骤将域名绑定至OSS Bucket。

说明

如果您不确定域名所属服务提供商，您可以在域名信息查询（WHOIS）页面进行查询。
如果您不确定域名是否属于当前阿里云账号，您可以在云解析DNS控制台进行查询。

绑定当前阿里云账号注册的域名

将当前阿里云账号注册的域名，绑定至OSS Bucket的操作步骤如下：

登录OSS管理控制台。
单击Bucket 列表，然后单击目标Bucket名称。
在左侧导航栏，选择Bucket 配置>域名管理。
在域名管理页面，单击绑定域名。
在绑定域名面板，输入要绑定的域名，例如static.example.com，然后单击确认绑定。

添加CNAME记录，将自定义域名static.example.com解析至被绑定的Bucket的默认外网域名。

自动添加

开启自动添加 CNAME 记录。

开启后，OSS会在云解析DNS自动添加一条CNAME记录。示例如下：

手动添加

如果没有开启自动添加 CNAME 记录，您需要在云解析DNS控制台手动添加一条CNAME记录，否则绑定的自定义域名不会生效。

登录云解析DNS控制台。
在公网DNS解析 > 权威域名解析，单击目标域名右侧的解析设置。

单击添加记录，填写域名解析信息。

参数	说明	示例值
记录类型	选择CNAME记录将域名解析指向另一个域名	CNAME
主机记录	填写要绑定的域名的前缀。	static
解析请求来源	解析域名时使用的线路。建议选择默认，系统将自动选择最佳线路。	默认
记录值	填写Bucket的外网访问域名。Bucket域名的结构为<bucketname>.<endpoint>。关于不同地域的外网Endpoint，请参见OSS地域和访问域名。	examplebucket.oss-cn-hangzhou.aliyuncs.com
TTL	域名的更新周期，保留默认值即可。说明生效TTL的时间有一定的延迟，请以实际为准。	10分钟

单击确定。
完成后，云解析DNS会出现一条CNAME记录。示例如下：

绑定其他阿里云账号注册的域名

将阿里云A账号注册的域名，绑定至阿里云B账号的OSS Bucket的操作步骤如下：

使用阿里云B账号，获取TXT记录的主机记录和记录值。
1. 登录OSS管理控制台。
2. 单击Bucket 列表，然后单击目标Bucket名称。
3. 在左侧导航栏，选择Bucket 配置>域名管理。
4. 在域名管理页面，单击绑定域名。
5. 在绑定域名面板，输入要绑定的阿里云A账号的自定义域名，例如static.example.com，然后复制页面显示的主机记录和记录值。

使用阿里云A账号，添加TXT记录。

登录云解析DNS控制台。
在域名解析列表中，单击目标域名右侧的解析设置。

单击添加记录，填写域名解析信息。

参数	说明	示例值
记录类型	选择域名指向的类型为TXT。	TXT
主机记录	阿里云云解析DNS已自动帮你填写了主域名。因此，填写时，不需要手动填写主域名部分。如果绑定的是主域名，填写`_dnsauth`。例如域名为`example.com`，填写`_dnsauth`。如果绑定的是子域名，填写`_dnsauth.<域名前缀>`。例如域名为`static.example.com`，填写`_dnsauth.static`。	_dnsauth.static
解析请求来源	解析域名时使用的线路。建议选择默认，系统将自动选择最佳线路。	默认
记录值	填写使用阿里云B账号获取的TXT记录中的CnameToken。	b0d777f7ccddeae93358d908ed59****
TTL	域名的更新周期，保留默认值即可。说明生效TTL的时间有一定的延迟，请以实际为准。	10分钟

单击确定。

使用阿里云B账号，在OSS控制台的绑定域名面板，单击验证域名所有权并绑定。

使用阿里云A账号，添加CNAME记录。

在域名解析列表中，单击目标域名右侧的解析设置。

单击添加记录，填写域名解析信息。

参数	说明	示例值
记录类型	选择域名指向的类型为CNAME。	CNAME
主机记录	根据域名前缀填写主机记录。如果是主域名，例如`example.com`，输入@。如果是子域名，输入域名的前缀。例如域名为`static.example.com`，输入static。	static
解析请求来源	解析域名时使用的线路。建议选择默认，系统将自动选择最佳线路。	默认
记录值	填写Bucket的外网访问域名。Bucket域名的结构为<bucketname>.<endpoint>。关于不同地域的外网Endpoint，请参见OSS地域和访问域名。	examplebucket.oss-cn-hangzhou.aliyuncs.com
TTL	域名的更新周期，保留默认值即可。说明生效TTL的时间有一定的延迟，请以实际为准。	10分钟

单击确定。

绑定非阿里云账号注册的域名

将在其他域名服务提供商注册的域名，绑定至OSS Bucket的操作步骤如下：

在阿里云OSS，生成TXT记录的主机记录和记录值。
1. 登录OSS管理控制台。
2. 单击Bucket 列表，然后单击目标Bucket名称。
3. 在左侧导航栏，选择Bucket 配置>域名管理。
4. 在域名管理页面，单击绑定域名。
5. 在绑定域名面板，输入在其他域名服务提供商注册的域名，例如static.example.com，然后复制页面显示的主机记录和记录值。

在域名服务提供商的DNS解析平台，参考下表添加TXT记录。

参数	说明	示例值
记录类型	选择域名指向的类型为TXT。	TXT
主机记录	如果其他域名服务提供商的DNS解析平台已自动帮你填写了主域名，填写时，不需要手动填写主域名部分。如果绑定的是主域名，填写`_dnsauth`。例如域名为`example.com`，填写`_dnsauth`。如果绑定的是子域名，填写`_dnsauth.<域名前缀>`。例如域名为`static.example.com`，填写`_dnsauth.static`。	_dnsauth.static
记录值	填写从阿里云OSS获取的TXT记录中的CnameToken。	b0d777f7ccddeae93358d908ed59****

在阿里云OSS控制台的绑定域名面板，单击验证域名所有权并绑定。

在域名服务提供商的DNS解析平台，参考下表添加CNAME记录。

参数	说明	示例值
记录类型	选择域名指向的类型为CNAME。	CNAME
主机记录	根据域名前缀填写主机记录。如果是主域名，例如`example.com`，输入@。如果是子域名，输入域名前缀。例如域名为`static.example.com`，输入static。	static
记录值	填写Bucket的外网访问域名。Bucket域名的结构为<bucketname>.<endpoint>。关于不同地域的外网Endpoint，请参见OSS地域和访问域名。	examplebucket.oss-cn-hangzhou.aliyuncs.com

步骤二：验证自定义域名

绑定自定义域名后，您可以使用nslookup或dig命令来验证自定义域名解析是否生效。如果域名解析结果显示为您绑定的Bucket的外网访问域名，则说明自定义域名的CNAME解析已生效。

nslookup

将static.example.com替换为您要查询的域名，然后执行以下命令。

nslookup -type=CNAME static.example.com

成功返回示例如下。

dig

将static.example.com替换为您要查询的域名，然后执行以下命令。

dig CNAME static.example.com

成功返回示例如下。

步骤三：使用自定义域名

自定义域名生效后，您可以直接通过HTTP协议访问文件。

重要

HTTP协议无法确保数据在传输过程中的安全性，即数据可能存在被第三方截取或篡改的风险。考虑到数据安全的重要性，强烈推荐您采用HTTPS协议进行访问。具体操作，请参见使用HTTPS协议。

上传文件。
具体操作，请参见简单上传。

获取文件URL。

临时文件URL

获取临时有效的文件URL的操作步骤如下：

设置文件读写权限ACL为私有。
具体操作，请参见设置Object ACL。
私有文件URL的格式为http://YourDomain/ObjectName?签名参数。您可以通过以下方法获取文件URL并设置URL的有效时长。

使用OSS控制台

登录OSS管理控制台。
单击Bucket列表，然后单击目标Bucket名称。
在左侧导航栏，选择文件管理 > 文件列表。
在文件列表页面，单击目标文件名称。
在详情面板的自有域名，选择绑定的自定义域名，其他保持默认值，然后单击复制文件URL。

使用图形化管理工具ossbrowser

ossbrowser支持Object级别的操作与控制台支持的操作类似，请按照ossbrowser界面指引完成获取签名URL的操作。

如何下载并使用ossbrowser，请参见图形化管理工具ossbrowser 2.0（预览版）。

使用阿里云SDK

使用自定义域名新建OssClient。

Java

// yourEndpoint填写自定义域名。
String endpoint = "yourEndpoint";

// 从环境变量中获取访问凭证。运行本代码示例之前，请先配置环境变量。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();

// 创建ClientBuilderConfiguration实例，您可以根据实际情况修改默认参数。
ClientBuilderConfiguration conf = new ClientBuilderConfiguration();

// 设置是否支持CNAME。CNAME用于将自定义域名绑定到目标Bucket。
conf.setSupportCname(true);

// 创建OSSClient实例。
OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider, conf);

// 关闭OSSClient。
ossClient.shutdown();

PHP

<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}

use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;
use OSS\CoreOssException;

// 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。 
$provider = new EnvironmentVariableCredentialsProvider();
// 填写自定义域名，例如http://example.com。
$endpoint = "http://example.com";

try {
    $config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
        "cname"	=> true
    );
    $ossClient = new OssClient($config);    
} catch (OssException $e) {
    print $e->getMessage();
}

Node.js

const OSS = require('ali-oss')

const client = new OSS({
  // 使用自定义域名作为Endpoint。
  endpoint: 'http://img.example.com', 
  // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // yourRegion填写Bucket所在地域。以华东1（杭州）为例，Region填写为cn-hangzhou。
  region: 'yourRegion',
  cname: true
});

Python

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 从环境变量中获取访问凭证。运行本代码示例之前，请先配置环境变量。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())

# 填写自定义域名，例如example.com。
cname = 'http://example.com'

# 填写Bucket名称，并设置is_cname=True来开启CNAME。CNAME是指将自定义域名绑定到存储空间。
bucket = oss2.Bucket(auth, cname, 'examplebucket', is_cname=True)

Browser.js

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Document</title>
    <script src="https://gosspublic.alicdn.com/aliyun-oss-sdk-6.18.0.min.js"></script>
  </head>
  <body>
    <script>
      const client = new OSS({
        // 填写自定义域名，例如example.com。
        // yourRegion填写Bucket所在地域。以华东1（杭州）为例，yourRegion填写为oss-cn-hangzhou。
        region: 'yourRegion',
        endpoint: "example.com",
        authorizationV4: true,
        // 从STS服务获取的临时访问密钥（AccessKey ID和AccessKey Secret）。
        accessKeyId: "yourAccessKeyId",
        accessKeySecret: "yourAccessKeySecret",
        // 从STS服务获取的安全令牌（SecurityToken）。
        stsToken: 'yourSecurityToken',
        // 填写Bucket名称，例如examplebucket。
        bucket: "examplebucket",
        cname: true,
      });    
          
    </script>
  </body>
</html>

.NET

using Aliyun.OSS;
using Aliyun.OSS.Common;
// 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// 填写自定义域名。
const string endpoint = "yourDomain";

// 创建ClientConfiguration实例，按照您的需要修改默认参数。
var conf = new ClientConfiguration();

// 打开CNAME开关。CNAME是指将自定义域名绑定到存储空间的过程。
conf.IsCname = true;

// 创建OssClient实例。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);

Android

// yourEndpoint填写自定义域名。
String endpoint = "yourEndpoint";
// 从STS服务获取的临时访问密钥（AccessKey ID和AccessKey Secret）。
String accessKeyId = "yourAccessKeyId";
String accessKeySecret = "yourAccessKeySecret";
// 从STS服务获取的安全令牌（SecurityToken）。
String securityToken = "yourSecurityToken";
// yourEndpoint填写Bucket所在地域。以华东1（杭州）为例，region填写为cn-hangzhou。
String region = "yourRegion";

OSSCredentialProvider credentialProvider = new OSSStsTokenCredentialProvider(accessKeyId, accessKeySecret, securityToken);
ClientConfiguration config = new ClientConfiguration();
config.setSignVersion(SignVersion.V4);
// 创建OSSClient实例。
OSSClient oss = new OSSClient(getApplicationContext(), endpoint, credentialProvider);
oss.setRegion(region);

Go

package main

import (
	"log"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

// handleError 用于处理不可恢复的错误，并记录错误信息后终止程序。
func handleError(err error) {
	log.Fatalf("Error: %v", err)
}

// setupClient 用于设置并创建OSS客户端实例，支持CNAME。
// 参数：
//
//	endpoint - 自定义域名，即绑定到存储空间的自定义域名。
//
// 返回创建的OSS客户端实例。
func setupClient(endpoint string) (*oss.Client, error) {
	// 从环境变量中获取访问凭证。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		return nil, err
	}

	// 创建OSSClient实例，并启用CNAME支持。
	// yourRegion填写Bucket所在地域，以华东1（杭州）为例，填写为cn-hangzhou。其它Region请按实际情况填写。
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	clientOptions = append(clientOptions, oss.UseCname(true))
	// 设置签名版本
	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
	client, err := oss.New(endpoint, "", "", clientOptions...)
	if err != nil {
		return nil, err
	}

	return client, nil
}

func main() {
	// yourEndpoint填写Bucket对应的自定义域名。
	// 示例：填写为 "custom-domain-for-your-bucket.com"。
	endpoint := "yourEndpoint"

	// 检查环境变量是否已经设置。
	if endpoint == "" {
		log.Fatal("Please set yourEndpoint.")
	}

	// 设置并创建OSS客户端实例，支持CNAME。
	client, err := setupClient(endpoint)
	if err != nil {
		handleError(err)
	}

	// 输出客户端信息。
	log.Printf("Client: %#v\n", client)
}

iOS

// yourEndpoint填写自定义域名。
NSString *endpoint = @"yourEndpoint";
// 从STS服务获取的临时访问密钥（AccessKey ID和AccessKey Secret）。
NSString *accessKeyId = @"yourAccessKeyId";
NSString *accessKeySecret = @"yourAccessKeySecret";
// 从STS服务获取的安全令牌（SecurityToken）。
NSString *securityToken = @"yourSecurityToken";

id<OSSCredentialProvider> credentialProvider = [[OSSStsTokenCredentialProvider alloc] initWithAccessKeyId:accessKeyId secretKeyId:accessKeySecret securityToken:securityToken];
OSSClient *client = [[OSSClient alloc] initWithEndpoint:endpoint credentialProvider:credentialProvider];

C++

#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;

int main(void)
{
    /* 初始化OSS账号信息。*/
            
    /* yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。*/
    std::string Endpoint = "yourEndpoint";
    
    /* 初始化网络等资源。*/
    InitializeSdk();

    ClientConfiguration conf;
    /* 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。*/
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClient client(Endpoint, credentialsProvider, conf);   

    /* 释放网络等资源。*/
    ShutdownSdk();
    return 0;
}

C

#include "oss_api.h"
#include "aos_http_io.h"
/* 填写自定义域名。*/
const char *endpoint = "yourCustomEndpoint";

void init_options(oss_request_options_t *options) {
    options->config = oss_config_create(options->pool);
    /* 用char*类型的字符串初始化aos_string_t类型。*/
    aos_str_set(&options->config->endpoint, endpoint);
    /* 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。*/  
    aos_str_set(&options->config->access_key_id, getenv("OSS_ACCESS_KEY_ID"));
    aos_str_set(&options->config->access_key_secret, getenv("OSS_ACCESS_KEY_SECRET"));
    /* 开启CNAME，将自定义域名绑定到存储空间上。*/
    options->config->is_cname = 1;
    options->ctl = aos_http_controller_create(options->pool, 0);
}
int main() {
    aos_pool_t *p;
    oss_request_options_t *options;
    /* 初始化全局变量，在程序生命周期内只需要调用一次。*/
    if (aos_http_io_initialize(NULL, 0) != AOSE_OK) {
        return -1;
    }
    /* 初始化内存池和options。*/
    aos_pool_create(&p, NULL);
    options = oss_request_options_create(p);
    init_options(options);
    /* 逻辑代码，此处省略。*/
    /* 释放内存池，相当于释放了请求过程中各资源分配的内存。*/
    aos_pool_destroy(p);
    /* 释放之前分配的全局资源，在程序生命周期内只需要调用一次。*/
    aos_http_io_deinitialize();
    return 0;
}

Ruby

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # 使用自定义域名作为Endpoint。
  endpoint: 'http://example.com',
  # 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
  cname: true)
)

使用OssClient调用generatePresignedUrl接口获取签名URL。
各语言SDK示例，请参见签名版本1。

使用命令行工具ossutil

通过配置文件设置Bucket和自定义域名的映射关系。详情请参见配置ossutil。
通过sign生成经过签名的文件URL。详情请参见sign（生成签名URL）。

长期文件URL

警告

如需获取长期有效的文件URL，即不存在过期时间。您需要将读文件读写权限ACL设置为公共读。设置为公共读后，文件的互联网上任何用户都可以对该Object进行访问，这有可能造成您数据的外泄以及费用激增，建议您使用临时文件URL。

获取长期有效的文件URL的操作步骤如下：

设置文件读写权限ACL为公共读。
具体操作，请参见设置Object ACL。
拼接文件URL。
绑定自定义域名后，如果文件读写权限ACL为公共读，则无需进行签名操作。公共读文件URL的格式为http://YourDomainName/ObjectName。
例如，您为华东1（杭州）地域的examplebucket绑定了自定义域名static.example.com，且该Bucket下包含example.jpg的文件，则该文件URL为http://static.example.com/example.jpg。

在浏览器中，访问生成的文件URL。

后续操作

使用HTTPS协议

HTTPS协议在HTTP的基础上整合了SSL/TLS安全协议层，从而为数据传输提供了强大的加密保护。使用HTTPS协议访问之前，您需要购买相应的数字证书并完成证书托管。具体步骤，请参见绑定自定义域名的证书托管。

使用CDN加速

如果您希望提升静态资源访问的速度和稳定性，您可以为OSS开启CDN加速，然后将自定义域名绑定到CDN加速域名上。具体操作，请参见绑定CDN加速域名。

避免盗刷

如果您希望避免Bucket内的资源被其他人盗用，您可以通过设置Referer列表（包括白名单Referer和黑名单Referer）以及是否允许空Referer的方式，限制您Bucket内资源的访问来源。具体步骤，请参见防盗链。

加速跨境传输

如果您希望提升跨境访问的速度和稳定性，您可以将自定义域名绑定到OSS传输加速域名上。具体操作，请参见绑定CDN加速域名。

托管静态网站

如果您希望将您的静态网站托管到OSS，并使用自定义域名访问，您需要为存储空间设置静态网站托管。具体步骤，请参见静态网站托管。

常见问题

备案时不支持选择OSS作为云服务怎么办

对于直接使用阿里云OSS托管静态网站的用户，由于OSS服务不支持备案，您可以采取以下步骤来满足备案要求：

购买用于备案服务器：建议您购买一台最低配置、时长至少3个月的ECS实例，以满足备案条件。
进行备案：使用该ECS实例进行相应的备案操作。
使用备案后的域名：备案成功后，您可以将域名指向阿里云OSS，实现静态网站的托管。

已有主机记录与当前添加CNAME记录生成的主机记录相同，暂时无法自动添加CNAME记录

当已有主机记录与当前自动添加的CNAME记录相同时，可能有以下几种情况：

冲突记录：已存在一个使用相同主机记录的记录，但记录类型可能与CNAME不同。例如，可能已经存在一个A记录。
重复记录：已存在一个使用相同主机记录的记录，且记录类型为CNAME记录。这可能是因为先前已手动添加了相同的记录。

在这种情况下，您可以在阿里云云解析DNS控制台根据您的需求来决定如何处理：

如果您希望保留已有的冲突或重复主机记录，您可以重新自定义一个子域名进行绑定。
如果您不希望保留已有的主机记录：
- 如果是冲突记录，您可以删除该记录，然后创建CNAME记录解析至Bucket域名。
- 如果是重复记录，您可以修改记录，将其解析至Bucket域名。

域名绑定在自己的其他Bucket上

您需要解除Bucket绑定的域名，然后重新绑定到当前Bucket上。具体操作，请参见OSS的域名管理中绑定域名时提示“域名绑定在自己的其他Bucket上”。

NeedVerifyDomainOwnership

你需要验证域名所有权。具体操作，请参见绑定自定义域名时返回错误码NeedVerifyDomainOwnership，怎么办？。

绑定自定义域名后，还是无法预览文件？

如果绑定自定义域名并且CNAME解析生效后，仍然无法预览文件，请排查以下设置：

设置	异常原因	解决方法
OSS	`Content-Type`的值与实际的文件类型不一致。浏览器无法正确解析和渲染该文件，而只能将其作为下载文件处理。	根据文件类型，设置合理的Content-Type。具体操作，请参见如何设置Content-Type（MIME）？。
OSS	`Content-Disposition`被设置为`attachment`。浏览器检测到`Content-Disposition: attachment`时，会触发下载行为。	将Content-Disposition设置为`inline`。具体步骤，请参见管理文件元数据。
CDN	缓存资源未刷新。	刷新CDN缓存资源。具体步骤，请参见刷新和预热资源。
浏览器	不支持预览该格式的文件，例如表格文件、文本文件、演示文件以及PDF文件。	您可以为浏览器安装插件以支持预览该格式的文件。

已经正常解析到WAF且有内容的域名可以绑定至Bucket吗？

可以正常绑定。WAF解析和CNAME解析不会发生冲突，因为它们在不同的层面上进行解析和操作。

绑定自定义域名后，之前的文件URL是否可以继续使用？

可以继续使用。如何获取之前的文件URL，请参见使用文件URL分享文件。

使用自定义域名就是公网访问吗？

一般是通过公网访问。公网用户通常需要以预览的方式访问您的OSS文件，因此自定义域名默认解析到Bucket的外网访问域名。

如何使用自定义域名访问OSS文件时是下载行为？

如需实现使用自定义域名访问OSS文件时是下载行为，您可以将Content-Disposition设置为attachment。具体操作，请参见如何配置通过自定义域名访问OSS文件实现强制下载？。

如何解除自定义域名绑定？

当您不再使用自定义域名时，您可以参考以下步骤解绑自定义域名。

如果开启了CDN加速，需要先关闭CDN加速。
您需要修改CDN加速服务的源站信息，使加速域名不再指向OSS的Bucket域名。具体操作，请参见配置源站。
解绑自定义域名。
1. 登录OSS管理控制台。
2. 单击Bucket 列表，然后单击目标Bucket名称。
3. 在左侧导航栏，选择Bucket配置>域名管理。
4. 在域名列表中，单击目标域名右侧的域名绑定配置。
5. 在域名绑定配置面板，单击解除绑定，然后单击确定。
删除域名解析。
解绑自定义域名后，您需要手动删除配置的TXT解析记录和CNAME解析记录。具体操作，请参见删除记录。

前提条件

使用场景

背景信息

访问Bucket默认域名或传输加速域名

访问自定义域名

使用限制

操作步骤

步骤一：绑定自定义域名

绑定当前阿里云账号注册的域名

自动添加

手动添加

绑定其他阿里云账号注册的域名

绑定非阿里云账号注册的域名

步骤二：验证自定义域名

nslookup

dig

步骤三：使用自定义域名

临时文件URL

使用OSS控制台

使用图形化管理工具ossbrowser

使用阿里云SDK

Java

PHP

Node.js

Python

Browser.js

.NET

Android

Go

iOS

C++

C

Ruby

使用命令行工具ossutil

长期文件URL

后续操作

使用HTTPS协议

使用CDN加速

避免盗刷

加速跨境传输

托管静态网站

常见问题

备案时不支持选择OSS作为云服务怎么办

已有主机记录与当前添加CNAME记录生成的主机记录相同，暂时无法自动添加CNAME记录

域名绑定在自己的其他Bucket上

NeedVerifyDomainOwnership

绑定自定义域名后，还是无法预览文件？

已经正常解析到WAF且有内容的域名可以绑定至Bucket吗？

绑定自定义域名后，之前的文件URL是否可以继续使用？

使用自定义域名就是公网访问吗？

如何使用自定义域名访问OSS文件时是下载行为？

如何解除自定义域名绑定？

相关API