065d8355c5
|
||
|---|---|---|
| .. | ||
| internal | ||
| logging | ||
| quicvarint | ||
| .gitignore | ||
| .golangci.yml | ||
| Changelog.md | ||
| LICENSE | ||
| README.md | ||
| buffer_pool.go | ||
| client.go | ||
| closed_conn.go | ||
| codecov.yml | ||
| config.go | ||
| conn_id_generator.go | ||
| conn_id_manager.go | ||
| connection.go | ||
| crypto_stream.go | ||
| crypto_stream_manager.go | ||
| datagram_queue.go | ||
| errors.go | ||
| frame_sorter.go | ||
| framer.go | ||
| interface.go | ||
| mockgen.go | ||
| mockgen_private.sh | ||
| 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_generic_helper.go | ||
| streams_map_incoming_bidi.go | ||
| streams_map_incoming_generic.go | ||
| streams_map_incoming_uni.go | ||
| streams_map_outgoing_bidi.go | ||
| streams_map_outgoing_generic.go | ||
| streams_map_outgoing_uni.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 | ||
| 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. It has support for HTTP/3 RFC 9114.
In addition 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.16.x, Go 1.17.x, and Go 1.18.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 |
|---|---|---|
| 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 |  |
| go-ipfs | IPFS implementation in go |  |
| syncthing | Open Source Continuous File Synchronization |  |
| traefik | The Cloud Native Application Proxy |  |
| v2ray-core | A platform for building proxies to bypass network restrictions |  |
| cloudflared | A tunneling daemon that proxies traffic from the Cloudflare network to your origins |  |
| OONI Probe | The Open Observatory of Network Interference (OONI) aims to empower decentralized efforts in documenting Internet censorship around the world. |  |
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.