Go访问域名 - 对象存储 OSS

本文介绍如何使用Go SDK V2设置访问域名。

配置访问域名

OSS支持多种方式配置访问域名，您可以根据使用场景选择对应的域名访问方式。

关于OSS访问域名规则，请参考OSS访问域名使用规则。

关于OSS支持的Region与Endpoint的对应关系，请参考OSS地域和访问域名。

访问域名方式	适用场景
方式一：使用公网域名访问	当您的应用或服务需要从全球各地访问 OSS 存储的数据时，使用公网域名是最简单和直接的方式。
方式二：使用内网域名访问	当您的应用部署在阿里云的VPC内，且需要频繁访问OSS数据时，使用内网域名可以显著减少网络延迟和带宽成本。
方式三：使用传输加速域名访问	当您的应用需要高速访问OSS数据，特别是在跨地域或跨国界的情况下，传输加速域名可以提供更快的访问速度。
方式四：使用双栈域名访问	当您的网络环境支持IPv6，且需要确保兼容IPv4和IPv6客户端时，使用双栈域名可以无缝支持两种协议。
方式五：使用自定义域名访问	当您有多个 OSS Bucket 需要管理时，可以为每个 Bucket 分配不同的自定义域名，便于管理和维护。
方式六：使用专有云或专有域访问	当您使用阿里云专有云时，可以通过专有云域名高效访问OSS数据，确保数据传输的安全性和可靠性。

方式一：使用公网域名访问

说明

您可以通过Endpoint参数，自定义服务请求的访问域名。当不指定时，SDK根据Region信息，构造公网访问域名。例如当Region为"cn-hangzhou"时，构造出来的访问域名为"oss-cn-hangzhou.aliyuncs.com"。

cfg := oss.LoadDefaultConfig().
  WithRegion("cn-hangzhou")

或者

cfg := oss.LoadDefaultConfig().
  WithRegion("cn-hangzhou").
  WithEndpoint("oss-cn-hanghzou.aliyuncs.com")

方式二：使用内网域名访问

cfg := oss.LoadDefaultConfig().
  WithRegion("cn-hangzhou").
  WithUseInternalEndpoint(true)

或者

cfg := oss.LoadDefaultConfig().
  WithRegion("cn-hangzhou").
  WithEndpoint("oss-cn-hanghzou-internal.aliyuncs.com")

方式三：使用传输加速域名访问

cfg := oss.LoadDefaultConfig().
  WithRegion("cn-hangzhou").
  WithUseAccelerateEndpoint(true)

或者

cfg := oss.LoadDefaultConfig().
  WithRegion("cn-hangzhou").
  WithEndpoint("oss-accelerate.aliyuncs.com")

方式四：使用双栈域名访问

cfg := oss.LoadDefaultConfig().
  WithRegion("cn-hangzhou").
  WithUseDualStackEndpoint(true)

或者

cfg := oss.LoadDefaultConfig().
  WithRegion("cn-hangzhou").
  WithEndpoint("cn-hangzhou.oss.aliyuncs.com")

方式五：使用自定义域名访问

说明

当通过自定义域名访问OSS服务时，您需要指定该配置参数。在使用自定义域名发送请求时，请先绑定自定域名至Bucket默认域名，具体操作详见绑定自定义域名至Bucket默认域名。

以"www.example-***.com"域名绑定到cn-hangzhou区域的存储空间为例，示例代码如下：

cfg := oss.LoadDefaultConfig().
  WithRegion("cn-hangzhou").
  WithEndpoint("www.example-***.com").
  WithUseCName(true)

方式六：使用专有云或专有域访问

var (
  region = "YOUR Region" // 填写您OSS服务所在的区域Region
  endpoint = "YOUR Endpoint" // 填写您的专有云或专有域的Endpoint
)

cfg := oss.LoadDefaultConfig().
  WithRegion(region).
  WithEndpoint(endpoint)

对象存储 OSS：Go访问域名