English | 🇨🇳中文

gnet is an event-driven networking framework that is fast and lightweight. It makes direct epoll and kqueue syscalls rather than using the standard Go net package and works in a similar manner as netty and libuv, which makes gnet achieve a much higher performance than Go net.

gnet is not designed to displace the standard Go net package, but to create a networking server framework for Go that performs on par with Redis and Haproxy for networking packets handling.

gnet sells itself as a high-performance, lightweight, non-blocking, event-driven networking framework written in pure Go which works on transport layer with TCP/UDP protocols and Unix Domain Socket , so it allows developers to implement their own protocols(HTTP, RPC, WebSocket, Redis, etc.) of application layer upon gnet for building diversified network applications, for instance, you get an HTTP Server or Web Framework if you implement HTTP protocol upon gnet while you have a Redis Server done with the implementation of Redis protocol upon gnet and so on.

gnet derives from the project: evio while having a much higher performance and more features.

• High-performance event-loop under networking model of multiple threads/goroutines
• Built-in goroutine pool powered by the library ants
• Built-in memory pool with bytes powered by the library bytebufferpool
• Lock-free during the entire life cycle
• Concise APIs
• Efficient memory usage: Ring-Buffer
• Supporting multiple protocols/IPC mechanism: TCP, UDP and Unix Domain Socket
• Supporting multiple load-balancing algorithms: Round-Robin, Source Addr Hash and Least-Connections
• Supporting two event-driven mechanisms: epoll on Linux and kqueue on FreeBSD/DragonFly/Darwin
• Supporting asynchronous write operation
• Flexible ticker event
• SO_REUSEPORT socket option
• Built-in multiple codecs to encode/decode network frames into/from TCP stream: LineBasedFrameCodec, DelimiterBasedFrameCodec, FixedLengthFrameCodec and LengthFieldBasedFrameCodec, referencing netty codec, also supporting customized codecs
• Supporting Windows platform with event-driven mechanism of IOCP Go stdlib: net
• Implementation of gnet Client

• Multiple Reactors
• Multiple Reactors + Goroutine Pool

• Reusable and auto-scaling Ring Buffer

gnet requires Go 1.9 or later.

go get -u github.com/panjf2000/gnet

gnet is available as a Go module, with Go 1.11 Modules support (Go 1.11+), just simply import "github.com/panjf2000/gnet" in your source code and go [build|run|test] will download the necessary dependencies automatically.

• What is Gnet?

# Hardware
CPU: 28 HT Cores Intel(R) Xeon(R) Gold 5120 CPU @ 2.20GHz
Mem: 32GB RAM
OS : Ubuntu 18.04.3 4.15.0-88-generic #88-Ubuntu
Net: Switched 10-gigabit ethernet
Go : go1.14.x linux/amd64

This is the top 50 on the framework ranking of all programming languages consists of a total of 382 frameworks from all over the world.

This is the full framework ranking of Golang.

To see the full ranking list, visit Full ranking list of Plaintext.

# Machine information
        OS : Ubuntu 18.04/x86_64
       CPU : 8 Virtual CPUs
    Memory : 16.0 GiB

# Go version and configurations
Go Version : go1.12.9 linux/amd64
GOMAXPROCS=8

# Machine information
        OS : macOS Mojave 10.14.6/x86_64
       CPU : 4 CPUs
    Memory : 8.0 GiB

# Go version and configurations
Go Version : go version go1.12.9 darwin/amd64
GOMAXPROCS=4

For more details about gnet, go Presenting Gnet.

Source code in gnet is available under the MIT License.

Please read the Contributing Guidelines before opening a PR and thank you to all the developers who already made contributions to gnet!

• evio
• netty
• ants
• go_reuseport
• bytebufferpool
• goframe
• ringbuffer

• A Million WebSockets and Go
• Going Infinite, handling 1M websockets connections in Go
• Go netpoll I/O 多路复用构建原生网络模型之源码深度解析
• gnet: 一个轻量级且高性能的 Golang 网络库
• 最快的 Go 网络框架 gnet 来啦！
• 字节跳动在 Go 网络库上的实践

Please feel free to add your projects here~~

gnet had been being developed with GoLand IDE under the free JetBrains Open Source license(s) granted by JetBrains s.r.o., hence I would like to express my thanks here.

Support us with a monthly donation and help us continue our activities.

Become a bronze sponsor with a monthly donation of $10 and get your logo on our README on Github.