lnicco/mvfst-qns

mvfst+proxygen Docker镜像文档

镜像概述

本镜像集成了mvfst（***的QUIC协议实现）和proxygen（***的HTTP/2及QUIC协议栈），专门用于与quic-network-simulator配合，提供QUIC协议的网络模拟测试环境，支持QUIC应用的开发、验证及性能评估。

核心功能和特性

• 集成关键组件：包含mvfst（***开源的QUIC协议实现，支持QUIC标准及扩展）和proxygen（***的HTTP框架，支持HTTP/2和QUIC协议）
• 模拟器适配：预配置用于quic-network-simulator，可直接集成到QUIC网络模拟环境
• 轻量部署：优化镜像大小，便于快速下载和部署，缩短测试环境搭建时间
• 协议支持：全面支持QUIC协议核心功能，兼容主流QUIC标准

使用场景和适用范围

• QUIC协议的网络模拟测试
• QUIC应用的开发与功能验证
• 网络条件（如延迟、丢包、带宽限制）对QUIC性能影响的评估
• 与quic-network-simulator配合搭建可控的QUIC网络测试环境

使用方法和配置说明

基本使用

拉取镜像

bash
docker pull [镜像仓库地址]/mvfst-proxygen:latest

运行容器

bash
docker run --rm --network=quic-network-simulator_default mvfst-proxygen:latest

与quic-network-simulator集成

1. 按照quic-network-simulator文档搭建基础模拟网络环境
2. 在模拟器环境中，将本镜像作为QUIC客户端或服务器节点运行：

   bash
   # 作为服务器运行示例
   docker run --name quic-server --network=quic-network-simulator_default -d mvfst-proxygen:latest proxygen_server --port=4433
   
   # 作为客户端运行示例
   docker run --name quic-client --network=quic-network-simulator_default mvfst-proxygen:latest mvfst_client --server=quic-server:4433
   

配置说明

环境变量

• QUIC_LOG_LEVEL：控制QUIC协议日志级别，可选值：debug、info、warn、error（默认：info）
• PROXYGEN_PORT：指定proxygen服务端口（默认：4433）
• MVFST_CONN_TIMEOUT：mvfst连接超时时间（单位：秒，默认：30）

配置文件挂载

如需自定义配置，可通过挂载配置文件到容器内：

bash
docker run --rm -v /local/config:/etc/mvfst-proxygen mvfst-proxygen:latest

注意事项

• 需确保与quic-network-simulator使用相同的Docker网络
• 详细的命令参数和配置选项可通过容器内执行 proxygen_server --help 或 mvfst_client --help 查看