2019-07-22 00:48:58 +03:00
|
|
|
# HTTP3 (and QUIC)
|
|
|
|
|
|
|
|
## Resources
|
|
|
|
|
|
|
|
[HTTP/3 Explained](https://daniel.haxx.se/http3-explained/) - the online free
|
|
|
|
book describing the protocols involved.
|
|
|
|
|
|
|
|
[QUIC implementation](https://github.com/curl/curl/wiki/QUIC-implementation) -
|
|
|
|
the wiki page describing the plan for how to support QUIC and HTTP/3 in curl
|
|
|
|
and libcurl.
|
|
|
|
|
|
|
|
[quicwg.org](https://quicwg.org/) - home of the official protocol drafts
|
|
|
|
|
|
|
|
## QUIC libraries
|
|
|
|
|
2019-12-06 14:56:14 +03:00
|
|
|
QUIC libraries we're experimenting with:
|
2019-07-22 00:48:58 +03:00
|
|
|
|
|
|
|
[ngtcp2](https://github.com/ngtcp2/ngtcp2)
|
|
|
|
|
|
|
|
[quiche](https://github.com/cloudflare/quiche)
|
|
|
|
|
|
|
|
## Experimental!
|
|
|
|
|
2019-08-06 15:44:30 +03:00
|
|
|
HTTP/3 and QUIC support in curl is considered **EXPERIMENTAL** until further
|
|
|
|
notice. It needs to be enabled at build-time.
|
2019-07-22 00:48:58 +03:00
|
|
|
|
2019-08-06 15:44:30 +03:00
|
|
|
Further development and tweaking of the HTTP/3 support in curl will happen in
|
|
|
|
in the master branch using pull-requests, just like ordinary changes.
|
2019-07-22 00:48:58 +03:00
|
|
|
|
|
|
|
# ngtcp2 version
|
|
|
|
|
2020-03-26 00:49:02 +03:00
|
|
|
## Build with OpenSSL
|
2019-07-22 00:48:58 +03:00
|
|
|
|
2019-08-11 00:19:55 +03:00
|
|
|
Build (patched) OpenSSL
|
|
|
|
|
2020-08-27 14:14:19 +03:00
|
|
|
% git clone --depth 1 -b OpenSSL_1_1_1g-quic-draft-29 https://github.com/tatsuhiro-t/openssl
|
2019-08-11 00:19:55 +03:00
|
|
|
% cd openssl
|
|
|
|
% ./config enable-tls1_3 --prefix=<somewhere1>
|
|
|
|
% make
|
|
|
|
% make install_sw
|
|
|
|
|
|
|
|
Build nghttp3
|
|
|
|
|
|
|
|
% cd ..
|
|
|
|
% git clone https://github.com/ngtcp2/nghttp3
|
|
|
|
% cd nghttp3
|
|
|
|
% autoreconf -i
|
|
|
|
% ./configure --prefix=<somewhere2> --enable-lib-only
|
|
|
|
% make
|
|
|
|
% make install
|
|
|
|
|
|
|
|
Build ngtcp2
|
|
|
|
|
|
|
|
% cd ..
|
2019-09-21 16:46:30 +03:00
|
|
|
% git clone https://github.com/ngtcp2/ngtcp2
|
2019-08-11 00:19:55 +03:00
|
|
|
% cd ngtcp2
|
|
|
|
% autoreconf -i
|
2020-11-20 08:10:49 +03:00
|
|
|
% ./configure PKG_CONFIG_PATH=<somewhere1>/lib/pkgconfig:<somewhere2>/lib/pkgconfig LDFLAGS="-Wl,-rpath,<somewhere1>/lib" --prefix=<somewhere3> --enable-lib-only
|
2019-08-11 00:19:55 +03:00
|
|
|
% make
|
|
|
|
% make install
|
|
|
|
|
|
|
|
Build curl
|
|
|
|
|
|
|
|
% cd ..
|
|
|
|
% git clone https://github.com/curl/curl
|
|
|
|
% cd curl
|
|
|
|
% ./buildconf
|
2021-04-13 19:11:43 +03:00
|
|
|
% LDFLAGS="-Wl,-rpath,<somewhere1>/lib" ./configure --with-openssl=<somewhere1> --with-nghttp3=<somewhere2> --with-ngtcp2=<somewhere3>
|
2019-08-11 00:19:55 +03:00
|
|
|
% make
|
2019-07-22 00:48:58 +03:00
|
|
|
|
2020-03-26 00:49:02 +03:00
|
|
|
## Build with GnuTLS
|
|
|
|
|
2020-11-20 08:10:49 +03:00
|
|
|
Build GnuTLS
|
2020-03-26 00:49:02 +03:00
|
|
|
|
2020-11-20 08:10:49 +03:00
|
|
|
% git clone --depth 1 https://gitlab.com/gnutls/gnutls.git
|
2020-03-26 00:49:02 +03:00
|
|
|
% cd gnutls
|
|
|
|
% ./bootstrap
|
|
|
|
% ./configure --disable-doc --prefix=<somewhere1>
|
|
|
|
% make
|
|
|
|
% make install
|
|
|
|
|
|
|
|
Build nghttp3
|
|
|
|
|
|
|
|
% cd ..
|
|
|
|
% git clone https://github.com/ngtcp2/nghttp3
|
|
|
|
% cd nghttp3
|
|
|
|
% autoreconf -i
|
|
|
|
% ./configure --prefix=<somewhere2> --enable-lib-only
|
|
|
|
% make
|
|
|
|
% make install
|
|
|
|
|
|
|
|
Build ngtcp2
|
|
|
|
|
|
|
|
% cd ..
|
|
|
|
% git clone https://github.com/ngtcp2/ngtcp2
|
|
|
|
% cd ngtcp2
|
|
|
|
% autoreconf -i
|
2021-04-07 04:45:01 +03:00
|
|
|
% ./configure PKG_CONFIG_PATH=<somewhere1>/lib/pkgconfig:<somewhere2>/lib/pkgconfig LDFLAGS="-Wl,-rpath,<somewhere1>/lib" --prefix=<somewhere3> --enable-lib-only --with-gnutls
|
2020-03-26 00:49:02 +03:00
|
|
|
% make
|
|
|
|
% make install
|
|
|
|
|
|
|
|
Build curl
|
|
|
|
|
|
|
|
% cd ..
|
|
|
|
% git clone https://github.com/curl/curl
|
|
|
|
% cd curl
|
|
|
|
% ./buildconf
|
2021-04-13 19:11:43 +03:00
|
|
|
% ./configure --without-openssl --with-gnutls=<somewhere1> --with-nghttp3=<somewhere2> --with-ngtcp2=<somewhere3>
|
2020-03-26 00:49:02 +03:00
|
|
|
% make
|
|
|
|
|
2019-07-22 00:48:58 +03:00
|
|
|
# quiche version
|
|
|
|
|
|
|
|
## build
|
|
|
|
|
2020-05-10 17:53:00 +03:00
|
|
|
Build quiche and BoringSSL:
|
2019-08-10 08:57:04 +03:00
|
|
|
|
2019-08-12 21:40:32 +03:00
|
|
|
% git clone --recursive https://github.com/cloudflare/quiche
|
2020-06-04 20:18:00 +03:00
|
|
|
% cd quiche
|
2021-02-01 16:13:12 +03:00
|
|
|
% cargo build --release --features ffi,pkg-config-meta,qlog
|
2020-07-17 00:31:21 +03:00
|
|
|
% mkdir deps/boringssl/src/lib
|
|
|
|
% ln -vnf $(find target/release -name libcrypto.a -o -name libssl.a) deps/boringssl/src/lib/
|
2019-07-22 00:48:58 +03:00
|
|
|
|
2020-02-05 02:25:12 +03:00
|
|
|
Build curl:
|
2019-07-22 00:48:58 +03:00
|
|
|
|
|
|
|
% cd ..
|
|
|
|
% git clone https://github.com/curl/curl
|
2019-08-10 08:57:04 +03:00
|
|
|
% cd curl
|
2019-07-22 00:48:58 +03:00
|
|
|
% ./buildconf
|
2021-04-13 19:11:43 +03:00
|
|
|
% ./configure LDFLAGS="-Wl,-rpath,$PWD/../quiche/target/release" --with-openssl=$PWD/../quiche/deps/boringssl/src --with-quiche=$PWD/../quiche/target/release
|
2019-09-23 21:56:48 +03:00
|
|
|
% make
|
2019-07-22 00:48:58 +03:00
|
|
|
|
2019-09-26 15:17:09 +03:00
|
|
|
## Run
|
|
|
|
|
|
|
|
Use HTTP/3 directly:
|
|
|
|
|
2021-04-26 05:29:10 +03:00
|
|
|
curl --http3 https://nghttp2.org:4433/
|
2019-07-22 00:48:58 +03:00
|
|
|
|
2019-09-26 15:17:09 +03:00
|
|
|
Upgrade via Alt-Svc:
|
2019-07-22 00:48:58 +03:00
|
|
|
|
2019-09-26 15:17:09 +03:00
|
|
|
curl --alt-svc altsvc.cache https://quic.aiortc.org/
|
2019-09-26 14:18:17 +03:00
|
|
|
|
|
|
|
See this [list of public HTTP/3 servers](https://bagder.github.io/HTTP3-test/)
|