panjf2000/ gnet
About the developer
3.7K Stars 
453 Forks 
MIT License 
479 Commits 
16 Opened issues 
Description
🚀 gnet is a high-performance, lightweight, non-blocking, event-driven networking framework written in pure Go./ gnet 是一个高性能、轻量级、非阻塞的事件驱动 Go 网络框架。
Services available
1 Support Hour
Developer Service
Email/Chat Support Ask me anything Coding not included 5 Support Hours
Developer Service Email/Chat Support Ask me anything Coding support if needed Bug Fix
Developer Service Bug Fix Fast resolution Contact me before purchase Need anything else?
Contributors list
English | 🇨🇳中文
📖 Introduction
gnetis 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
gnetachieve a much higher performance than Go net.
gnetis 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.
gnetsells 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
gnetfor building diversified network applications, for instance, you get an HTTP Server or Web Framework if you implement HTTP protocol upon
gnetwhile you have a Redis Server done with the implementation of Redis protocol upon
gnetand so on.
gnetderives from the project:
eviowhile having a much higher performance and more features.
🚀 Features
- [x] High-performance event-loop under networking model of multiple threads/goroutines
- [x] Built-in goroutine pool powered by the library ants
- [x] Built-in memory pool with bytes powered by the library bytebufferpool
- [x] Lock-free during the entire runtime
- [x] Concise and easy-to-use APIs
- [x] Efficient, reusable and scalable memory buffer: Ring-Buffer
- [x] Supporting multiple protocols/IPC mechanism:
TCP
,UDP
andUnix Domain Socket
- [x] Supporting multiple load-balancing algorithms:
Round-Robin
,Source-Addr-Hash
andLeast-Connections
- [x] Supporting two event-driven mechanisms:
epoll
on Linux andkqueue
on FreeBSD/DragonFly/Darwin - [x] Supporting asynchronous write operation
- [x] Flexible ticker event
- [x] SO_REUSEPORT socket option
- [x] 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
- [x] Supporting Windows platform with ~~event-driven mechanism of IOCP~~ Go stdlib: net
- [ ] Implementation of
gnet
Client
📊 Performance
Benchmarks on TechEmpower
# Hardware Environment 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 422 frameworks from all over the world where
gnetis the runner-up.
This is the full framework ranking of Go and
gnettops all the other frameworks, which makes
gnetthe fastest networking framework in Go.
To see the full ranking list, visit TechEmpower Plaintext Benchmark.
Contrasts to the similar networking libraries
On Linux (epoll)
Test Environment
# Machine information
OS : Ubuntu 20.04/x86_64
CPU : 8 processors, AMD EPYC 7K62 48-Core Processor
Memory : 16.0 GiB
Go version and settings
Go Version : go1.15.7 linux/amd64
GOMAXPROCS : 8
Netwokr settings
TCP connections : 300
Test duration : 30s
Echo Server
HTTP Server
On FreeBSD (kqueue)
Test Environment
# Machine information
OS : macOS Catalina 10.15.7/x86_64
CPU : 6-Core Intel Core i7
Memory : 16.0 GiB
Go version and configurations
Go Version : go1.15.7 darwin/amd64
GOMAXPROCS : 12
Netwokr settings
TCP connections : 100
Test duration : 20s
Echo Server
HTTP Server
🏛 Website
Please visit the official website for more details about architecture, usage and other information of
gnet.
⚠️ License
Source code in
gnetis available under the MIT License.
👏 Contributors
Please read the Contributing Guidelines before opening a PR and thank you to all the developers who already made contributions to
gnet!
⚓ Relevant Articles
- A Million WebSockets and Go
- Going Infinite, handling 1M websockets connections in Go
- Go netpoller 原生网络模型之源码全面揭秘
- gnet: 一个轻量级且高性能的 Golang 网络库
- 最快的 Go 网络框架 gnet 来啦！
- 字节跳动在 Go 网络库上的实践
🎡 User cases
The following companies/organizations use
gnetas the underlying network service in production.
If your project is also using
gnet, feel free to open a pull request to refresh this list of user cases.
💰 Backers
Support us with a monthly donation and help us continue our activities.
💎 Sponsors
Become a bronze sponsor with a monthly donation of $10 and get your logo on our README on Github.
☕️ Buy me a coffee
Please be sure to leave your name, Github account or other social media accounts when you donate by the following means so that I can add it to the list of donors as a token of my appreciation.
💴 Donors
💵 Paid Support
If you need a tailored version of
gnetand want the author to help develop it, or bug fix/fast resolution/consultation which takes a lot of effort, you can request paid support here.
🔑 JetBrains OS licenses
gnethad been being developed with
GoLandIDE under the free JetBrains Open Source license(s) granted by JetBrains s.r.o., hence I would like to express my thanks here.
🔋 Sponsorship
This project is supported by:
