9426b60308
The lucas-clemente/quic-go package moved namespaces and our branch went stale, this new fork provides support for the new quic-go repo and applies the max datagram frame size change. Until the max datagram frame size support gets upstreamed into quic-go, this can be used to unblock go 1.20 support as the old lucas-clemente/quic-go will not get go 1.20 support. |
||
|---|---|---|
| .. | ||
| internal | ||
| logging | ||
| quicvarint | ||
| .gitignore | ||
| .golangci.yml | ||
| Changelog.md | ||
| LICENSE | ||
| README.md | ||
| SECURITY.md | ||
| buffer_pool.go | ||
| client.go | ||
| closed_conn.go | ||
| codecov.yml | ||
| config.go | ||
| conn_id_generator.go | ||
| conn_id_manager.go | ||
| connection.go | ||
| connection_timer.go | ||
| crypto_stream.go | ||
| crypto_stream_manager.go | ||
| datagram_queue.go | ||
| errors.go | ||
| frame_sorter.go | ||
| framer.go | ||
| interface.go | ||
| mockgen.go | ||
| mtu_discoverer.go | ||
| multiplexer.go | ||
| packet_handler_map.go | ||
| packet_packer.go | ||
| packet_unpacker.go | ||
| receive_stream.go | ||
| retransmission_queue.go | ||
| send_conn.go | ||
| send_queue.go | ||
| send_stream.go | ||
| server.go | ||
| stream.go | ||
| streams_map.go | ||
| streams_map_incoming.go | ||
| streams_map_outgoing.go | ||
| sys_conn.go | ||
| sys_conn_df.go | ||
| sys_conn_df_linux.go | ||
| sys_conn_df_windows.go | ||
| sys_conn_helper_darwin.go | ||
| sys_conn_helper_freebsd.go | ||
| sys_conn_helper_linux.go | ||
| sys_conn_no_oob.go | ||
| sys_conn_oob.go | ||
| sys_conn_windows.go | ||
| token_store.go | ||
| tools.go | ||
| transport.go | ||
| window_update_queue.go | ||
README.md
A QUIC implementation in pure Go
quic-go is an implementation of the QUIC protocol (RFC 9000, RFC 9001, RFC 9002) in Go, including the Unreliable Datagram Extension (RFC 9221) and Datagram Packetization Layer Path MTU Discovery (DPLPMTUD, RFC 8899). It has support for HTTP/3 (RFC 9114), including QPACK (RFC 9204).
In addition to the RFCs listed above, it currently implements the IETF QUIC draft-29. Support for draft-29 will eventually be dropped, as it is phased out of the ecosystem.
Guides
We currently support Go 1.19.x and Go 1.20.x
Running tests:
go test ./...
QUIC without HTTP/3
Take a look at this echo example.
Usage
As a server
See the example server. Starting a QUIC server is very similar to the standard lib http in go:
http.Handle("/", http.FileServer(http.Dir(wwwDir)))
http3.ListenAndServeQUIC("localhost:4242", "/path/to/cert/chain.pem", "/path/to/privkey.pem", nil)
As a client
See the example client. Use a http3.RoundTripper as a Transport in a http.Client.
http.Client{
Transport: &http3.RoundTripper{},
}
Projects using quic-go
| Project | Description | Stars |
|---|---|---|
| AdGuardHome | Free and open source, powerful network-wide ads & trackers blocking DNS server. |  |
| algernon | Small self-contained pure-Go web server with Lua, Markdown, HTTP/2, QUIC, Redis and PostgreSQL support |  |
| caddy | Fast, multi-platform web server with automatic HTTPS |  |
| cloudflared | A tunneling daemon that proxies traffic from the Cloudflare network to your origins |  |
| go-libp2p | libp2p implementation in Go, powering Kubo (IPFS) and Lotus (Filecoin), among others |  |
| Mercure | An open, easy, fast, reliable and battery-efficient solution for real-time communications |  |
| OONI Probe | Next generation OONI Probe. Library and CLI tool. |  |
| syncthing | Open Source Continuous File Synchronization |  |
| traefik | The Cloud Native Application Proxy |  |
| v2ray-core | A platform for building proxies to bypass network restrictions |  |
| YoMo | Streaming Serverless Framework for Geo-distributed System |  |
Contributing
We are always happy to welcome new contributors! We have a number of self-contained issues that are suitable for first-time contributors, they are tagged with help wanted. If you have any questions, please feel free to reach out by opening an issue or leaving a comment.