go-kratos /kratos
Your ultimate Go microservices framework for the cloud-native era.
★ 26,030⑂ 4,179👁 433⑃ 2,570● 1,284▤ 73
+0
日增长
+21
周增长
+55
月增长
26,030
stars
4,179
forks
433
watchers
2,570
prs
1,284
issues
73
releases
README
Translations: English | 简体中文
Kratos
Kratos 是一套轻量级 Go 微服务框架,围绕传输、Middleware、注册发现、配置、日志、编码和代码生成提供清晰的基础能力,让业务代码保持聚焦。
功能特性
- 以 Protobuf 为中心定义 API,并生成 HTTP/gRPC 代码。
- 统一的 Transport 抽象,支持 HTTP 和 gRPC。
- 可组合的 Middleware,覆盖 Recovery、Logging、Validation、Tracing、Metrics、Auth 等场景。
- 插件化的 Registry、Config 和 Encoding 能力。
- 基于标准库 log/slog 的日志能力,OpenTelemetry 扩展由 contrib 包提供。
- 统一的 Metadata、Errors、Validation、OpenAPI 和代码生成工作流。
- contrib 生态提供注册中心、配置中心、Middleware、编码和可观测性等可选集成。
安装
环境要求
- Go 1.25 或更高版本
- protoc
- protoc-gen-go
安装 CLI
shell
go install github.com/go-kratos/kratos/cmd/kratos/v3@latest
kratos upgrade
创建服务
shell
kratos new helloworld
cd helloworld
go mod tidy
kratos run
服务启动后访问 http://localhost:8000/helloworld/kratos。
如果需要从 proto 开始生成服务代码:
shell
kratos proto add api/helloworld/helloworld.proto
kratos proto client api/helloworld/helloworld.proto
kratos proto server api/helloworld/helloworld.proto -t internal/service
go generate ./...
kratos run
使用示例
go
package main
import (
"github.com/go-kratos/kratos/v3"
"github.com/go-kratos/kratos/v3/transport/grpc"
"github.com/go-kratos/kratos/v3/transport/http"
)
func main() {
httpSrv := http.NewServer(http.Address(":8000"))
grpcSrv := grpc.NewServer(grpc.Address(":9000"))
app := kratos.New(
kratos.Name("helloworld"),
kratos.Version("v1.0.0"),
kratos.Server(httpSrv, grpcSrv),
)
if err := app.Run(); err != nil {
panic(err)
}
}
v3 迁移
Kratos v3 进一步降低核心依赖,并将历史上隐式的行为显式化。升级生产服务前请先阅读 v2 到 v3 迁移指南。
扩展阅读
- 文档
- 示例
- 项目模板
- v2 到 v3 迁移指南
- 贡献指南
开发
shell
make test
make lint
社区
- 文档站点
- 微信群
- Discord
- GitHub Discussions
- QQ 群:716486124
安全
如果你发现 Kratos 存在安全漏洞,请发送邮件到 [email protected]。安全问题会在公开披露前以私密方式处理。
贡献者
感谢所有为 Kratos 做出贡献的开发者。贡献流程请参考 Kratos 贡献指南。
致谢
以下项目对 Kratos 的设计有重要影响:
- go-kit/kit
- go-micro
- google/go-cloud
- go-zero
- beego
License
Kratos 基于 MIT license 开源。Top issues
#969用户案例 | Who's using Kratos?47 comments · 2021-05-30#3868Kratos 命令行工具创建的模板与自身版本不匹配8 comments · 2026-08-07#3857在发送 grpc 请求时 header 无法支持数组5 comments · 2026-07-27#3815http server Bind errors bypass middleware chain (logging/tracing/recovery not executed)4 comments · 2026-04-20#3859kratos V3使用kratos-admin模板创建项目,启动web之后在用kratos run运行服务会一直报错3 comments · 2026-07-28#3861v3版本registry的nacos sdk v2.3.5, config的nacos sdk v1.1.62 comments · 2026-07-29#3854protobuf slice bounds out of range panic2 comments · 2026-07-19#3842kratos v3 `transport/grpc.NewClient` nil pointer panic2 comments · 2026-06-17
Discussions
#3763Audit logging in microservices0 comments · 2025-12-02#3750Discussion: How to handle path variables with different text names and json_name tags in EncodeURL1 comments · 2025-11-20#3726關於 grpc client 30 分鐘后會自動關閉地址更新的問題,1 comments · 2025-09-15#3518项目在windows环境下执行make api 会有提示格式错误1 comments · 2025-01-19#3488http.Server配置了http.Timeout选项,为什么请求接口的时间超过了设定的时间,不回返回请求超时错误1 comments · 2024-12-15#3453Goland波浪线错误提示1 comments · 2024-10-29#3423使用NewFilter日志不会输出该行的行号,怎么解决??1 comments · 2024-09-14#3419github.com/go-kratos/kratos/v2/metrics1 comments · 2024-09-12
Latest release
v3.0.0 v3.0.0 2026-06-26Breaking Changes - break: update kratos modules to v3 (3822) New Features - feat(errors): add standard library errors wrappers (3844) - feat(transport/http): add read/write deadline control to ServerStream (3843) - feat(protoc-gen-go-http): support google.api.HttpBody response (3839) - feat(config): add generic config Get support (3778) - feat(middleware/auth/jwt): add WithParserOptions to allow configuring… (3803) - feat: support pre condition failed code mapping (3795) - feat(cmd): add --repo flag to kratos new command (3789) - feat(errors): add TooManyRequests error type (3787)