go-kratos/kratos

go-kratos/kratos has 26,021 GitHub stars and 4,181 forks. GitHot measured +2 stars in 24 hours, +10 in 7 days, and +27 in 15 days. Last checked 2026-11-11 01:08 UTC. Last push 2026-11-01.

이 수치를 측정하는 방법

클라우드 네이티브 시대를 위한 최고의 Go 마이크로서비스 프레임워크.

26,021 스타 4,181 forks +2 in 24h

What you can do

API-first development with Protobuf and generated HTTP/gRPC code.
Unified transport layer for HTTP and gRPC.
Composable middleware for recovery, logging, validation, tracing, metrics, auth, and more.
Pluggable registry, configuration, and encoding components.

측정된 스타 증가

in 24h: +2
in 7 days: +10
in 15 days: +27
in 1 month: 업데이트 지연

서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.

README.md

Original

Translations: English | 简体中文

Kratos

Kratos is a lightweight Go framework for building cloud-native microservices. It provides small, explicit APIs for transport, middleware, registry, configuration, logging, encoding, and code generation so applications can focus on business logic.

Features

API-first development with Protobuf and generated HTTP/gRPC code.
Unified transport layer for HTTP and gRPC.
Composable middleware for recovery, logging, validation, tracing, metrics, auth, and more.
Pluggable registry, configuration, and encoding components.
Standard-library log/slog based logging with OpenTelemetry extensions in contrib packages.
Consistent metadata, errors, validation, OpenAPI, and code-generation workflows.
A contrib ecosystem for optional integrations such as registries, config stores, middleware, encodings, and observability.

Installation

Requirements

Go 1.25 or later
protoc
protoc-gen-go

Install the CLI

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

Create a Service

kratos new helloworld
cd helloworld
go mod tidy
kratos run

Visit http://localhost:8000/helloworld/kratos after the service starts.

For a fuller generated service flow:

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

Usage Example

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 Migration

Kratos v3 reduces core dependencies and makes previously implicit behavior explicit. Review the v2 to v3 migration guide before upgrading production services.

Development

make test
make lint

Community

Security

If you discover a security vulnerability in Kratos, please contact [email protected]. Security reports are handled privately before disclosure.

Contributors

Thank you for contributing to Kratos. The contribution guide is available in the Kratos documentation.

Acknowledgments

The following projects influenced Kratos design:

License

Kratos is open-sourced software licensed under the MIT license.