Hertz

English | 中文

Hertz[həːts] 是一个 Golang 微服务 HTTP 框架，在设计之初参考了其他开源框架 fasthttp、gin、echo 的优势，并结合字节跳动内部的需求，使其具有高易用性、高性能、高扩展性等特点，目前在字节跳动内部已广泛使用。如今越来越多的微服务选择使用 Golang，如果对微服务性能有要求，又希望框架能够充分满足内部的可定制化需求，Hertz 会是一个不错的选择。

框架特点

• 高易用性

  在开发过程中，快速写出来正确的代码往往是更重要的。因此，在 Hertz 在迭代过程中，积极听取用户意见，持续打磨框架，希望为用户提供一个更好的使用体验，帮助用户更快的写出正确的代码。

• 高性能

  Hertz 默认使用自研的高性能网络库 Netpoll，在一些特殊场景相较于 go net，Hertz 在 QPS、时延上均具有一定优势。关于性能数据，可参考下图 Echo 数据。 关于详细的性能数据，可参考 hertz-benchmark。

• 高扩展性

  Hertz 采用了分层设计，提供了较多的接口以及默认的扩展实现，用户也可以自行扩展。同时得益于框架的分层设计，框架的扩展性也会大很多。目前仅将稳定的能力开源给社区，更多的规划参考 RoadMap。

• 多协议支持

  Hertz 框架原生提供 HTTP1.1、ALPN 协议支持。除此之外，由于分层设计，Hertz 甚至支持自定义构建协议解析逻辑，以满足协议层扩展的任意需求。

• 网络层切换能力

  Hertz 实现了 Netpoll 和 Golang 原生网络库 间按需切换能力，用户可以针对不同的场景选择合适的网络库，同时也支持以插件的方式为 Hertz 扩展网络库实现。

详细文档

快速开始

Example

Hertz-Examples 仓库提供了开箱即用的代码，详见。

用户指南

基本特性

包含通用中间件的介绍和使用，上下文选择，数据绑定，数据渲染，直连访问，日志，错误处理，详见文档

治理特性

包含 trace monitor，详见文档

框架扩展

包含网络库扩展，详见文档

参考

apidoc、框架可配置项一览，详见文档

FAQ

常见问题排查，详见文档

框架性能

性能测试只能提供相对参考，工业场景下，有诸多因素可以影响实际的性能表现 我们提供了 hertz-benchmark 项目用来长期追踪和比较 Hertz 与其他框架在不同情况下的性能数据以供参考

相关项目

• Netpoll: 自研高性能网络库，Hertz 默认集成
• Hertz-Contrib: Hertz 扩展仓库，提供中间件、tracer 等能力
• Example: Hertz 使用例子

相关文章

• 字节跳动在 Go 网络库上的实践

贡献代码

Contributing

RoadMap

Hertz RoadMap

开源许可

Hertz 基于Apache License 2.0 许可证，其依赖的三方组件的开源许可见 Licenses。

联系我们

• Email: conduct@cloudwego.io

• 如何成为 member: COMMUNITY MEMBERSHIP

• Issues: Issues

• 飞书用户群（注册飞书进群）

  

• 微信: CloudWeGo community

  

Landscapes

  

CloudWeGo 丰富了 CNCF 云原生生态。