Kong API 网关落地指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/api-gateway-deployment-guide
技能介绍
先解决什么问题
很多团队在微服务膨胀后都会遇到同一个麻烦:每个服务都要自己写一遍鉴权、限流和日志,重复代码遍地开花,还容易漏掉边界条件。结果就是认证逻辑不一致,限流规则各说各话,排查问题时要在多个服务里翻日志,效率极低。API 网关的价值就在于把这些横切关注点收敛到入口层,让业务服务只关心业务本身。
技能如何工作
这套指南提炼自 Kong 开源网关的核心能力,主要覆盖四块:
- 路由:按
path或host将请求转发到对应后端,服务无需感知流量入口。 - 认证:统一支持
JWT、Key、OAuth等方案,业务服务不再各自实现鉴权。 - 限流:在入口层做速率限制,保护后端不被突发流量打垮。
- 可观测:提供全链路日志和指标,快速定位是哪个服务、哪个插件出了问题。
落地时建议分三步走:
- 先上「路由 + 认证」,确保所有请求都经过网关,这是最基础的收口。
- 再加限流和基础监控,给核心服务兜底,防止雪崩。
- 需要灰度、WAF 等高级能力时,通过插件按需开启,不盲目全开。
适用边界与注意点
网关自身不能成为单点故障。生产环境必须多节点部署,做好负载均衡。配置要版本化管理,变更需要评审——一次误配可能影响全站流量。密钥和证书要集中托管并定期轮换,别让它们散落在各个服务的配置文件里。对于同时承载传统 API 和 AI 服务的场景,网关还能作为统一入口,方便做调用审计和成本归因,这对混合架构的企业很实用。
使用场景
- 微服务项目要上线,团队需要在入口统一配置 JWT 认证和基于路径的请求路由,避免每个服务各写一份鉴权逻辑。
- 后端服务经常被突发流量打垮,工程师要在 Kong 网关层配置限流规则,保护核心 API 不被刷量拖垮。
- 混合架构中同时跑传统 API 和 AI 服务,架构师需要通过网关统一收口,实现调用审计和成本归因。
- 线上请求出现异常,运维要在网关侧排查全链路日志和指标,快速定位是哪个后端服务或插件出了问题。
适合人员
- 负责微服务架构的后端工程师,希望把认证、限流等横切能力从业务代码中剥离,减少重复实现。
- 管理线上服务稳定性的 SRE 或运维工程师,需要在入口层统一配置限流和监控,防止突发流量导致雪崩。
- 同时交付传统 API 和 AI 服务的团队负责人,需要通过网关统一收口来做调用审计和成本控制。
- 正在评估或已在使用 Kong 网关的技术决策者,需要参考分阶段落地步骤和生产环境注意事项。