微服务网关：从对比到选型，由理论到实践 | Java 程序员进阶之路

> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [tobebetterjavaer.com](https://tobebetterjavaer.com/microservice/api-wangguan.html#%E5%8D%8F%E8%AE%AE%E8%BD%AC%E6%8D%A2%E6%A8%A1%E5%9D%97)

2022 年 5 月 21 日 Java 企业级开发微服务网关约 5132 字大约 17 分钟

* * *

整理：沉默王二，戳[转载链接 open in new window](https://mp.weixin.qq.com/s/b2xf4GiJksBQqjHVpsh49Q)，作者：楼仔，戳[原文链接 open in new window](https://mp.weixin.qq.com/s/0Qupyl5eCyQGFEAIY6GxoQ)。

微服务近几年非常火，围绕微服务的技术生态也比较多，比如微服务网关、Docker、Kubernetes 等。

我是于 2019 年开始接触微服务网关，当时和公司的一位同事一起开发，由于技术能力有限，我只负责网关后台，后续微服务网关的迭代，我其实没有参与，不过后来抽空看了微服务网关前台的代码，所以对这套微服务网关的实现原理算是基本掌握。

最近在写技术栈相关的文章，刚好写到微服务网关，就把之前学习的知识进行简单总结，同时也把市面上常用的微服务网关进行梳理，一方面便于后续技术选型，另一方面也算是给自己一个交代。下面是文章目录：

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-f910e9f2-0374-4afb-aef0-3ea47c9b7f67.png)

[#](#api网关基础) API 网关基础
----------------------

### [#](#什么是api网关) 什么是 API 网关

**API 网关是一个服务器，是系统的唯一入口。** 从面向对象设计的角度看，它与外观模式类似。

API 网关封装了系统内部架构，为每个客户端提供一个定制的 API。它可能还具有其它职责，如身份验证、监控、负载均衡、缓存、协议转换、限流熔断、静态响应处理。

**API 网关方式的核心要点是，所有的客户端和消费端都通过统一的网关接入微服务**，在网关层处理所有的非业务功能。通常，网关也是提供 REST/HTTP 的访问 API。

### [#](#网关的主要功能) 网关的主要功能

微服务网关作为微服务后端服务的统一入口，它可以统筹管理后端服务，主要分为数据平面和控制平面：

*   数据平面主要功能是接入用户的 HTTP 请求和微服务被拆分后的聚合。使用微服务网关统一对外暴露后端服务的 API 和契约，路由和过滤功能正是网关的核心能力模块。另外，微服务网关可以实现拦截机制和专注跨横切面的功能，包括协议转换、安全认证、熔断限流、灰度发布、日志管理、流量监控等。
*   控制平面主要功能是对后端服务做统一的管控和配置管理。例如，可以控制网关的弹性伸缩；可以统一下发配置；可以对网关服务添加标签；可以在微服务网关上通过配置 Swagger 功能统一将后端服务的 API 契约暴露给使用方，完成文档服务，提高工作效率和降低沟通成本。

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-f6ea867d-ffdf-4da2-a89d-fccbe6326110.png)

*   **路由功能**：路由是微服务网关的核心能力。通过路由功能微服务网关可以将请求转发到目标微服务。在微服务架构中，网关可以结合注册中心的动态服务发现，实现对后端服务的发现，调用方只需要知道网关对外暴露的服务 API 就可以透明地访问后端微服务。
*   **负载均衡**：API 网关结合负载均衡技术，利用 Eureka 或者 Consul 等服务发现工具，通过轮询、指定权重、IP 地址哈希等机制实现下游服务的负载均衡。
*   **统一鉴权**：一般而言，无论对内网还是外网的接口都需要做用户身份认证，而用户认证在一些规模较大的系统中都会采用统一的单点登录（Single Sign On）系统，如果每个微服务都要对接单点登录系统，那么显然比较浪费资源且开发效率低。API 网关是统一管理安全性的绝佳场所，可以将认证的部分抽取到网关层，微服务系统无须关注认证的逻辑，只关注自身业务即可。
*   **协议转换**：API 网关的一大作用在于构建异构系统，API 网关作为单一入口，通过协议转换整合后台基于 REST、AMQP、Dubbo 等不同风格和实现技术的微服务，面向 Web Mobile、开放平台等特定客户端提供统一服务。
*   **指标监控**：网关可以统计后端服务的请求次数，并且可以实时地更新当前的流量健康状态，可以对 URL 粒度的服务进行延迟统计，也可以使用 Hystrix Dashboard 查看后端服务的流量状态及是否有熔断发生。
*   **限流熔断**：在某些场景下需要控制客户端的访问次数和访问频率，一些高并发系统有时还会有限流的需求。在网关上可以配置一个阈值，当请求数超过阈值时就直接返回错误而不继续访问后台服务。当出现流量洪峰或者后端服务出现延迟或故障时，网关能够主动进行熔断，保护后端服务，并保持前端用户体验良好。
*   **黑白名单**：微服务网关可以使用系统黑名单，过滤 HTTP 请求特征，拦截异常客户端的请求，例如 DDoS 攻击等侵蚀带宽或资源迫使服务中断等行为，可以在网关层面进行拦截过滤。比较常见的拦截策略是根据 IP 地址增加黑名单。在存在鉴权管理的路由服务中可以通过设置白名单跳过鉴权管理而直接访问后端服务资源。
*   **灰度发布**：微服务网关可以根据 HTTP 请求中的特殊标记和后端服务列表元数据标识进行流量控制，实现在用户无感知的情况下完成灰度发布。
*   **流量染色**：和灰度发布的原理相似，网关可以根据 HTTP 请求的 Host、Head、Agent 等标识对请求进行染色，有了网关的流量染色功能，我们可以对服务后续的调用链路进行跟踪，对服务延迟及服务运行状况进行进一步的链路分析。
*   **文档中心**：网关结合 Swagger，可以将后端的微服务暴露给网关，网关作为统一的入口给接口的使用方提供查看后端服务的 API 规范，不需要知道每一个后端微服务的 Swagger 地址，这样网关起到了对后端 API 聚合的效果。
*   **日志审计**：微服务网关可以作为统一的日志记录和收集器，对服务 URL 粒度的日志请求信息和响应信息进行拦截。

[#](#api网关选型) API 网关选型
----------------------

### [#](#常用api网关) 常用 API 网关

先简单看一下市面上常用的 API 网关：

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-ddaf1b1e-60b2-4cff-bab2-2b7b32f07f72.png)

#### [#](#nginx) Nginx

Nginx 是一个高性能的 HTTP 和反向代理服务器。**Nginx 一方面可以做反向代理，另外一方面可以做静态资源服务器，接口使用 Lua 动态语言可以完成灵活的定制功能。**

Nginx 在启动后，会有一个 Master 进程和多个 Worker 进程，Master 进程和 Worker 进程之间是通过进程间通信进行交互的，如图所示。Worker 工作进程的阻塞点是在像 select()、epoll_wait() 等这样的 I/O 多路复用函数调用处，以等待发生数据可读 / 写事件。Nginx 采用了异步非阻塞的方式来处理请求，也就是说，Nginx 是可以同时处理成千上万个请求的。

#### [#](#zuul) Zuul

Zuul 是 Netflix 开源的一个 API 网关组件，它可以和 Eureka、Ribbon、Hystrix 等组件配合使用。社区活跃，融合于 SpringCloud 完整生态，是构建微服务体系前置网关服务的最佳选型之一。

Zuul 的核心是一系列的过滤器，这些过滤器可以完成以下功能：

*   **统一鉴权 + 动态路由 + 负载均衡 + 压力测试**
*   **审查与监控**：与边缘位置追踪有意义的数据和统计结果，从而带来精确的生产视图。
*   **多区域弹性**：跨越 AWS Region 进行请求路由，旨在实现 ELB（Elastic Load Balancing，弹性负载均衡）使用的多样化，以及让系统的边缘更贴近系统的使用者。

Zuul 目前有两个大的版本：**Zuul1 和 Zuul2**

Zuul1 是基于 Servlet 框架构建，如图所示，采用的是阻塞和多线程方式，即一个线程处理一次连接请求，这种方式在内部延迟严重、设备故障较多情况下会引起存活的连接增多和线程增加的情况发生。

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-93bef98d-7d71-48d1-943a-b8ede72432c8.png)

Netflix 发布的 Zuul2 有重大的更新，它运行在异步和无阻塞框架上，每个 CPU 核一个线程，处理所有的请求和响应，请求和响应的生命周期是通过事件和回调来处理的，这种方式减少了线程数量，因此开销较小。

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-90dfae10-7cbd-4099-a5df-ea09a1435bc0.png)

#### [#](#spring-cloud-getway) Spring Cloud GetWay

Spring Cloud Gateway 是 Spring Cloud 的一个全新的 API 网关项目，目的是为了替换掉 Zuul1，它基于 Spring5.0 + SpringBoot2.0 + WebFlux（基于⾼性能的 Reactor 模式响应式通信框架 Netty，异步⾮阻塞模型）等技术开发，性能⾼于 Zuul，官⽅测试，**Spring Cloud GateWay 是 Zuul 的 1.6 倍**，旨在为微服务架构提供⼀种简单有效的统⼀的 API 路由管理⽅式。

Spring Cloud Gateway 可以与 Spring Cloud Discovery Client（如 Eureka）、Ribbon、Hystrix 等组件配合使用，**实现路由转发、负载均衡、熔断、鉴权、路径重写、⽇志监控等，并且 Gateway 还内置了限流过滤器，实现了限流的功能。**

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-71c6dfa6-dcf3-43ab-98bf-34d7ef588f02.png)

#### [#](#kong) Kong

Kong 是一款基于 OpenResty（Nginx + Lua 模块）编写的高可用、易扩展的，由 Mashape 公司开源的 API Gateway 项目。**Kong 是基于 NGINX 和 Apache Cassandra 或 PostgreSQL 构建的**，能提供易于使用的 RESTful API 来操作和配置 API 管理系统，所以它可以水平扩展多个 Kong 服务器，通过前置的负载均衡配置把请求均匀地分发到各个 Server，来应对大批量的网络请求。

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-e2113ab8-0fc2-4df5-91be-60154e557cc0.png)

Kong 主要有三个组件：

*   Kong Server ：基于 Nginx 的服务器，用来接收 API 请求。
*   Apache Cassandra/PostgreSQL ：用来存储操作数据。
*   Kong dashboard：官方推荐 UI 管理工具，也可以使用 restfull 方式管理 admin api。

Kong 采用插件机制进行功能定制，插件集（可以是 0 或 N 个）在 API 请求响应循环的生命周期中被执行。插件使用 Lua 编写，目前已有几个基础功能：**HTTP 基本认证、密钥认证、CORS（Cross-Origin Resource Sharing，跨域资源共享）、TCP、UDP、文件日志、API 请求限流、请求转发以及 Nginx 监控。**

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-c6c7c5e3-214b-472e-b998-8adc820aa922.png)

Kong 网关具有以下的特性：

*   可扩展性: 通过简单地添加更多的服务器，可以轻松地进行横向扩展，这意味着您的平台可以在一个较低负载的情况下处理任何请求；
*   模块化: 可以通过添加新的插件进行扩展，这些插件可以通过 RESTful Admin API 轻松配置；
*   在任何基础架构上运行: Kong 网关可以在任何地方都能运行。您可以在云或内部网络环境中部署 Kong，包括单个或多个数据中心设置，以及 public，private 或 invite-only APIs。

#### [#](#traefik) Traefik

Træfɪk 是一个为了让部署微服务更加便捷而诞生的现代 HTTP 反向代理、负载均衡工具。 它支持多种后台 (Docker, Swarm, Kubernetes, Marathon, Mesos, Consul, Etcd, Zookeeper, BoltDB, Rest API, file…) 来自动化、动态的应用它的配置文件设置。

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-553541d9-870d-45a8-8026-a1274d809e5e.png)

重要特性：

*   它非常快，无需安装其他依赖，通过 Go 语言编写的单一可执行文件；
*   **多种后台支持：Docker, Swarm, Kubernetes, Marathon, Mesos, Consul, Etcd；**
*   支持支持 Rest API、Websocket、HTTP/2、Docker 镜像；
*   监听后台变化进而自动化应用新的配置文件设置；
*   配置文件热更新，无需重启进程；
*   后端断路器、负载均衡、容错机制；
*   清爽的前端页面，可监控服务指标。

关于 Traefik 的更多内容，可以查看官网：[https://traefik.cn/open in new window](https://traefik.cn/)

### [#](#api网关对比) API 网关对比

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-ad51c257-fe2d-435d-a043-92a70957756e.png)

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-ae017d9d-db0d-4322-805e-5230189561f5.png)

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-daf82b5b-011d-488d-9d60-c1221bd5b0ec.png)

上面是网关对比截图，偷个懒，大家主要关注 Kong、Traefik 和 Zuul 即可：

*   从**开源社区活跃度**来看，无疑是 Kong 和 Traefik 较好；
*   从**成熟度**来看，较好的是 Kong、Tyk、Traefik；
*   从**性能**来看，Kong 要比其他几个领先一些；
*   从**架构优势**的扩展性来看，Kong、Tyk 有丰富的插件，Ambassador 也有插件但不多，而 Zuul 是完全需要自研，但 Zuul 由于与 Spring Cloud 深度集成，使用度也很高，近年来 Istio 服务网格的流行，Ambassador 因为能够和 Istio 无缝集成也是相当大的优势。

下面是其它网友的思考结论，可供参考：

*   **性能**：Nginx+Lua 形式必然是高于 Java 语言实现的网关的，Java 技术栈里面 Zuul1.0 是基于 Servlet 实现的，剩下都是基于 webflux 实现，性能是高于基于 Servlet 实现的。**在性能方面我觉得选择网关可能不算那么重要，多加几台机器就可以搞定。**
*   **可维护性和扩展性**：Nginx+Lua 这个组合掌握的人不算多，如果团队有大神，大佬们就随意了，当没看到这段话，对于一般团队来说的话，选择自己团队擅长的语言更重要。Java 技术栈下的 3 种网关，对于 Zuul 和 Spring Cloud Getway 需要或多或少要搞一些集成和配置页面来维护，但是对于 Soul 我就无脑看看文章，需要哪个搬哪个好了，尤其是可以无脑对接 Dubbo 美滋滋，此外 Soul2.0 以后版本可以摆脱 ZK，在我心里再无诟病，我就喜欢无脑操作。
*   **高可用**：对于网关高可用基本都是统一的策略都是采用多机器部署的方式，前面挂一个负载，对于而外需要用的一些组件大家注意一下。

[#](#基于traefik自研的微服务网关) 基于 Traefik 自研的微服务网关
-------------------------------------------

这个是我司自研的微服务网关，基于 Traefik 进行开发，下面从技术选型、网关框架、网关后台、协议转换进行讲解，绝对干货！

### [#](#技术栈选型) 技术栈选型

*   **Traefik**：一款开源的反向代理与负载均衡工具，它最大的优点是能够与常见的微服务系统直接整合，可以实现自动化动态配置。traefik 较为轻量，非常易于使用和设置，性能比较好，已在全球范围内用于生产环境。
*   **Etcd**：一个 Go 言编写的分布式、高可用的一致性键值存储系统，用于提供可靠的分布式键值存储、配置共享和服务发现等功能。
*   **Go**：并发能力强，性能媲美 C，处理能力是 PHP 的 4 倍，效率高，语法简单，易上手，开发效率接近 PHP。

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-3567ace8-c7f3-4b5d-bf0f-9bb85fa8c439.png)

### [#](#网关框架) 网关框架

整个网关框架分为 3 块：

*   **网关后台**（hal-fe 和 hal-admin）：用于应用、服务和插件的配置，然后将配置信息发布到 ETCD；
*   **Traefik**：读取 ETCD 配置，根据配置信息对请求进行路由分发，如果需要鉴权，会直接通过 hal-agent 模块进行统一鉴权。鉴权完毕后，如果是 Http 请求，直接打到下游服务，如果是 Grpc 和 Thrift 协议，会通过 hal-proxy 模块进行协议转换。
*   **协议转换模块**：读取 ETCD 配置，对 Traefik 分发过来的请求，进行 Grpc 和 Thrift 协议转换，并通过服务发现机制，获取服务下游机器，并通过负载均衡，将转换后的数据打到下游服务机器。

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-45943e5f-2cca-45ff-9fb0-908e3cf7c990.png)

### [#](#网关后台) 网关后台

主要由 3 大模块组成：

*   **应用**：主要包括应用名、域名、路径前缀、所属组、状态等，比如印度海外商城、印度社区；
*   **服务**：主要包括服务名、注册方式、协议类型、所属组、状态等，比如评论服务、地址服务、搜索服务。
*   **插件**：主要包括插件名称、插件类型、插件属性配置等，比如路径前缀替换插件、鉴权插件。

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-0b16b390-77b7-4fba-8529-7be31ba6335b.png)

**一个应用只能绑定一个服务，但是可以绑定多个插件。** 通过后台完成网关配置后，将这些配置信息生成 Config 文件，发布到 ETCD 中，Config 文件需要遵循严格的数据格式，比如 Traefix 配置需要遵循官方的文件配置格式，才能被 Traefik 识别。

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-299f8c95-d6a3-49d8-946d-5efed32faa29.png)

### [#](#协议转换模块) 协议转换模块

hal-proxy 模块是整个微服务网关最复杂，也是技术含量最高的模块，所以给大家详细讲解一下。

#### [#](#问题引入) 问题引入

在讲这个模块前，我们先看下面几个问题：

*   当请求从上游的 trafik 过来时，需要知道访问下游的机器 IP 和端口，才能将请求发送给下游，这些机器如何获取呢？
*   有了机器后，我们需要和下游机器建立连接，如果连接用一次就直接释放，肯定对服务会造成很大的压力，这就需要引入 Client 缓存池，那这个 Client 缓存池我们又该如何实现呢？
*   最后就是需要对协议进行转换，因为不同的下游服务，支持的协议类型是不一样的，这个网关又是如何动态支持的呢？

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-c2672067-0b21-41ba-807d-f59e0baf5b99.png)

#### [#](#实现原理) 实现原理

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-e7f9c956-cdf2-4238-aeb3-372c61c1532f.png)

我们还是先看一下 hal-proxy 内部有哪些模块，首先是 Resolver 模块，这个模块的是什么作用呢？这里我简单介绍一下，目前公司内部通过服务获取到机器列表的方式有多种，比如 MIS 平台、服务树等，也就是有的是通过平台配置的，有的是直接挂在服务树下，无论哪种方式，我们都通过服务名，通过一定的方式，找到该服务下面所有的主机。

**所以 Resolver 模块的作用，其实就是通过服务名，找到该服务下的所有机器的 IP 和服务端口，然后持久化到内存中，并定时更新。**

协议模块就是支持不同的协议转换，每个协议类型的转换，都需要单独实现，**这些协议转换，无非就是先通过机器 IP 和端口初始化 Client，然后再将数据进行转换后，直接发送到下游的机器。**

最后就是连接池，之前我们其实也用到 go 自带的 pool 来做，但是当对 pool 数据进行更新时，需要加锁，所以性能一直起不来，后来**改成了环形队列，然后对数据的操作全部通过原子操作方式，就实现了无锁操作，大大提高的并发性能。**

#### [#](#实现逻辑) 实现逻辑

这个是 hal-proxy 的逻辑实现图，画了 2 天，包含所有核心对象的交互方式，这里就不去细讲，能掌握多少，靠大家自己领悟，如果有任何疑问 (或者看不清图片)，可以关注我公众号，加我微信沟通。

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/microservice/api-wangguan-c79970c9-9fce-4164-a299-bb268b058924.png)

* * *

整理：沉默王二，戳[转载链接 open in new window](https://mp.weixin.qq.com/s/b2xf4GiJksBQqjHVpsh49Q)，作者：楼仔，戳[原文链接 open in new window](https://mp.weixin.qq.com/s/0Qupyl5eCyQGFEAIY6GxoQ)。

![](https://cdn.tobebetterjavaer.com/tobebetterjavaer/images/gongzhonghao.png)