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
5381 commits 12 branches 6 tags 19 MiB
Find a file
Olivier Poitrey eb6bdfdfc1 Use the correct source IP when binding multiple IPs 
When the server is listening on multiple interfaces or interfaces with
multiple IPs, the outgoing datagrams are sometime delivered with the
wrong source IP address.

In order to fix that, each quic connection needs to extract the
destination IP (and optionally interface id) of the received datagrams,
and set it as source IP (and interface) on the sent datagrams.

On most platforms, this can be done using ancillary data with recvmsg()
and sendmsg(). Some of the machinery for this is already there for ECN,
this change extends it to read the destination IP info and write it to
the outgoing packets.

Fix #1736
2021-03-16 00:50:05 +01:00
.circleci set the TIMESCALE_FACTOR for integration tests on CircleCI and GitHub Actions 2021-03-04 10:45:27 +08:00
.githooks only run gofumpt on .go files in pre-commit hook 2021-01-06 10:48:41 +08:00
.github/workflows Merge pull request #2893 from lucas-clemente/clean-up-workflow 2021-03-10 12:32:37 +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 add a function to tell if a packet is a 0-RTT packet 2021-03-11 21:05:41 +08:00
http3 Merge pull request #3063 from lucas-clemente/dont-reset-qpack-streams 2021-03-08 18:08:02 +08:00
integrationtests store 0-RTT queues in the packet handler map 2021-03-11 21:16:50 +08:00
internal add a function to tell if a packet is a 0-RTT packet 2021-03-11 21:05:41 +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 rename MaxReceivePacketSize to MaxPacketBufferSize 2021-03-03 12:00:14 +08:00
buffer_pool_test.go rename MaxReceivePacketSize to MaxPacketBufferSize 2021-03-03 12:00:14 +08:00
Changelog.md introduce a quic.Config.HandshakeIdleTimeout, remove HandshakeTimeout 2020-12-08 16:12:39 +07:00
client.go Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01:00
client_test.go Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01: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 add a quic.Config option to disable Path MTU discovery 2021-03-03 12:00:14 +08:00
config_test.go add a quic.Config option to disable Path MTU discovery 2021-03-03 12:00:14 +08:00
conn.go Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01:00
conn_ecn_test.go Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01:00
conn_generic.go Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01:00
conn_helper_darwin.go Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01:00
conn_helper_freebsd.go Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01:00
conn_helper_linux.go Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01:00
conn_id_generator.go fix issuing of connection IDs when dialing a 0-RTT connections 2021-03-03 14:10:06 +08:00
conn_id_generator_test.go fix issuing of connection IDs when dialing a 0-RTT connections 2021-03-03 14:10:06 +08: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_oob.go Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01:00
conn_test.go rename MaxReceivePacketSize to MaxPacketBufferSize 2021-03-03 12:00:14 +08: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 add an internal queue to signal that a datagram frame has been dequeued 2021-03-09 18:53:20 +01: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 drop STREAM and *_BLOCKED frames from queue when 0-RTT is rejected 2021-03-09 17:59:11 +08:00
framer_test.go drop STREAM and *_BLOCKED frames from queue when 0-RTT is rejected 2021-03-09 17:59:11 +08:00
go.mod reject 0-RTT before handling transport parameters 2021-03-09 16:36:33 +08:00
go.sum reject 0-RTT before handling transport parameters 2021-03-09 16:36:33 +08:00
interface.go return an Err0RTTRejected when the server rejects a 0-RTT connection 2021-03-09 18:02:12 +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_mtu_discoverer_test.go start path MTU discovery when the handshake completes 2021-03-03 12:00:51 +08:00
mock_multiplexer_test.go use mockgen source mode 2021-02-20 09:59:44 +08:00
mock_packer_test.go start path MTU discovery when the handshake completes 2021-03-03 12:00:51 +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 return an Err0RTTRejected when the server rejects a 0-RTT connection 2021-03-09 18:02:12 +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 add a function to reset the streams map after 0-RTT rejection 2021-03-09 17:59:49 +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 start path MTU discovery when the handshake completes 2021-03-03 12:00:51 +08:00
mockgen_private.sh use mockgen source mode 2021-02-20 09:59:44 +08:00
mtu_discoverer.go introduce a mtuDiscoverer interface 2021-03-03 12:00:14 +08:00
mtu_discoverer_test.go introduce a mtuDiscoverer interface 2021-03-03 12:00:14 +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 Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01:00
packet_handler_map_test.go store 0-RTT queues in the packet handler map 2021-03-11 21:16:50 +08:00
packet_packer.go don't reduce the congestion window when a path MTU probe packet is lost 2021-03-03 12:00:52 +08:00
packet_packer_test.go don't reduce the congestion window when a path MTU probe packet is lost 2021-03-03 12:00:52 +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 Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01:00
send_conn_test.go Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01: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 rename MaxReceivePacketSize to MaxPacketBufferSize 2021-03-03 12:00:14 +08:00
send_stream_test.go rename MaxReceivePacketSize to MaxPacketBufferSize 2021-03-03 12:00:14 +08:00
server.go Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01:00
server_test.go store 0-RTT queues in the packet handler map 2021-03-11 21:16:50 +08:00
session.go Use the correct source IP when binding multiple IPs 2021-03-16 00:50:05 +01:00
session_test.go remove unused error return value from HandleMaxStreamsFrame 2021-03-07 12:36:50 +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 add a function to reset the streams map after 0-RTT rejection 2021-03-09 17:59:49 +08: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 add a function to reset the streams map after 0-RTT rejection 2021-03-09 17:59:49 +08: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

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.