go-kratos--kratos/README.md

Note

本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

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

go install github.com/go-kratos/kratos/cmd/kratos/v3@latest
kratos upgrade

创建服务

kratos new helloworld
cd helloworld
go mod tidy
kratos run

服务启动后访问 http://localhost:8000/helloworld/kratos。

如果需要从 proto 开始生成服务代码：

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

使用示例

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 迁移指南
• 贡献指南

开发

make test
make lint

社区

• 文档站点
• 微信群
• Discord
• GitHub Discussions
• QQ 群：716486124

安全

如果你发现 Kratos 存在安全漏洞，请发送邮件到 go-kratos@googlegroups.com。安全问题会在公开披露前以私密方式处理。

贡献者

感谢所有为 Kratos 做出贡献的开发者。贡献流程请参考 Kratos 贡献指南。

致谢

以下项目对 Kratos 的设计有重要影响：

• go-kit/kit
• go-micro
• google/go-cloud
• go-zero
• beego

License

Kratos 基于 MIT license 开源。