A QUIC implementation in pure Go

May 5, 2023 ยท View on GitHub

PkgGoDev Travis Build Status CircleCI Build Status Windows Build Status Code Coverage

quic-go is an implementation of the QUIC protocol, RFC 9000 protocol in Go. In addition to RFC 9000, 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 and Go 1.17.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

ProjectDescriptionStars
algernonSmall self-contained pure-Go web server with Lua, Markdown, HTTP/2, QUIC, Redis and PostgreSQL supportGitHub Repo stars
caddyFast, multi-platform web server with automatic HTTPSGitHub Repo stars
go-ipfsIPFS implementation in goGitHub Repo stars
nextdnsNextDNS CLI client (DoH Proxy)GitHub Repo stars
syncthingOpen Source Continuous File SynchronizationGitHub Repo stars
traefikThe Cloud Native Application ProxyGitHub Repo stars
v2ray-coreA platform for building proxies to bypass network restrictionsGitHub Repo stars

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.