对象存储 OSS：绑定自定义域名至Bucket默认域名

步骤一：绑定自定义域名

根据域名所属服务提供商（可在域名信息查询（WHOIS）页面查询）和所属账号（可在云解析DNS控制台查询），参考对应的步骤将域名绑定至OSS Bucket。

步骤二：验证自定义域名

绑定自定义域名后，当用户通过自定义域名发起请求时，该请求会通过 DNS 解析到 Bucket 默认域名。您可以使用nslookup或dig命令来验证自定义域名解析是否生效。

nslookup -type=CNAME static.example.com

dig CNAME static.example.com

步骤三：使用自定义域名

自定义域名解析生效后，您可以使用HTTP协议和自定义域名构造包含签名和有效期的URL，URL的格式为http://YourDomain/ObjectName?签名参数，然后使用该URL访问OSS文件。

1. 获取预签名URL。

   使用OSS控制台

   1. 登录OSS管理控制台。

   2. 单击Bucket列表，然后单击目标Bucket名称。

   3. 在左侧导航栏，选择文件管理 > 文件列表。

   4. 在文件列表页面，单击目标文件名称。

   5. 在详情面板的自有域名，选择绑定的自定义域名，其他保持默认值，然后单击复制文件URL。

      

   使用图形化管理工具ossbrowser

   ossbrowser支持Object级别的操作与控制台支持的操作类似，请按照ossbrowser界面指引完成获取预签名URL的操作。如何下载ossbrowser，请参见图形化管理工具ossbrowser 2.0（预览版）。

   1. 使用自定义域名登录ossbrowser。

   1. 获取文件URL。

   使用阿里云SDK

   使用自定义域名新建OssClient并生成预签名URL。

   Java

   import com.aliyun.oss.*;
   import com.aliyun.oss.common.auth.*;
   import com.aliyun.oss.common.comm.SignVersion;
   import com.aliyun.oss.model.GeneratePresignedUrlRequest;
   
   import java.net.URL;
   import java.util.Date;
   
   public class Demo {
       public static void main(String[] args) throws Throwable {
           // yourCustomEndpoint请填写您的自定义域名。例如http://static.example.com。
           String endpoint = "yourCustomEndpoint";
           // 请填写您存储空间所在的Region信息，例如cn-hangzhou
           String region = "cn-hangzhou";
           // 填写Bucket名称，例如examplebucket。
           String bucketName = "examplebucket";
           // 填写Object完整路径，例如exampleobject.txt。Object完整路径中不能包含Bucket名称。
           String objectName = "exampleobject.txt";
   
           // 从环境变量中获取访问凭证。运行本代码示例之前，请先配置环境变量
           EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
   
           // 创建OSSClient实例
           ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
           // 请注意，设置true开启CNAME选项
           clientBuilderConfiguration.setSupportCname(true);
           // 显式声明使用 V4 签名算法
           clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
           OSS ossClient = OSSClientBuilder.create()
                   .endpoint(endpoint)
                   .credentialsProvider(credentialsProvider)
                   .clientConfiguration(clientBuilderConfiguration)
                   .region(region)
                   .build();
   
           try {
               // 指定生成的预签名URL过期时间，单位为毫秒。本示例以设置过期时间为1小时为例。
               Date expiration = new Date(new Date().getTime() + 3600 * 1000L);
   
               // 生成预签名URL。
               GeneratePresignedUrlRequest request = new GeneratePresignedUrlRequest(bucketName, objectName, HttpMethod.GET);
   
               // 设置过期时间。
               request.setExpiration(expiration);
   
               // 通过HTTP GET请求生成预签名URL。
               URL signedUrl = ossClient.generatePresignedUrl(request);
               // 打印预签名URL。
               System.out.println("signed url for getObject: " + signedUrl);
           } catch (OSSException oe) {
               System.out.println("Caught an OSSException, which means your request made it to OSS, "
                       + "but was rejected with an error response for some reason.");
               System.out.println("Error Message:" + oe.getErrorMessage());
               System.out.println("Error Code:" + oe.getErrorCode());
               System.out.println("Request ID:" + oe.getRequestId());
               System.out.println("Host ID:" + oe.getHostId());
           } catch (ClientException ce) {
               System.out.println("Caught an ClientException, which means the client encountered "
                       + "a serious internal problem while trying to communicate with OSS, "
                       + "such as not being able to access the network.");
               System.out.println("Error Message:" + ce.getMessage());
           } finally {
               if (ossClient != null) {
                   ossClient.shutdown();
               }
           }
       }
   }

   Python

   # -*- coding: utf-8 -*-
   import oss2
   from oss2.credentials import EnvironmentVariableCredentialsProvider
   
   # 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
   auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
   
   # 填写Endpoint对应的Region信息，例如cn-hangzhou。注意，v4签名下，必须填写该参数
   region = "cn-hangzhou"
   
   # 填写自定义域名，例如static.example.com。
   endpoint = 'http://static.example.com'
   
   # yourBucketName填写存储空间名称。
   bucket = oss2.Bucket(auth, endpoint, "yourBucketName", region=region, is_cname=True)
   
   
   # 填写Object完整路径，例如exampledir/exampleobject.txt。Object完整路径中不能包含Bucket名称。
   object_name = 'exampledir/exampleobject.txt'
   
   # 生成下载文件的预签名URL，有效时间为600秒。
   # 生成预签名URL时，OSS默认会对Object完整路径中的正斜线（/）进行转义，从而导致生成的预签名URL无法直接使用。
   # 设置slash_safe为True，OSS不会对Object完整路径中的正斜线（/）进行转义，此时生成的预签名URL可以直接使用。
   url = bucket.sign_url('GET', object_name, 600, slash_safe=True, params=params)
   print('预签名URL的地址为：', url)

   Node.js

   const OSS = require("ali-oss");
   
   // 定义一个生成预签名 URL 的函数
   async function generateSignatureUrl(fileName) {
     // 获取预签名URL
     const client = await new OSS({
         // 使用自定义域名作为Endpoint。
         endpoint: 'http://static.example.com', 
         // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
         accessKeyId: process.env.OSS_ACCESS_KEY_ID,
         accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
         bucket: 'examplebucket',
         // yourregion填写Bucket所在地域。以华东1（杭州）为例，Region填写为oss-cn-hangzhou。
         region: 'oss-cn-hangzhou',
         authorizationV4: true,
         cname: true
     });
   
     return await client.signatureUrlV4('GET', 3600, {
         headers: {} // 请根据实际发送的请求头设置此处的请求头
     }, fileName);
   }
   // 调用函数并传入文件名
   generateSignatureUrl('yourFileName').then(url => {
     console.log('Generated Signature URL:', url);
   }).catch(err => {
     console.error('Error generating signature URL:', err);
   });

   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\OssClient;
   use OSS\Core\OssException;
   use OSS\Http\RequestCore;
   use OSS\Http\ResponseCore;
   use OSS\Credentials\EnvironmentVariableCredentialsProvider;
   
   // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
   $provider = new EnvironmentVariableCredentialsProvider();
   // yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为http://static.example.com。
   $endpoint = "http://static.example.com";
   // 填写Bucket名称。
   $bucket= "examplebucket";
   // 填写不包含Bucket名称在内的Object完整路径。
   $object = "exampleobject.txt";
   // 指定预签名URL的过期时间为600s（最长可达32400s）。
   $timeout = 600;
   try {
       $config = array(  
           "provider" => $provider,
           "endpoint" => $endpoint,
           'signatureVersion'=>OssClient::OSS_SIGNATURE_VERSION_V4,
           "cname"	=> true,
           "region"=> "cn-hangzhou"
       );
       $ossClient = new OssClient($config);
       // 生成预签名URL。
       $signedUrl = $ossClient->signUrl($bucket, $object, $timeout, "GET");
       print_r($signedUrl);
   } catch (OssException $e) {
       printf(__FUNCTION__ . ": FAILED\n");
       printf($e->getMessage() . "\n");
       return;
   }

   Go

   package main
   
   import (
   	"context"
   	"flag"
   	"log"
   	"time"
   
   	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
   	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
   )
   
   // 定义全局变量
   var (
   	region     string // 存储区域
   	bucketName string // 存储空间名称
   	objectName string // 对象名称
   )
   
   // init函数用于初始化命令行参数
   func init() {
   	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
   	flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
   	flag.StringVar(&objectName, "object", "", "The name of the object.")
   }
   
   func main() {
   	// 解析命令行参数
   	flag.Parse()
   
   	// 检查bucket名称是否为空
   	if len(bucketName) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("invalid parameters, bucket name required")
   	}
   
   	// 检查region是否为空
   	if len(region) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("invalid parameters, region required")
   	}
   
   	// 检查object名称是否为空
   	if len(objectName) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("invalid parameters, object name required")
   	}
   
   	// 加载默认配置并设置凭证提供者和区域
   	cfg := oss.LoadDefaultConfig().
   		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
   		WithRegion(region).
   		WithEndpoint("http://static.example.com").
   		WithUseCName(true)
   
   	// 创建OSS客户端
   	client := oss.NewClient(cfg)
   
   	// 生成GetObject的预签名URL
   	result, err := client.Presign(context.TODO(), &oss.GetObjectRequest{
   		Bucket: oss.Ptr(bucketName),
   		Key:    oss.Ptr(objectName),
   		//RequestPayer: oss.Ptr("requester"), // 指定请求者身份
   	},
   		oss.PresignExpires(10*time.Minute),
   	)
   	if err != nil {
   		log.Fatalf("failed to get object presign %v", err)
   	}
   
   	log.Printf("request method:%v\n", result.Method)
   	log.Printf("request expiration:%v\n", result.Expiration)
   	log.Printf("request url:%v\n", result.URL)
   	if len(result.SignedHeaders) > 0 {
   		//当返回结果包含预签名头时，使用预签名URL发送GET请求时也包含相应的请求头，以免出现不一致，导致请求失败和预签名错误
   		log.Printf("signed headers:\n")
   		for k, v := range result.SignedHeaders {
   			log.Printf("%v: %v\n", k, v)
   		}
   	}
   }

   使用命令行工具ossutil

   使用自定义域名通过presign（生成预预签名URL）命令生成文件的预签名URL。

   ossutil presign oss://examplebucket/exampleobject.txt --endpoint "http://static.example.com” --addressing-style "cname"

   如需ossutil命令自动使用自定义域名，而无需每次在命令中手动指定自定义域名，您可以在配置文件中添加自定义域名，

2. 在浏览器中访问预签名URL。

   

通过HTTPS协议访问OSS文件

自定义域名在未配置SSL证书的情况下，默认不支持HTTPS协议访问。通过HTTPS协议访问自定义域名时，浏览器会显示不安全连接警告。为了通过HTTPS协议访问OSS文件，需要为自定义域名配置证书。

使用不带签名的长期有效的URL访问OSS文件

您可以通过以下两种方式将文件设置为公共读：

• 设置文件为公共读：将 OSS 文件的权限设置为公共读。在这种情况下，文件的 URL 将没有有效期，任何人都可以访问。为了防止文件被其他网站盗用，您需要在 OSS 中配置防盗链。

• CDN加速OSS资源：保持 OSS 文件的权限为私有，通过 CDN 提供公共读访问。在这种情况下，文件的 URL 将没有有效期，任何人都可以访问。为了防止文件被其他网站盗用，您需要在 CDN 配置防盗链。

防止OSS文件被其他网站盗用

默认情况下，任何网站都可以显示您的OSS文件，这可能导致额外的请求费用和下行流量费用。您可以通过防盗链，设置Referer黑名单或白名单来限制访问来源。配置防盗链后，未授权的网站将无法显示您的OSS文件，同时失败的请求也不会产生请求费用和下行流量费用。

使用OSS托管静态网站

如果您使用OSS作为静态网站的服务器，直接存储和提供静态文件（如HTML、CSS、JavaScript等），以便用户通过互联网访问这些内容，除了绑定自定义域名外，您还需要为Bucket设置静态网站托管。

提升OSS文件在不同地域的下载速度

OSS Bucket 中的文件存储在某个地域（例如杭州）。为了提高不同地域用户下载 OSS 文件的速度，您可以使用CDN加速OSS。开启CDN加速后，OSS 文件会分发到各个地域的 CDN 缓存节点。用户在访问文件时，可以从离他们更近的缓存节点获取内容，从而有效提升下载速度。

提升OSS文件的远距离传输速度

OSS Bucket 中的文件存储在某个地域（例如杭州）。非中国内地的用户访问时，可能因传输距离较远导致上传和下载体验非常差。为提升 OSS 文件的远距离传输速度，您可以开启传输加速，将自定义域名绑定到 OSS 的传输加速域名，而不是Bucket默认域名。