Kratos 官方不提供网关组件,因其设计哲学聚焦微服务内部治理(如注册发现、熔断限流),而将入口流量调度明确划归外部统一网关;它仅提供HTTP/gRPC传输层,不具备跨服务路由、协议转换等网关能力。

Kratos 没有内置 API 网关,它本身是微服务框架,不是网关;想用 Kratos 做网关,得自己基于 http.Server 或 grpc.Server 手动实现反向代理逻辑,或者外挂成熟网关(如 Kong、APISIX)。
为什么 Kratos 官方不提供网关组件?
Kratos 的设计哲学是「专注微服务内部治理」:服务注册发现、熔断限流、链路追踪、配置中心都内置了,但入口流量调度(即网关职责)被明确划为边界外——它假设你已有统一入口层。官方示例里所有 http.NewServer 都直接暴露服务,没封装路由分发逻辑。
常见误判是把 kratos transport/http 当成网关:它只是 HTTP 传输层,不具备跨服务路由、鉴权聚合、协议转换等网关能力。
- 如果你只有一两个服务,且不需要灰度、AB 测试、JWT 统一校验,可以直接用 Kratos 启一个
http.Server+gin或echo做轻量路由层 - 如果要支持多租户、插件化鉴权、WebSocket 透传、gRPC-JSON 转换,必须引入独立网关
- Kratos 的
middleware只作用于本服务内请求,无法跨服务注入或修改下游请求头
用 Kratos 自建简易 HTTP 网关的关键步骤
适合测试环境或极简场景,核心是复用 Kratos 的 http.Server 和中间件机制,手动实现反向代理。
- 用
net/http/httputil.NewSingleHostReverseProxy构建基础代理,注意设置Director修改req.URL和Host头 - 在
http.Server的Middleware中做统一鉴权(比如解析X-Auth-Token并调用用户中心UserClient.GetUser) - 避免直接用
transport/http.NewServer的默认路由注册方式——它会把所有 handler 绑定到根路径,应改用http.ServeMux或gorilla/mux手动注册proxyHandler - 务必重写
FlushInterval和Transport,否则长连接、流式响应(如 SSE)会超时或阻塞
示例片段:
proxy := httputil.NewSingleHostReverseProxy(&url.URL{Scheme: "http", Host: "127.0.0.1:8001"})
proxy.Transport = &http.Transport{...} // 设置 idle timeout 和 max idle conns
mux := http.NewServeMux()
mux.Handle("/api/user/", proxy) // 注意末尾斜杠,影响路径重写
server := http.Server{
Addr: ":8000",
Handler: mux,
}
和 APISIX/Kong 配合时 Kratos 服务怎么改?
这是生产推荐方案:APISIX 做七层路由与插件治理,Kratos 服务退为纯后端,只需暴露标准 HTTP/gRPC 接口,不做任何网关逻辑。
- Kratos 服务禁用所有对外网关相关中间件(比如自定义的
gateway.Auth),只保留服务内熔断、日志、metric - APISIX 的
upstream直接指向 Kratos 服务的http.Address(如10.10.1.5:9000),不要走服务发现(Kratos 的discovery是给客户端用的,APISIX 不兼容) - 若需 gRPC 支持,APISIX 开启
grpc-web插件,Kratos 的grpc.Server必须启用grpc.WithKeepaliveParams,否则空闲连接会被 APISIX 断开 - APISIX 的
jwt-auth插件生成的X-Jwt-Claim-Uid,需在 Kratos 的http.Servermiddleware 中从 header 读取,而非解析 token
真正麻烦的不是配 Kratos,而是厘清「谁该处理什么」:路由规则、证书卸载、WAF 规则、流控粒度(全局 vs 单服务)这些必须由网关层承接,Kratos 再强也不该越界。很多线上问题,根源是把鉴权逻辑一半放 APISIX、一半放 Kratos,导致 header 传递遗漏或重复校验。


















