ntap/quant

Quant 镜像文档

镜像概述

Quant是一个采用BSD许可的C11实现，基于IETF QUIC标准的新型UDP传输协议，旨在支持HTTP/3及其他应用协议。该镜像使用warpcore零拷贝用户空间UDP/IP栈，除标准Socket API外，还支持netmap快速包I/O框架、Particle和RIOT物联网栈，可运行于传统POSIX平台（Linux、MacOS、FreeBSD等）及嵌入式系统。

注意：Quant仅实现QUIC传输层，不包含HTTP/3绑定。
注意：Quant为研究项目，不建议用于生产环境。

核心功能和特性

• QUIC协议实现：遵循IETF QUIC标准，提供UDP之上的可靠传输能力
• 高效网络栈：集成warpcore零拷贝用户空间UDP/IP栈，优化网络性能
• 多框架支持：兼容Socket API、netmap、Particle IoT栈及RIOT操作系统
• 跨平台兼容：支持Linux、MacOS、FreeBSD等POSIX系统及嵌入式设备
• 依赖管理：自动构建picotls（TLS 1.3实现）、klib等依赖库
• 示例程序：提供客户端（client）和服务器（server）示例，支持基本QUIC通信测试

使用场景和适用范围

• QUIC协议研究与开发验证
• 嵌入式系统中QUIC协议的原型测试
• 高性能UDP网络应用的实验环境搭建
• 网络协议栈性能对比分析
• 非生产环境下的QUIC协议互操作性测试

使用方法和配置说明

Docker容器使用

拉取镜像

bash
docker pull docker.xuanyuan.run/ntap/quant:latest

运行容器

默认容器暴露UDP 4433端口，运行QUIC服务器，可提供/index.html及其他资源：

bash
docker run -p 4433:4433/udp docker.xuanyuan.run/ntap/quant

本地构建（可选）

依赖安装

• MacOS（需先安装Homebrew）：

  bash
  brew install cmake http-parser pkg-config
  xcode-select --install  # 必须安装Xcode命令行工具
  

• Debian/Ubuntu：

  bash
  apt install libssl-dev libhttp-parser-dev libbsd-dev pkgconf g++
  

构建步骤

bash
# 初始化子模块
git submodule update --init --recursive

# 调试版本构建
mkdir Debug && cd Debug
cmake ..
make

# 优化版本构建
mkdir Release && cd Release
cmake -DCMAKE_BUILD_TYPE=Release ..
make

测试与互操作性

构建完成后，lib目录下生成libquant库，bin目录包含client和server示例程序。通过-h参数查看使用说明：

bash
./bin/server -h  # 查看服务器使用帮助
./bin/client -h  # 查看客户端使用帮助

互操作性状态可参考https://docs.google.com/spreadsheets/d/1D0tW89vOoaScs3IY9RGC0UesWGAwE6xyLk0l4JtvTVg/edit#gid=***%E3%80%82

版权信息

Copyright (c) 2016-2020, NetApp, Inc. 保留所有权利。
采用BSD许可协议，详见https://github.com/NTAP/quant%E3%80%82

致谢

本软件曾获欧盟Horizon 2020研究与创新计划（2014-2018）资助（项目编号644866 "SSICLOPS"）。欧盟委员会不对本软件的任何使用负责。