QUIC linux编译

一、源码下载

Chromium 源码本身非常大，加之国内由于墙的存在，导致源码的下载难上加难。因此，本文直接使用文章：如何下载Google Chromium源码提供的源码，百度网盘下载链接：https://pan.baidu.com/s/1UCi4blsdGrqHQRRIcYnW6w ，提取码：s4yr。
链接中包含8个 chromium.tar.gz* 文件和1个 depot_tools.tar.gz，前者即为 Chromium 分片后的源码，后者为 Google 代码管理工具包。

chromium.tar.gz* 下载完毕后，需要先合并，再解压：

cat chromium.tar.gz* >> chromium.tar.gz

链接中所使用的的 QUIC 版本号为 46（非 Chromium 的版本号），具体可以查看文件：chromium/src/net/third_party/quic/core/quic_versions.cc：

二、depot_tools 配置

将 depot_tools 根目录添加至 PATH：

export PATH=$PATH:/path/to/depot_tools

三、安装所需的依赖项

cd chromium/src
build/install-build-deps.sh

四、编译 quic-sever / quic-client 工程

4.1、配置编译参数

使用如下命令，生成编译参数配置脚本文件：

cd chromium/src
gn args out/Default

命令执行后，会新建文件：out/Default/args.gn，并进入文本编辑模式。若对编译配置无特殊要求，则可直接保存退出。
退出之后，编译系统会根据 args.gn 自动生成ninja文件。

若后续需修改编译参数，则在编辑 args.gn 后，执行如下命令，即可重新生成 ninja 文件。

gn gen out/Default

4.2、编译

使用如下命令编译quic_server / quic_client模块：

ninja -C out/Default quic_server quic_client

编译成功后，out/Default 目录下回生成 quic_server 和 quic_client 可执行文件。

4.3、基于HTTP封装的 QUIC 协议测试

本文测试方案，是根据文档：Playing with QUIC 来展开的。

4.3.1、测试数据准备

由于工作使用的开发环境位于内网，因此需首先在外网准备好测试数据。Win10终端执行如下命令：

./wget -p --save-headers https://www.example.org

命令执行完毕后，会在当前目录下生成一个文件夹：www.example.org，其中只包含一个名为 index.html 的文件。

修改 index.html，删掉标签：“doctype html”，并新增行：

X-Original-Url: https://www.example.org/

在内网新建目录：/tmp/quic-data，并将前一步修改后的整个 www.example.org 目录拷贝到 /tmp/quic-data 目录下。

4.3.2、生成秘钥

apt install libnss3-toolscd chromium/src/net/tools/quic/certs
./generate-certs.sh

4.3.3、测试

运行 quic_server：

cd chromium/src./out/Default/quic_server --quic_response_cache_dir=/tmp/quic-data/www.example.org --certificate_file=net/tools/quic/certs/out/leaf_cert.pem --key_file=net/tools/quic/certs/out/leaf_cert.pkcs8

运行 quic_client：

cd chromium/src./out/Default/quic_client  --host=127.0.0.1 --port=6121 https://www.example.org/

若无异常，则 quic_client 执行后，会输出如下命令：

注意：
quic_server 的默认监听端口为 6121，quic_client 的默认请求端口为 80，两者均可通过选项 “–port=监听/请求端口号” 进行个性化配置。

4.3.4、故障排查

若命令quic_server 或 quic_client在执行过程中出现异常，则可通过增加运行参数“–v=1”，来打印详细调试日志信息。

4.4、模拟 SOCKET 的 QUIC 数据接发

若要模拟 SOCKET 的 QUIC 数据接发，则可借助 Quartc 相关的测试用例。（Quartc 无需配置SSL加密证书）

4.4.1、编译 net_unittests

cd chromium/srcninja -C out/Default/ net_unittests