panjf2000/ gnet

(v1.5.0) 3 months ago

reactor

non-blocking

golang

kqueue

event-loop

View on GitHub

Need help with gnet?

Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

panjf2000

Global Rank

#2,083

Topics of expertise

gorouti...

kqueue

worker-...

pool

gorouti...

non-blo...

event-l...

reactor

Location

none

5.3K Stars

611 Forks

Apache License 2.0

574 Commits

28 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

One time

$50.00

Email/Chat Support

Ask me anything

Coding not included

5 Support Hours

Developer Service

One time

$100.00

Email/Chat Support

Ask me anything

Coding support if needed

Bug Fix

Developer Service

One time

$50.00

Bug Fix

Fast resolution

Contact me before purchase

Need anything else?

Contributors list

Andy Pan

panjf2000

# 2,083

Shell

golang

Rust

Gin

554 commits

Dietoad

firedtoad

# 57,829

kqueue

golang

C++

Shell

3 commits

Guoyan Chen drinktee

# 135,678

kqueue

golang

prometh...

Kuberne...

1 commit

dudu hellodudu

# 161,837

Shell

golang

kqueue

reactor

1 commit

Henry Stanley henryaj

# 50,774

Shell

Jupyter...

CSS

kqueue

1 commit

Robin hihaha

# 214,815

kqueue

golang

reactor

1 commit

eruca eruca

# 38,103

ant-des...

React

query-l...

Chrome

1 commit

Roman rdmrcv

# 35,985

php-fra...

cython

Sass

Shell

1 commit

smart smartczy

# 22,827

Shell

golang

transla...

1 commit

0xflotus 0xflotus

# 2,236

autoit

socat

atom-pl...

1 commit

theoneLee theoneLee

# 192,307

golang

kqueue

reactor

HTML

1 commit

Readme

English | 🇨🇳中文

📖 Introduction

Name: gnet
Brand: gnet
SKU: //panjf2000/gnet
Rating: 4.481111111111111 (5330 reviews)

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.

🚀 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
```
and
```
Unix Domain Socket
```
[x] Supporting multiple load-balancing algorithms:
```
Round-Robin
```
,
```
Source-Addr-Hash
```
and
```
Least-Connections
```
[x] Supporting two event-driven mechanisms:
```
epoll
```
on Linux and
```
kqueue
```
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

gnet

is the runner-up.

This is the full framework ranking of Go and

gnet

tops all the other frameworks, which makes

gnet

the 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 CPU cores, AMD EPYC 7K62 48-Core Processor Memory : 16.0 GiB

Go version and settings

Go Version : go1.16.5 linux/amd64 GOMAXPROCS : 8

Benchmark parameters

TCP connections : 500/1000/5000/10000 Packet size : 512/1024/2048/4096/8192/16384/32768/65536 bytes Test duration : 15s

Echo benchmark

On MacOS (kqueue)

Test Environment

# Machine information OS : MacOS Big Sur/x86_64 CPU : 6 CPU cores, Intel(R) Core(TM) i7-9750H CPU @ 2.60GHz Memory : 16.0 GiB

Go version and settings

Go Version : go1.16.5 darwin/amd64 GOMAXPROCS : 12

Benchmark parameters

TCP connections : 300/400/500/600/700 Packet size : 512/1024/2048/4096/8192 bytes Test duration : 15s

Echo benchmark

🏛 Website

Please visit the official website for more details about architecture, usage and other information of

gnet

⚠️ License

Source code of

gnet

should be distributed under the Apache-2.0 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

🎡 User cases

The following companies/organizations use

gnet

as the underlying network service in production.

If you have

gnet

integrated into projects, feel free to open a pull request refreshing 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.