Agent Skills
返回列表
💻

Kong API 网关落地指南

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/api-gateway-deployment-guide

技能介绍

先解决什么问题

很多团队在微服务膨胀后都会遇到同一个麻烦:每个服务都要自己写一遍鉴权、限流和日志,重复代码遍地开花,还容易漏掉边界条件。结果就是认证逻辑不一致,限流规则各说各话,排查问题时要在多个服务里翻日志,效率极低。API 网关的价值就在于把这些横切关注点收敛到入口层,让业务服务只关心业务本身。

技能如何工作

这套指南提炼自 Kong 开源网关的核心能力,主要覆盖四块:

  • 路由:按 path 或 host 将请求转发到对应后端,服务无需感知流量入口。
  • 认证:统一支持 JWT、Key、OAuth 等方案,业务服务不再各自实现鉴权。
  • 限流:在入口层做速率限制,保护后端不被突发流量打垮。
  • 可观测:提供全链路日志和指标,快速定位是哪个服务、哪个插件出了问题。

落地时建议分三步走:

  1. 先上「路由 + 认证」,确保所有请求都经过网关,这是最基础的收口。
  2. 再加限流和基础监控,给核心服务兜底,防止雪崩。
  3. 需要灰度、WAF 等高级能力时,通过插件按需开启,不盲目全开。

适用边界与注意点

网关自身不能成为单点故障。生产环境必须多节点部署,做好负载均衡。配置要版本化管理,变更需要评审——一次误配可能影响全站流量。密钥和证书要集中托管并定期轮换,别让它们散落在各个服务的配置文件里。对于同时承载传统 API 和 AI 服务的场景,网关还能作为统一入口,方便做调用审计和成本归因,这对混合架构的企业很实用。

使用场景

  • 微服务项目要上线,团队需要在入口统一配置 JWT 认证和基于路径的请求路由,避免每个服务各写一份鉴权逻辑。
  • 后端服务经常被突发流量打垮,工程师要在 Kong 网关层配置限流规则,保护核心 API 不被刷量拖垮。
  • 混合架构中同时跑传统 API 和 AI 服务,架构师需要通过网关统一收口,实现调用审计和成本归因。
  • 线上请求出现异常,运维要在网关侧排查全链路日志和指标,快速定位是哪个后端服务或插件出了问题。

适合人员

  • 负责微服务架构的后端工程师,希望把认证、限流等横切能力从业务代码中剥离,减少重复实现。
  • 管理线上服务稳定性的 SRE 或运维工程师,需要在入口层统一配置限流和监控,防止突发流量导致雪崩。
  • 同时交付传统 API 和 AI 服务的团队负责人,需要通过网关统一收口来做调用审计和成本控制。
  • 正在评估或已在使用 Kong 网关的技术决策者,需要参考分阶段落地步骤和生产环境注意事项。