文档中心

API 网关

Upstream 管理

固定域名类型 Upstream

API 网关支持对接固定域名，允许将与网关网络互通的固定域名封装为一个 Upstream，作为网关的路由后端。本文为您介绍如何创建域名类型 Upstream。

注意

【邀测·申请试用】：该功能目前处于邀测阶段，如需使用，请联系您的客户经理。

前提条件

已创 API 网关建实例，详情可参见创建实例。

已创建服务，详情请参见创建服务。

已获取对接的域名和端口。

操作步骤

在实例管理中选择目标实例后，单击 Upstream 列表。

在 Upstream 列表页面，单击创建 Upstream。

在创建 Upstream 页面，按要求填写参数信息。

基本信息

配置项	说明
所属实例	Upstream 属于实例级别的资源，请选择当前 Upstream 所属的网关实例。
Upstream 名称	自定义 Upstream 名称。同一实例下的 Upstream 名称唯一。
备注	填写当前 Upstream 的备注信息，可以为空。

后端配置

配置项	说明
后端服务	选择 Upstream 对接的后端服务类型。本场景选择固定域名。
协议	选择协议类型。支持 HTTP1.1、HTTP2 和 HTTP2/GRPC。
TLS 设置	配置 TLS。关闭 TLS：网关访问后端 Upstream 使用 HTTP 协议。单向 TLS：网关访问后端 Upstream 使用 HTTPS 协议，需要选择对应证书。
域名	配置 Upstream 对接的后端域名。
端口	配置 Upstream 对接后端域名的端口号。支持配置多个端口号，每个端口号输入完成后，按回车键确认。
负载均衡算法	选择负载均衡算法。轮询：（默认）将所有请求依次分发到各个域名，适合服务规格相同的场景。随机：请求随机分配到各个域名。最小连接数：将请求分配到目前处理请求数最少的域名。一致性哈希：基于 header/querystring 信息进行负载均衡，在后端服务数量不变的情况下，确保携带信息相同的用户可固定访问同一域名。支持单击启用过载保护，设置负载阈值，开启实例过载保护。开启后，若实例活跃请求数超过平均活跃请求数的阈值，即便 Hash 值命中该实例，也不会选择该实例。
服务熔断	配置是否开启熔断。开启后，API 网关可以通过设置熔断器以提高路由的命中率，不消耗额外流量。详情请参见服务熔断策略。
预热时间	当负载均衡算法配置为轮询或最小连接数时，支持配置。配置后端服务预热时间。整数形式，取值范围为 1～10000，不包含 10000，单位为秒。

单击确定，完成配置。

安全组配置

如果固定域名解析后的 IP 是私网 IP，那么您的服务是通过私网 IP 连接的，请按照以下操作配置安全组。

登录私有网络控制台。

在顶部导航栏，选择目标资源所属的项目和地域。

在左侧导航栏，单击安全组。

单击创建安全组，选择目标私有网络，在访问规则中添加入方向，然后单击确定。

最近更新时间：2025.11.18 11:46:33

这个页面对您有帮助吗？

有用

无用