服务作为业务对外暴露的入口,可以通过绑定域名功能,将您的自定义域名绑定至服务。本文为您介绍如何绑定自定义域名。
前提条件
- 已创建服务,详情请参见 创建服务。
- 已在域名注册商处获取待绑定的域名。
- 公网域名需要在工信部完成 ICP 备案或接入备案。火山引擎也提供了备案能力,详情请参见 备案流程。
- (可选)如果域名使用 HTTPS 协议,则需获取可信数字证书。
说明
API 网关已对接火山引擎的 证书中心,您可以在证书中心购买或上传证书。支持上传单/多/泛域名证书,详情请参见 证书管理。
使用限制
- 一个域名仅能唯一绑定一个服务,域名冲突无法配置成功。
- 绑定自定义域名过程中,无法对当前服务下的所有自定义域名和路由进行增/删/改操作。
- 每个服务可关联的自定义域名数量存在限制,详情可参见 使用限制。
操作步骤
登录 API 网关控制台。
在顶部导航栏,选择目标地域。
在左侧导航栏选择 路由管理 > 服务列表(域名)。
在服务列表中单击目标服务名称,进入服务概览页面。
选择 域名管理 页签,单击 绑定域名,在服务中绑定自定义域名。
配置项 | 说明 |
---|
服务名 | 显示当前服务的名称。 |
绑定域名 | 请输入待绑定的域名。 注意 - 公网域名必须在工信部完成 ICP 备案或接入备案,否则无法配置成功。
- 一个域名仅能唯一绑定一个服务,域名冲突无法配置成功。
|
协议类型 | 选择自定义域名支持的通信协议类型。 - HTTP:仅支持 HTTP 协议的请求。
- HTTPS:仅支持 HTTPS 协议的请求。
- HTTP & HTTPS:同时支持 HTTP 和 HTTPS 协议的请求。
|
强制 HTTPS | 是否启用强制 HTTP 请求重定向,包括: - 启用:该域名的所有 HTTP 请求将重定向至 HTTPS。
- 不启用:该域名的 HTTP 请求不会被重定向至 HTTPS。
|
证书选择 | 当 协议类型 包含 HTTPS 协议时,在下拉菜单中选择证书中心保存的 HTTPS 证书。 注意 - 证书中的域名需要与待绑定的域名相匹配。
- 泛域名证书仅支持同级匹配。例如:
*.example.com 能够匹配 a.example.com ,无法匹配 a.b.example.com 。 - 当您需要重复使用同一个多/泛域名证书时,请确保同一网关下选择的证书 ID 一致(在证书中心重复上传内容相同的证书,会得到不同的证书 ID)。否则,在同一浏览器下访问这些域名时,会存在访问失败的情况。
|
单击 确定,完成域名绑定。
后续操作
配置完成后,您需要前往 DNS 服务商处完成 DNS 解析,将自定义域名指向 API 网关的默认域名或 IP 地址。
- 添加 DNS 解析记录。将自定义域名指向 API 网关的 IP 地址。API 网关的 IP 地址获取,请参见 获取网关地址。
- 添加 CNAME 记录。将自定义域名指向 API 网关当前服务的默认域名。如果不添加 CNAME 记录,通过自定义域名发送的客户端请求,将无法正确解析至 API 网关。