文档中心

API 网关

Upstream 管理

固定 IP 类型 Upstream

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

前提条件

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

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

已获取对接的 IP 地址和端口。

使用限制

固定 IP 地址与网关实例所在的 VPC 互通。

固定 IP 地址仅支持以下私有网段：172.16.0.0/12、10.0.0.0/8 和 192.168.0.0/16。

暂不支持公网 IP 地址。

操作步骤

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

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

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

基本信息

配置项
说明
Upstream 名称
自定义 Upstream 名称。同一实例下的 Upstream 名称唯一。

后端配置

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

单击确定，完成配置。

安全组配置

当您 IP 地址对应的资源和网关实例在相同 VPC，但访问端口为非常用端口（例如 8080）时，您需要在对应的安全组内为访问端口放行 APIG 安全组（命名为apig-sg-<accountID>），确保网关可以正常访问 IP 地址对应的后端资源。

例如：假设您固定 IP 地址对应资源的访问端口为 8080。您需要配置 VPC 关联的安全组，添加一条入方向规则，为 8080 端口放行 APIG 安全组。

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

这个页面对您有帮助吗？

有用

无用

配置项	说明
Upstream 名称	自定义 Upstream 名称。同一实例下的 Upstream 名称唯一。