uquic/README.md

A QUIC server implementation in pure Go

This is very much an incomplete, buggy, unperformant and insecure work in progress :)

Features

Done:

• Basic protocol with support for QUIC version 30, 31 and 32
• HTTP/2 support
• Crypto (RSA for signing, curve25519 for KEX, chacha20-poly1305 as cipher)
• Basic loss detection (currently only fast retransmission) & retransmission
• Flow Control when sending
• Congestion control using cubic

Major TODOs:

• Security, especially DOS protections
• Performance
• Better packet loss detection
• Support for QUIC versions 33 & 34
• Flow Control when receiving
• Some special cases
• Better error handling
• Connection migration
• Public API cleanup
• QUIC client
• Integration into caddy (mostly to figure out the right server API)

Guides

Installing deps:

go get -t

Running tests:

go test ./...

Running the example server:

go run example/main.go -www /var/www/

Using the quic_client from chromium:

quic_client --quic-version=32 --host=127.0.0.1 --port=6121 --v=1 https://quic.clemente.io

Using Chrome:

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --user-data-dir=/tmp/chrome --no-proxy-server --enable-quic --origin-to-force-quic-on=quic.clemente.io:443 --host-resolver-rules='MAP quic.clemente.io:443 127.0.0.1:6121' https://quic.clemente.io

Usage

See the example server or our fork of caddy. Starting a QUIC server is very similar to the standard lib http in go:

http.Handle("/", http.FileServer(http.Dir(wwwDir)))

server, _ := h2quic.NewServer(tlsConfig)

server.ListenAndServe("localhost:4242", nil /* use http.DefaultServeMux */)