选择一个QUIC代码源

下面的说明是用来基于chromium代码库编译QUIC代码。在Chrome支持的任何平台上，这里的说明都能保证是有效的，遇到问题时可以查看一些扩展的故障排查的文档。如果你不想checking out整个chrome，你可以尝试github上快速而干净的proto-quic库。这是chrome代码的一份克隆，但剔除了大多数不必要的依赖，因而它可以快得多的check out并编译，但不一定扩展了完整的chrome平台集，因而你选择的平台有可能无法编译。

编译QUIC 客户端和服务器

Chromium中提供了一个示例客户端和服务器实现。要使用这些东西，你首先应该已经checked out Chromium的源代码，然后构建二进制文件：

ninja -C out/Debug quic_server quic_client

从www.example.org准备测试数据

下载一份www.example.org的拷贝，它主要是使用quic_server来提供本地服务的：

1mkdir /tmp/quic-data
2cd /tmp/quic-data
3wget -p --save-headers https://www.example.org

这里主要是要下载一个html文件，且保存文件的所有的HTTP header，当然也可以从其它的站点下载这个文件。

手动地编辑index.html，并调整如下的headers：

移除(如果存在的话)："Transfer-Encoding: chunked"
移除(如果存在的话)："Alternate-Protocol: ..."
添加：X-Original-Url: https://www.example.org/

生成证书

为了运行服务器，你需要一个有效的证书，及一个pkcs8格式的私有key。如果你没有，则你可以使用一些脚本来产生它们：

1cd net/tools/quic/certs
2./generate-certs.sh
3cd -

除了服务器的证书及public key，这个脚本也会产生一个CA证书 (net/tools/quic/certs/out/2048-sha256-root.pem)，你需要把它添加到你的操作系统的根证书商店以便于在证书验证期间它被信任。要在linux上完成这一点，请参考这些说明。

如果遗漏了这里的添加CA证书的步骤的话，后面在执行quic_client的时候会报出如下的证书验证错误：

1$ ./out/Default/quic_client --host=127.0.0.1 --port=80 https://www.example.org/
2[1008/164047:ERROR:cert_verify_proc_nss.cc(942)] CERT_PKIXVerifyCert for www.example.org failed err=-8179
3[1008/164047:WARNING:proof_verifier_chromium.cc(466)] Failed to verify certificate chain: net::ERR_CERT_AUTHORITY_INVALID
4Failed to connect to 127.0.0.1:80. Error: QUIC_PROOF_INVALID

运行QUIC服务器和客户端

运行quic_server：

1./out/Default/quic_server \
2  --quic_in_memory_cache_dir=/tmp/quic-data/www.example.org \
3  --certificate_file=net/tools/quic/certs/out/leaf_cert.pem \
4  --key_file=net/tools/quic/certs/out/leaf_cert.pkcs8

运行quic_server还可以通过--port参数指定监听的端口，及--v参数指定输出更多信息，如：

./out/Default/quic_server --certificate_file=/media/data/osprojects/proto-quic/src/net/tools/quic/certs/out/leaf_cert.pem --key_file=/media/data/osprojects/proto-quic/src/net/tools/quic/certs/out/leaf_cert.pkcs8 --quic_in_memory_cache_dir=/home/hanpfei0306/quic-data/www.example.com --port=32457 --v=1

然后你就可以成功地使用quic_client以QUIC协议请求文件了：

./out/Default/quic_client --host=127.0.0.1 --port=32457 https://www.example.org/

注意，如果你让服务器的端口默认为32457，则你必须指定客户端的端口，因为它默认是80。此外，如果你的本地机器有多个loopback地址 (由于它同时使用IPv4 和 IPv6)，你不得不选定一个地址。目前还不确定后面的缺点是不是一个bug。

注意：client和server都主要是为了做集成测试的：它们都不能大规模使用。

要使用chrome来测试相同的下载过程，

1chromium-browser \
2  --user-data-dir=/tmp/chrome-profile \
3  --no-proxy-server \
4  --enable-quic \
5  --origin-to-force-quic-on=www.example.org:443 \
6  --host-resolver-rules='MAP www.example.org:443 127.0.0.1:32457' \
7  https://www.example.org

故障排查

如果你在运行时遇到了问题，则可以以--v=1参数运行服务器或客户端。它将提升日志的verbosity，更多的日志常常可以帮助暴露底层的问题。

原文

Playing with QUIC