rmarx/curl-http3

curl-http3镜像说明

镜像概述

本镜像提供了支持QUIC和HTTP/3协议的curl工具，基于BoringSSL和Cloudflare quiche编译，包含qlog日志、alt-svc发现等功能，适用于HTTP/3协议的测试与分析。源码地址：https://github.com/rmarx/curl-http3（2022年11月更新，支持最终版"h3" ALPN和qlog）。

核心功能

1. 支持HTTP/3协议的请求发送
2. 生成qlog格式日志（用于QUIC/HTTP3流量分析）
3. 支持alt-svc协议发现机制（模拟浏览器HTTP/3自动切换）
4. 集成tcpdump抓包工具，可导出TLS密钥用于流量解密

使用场景

• HTTP/3服务兼容性测试
• QUIC协议性能分析
• TLS加密流量的调试与解密
• 学习和验证HTTP/3协议特性

配置说明与示例

直接运行镜像

查看curl版本信息：

bash
docker run -it --rm docker.xuanyuan.run/rmarx/curl-http3 curl -V

强制使用HTTP/3访问网站：

bash
docker run -it --rm docker.xuanyuan.run/rmarx/curl-http3 curl -IL https://daniel.haxx.se --http3

启用qlog日志

qlog是QUIC/HTTP3专用的JSON日志格式，可通过QLOGDIR环境变量启用：

bash
# 挂载本地目录保存qlog文件
docker run --volume $(pwd)/qlogs:/srv -it --rm --env QLOGDIR=/srv docker.xuanyuan.run/rmarx/curl-http3 curl -IL https://daniel.haxx.se --http3

日志文件会保存到本地qlogs目录，可使用qvis.quictools.info分析。

测试alt-svc发现

通过alt-svc缓存文件模拟浏览器自动切换HTTP/3：

bash
docker run -it --rm docker.xuanyuan.run/rmarx/curl-http3 bash -c "curl -IL https://daniel.haxx.se --alt-svc as.store; curl -IL https://daniel.haxx.se --alt-svc as.store; cat as.store"

首次请求使用HTTP/1.1或HTTP/2，第二次会自动切换到HTTP/3。

导出数据包与TLS密钥

通过tcpdump抓包并导出TLS密钥，用于Wireshark解密：

bash
docker run -it --rm --volume $(pwd)/pcaps:/srv --env SSLKEYLOGFILE=/srv/tls_keys.txt docker.xuanyuan.run/rmarx/curl-http3 bash -c "tcpdump -w /srv/packets.pcap -i eth0 & sleep 1; curl -IL https://daniel.haxx.se --http3; sleep 2; pkill tcpdump; sleep 2"

抓包文件packets.pcap和密钥文件tls_keys.txt会保存到本地pcaps目录。在Wireshark中设置TLS密钥文件路径（Preferences > Protocols > TLS）即可解密流量。