This is a private fork. To use, clone this repository as $GOPATH/github.com/lucas-clemente/quic-go
and perform the following additional setup locally:
git remote add upstream git@github.com:lucas-clemente/quic-go.git
git remote set-url --push upstream DISABLE
To take upstream changes (into master for example):
** Make sure to push a tag with the current master before executing a rebase to preserve any references pointed at the current commit.
git fetch upstream
git tag snapshot_<version>
git push origin --tags
git rebase upstream/master
...
Help! I rebased and now something is complaining about a commit that doesn't exist!
You may still have the commit locally, just check it out, tag it and push the tag to the origin. If you don't have it locally github likely still has it and you can use the api to create a branch or tag using the commit hash. See https://stackoverflow.com/questions/10098095/git-can-i-view-the-reflog-of-a-remote
If including this fork in a project using go modules, specify the following to use version X.Y.Z
replace github.com/lucas-clemente/quic-go => github.com/getlantern/quic-go vX.Y.Z
This fork allows certain customizations and exposes some internal details that are necessary for lantern/oquic development but may not be fully in spec with QUIC or are not currently justifiable/understood needs upstream.
These include things like:
- making it possible to exclude SNI information
- exposing internal bandwidth estimates from congestion control algorithms
- making the quic packet size externally customizable
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.
We currently support Go 1.18.x and Go 1.19.x.
Running tests:
go test ./...
Take a look at this echo example.
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)See the example client. Use a http3.RoundTripper as a Transport in a http.Client.
http.Client{
Transport: &http3.RoundTripper{},
}| 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. |  |
| YoMo | Streaming Serverless Framework for Geo-distributed System |  |
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.