A QUIC implementation in pure Go

quic-go is an implementation of the QUIC protocol in Go. It implements the IETF QUIC draft-29.

Version compatibility

Since quic-go is under active development, there's no guarantee that two builds of different commits are interoperable. The QUIC version used in the master branch is just a placeholder, and should not be considered stable.

If you want to use quic-go as a library in other projects, please consider using a tagged release. These releases expose experimental QUIC versions, which are guaranteed to be stable.

Guides

We currently support Go 1.14+, with Go modules support enabled.

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{},
}

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.

Name		Name	Last commit message	Last commit date
Latest commit History 4,829 Commits
.circleci		.circleci
.github/workflows		.github/workflows
.travis		.travis
benchmark		benchmark
docs		docs
example		example
fuzzing		fuzzing
http3		http3
integrationtests		integrationtests
internal		internal
interop		interop
logging		logging
metrics		metrics
qlog		qlog
quictrace		quictrace
.editorconfig		.editorconfig
.gitignore		.gitignore
.golangci.yml		.golangci.yml
.travis.yml		.travis.yml
Changelog.md		Changelog.md
LICENSE		LICENSE
README.md		README.md
buffer_pool.go		buffer_pool.go
buffer_pool_test.go		buffer_pool_test.go
client.go		client.go
client_test.go		client_test.go
closed_session.go		closed_session.go
closed_session_test.go		closed_session_test.go
codecov.yml		codecov.yml
config.go		config.go
config_test.go		config_test.go
conn_id_generator.go		conn_id_generator.go
conn_id_generator_test.go		conn_id_generator_test.go
conn_id_manager.go		conn_id_manager.go
conn_id_manager_test.go		conn_id_manager_test.go
crypto_stream.go		crypto_stream.go
crypto_stream_manager.go		crypto_stream_manager.go
crypto_stream_manager_test.go		crypto_stream_manager_test.go
crypto_stream_test.go		crypto_stream_test.go
frame_sorter.go		frame_sorter.go
frame_sorter_test.go		frame_sorter_test.go
framer.go		framer.go
framer_test.go		framer_test.go
go.mod		go.mod
go.sum		go.sum
interface.go		interface.go
mock_ack_frame_source_test.go		mock_ack_frame_source_test.go
mock_crypto_data_handler_test.go		mock_crypto_data_handler_test.go
mock_crypto_stream_test.go		mock_crypto_stream_test.go
mock_frame_source_test.go		mock_frame_source_test.go
mock_multiplexer_test.go		mock_multiplexer_test.go
mock_packer_test.go		mock_packer_test.go
mock_packet_handler_manager_test.go		mock_packet_handler_manager_test.go
mock_packet_handler_test.go		mock_packet_handler_test.go
mock_quic_session_test.go		mock_quic_session_test.go
mock_receive_stream_internal_test.go		mock_receive_stream_internal_test.go
mock_sealing_manager_test.go		mock_sealing_manager_test.go
mock_send_conn_test.go		mock_send_conn_test.go
mock_send_stream_internal_test.go		mock_send_stream_internal_test.go
mock_session_runner_test.go		mock_session_runner_test.go
mock_stream_getter_test.go		mock_stream_getter_test.go
mock_stream_internal_test.go		mock_stream_internal_test.go
mock_stream_manager_test.go		mock_stream_manager_test.go
mock_stream_sender_test.go		mock_stream_sender_test.go
mock_token_store_test.go		mock_token_store_test.go
mock_unknown_packet_handler_test.go		mock_unknown_packet_handler_test.go
mock_unpacker_test.go		mock_unpacker_test.go
mockgen.go		mockgen.go
mockgen_private.sh		mockgen_private.sh
multiplexer.go		multiplexer.go
multiplexer_test.go		multiplexer_test.go
packet_handler_map.go		packet_handler_map.go
packet_handler_map_test.go		packet_handler_map_test.go
packet_packer.go		packet_packer.go
packet_packer_test.go		packet_packer_test.go
packet_unpacker.go		packet_unpacker.go
packet_unpacker_test.go		packet_unpacker_test.go
quic_suite_test.go		quic_suite_test.go
receive_stream.go		receive_stream.go
receive_stream_test.go		receive_stream_test.go
retransmission_queue.go		retransmission_queue.go
retransmission_queue_test.go		retransmission_queue_test.go
send_conn.go		send_conn.go
send_conn_test.go		send_conn_test.go
send_queue.go		send_queue.go
send_queue_test.go		send_queue_test.go
send_stream.go		send_stream.go
send_stream_test.go		send_stream_test.go
server.go		server.go
server_test.go		server_test.go
session.go		session.go
session_test.go		session_test.go
stream.go		stream.go
stream_deadline_error.go		stream_deadline_error.go
stream_deadline_error_go115.go		stream_deadline_error_go115.go
stream_deadline_error_test.go		stream_deadline_error_test.go
stream_test.go		stream_test.go
streams_map.go		streams_map.go
streams_map_generic_helper.go		streams_map_generic_helper.go
streams_map_incoming_bidi.go		streams_map_incoming_bidi.go

License

damz/quic-go

Folders and files

Latest commit

History