mirrors/uquic
1
0
Fork 0
mirror of https://github.com/refraction-networking/uquic.git synced 2025-04-03 20:27:35 +03:00
Code Issues Projects Releases Packages Wiki Activity
Low-level access to the QUIC Initial Packet for mimicry purposes, hard fork of quic-go. https://quic.tlsfingerprint.io
5326 commits 12 branches 6 tags 19 MiB
Find a file
Marten Seemann fb5a45ac53 implement a function to pack MTU probe packets
2021-03-03 12:00:14 +08:00
.circleci update Go to 1.16, drop support for 1.14 2021-02-17 12:17:46 +08:00
.githooks only run gofumpt on .go files in pre-commit hook 2021-01-06 10:48:41 +08:00
.github/workflows update Go to 1.16, drop support for 1.14 2021-02-17 12:17:46 +08:00
benchmark run gofumpt, enable the gofumpt linter 2020-10-26 09:33:35 +07:00
docs add gopher-logo 2016-05-03 10:27:59 +02:00
example remove support for quic-trace 2020-12-05 23:13:45 +07:00
fuzzing reject DATAGRAM frames if datagram support is not enabled 2020-12-09 15:31:23 +07:00
http3 use the correct HTTP/3 ALPN when using draft-34 2021-02-11 09:46:00 +08:00
integrationtests Merge pull request #3040 from lucas-clemente/improve-handshake-tests 2021-03-03 00:27:46 +08:00
internal use the actual maximum packet size in the pacer 2021-03-03 12:00:14 +08:00
interop update Go to 1.16, drop support for 1.14 2021-02-17 12:17:46 +08:00
logging update gomock to v1.5.0 2021-02-20 09:33:43 +08:00
qlog fix logging of dropped 0-RTT keys 2021-03-01 10:30:59 +08:00
quicvarint rename ReadVarint / WriteVarInt / VarIntLen to Read / Write / Len 2021-01-02 00:15:07 +08:00
.editorconfig add editorconfig 2016-04-15 12:13:33 +02:00
.gitignore add common temporary file patterns to .gitignore 2020-11-30 12:59:35 +07:00
.golangci.yml update Go to 1.16, drop support for 1.14 2021-02-17 12:17:46 +08:00
.travis.yml read the ECN bits 2020-09-15 10:51:22 +07:00
buffer_pool.go simplify content storage in packed packets 2020-02-20 16:25:54 +07:00
buffer_pool_test.go simplify content storage in packed packets 2020-02-20 16:25:54 +07:00
Changelog.md introduce a quic.Config.HandshakeIdleTimeout, remove HandshakeTimeout 2020-12-08 16:12:39 +07:00
client.go remove unused initialVersion variable in session 2020-12-18 12:00:17 +07:00
client_test.go remove unused initialVersion variable in session 2020-12-18 12:00:17 +07:00
closed_session.go simplify the connection, rename it to sendConn 2020-08-09 19:24:04 +07:00
closed_session_test.go simplify the connection, rename it to sendConn 2020-08-09 19:24:04 +07:00
codecov.yml remove support for quic-trace 2020-12-05 23:13:45 +07:00
config.go Merge pull request #2162 from lucas-clemente/datagram 2020-12-17 11:22:40 +07:00
config_test.go Merge pull request #2162 from lucas-clemente/datagram 2020-12-17 11:22:40 +07:00
conn.go introduce an ECNCapablePacketConn interface to determine ECN support 2020-09-15 14:41:06 +07:00
conn_ecn.go use golang.org/x/sys/unix instead of syscall 2020-12-06 12:06:15 +07:00
conn_ecn_test.go use golang.org/x/sys/unix instead of syscall 2020-12-06 12:06:15 +07:00
conn_generic.go set the UDP receive buffer size on Windows 2020-11-21 17:49:39 +07:00
conn_helper_darwin.go use golang.org/x/sys/unix instead of syscall 2020-12-06 12:06:15 +07:00
conn_helper_linux.go use golang.org/x/sys/unix instead of syscall 2020-12-06 12:06:15 +07:00
conn_id_generator.go only use the conn ID backwards compatibility mode with draft-29 2020-10-22 20:33:17 +07:00
conn_id_generator_test.go only use the conn ID backwards compatibility mode with draft-29 2020-10-22 20:33:17 +07:00
conn_id_manager.go reduce memory footprint of the connIDManager 2021-02-18 09:58:34 +08:00
conn_id_manager_test.go immediately remove reset tokens when retiring a connection ID 2020-11-22 10:21:20 +07:00
conn_test.go use a mock net.PacketConn in tests 2020-09-27 15:13:07 +07:00
conn_windows.go use golang.org/x/sys/unix instead of syscall 2020-12-06 12:06:15 +07:00
crypto_stream.go use the correct error code for crypto stream errors 2020-05-14 17:12:07 +07:00
crypto_stream_manager.go add the exhaustive linter 2020-10-05 13:47:57 +07:00
crypto_stream_manager_test.go process the NewSessionTicket TLS message 2019-04-01 11:45:20 +09:00
crypto_stream_test.go run gofumpt, enable the gofumpt linter 2020-10-26 09:33:35 +07:00
datagram_queue.go implement receiving of DATAGRAM frames 2020-12-09 15:31:23 +07:00
datagram_queue_test.go implement receiving of DATAGRAM frames 2020-12-09 15:31:23 +07:00
frame_sorter.go rewrite the frame sorter 2020-05-25 13:10:26 +07:00
frame_sorter_test.go fix seed generation in frame sorter tests 2020-06-01 09:59:54 +07:00
framer.go rename ReadVarint / WriteVarInt / VarIntLen to Read / Write / Len 2021-01-02 00:15:07 +08:00
framer_test.go rename DataBlockedFrame.DataLimit to MaximumData 2020-07-02 16:41:43 +07:00
go.mod update qtls to a version that doesn't export 0-RTT when it's rejected 2021-03-03 11:27:34 +08:00
go.sum update qtls to a version that doesn't export 0-RTT when it's rejected 2021-03-03 11:27:34 +08:00
interface.go fix documentation of the default MaxReceiveConnectionFlowControlWindow 2021-03-01 11:33:42 +08:00
LICENSE add Google to license file 2016-12-14 11:54:01 +01:00
mock_ack_frame_source_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_crypto_data_handler_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_crypto_stream_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_frame_source_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_multiplexer_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_packer_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_packet_handler_manager_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_packet_handler_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_packetconn_test.go update gomock to v1.5.0 2021-02-20 09:33:43 +08:00
mock_quic_session_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_receive_stream_internal_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_sealing_manager_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_send_conn_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_send_stream_internal_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_sender_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_session_runner_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_stream_getter_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_stream_internal_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_stream_manager_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_stream_sender_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_token_store_test.go update gomock to v1.5.0 2021-02-20 09:33:43 +08:00
mock_unknown_packet_handler_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_unpacker_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mockgen.go introduce an interface for the send queue, use a mock in session tests 2021-01-17 16:18:17 +08:00
mockgen_private.sh use mockgen source mode 2021-02-20 09:59:44 +08:00
multiplexer.go use a mock net.PacketConn in tests 2020-09-27 15:13:07 +07:00
multiplexer_test.go use a mock net.PacketConn in tests 2020-09-27 15:13:07 +07:00
packet_handler_map.go fix error message when the UDP receive buffer size can't be increased 2021-02-15 10:13:40 +08:00
packet_handler_map_test.go Merge pull request #2897 from lucas-clemente/immediately-delete-stateless-reset-tokens 2020-12-04 10:14:28 +07:00
packet_packer.go implement a function to pack MTU probe packets 2021-03-03 12:00:14 +08:00
packet_packer_test.go implement a function to pack MTU probe packets 2021-03-03 12:00:14 +08:00
packet_unpacker.go Merge pull request #2903 from lucas-clemente/fix-packet-number-decoding 2020-12-04 09:20:22 +07:00
packet_unpacker_test.go fix decoding of packet numbers in different packet number spaces 2020-12-03 23:35:27 +07:00
quic_suite_test.go link to the wiki explaining the UDP receive buffer size 2020-12-04 09:16:22 +07:00
README.md add draft-34 to support versions in README 2021-02-20 11:19:29 +08:00
receive_stream.go run gofumpt, enable the gofumpt linter 2020-10-26 09:33:35 +07:00
receive_stream_test.go increase the threshold for the receive stream deadline test 2020-09-11 17:10:16 +07:00
retransmission_queue.go add the exhaustive linter 2020-10-05 13:47:57 +07:00
retransmission_queue_test.go rename MaxDataFrame.ByteOffset to MaximumData 2020-07-02 16:41:43 +07:00
send_conn.go read the ECN bits 2020-09-15 10:51:22 +07:00
send_conn_test.go use a mock net.PacketConn in tests 2020-09-27 15:13:07 +07:00
send_queue.go increase the size of the send queue 2021-01-20 14:45:18 +08:00
send_queue_test.go increase the size of the send queue 2021-01-20 14:45:18 +08:00
send_stream.go complete a stream that has frames in flight if it is canceled 2021-01-17 15:54:33 +08:00
send_stream_test.go complete a stream that has frames in flight if it is canceled 2021-01-17 15:54:33 +08:00
server.go use the updated salt for draft-34 2021-02-11 09:46:00 +08:00
server_test.go use the updated salt for draft-34 2021-02-11 09:46:00 +08:00
session.go only read multiple packets at a time after handshake completion 2021-03-03 11:33:00 +08:00
session_test.go only read multiple packets at a time after handshake completion 2021-03-03 11:33:00 +08:00
stream.go update Go to 1.16, drop support for 1.14 2021-02-17 12:17:46 +08:00
stream_test.go update Go to 1.16, drop support for 1.14 2021-02-17 12:17:46 +08:00
streams_map.go move the transport parameter stream limit check to the parser 2020-12-18 13:00:33 +07:00
streams_map_generic_helper.go remove nolint commands that show up in GoDoc 2019-11-16 18:52:25 +08:00
streams_map_incoming_bidi.go use a single map in the incoming streams map 2020-11-20 16:26:14 +07:00
streams_map_incoming_generic.go use a single map in the incoming streams map 2020-11-20 16:26:14 +07:00
streams_map_incoming_generic_test.go reject DATAGRAM frames if datagram support is not enabled 2020-12-09 15:31:23 +07:00
streams_map_incoming_uni.go use a single map in the incoming streams map 2020-11-20 16:26:14 +07:00
streams_map_outgoing_bidi.go send STREAMS_BLOCKED frame when MAX_STREAMS frame allows too few streams 2020-10-30 15:28:09 +07:00
streams_map_outgoing_generic.go send STREAMS_BLOCKED frame when MAX_STREAMS frame allows too few streams 2020-10-30 15:28:09 +07:00
streams_map_outgoing_generic_test.go fix flaky streams map test on Windows 2021-01-20 11:45:06 +08:00
streams_map_outgoing_uni.go send STREAMS_BLOCKED frame when MAX_STREAMS frame allows too few streams 2020-10-30 15:28:09 +07:00
streams_map_test.go move the transport parameter stream limit check to the parser 2020-12-18 13:00:33 +07:00
token_store.go define a quic.TokenStore interface and provide a LRU implementation 2019-08-13 10:30:31 +07:00
token_store_test.go define a quic.TokenStore interface and provide a LRU implementation 2019-08-13 10:30:31 +07:00
window_update_queue.go rename MaxStreamDataFrame.ByteOffset to MaximumStreamData 2020-07-02 16:41:43 +07:00
window_update_queue_test.go rename MaxStreamDataFrame.ByteOffset to MaximumStreamData 2020-07-02 16:41:43 +07:00
zero_rtt_queue.go dequeue all 0-RTT packets to the session in one go 2021-01-09 13:34:05 +08:00
zero_rtt_queue_test.go dequeue all 0-RTT packets to the session in one go 2021-01-09 13:34:05 +08:00

README.md

A QUIC implementation in pure Go

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

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

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.

When using quic-go as a library, please always use a tagged release. Only these releases use the official draft version numbers.

Guides

We currently support Go 1.15+, 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.