# 上游

本文档将介绍 APISIX 中上游（Upstream）对象的基本概念以及为什么要使用它。你将了解一些相关功能，包括负载均衡、服务发现和上游健康检查。

在末尾探索其他资源以获取有关相关主题的更多信息。

## 概述[​](#概述 "概述的直接链接")

APISIX 中的\_上游\_（Upstream）对象是包含一个或多个上游地址的集合的逻辑抽象。路由和服务通常使用上游指定请求流向**哪里**以及**如何**分发。如果插件自行生成响应，或在代理请求前结束处理，则可以不配置上游。

有多种配置上游地址的方法，其中之一是在每个路由/服务中显式配置它们。以下是在路由中进行此类配置的示例，其中相同的上游地址在三个不同的路由中重复出现：

<br />

![Upstreams Diagram showing three routes with different plugins and the same hard-coded upstream address](https://static.api7.ai/uploads/2023/02/24/6gZ6zw2R_upstream-before.svg)

<br />

<br />

然而，这种方法会导致数据冗余，并带来更新异常的风险（即部分更新导致的数据不一致）。

更好的方法是将重复的上游配置提取到一个单独的上游对象中，并将其 `upstream_id` 嵌入到路由/服务中，如下所示：

<br />

![Upstreams Diagram showing three routes with different plugins pointing to the same upstream object with the desired upstream address](https://static.api7.ai/uploads/2023/02/24/vPjoKWdE_upstream-after.svg)

<br />

你可能已经看到，拥有许多路由/服务的大规模系统将从在上游对象中配置相同的上游地址组中受益匪浅，从而减少冗余信息和运营成本。

## 负载均衡[​](#load-balancing "负载均衡的直接链接")

上游中的一个重要配置选项是[负载均衡](https://docs.apiseven.com/apisix/getting-started/load-balancing.md)算法。

APISIX 提供四种负载均衡算法选项供选择：

* `roundrobin` - 加权轮询
* `chash` - 一致性哈希
* `ewma` - 指数加权移动平均
* `least_conn` - 最小连接数

你还可以通过将源文件添加到 `apisix/balancer` 下并在需要时通过 `require("apisix.balancer.your_balancer_name")` 导入它来构建自己的负载均衡算法。

当新的应用实例需要预热时间时，慢启动可以逐步增加新发现节点的有效权重。有关支持的配置和生命周期行为，请参阅[配置上游慢启动](https://docs.apiseven.com/apisix/how-to-guide/traffic-management/configure-upstream-slow-start.md)。

要了解有关如何在 APISIX 中配置负载均衡的更多信息，请参阅[负载均衡教程](https://docs.apiseven.com/apisix/getting-started/load-balancing.md)和 [Admin API 参考](https://docs.apiseven.com/apisix/reference/admin-api.md#tag/Upstreams/paths/~1apisix~1admin~1upstreams~1%7Bid%7D/put)。

## 服务发现[​](#服务发现 "服务发现的直接链接")

虽然静态配置上游地址很简单，但在基于微服务的架构中，上游地址通常是动态分配的，因此会在自动扩缩容、故障和更新期间发生更改。在这种情况下，静态配置不太理想。

服务发现此时就派上用场了。它描述了自动检测可用上游服务并将它们的地址保存在数据库（称为服务注册表）中以供他人引用的过程。这样，API 网关可以从服务注册表获取最新的上游地址列表，无需依赖静态地址。

APISIX 支持与许多服务注册表集成，例如 Consul、Eureka、Nacos、Kubernetes 服务发现等。

有关如何与第三方服务注册表（如 HashiCorp Consul）集成的更多详细信息，请参阅[操作指南](https://docs.apiseven.com/apisix/how-to-guide/service-discovery/consul-integration.md)。

## TLS 与 mTLS[​](#tls-与-mtls "TLS 与 mTLS的直接链接")

上游可以使用 TLS 加密从 APISIX 发往所选节点的流量，并让 APISIX 验证该节点的身份。当上游还要求客户端提供身份凭证时，APISIX 可以通过 mTLS 提供证书。

配置和验证步骤请参阅[配置 APISIX 与上游之间的 HTTPS](https://docs.apiseven.com/apisix/how-to-guide/traffic-management/tls-and-mtls/configure-upstream-https.md)和[配置 APISIX 与上游之间的 mTLS](https://docs.apiseven.com/apisix/how-to-guide/traffic-management/tls-and-mtls/configure-mtls-between-apisix-and-upstream.md)。

## 上游健康检查[​](#上游健康检查 "上游健康检查的直接链接")

APISIX 通过主动和被动健康检查判断上游节点是否健康。只要有至少一个健康节点，APISIX 就会排除不健康的节点。如果所有节点都不健康，APISIX 会回退到原始节点集合，使其中仍可访问的节点能够处理流量。

可以在上游对象的 `checks` 参数中配置上游健康检查。

有关如何配置主动和被动上游健康检查的更多详细信息，请参阅[操作指南](https://docs.apiseven.com/apisix/how-to-guide/traffic-management/health-check.md)。

## 其他资源[​](#其他资源 "其他资源的直接链接")

* 快速入门 - [负载均衡](https://docs.apiseven.com/apisix/getting-started/load-balancing.md)
* [配置上游健康检查](https://docs.apiseven.com/apisix/how-to-guide/traffic-management/health-check.md)
* [集成 HashiCorp Consul 进行服务发现](https://docs.apiseven.com/apisix/how-to-guide/service-discovery/consul-integration.md)
* Admin API - [Upstreams](https://docs.apiseven.com/apisix/reference/admin-api.md#tag/Upstreams)
