Gateway/English

Gateway 是一个基于HTTP协议的restful的API网关。可以作为统一的API接入层。

教程

如果你是一个初学者，那么这个详细的教程非常适合你。现在只有英文版本。

注意

请确保你的Go版本是在1.10或者之上。用1.10之前版本的Go编译时会出现undefined "math/rand".Shuffle错误。StackOverFlow链接

Features

• 流量控制(Server或API级别)
• 熔断(Server或API级别)
• 负载均衡
• 服务发现
• 插件机制
• 路由(分流，复制流量)
• API 聚合
• API 参数校验
• API 访问控制（黑白名单）
• API 默认返回值
• API 定制返回值
• API 结果Cache
• JWT Authorization
• API Metric导入Prometheus
• API 失败重试
• 后端server的健康检查
• 开放管理API(GRPC、Restful)
• 支持websocket
• 支持在线迁移数据

Docker

以下内容要求对docker基本操作有一定了解，可以看这本书，或者直接看官方文档。

快速开始

使用 docker pull fagongzi/gateway 命令下载Docker镜像, 使用 docker run -d -p 9093:9093 -p 80:80 -p 9092:9092 fagongzi/gateway 运行镜像. 镜像启动后export 3个端口:

• 80

  Proxy的http端口，这个端口就是直接为终端用户服务的

• 9092

  APIServer的对外GRPC的端口

• 9093

  APIServer的对外HTTP Restful的端口，访问 http://127.0.0.1:9093/ui/index.html访问WEBUI

通过设置以下环境变量可以改变运行参数，参数相同时配置参数将会覆盖默认参数

• GW_PROXY_OPTS

  支持proxy --help中的所有参数；

• API_SERVER_OPTS

  支持apiserver --help中的所有参数；

• ETCD_OPTS

  支持etcd --help中的所有参数；

可用的docker镜像

• fagongzi/gateway

  镜像是一个quickstart镜像，包含了3个组件：etcd,proxy,apiserver， 仅限于快速体验，不能使用在生产

• fagongzi/proxy

  proxy组件，生产可用

• fagongzi/apiserver

  apiserver组件，生产可用

架构

WebUI

可用的Gateway的WebUI的项目：

• 官方
• gateway_ui
• gateway_admin_ui

组件

Gateway由proxy, apiserver组成

Proxy

Proxy是Gateway对终端用户提供服务的组件，Proxy是一个无状态的节点，可以部署多个来支撑更大的流量，更多。

ApiServer

ApiServer对外提供GRPC和Restful来管理元信息，ApiServer同时集成了官方的WebUI，更多。

Gateway中的概念

Server

Server是一个真实的后端服务，更多。

Cluster

Cluster是一个逻辑概念，它由一组提供相同服务的Server组成。会依据负载均衡策略选择一个可用的Server，更多。

API

API是Gateway的核心概念，我们可以在Gateway的中维护对外的API，以及API的分发规则，聚合规则以及URL匹配规则，更多。

Routing

Routing是一个路由策略，根据HTTP Request中的Cookie，Querystring、Header、Path中的一些信息把流量分发到或者复制到指定的Cluster，通过这个功能，我们可以实现AB Test和线上引流，更多。

参与开发

更多

交流方式-微信

赞助

开源不易，如果这个项目对你有帮助，你可以请我喝一杯，谢谢！

微信

支付宝