# gazelle

**Repository Path**: openeuler/gazelle

## Basic Information

- **Project Name**: gazelle
- **Description**: A high performance user-mode stack, which powered by dpdk and lwip
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 121
- **Forks**: 108
- **Created**: 2022-02-17
- **Last Updated**: 2025-09-05

## Categories & Tags

**Categories**: web-dev-toolkits

**Tags**: sig-high-performance-network

## README

<img src="doc/images/logo.png"> 

# 用户态协议栈Gazelle

[简体中文](README.md) | [English](README_en.md)

## 简介

Gazelle是一款高性能用户态协议栈。它基于DPDK在用户态直接读写网卡报文，共享大页内存传递报文，使用轻量级LwIP协议栈。能够大幅提高应用的网络I/O吞吐能力。专注于数据库网络性能加速，如MySQL、redis等。兼顾高性能与通用性：
- 高性能  
报文零拷贝，无锁，灵活scale-out，自适应调度。
- 通用性  
完全兼容POSIX，零修改，适用不同类型的应用。  

## 性能效果
### mysql 8.0.20
<img src="doc/images/mysql_kernel.png"> 
<img src="doc/images/mysql_gazelle.png"> 

使用内核协议栈跑分为54.84万，使用Gazelle跑分为66.85万，Gazelle提升20%+  

### ceph 14.2.8
<img src="doc/images/ceph_client_testdata.png"> 

4k整机场景，Gazelle提升20%+  


## 详情 
可点击标题跳转，欢迎投递文章、提意见。
| 主题 | 内容简介 | 发布时间 |
|:---|:-----|:---|
|[openEuler指南](https://gitee.com/openeuler/community/blob/master/zh/contributors/README.md)| 如何参与openEuler社区 | 已发布 |
|[Gazelle用户指南](doc/zh/user-guide.md)| 1. 安装、部署环境、启动应用程序<br>2. 配置参数说明<br>3. 调测命令说明<br>4. 使用约束、风险、注意事项|已发布|
|[Gazelle开发者指南](doc/zh/programmer-guide.md)| 1. 技术原理<br>2. 架构设计| 待定 |
|[实践系列-Gazelle加速mysql 20%](doc/zh/%E5%AE%9E%E8%B7%B5%E7%B3%BB%E5%88%97-Gazelle%E5%8A%A0%E9%80%9Fmysql.md)|1. 详细测试步骤<br>2. 性能效果|已发布|
|[实践系列-Gazelle加速ceph client 20%](https://www.hikunpeng.com/document/detail/zh/kunpengcpfs/basicAccelFeatures/storageAccel/kunpengcpfs_hpcd_0002.html)|1. 详细测试步骤<br>2. 性能效果|已发布|
|[实践系列-Gazelle加速redis](doc/zh/redis.md) |1. 详细测试步骤<br>2. 性能效果| 已发布 |
|实践系列-Gazelle加速openGauss |1. 详细测试步骤<br>2. 性能效果| 待定 |
|[实践系列-Gazelle支持netperf性能测试](doc/zh/netperf.md)| 1.版本说明 <br>2. 详细测试步骤| 待定 |

## 特性变更
- [多进程模式即将下线](doc/zh/releasenote.md)

## 支持列表
- [posix接口列表及应用支持列表](doc/zh/support.md)

## FAQ
- [如何使用pdump工具抓包](doc/zh/pdump.md) 
- [多进程各自独立使用网卡](doc/zh/multiple-nic.md)

## 路标
TODO

## 联系方式
[订阅邮件列表](https://mailweb.openeuler.org/postorius/lists/high-performance-network.openeuler.org/)  
[历史邮件](https://mailweb.openeuler.org/hyperkitty/list/high-performance-network@openeuler.org/)  
[SIG首页](https://gitee.com/openeuler/community/tree/master/sig/sig-high-performance-network)