https://github.com/swananan/feather-quic
feather-quic is an experimental, lightweight QUIC protocol stack written in Rust, complete with a flexible client tool for deep-dive testing and learning
https://github.com/swananan/feather-quic
network network-programming quic rust
Last synced: 27 days ago
JSON representation
feather-quic is an experimental, lightweight QUIC protocol stack written in Rust, complete with a flexible client tool for deep-dive testing and learning
- Host: GitHub
- URL: https://github.com/swananan/feather-quic
- Owner: swananan
- License: mit
- Created: 2024-12-15T13:50:11.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-10T15:23:15.000Z (11 months ago)
- Last Synced: 2025-07-10T21:52:59.294Z (11 months ago)
- Topics: network, network-programming, quic, rust
- Language: Rust
- Homepage:
- Size: 246 KB
- Stars: 86
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.en.md
- License: LICENSE
Awesome Lists containing this project
README
# feather-quic
A tiny QUIC implementation in Rust
[δΈζ](./README.md)
feather-quic is a personal experimental project aimed at implementing the QUIC protocol in Rust while also developing a client tool that offers flexible configuration options for QUIC's underlying features. Along the way, I'll document my thoughts and interesting details from the development process through a series of blog posts:
[Implementing QUIC from Scratch with Rust: A Fresh Start](https://jt26wzz.com/en/posts/0001-implement-quic-in-rust-en/)
[Implementing QUIC from Scratch with Rust: Runtime](https://jt26wzz.com/en/posts/0002-implement-quic-in-rust-en/)
[Implementing QUIC from Scratch with Rust: Trying to analyse and implement QUIC Handshake π](https://jt26wzz.com/en/posts/0003-implement-quic-in-rust-en/)
[Implementing QUIC from Scratch with Rust: Implement TLS 1.3 Handshake and QUIC-TLS Key Update](https://jt26wzz.com/en/posts/0004-implement-quic-in-rust-en/)
To be continued
---
**Building and Debugging**
Currently, compilation is tested on Linux and MacOS platforms. Windows platform has not been tested yet, but it should be ok.
Build command:
```bash
cargo build --all-targets
```
Running tests:
1. Start the echo server:
```bash
RUST_LOG=trace ./target/debug/echo-server --listen 127.0.0.1:44437
```
2. Use feather-quic-tool for echo testing:
```bash
RUST_LOG=trace ./target/debug/feather-quic-client-tool \
--target-address 127.0.0.1:44437 \
--sni localhost \
--first-initial-packet-size 1200 \
--scid dddd1baa12 \
--alpn echo \
-e feather-quic-integration-tests/src/tests/test_files/basic_echo_input \
--ssl-key-log ~/sslkey.log
```
Debugging:
- Use tshark or WireShark to inspect QUIC packets
- View internal feather-quic logs directly
---
Contribution
Contributions are welcome! Feel free to open issues or submit pull requests to improve Feather-QUIC.
---
License
This project is licensed under the MIT License. See the [LICENSE](./LICENSE.md) file for more details.