Neqo，使用Rust编写的QUIC实现

运行测试HTTP/3程序（neqo-client和neqo-server）

• cargobuild
• ./target/debug/neqo-server '[::]:12345' --db./test-fixture/db
• ./target/debug/neqo-clienthttp://127.0.0.1:12345/

如果在运行时出现“无法加载动态库”错误，请执行以下操作

export LD_LIBRARY_PATH="$(dirname "$(find . -name libssl3.so -print | head -1)")"

在macOS上，执行以下操作

export DYLD_LIBRARY_PATH="$(dirname "$(find . -name libssl3.dylib -print | head -1)")"

使用独立的NSS/NSPR加速构建

您可以将NSS (https://hg.mozilla.org/projects/nss) 和 NSPR (https://hg.mozilla.org/projects/nspr) 克隆到同一目录中，并导出一个名为 NSS_DIR 的环境变量，指向NSS。这将导致构建使用现有的NSS检查结果。但是，为了运行依赖于NSS的任何内容，您需要将 $\[DY]LD\_LIBRARY\_PATH 设置为指向 $NSS_DIR/../dist/Debug/lib。

注意：如果您没有单独编译NSS，则需要安装mercurial (hg)。NSS构建需要gyp和ninja（或ninja-build）。

调试Neqo

QUIC日志记录

使用以下方式启用QLOG

$ mkdir "$logdir"
$ ./target/debug/neqo-server '[::]:12345' --db ./test-fixture/db --qlog-dir "$logdir"
$ ./target/debug/neqo-client 'https://[::]:12345/' --qlog-dir "$logdir"

您可以使用https://qvis.quictools.info/ 通过上传QLOG文件并可视化流量。

使用SSLKEYLOGFILE解密Wireshark日志

信息在此处

待办：需要什么最低的 Wireshark 版本？待办：上述链接可能不正确，协议现在称为 TLS 而不是 SSL？

有效使用 RUST_LOG

如 env_logger 文档 所述，环境变量 RUST_LOG 可以用于选择性地启用 Rust 代码的日志消息。这适用于 Neqo 的命令行工具，以及 Neqo 集成到 Gecko 的情况，尽管 Gecko 需要以调试模式构建。

一些示例

1. RUST_LOG=neqo_transport::dump ./mach run 仅列出发送和接收的 QUIC 数据包及其帧的内容。
2. RUST_LOG=neqo_transport=debug,neqo_http3=trace,info ./mach run 为传输设置 'debug' 日志级别，为 http3 设置 'trace' 级别，并为所有其他 Rust crate（包括 Neqo 和 Gecko 使用的其他 crate）设置 'info' 日志级别。
3. RUST_LOG=neqo=trace,error ./mach run 为以 "neqo" 开头的所有模块设置 trace 级别，并将 error 设置为其他无关 Rust 日志消息的最小日志级别。

在 Gecko 中尝试开发中的 Neqo 代码

在检出的 Gecko 源代码副本中，将四个 Neqo crate 的值设置为主目录 Cargo.toml 中的本地版本。例如，如果 Neqo 检出到 /home/alice/git/neqo，请将以下行添加到主目录的 Cargo.toml。

[patch."https://github.com/mozilla/neqo"]
neqo-http3 = { path = "/home/alice/git/neqo/neqo-http3" }
neqo-transport = { path = "/home/alice/git/neqo/neqo-transport" }
neqo-common = { path = "/home/alice/git/neqo/neqo-common" }
neqo-qpack = { path = "/home/alice/git/neqo/neqo-qpack" }
neqo-crypto = { path = "/home/alice/git/neqo/neqo-crypto" }

然后运行以下命令

./mach vendor rust

使用 ./mach build 正常编译 Gecko。

注意：如果 Neqo 代码有变化，使用较新的 Neqo 代码与 Gecko 一起使用可能也需要更改（可能是对 neqo_glue 的更改）。