Eagle

Go 微服务框架 · 轻量级 · 高性能 · 全链路可观测

HTTP
gRPC
Registry
Trace
Cache

一款轻量级的 Go 微服务框架，通过工具链快速构建支持 HTTP / gRPC 协议的 API 服务，内置配置、日志、监控、链路追踪、服务注册发现等微服务全套能力。

package main

import (
    "github.com/go-eagle/eagle"
)

func main() {
    e := eagle.New(
        eagle.WithHTTP(),
        eagle.WithGRPC(),
        eagle.WithRegistry(),
        eagle.WithTrace(),
        eagle.WithCache(),
    )
    e.Run()
}

微服务，开箱即用

Eagle 内置一整套生产级微服务组件，让你专注业务逻辑，而不是基础设施。

Config 配置

支持 YAML/TOML/JSON 等多种格式与配置热加载，无需重启即可生效。

Logger 日志

标准化日志接口，默认集成高性能 Zap，可灵活替换第三方日志库。

Transport 传输

同时支持 HTTP 与 gRPC，一个进程承载多种协议，按需启停。

API 定义

基于 Protobuf 统一定义接口，一键生成代码，前后端契约清晰。

Metrics 指标

统一指标接口，默认对接 Prometheus，覆盖延迟、吞吐、错误等黄金信号。

Tracing 链路追踪

遵循 OpenTelemetry 规范，完整还原跨服务调用链路，快速定位瓶颈。

Registry 注册发现

内置服务注册与发现，轻松构建可弹性伸缩的分布式微服务架构。

Cache 缓存

本地缓存（ristretto）与分布式缓存（Redis）开箱即用，加速数据访问。

分布式锁 / 定时任务

提供分布式锁与 Cronjob 定时任务能力，从容应对并发与调度场景。

三步上手

从零到第一个跑起来的微服务，只需要几分钟。

安装 CLI

使用 go install 安装 eagle 命令行工具（需 Go 1.16+）。

$go install github.com/go-eagle/eagle/cmd/eagle@latest

创建项目

一条命令生成默认包含 HTTP 与 gRPC 服务的项目骨架。

$eagle new eagle-demo

编译运行

进入项目目录，编译并启动你的微服务。

$make build && ./eagle-demo

查看项目布局模板 eagle-layout

清晰的分层架构

遵循 SOLID 设计原则的分层结构，关注点分离，易扩展、易测试、易维护。

深入了解项目结构

开始构建你的微服务

加入 Eagle 社区，用 Go 优雅地构建高性能、可扩展的微服务系统。

立即开始给个 Star

GitHub 仓库阅读文档示例项目（类 Instagram 社交 API）布局模板 eagle-layout

QQ 群：1074476202MIT 开源协议