Skip to main content
Version: 1.0-beta

上游

APIPark中,“上游”是指 API 请求最终被路由到的后端服务器或服务。上游通常包含处理 API 请求的实际业务逻辑、数据存储和应用程序。在 API 网关架构中,网关接收并处理来自客户端的请求,然后将这些请求转发到上游服务器进行具体处理,获取响应并返回给客户端。

配置上游是API开放平台中关键的一步,确保API请求能够正确路由到后端服务。上游配置涉及定义和管理目标地址、负载均衡策略、以及故障转移机制,以确保服务的高可用性和性能。

操作演示

配置上游

  1. 选中需要配置的服务,进入服务内部页面。

  1. 点击 上游,进入上游配置页面。

  1. 配置上游信息,配置完成后,点击保存

字段说明

字段名说明
上游类型上游服务的类型,目前仅支持静态上游,即有固定IP/域名+端口号的上游入口的服务。
服务地址上游服务访问地址,可填写多个上游地址,并配置每个上游服务的权重。
请求协议请求上游服务的协议,目前仅支持HTTP/HTTPS。
负载均衡负载均衡算法,当前支持带权轮询、IP Hash。
转发Host请求上游服务时,使用的Host值,此处有三个选项:

透传客户端请求Host:
这种策略下,网关或代理服务器不会修改请求中的Host头信息。它将客户端(发起请求的一方)原始的Host头直接传递给上游服务(即实际提供服务的服务器)。
这允许上游服务识别请求的原始来源域名,从而可以根据原始请求的Host头提供定制化的内容或执行特定的逻辑。

使用上游服务Host:

这种策略中,网关或代理服务器会用配置好的一个或多个上游服务的Host头来替换原始请求中的Host头。
这通常用于将请求路由到特定的后端服务,而不管客户端请求中的Host头是什么。这可以简化上游服务的配置,因为它们不需要关心进入请求的Host头信息。

重写Host:

这种策略涉及到修改请求中的Host头,将其更改为特定的值。 这可以用于多种情况,比如当需要将请求路由到一个不同的域名,或者当需要确保请求符合特定的格式或安全要求时。
重写Host头可以提供更大的灵活性,但也可能导致一些意外的行为,特别是如果客户端依赖于原始Host头来进行某些操作时。
超时时间请求上游超时时间,单位为ms。
超时重试次数允许超时时,重新请求上游的次数,重试时,若上游配置多个服务地址,则网关会重新请求未请求过的服务地址。
调用频率限制当前上游每秒允许请求的次数。
转发上游请求头当请求上游时,需要增加或删除的请求头部信息,若不配置,网关会原封不动将请求头部转发给上游服务。

填写完后,点击保存即可。