You need to enable JavaScript to run this app.
导航
绑定自定义域名
最近更新时间:2024.11.21 17:34:39首次发布时间:2022.11.24 23:20:30

服务作为业务对外暴露的入口,可以通过绑定域名功能,将您的自定义域名绑定至服务。本文为您介绍如何绑定自定义域名。

前提条件

  • 已创建服务,详情请参见 创建服务
  • 已在域名注册商处获取待绑定的域名。
  • 公网域名需要在工信部完成 ICP 备案或接入备案。火山引擎也提供了备案能力,详情请参见 备案流程
  • (可选)如果域名使用 HTTPS 协议,则需获取可信数字证书。

    说明

    API 网关已对接火山引擎的 证书中心,您可以在证书中心购买或上传证书。支持上传单/多/泛域名证书,详情请参见 证书管理

使用限制

  • 一个域名仅能唯一绑定一个服务,域名冲突无法配置成功。
  • 绑定自定义域名过程中,无法对当前服务下的所有自定义域名和路由进行增/删/改操作。
  • 每个服务可关联的自定义域名数量存在限制,详情可参见 使用限制

操作步骤

  1. 登录 API 网关控制台

  2. 在顶部导航栏,选择目标地域。

  3. 在左侧导航栏选择 路由管理 > 服务列表(域名)

  4. 在服务列表中单击目标服务名称,进入服务概览页面。

  5. 选择 域名管理 页签,单击 绑定域名,在服务中绑定自定义域名。
    alt

    配置项说明
    服务名显示当前服务的名称。

    绑定域名

    请输入待绑定的域名。

    注意

    • 公网域名必须在工信部完成 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)。否则,在同一浏览器下访问这些域名时,会存在访问失败的情况。
  6. 单击 确定,完成域名绑定。

后续操作

配置完成后,您需要前往 DNS 服务商处完成 DNS 解析,将自定义域名指向 API 网关的默认域名或 IP 地址。

  • 添加 DNS 解析记录。将自定义域名指向 API 网关的 IP 地址。API 网关的 IP 地址获取,请参见 获取网关地址
  • 添加 CNAME 记录。将自定义域名指向 API 网关当前服务的默认域名。如果不添加 CNAME 记录,通过自定义域名发送的客户端请求,将无法正确解析至 API 网关。