概述

自定义域名用于把您持有的业务域名绑定到 AI 原生网关实例，让客户端通过该域名访问网关上的后端服务，而不必使用网关的默认入口。

绑定后，客户端按自定义域名调用网关，请求经域名解析到达网关后，由对应 模型推理服务/MCP 服务 根据其「关联域名」配置接管处理。

前提条件

• 已创建 AI 原生网关实例。
• 已在域名注册商处获取需要绑定的域名（支持完整域名，也支持三级及以上的泛域名，详见下文「使用限制」）。
• 若该域名需要在中国大陆地区通过公网访问，需提前完成 ICP 备案或接入备案，未备案的公网域名无法对外访问。
• 由于网关固定要求自定义域名同时支持 HTTPS 协议，需提前在百度智能云证书管理中购买或上传与该域名匹配的证书。

使用限制

• 每个网关实例仅支持创建 1 个自定义域名。
• 协议类型固定为 HTTP & HTTPS（同时支持），暂不可调整为仅 HTTP 或仅 HTTPS。
• 域名一经创建后不支持修改，仅可修改证书。如需更换域名，请删除后重新创建。

• 泛域名规则：

  • 支持完整域名（如 aigw.example.com）。
  • 支持三级及以上泛域名（如 *.aigw.example.com）。
  • 不支持二级泛域名（如 *.com）、多处泛域名（如 *.aigw.*）、部分泛域名（如 aigw*.example.com）。

• HTTPS 证书要求：

  • 证书的 Common Name 中需包含待绑定的域名。
  • 泛域名证书仅支持同级匹配：例如 *.example.com 可匹配 a.example.com，无法匹配 a.b.example.com。
• 删除前置校验：当自定义域名已被任意模型推理服务关联时无法删除，需先在对应的模型推理服务中移除该域名的「关联域名」配置后再操作。

创建自定义域名

1. 登录百度智能云 AI 原生网关控制台。
2. 在顶部导航栏选择目标地域，并在实例列表中单击目标实例 ID，进入实例详情页。
3. 在左侧导航栏选择 自定义域名，进入自定义域名管理页。

4. 单击列表上方的 创建自定义域名，打开「创建自定义域名」面板。

5. 配置以下参数：

   配置项	说明
   域名	待绑定的自定义域名，必填且创建后不可修改。 长度不超过 253 个字符。 仅支持小写字母、数字、点（.）、连字符（-）、星号（*）。 支持完整域名（如 api.example.com）和三级及以上泛域名（如 *.api.example.com）。 不支持二级泛域名、多处泛域名、部分泛域名。 同一网关实例下域名唯一，重复创建会提示「当前域名已存在，请重新输入」。
   支持协议	固定为 HTTP & HTTPS（同时支持），不可调整。
   证书选择	必填。从百度智能云证书管理中选择已购买或已上传的 HTTPS 证书： 注意：系统会按所填域名自动过滤匹配的证书，避免选错。 列表展示证书名称 / ID、Common Name、到期时间，可按证书名称或 ID 搜索。 如暂无可用证书，可单击 前往证书管理 跳转至百度智能云证书管理购买或上传证书后再回来选择。

6. 单击 确定，完成自定义域名的创建。新创建的域名会出现在列表中。

   此时域名仅完成了网关侧的接入，您还需要执行下一步「完成 DNS 解析」并在模型推理服务/MCP 服务中关联该域名，客户端才能真正通过该自定义域名访问相关服务。

配置 DNS 解析

自定义域名创建成功后，您需要配置 DNS 解析，将该域名指向 AI 原生网关实例的访问入口。

具体可采用以下任一方式：

• A 记录解析：将自定义域名指向网关实例的公网 / 内网 IP 地址。在「实例详情 → 基本信息」中可查看本实例对外暴露的 IP。
• CNAME 解析：将自定义域名 CNAME 到网关实例的默认域名（公网默认域名 / 内网默认域名）。同样可在「实例详情 → 基本信息」中查看。

关联自定义域名

完成 DNS 解析后，您还需要把自定义域名关联到具体的模型推理服务/MCP 服务上，请求才能被正确路由：

1. 在左侧导航栏选择 AI 服务 > 模型推理服务。
2. 选择需要使用该域名的模型推理服务，单击 编辑。
3. 在 基本信息 → 关联域名 中选择 自定义域名，并在下拉框中勾选刚才创建的自定义域名。
4. 单击页面底部的 发布，配置发布后该域名即可访问对应的模型推理服务。

编辑自定义域名

域名一经创建后不支持修改域名本身，但您可以更换 HTTPS 证书。

1. 进入「自定义域名」列表页。
2. 在目标域名的操作列单击 编辑。
3. 在「编辑自定义域名」面板中重新选择证书。
4. 单击 确定，证书更换即时生效。

删除自定义域名

对于不再使用的自定义域名，您可以将其从实例中删除。

1. 进入「自定义域名」列表页，确认目标域名的「关联路由数」列显示为 0。
2. 在操作列单击 删除。
3. 在弹出的二次确认框中查看提示，二次确认后单击 确定。

删除后该域名立即从网关侧解绑。如客户端仍在通过该域名调用，会因 DNS 仍指向网关但网关不再认识该域名而被拒绝；建议在删除前同步通知调用方调整。