QUIC와 HTTP/3 패킷을 직접 다루는 저수준 API를 제공합니다
소켓에서 들어온 바이트를 QUIC 연결 상태로 변환하고, 다시 네트워크로 보낼 패킷을 생성하는 코드를 직접 작성해야 하는 개발자에게 필요한 도구를 줍니다. quiche는 IETF 표준에 따른 QUIC 전송 프로토콜과 HTTP/3를 구현한 Rust 라이브러리입니다. 소켓 처리나 이벤트 루프 같은 입출력(I/O) 작업은 애플리케이션이 담당하고, quiche는 그 위에 프로토콜 로직을 얹어줍니다.
클라우드플레어와 안드로이드에서 이미 쓰이는 이유
이 라이브러리는 클라우드플레어 엣지 네트워크의 HTTP/3 지원을 담당하고 있습니다. 또한 안드로이드의 DNS 리졸버가 DNS over HTTP/3를 구현할 때 quiche를 사용합니다. curl에도 통합되어 HTTP/3 지원을 제공할 수 있습니다. 이러한 실제 서비스 사례는 프로토콜 구현의 안정성을 보여줍니다.
연결 설정과 패킷 처리 흐름
연결을 시작하려면 먼저 Config 객체를 만들어 QUIC 버전, ALPN ID, 흐름 제어, 혼잡 제어, 유휴 타임아웃 등을 설정합니다. QUIC는 범용 전송 프로토콜이라 동시 스트림 수나 데이터 제한 같은 값은 애플리케이션 성격에 따라 달라져야 하므로, quiche는 일부 값을 0으로 기본 설정해 두고 있습니다. 개발자는 set_initial_max_streams_bidi() 같은 메서드로 필요한 값을 직접 지정해야 합니다. 클라이언트는 connect(), 서버는 accept() 함수로 연결을 생성합니다. 이후 recv()로 들어오는 패킷을 처리하고, send()로 나가는 패킷을 생성합니다.
스트림 데이터 주고받기와 HTTP/3 모듈
핸드셰이크가 완료되면 stream_send()와 stream_recv() 메서드로 스트림 데이터를 주고받을 수 있습니다. readable() 메서드는 읽을 데이터가 있는 스트림 목록을 반환해 주므로, 이를 반복하며 데이터를 읽어오면 됩니다. quiche는 QUIC 위에 HTTP 요청과 응답을 처리하는 고수준 API인 HTTP/3 모듈도 제공합니다. 이 모듈을 사용하면 프로토콜 세부 사항 없이 HTTP 트래픽을 처리할 수 있습니다.
C/C++ 통합과 빌드 환경
Rust API 위에 얇은 C API를 제공하여 C/C++ 애플리케이션이나 FFI를 지원하는 다른 언어에서도 quiche를 사용할 수 있습니다. cargo build 시 libquiche.a 정적 라이브러리가 자동으로 생성되며, FFI API를 쓰려면 --features ffi 옵션을 활성화해야 합니다. 빌드에는 Rust 1.88 이상과 BoringSSL이 필요합니다. BoringSSL은 QUIC의 암호화 핸드셰이크를 위해 TLS 기반으로 사용되며, 빌드 과정에서 cmake 명령이 필요합니다. Windows에서는 NASM도 추가로 요구됩니다. Android나 iOS로 빌드할 때는 각각 cargo-ndk나 cargo-lipo 같은 도구를 사용해 특정 아키텍처에 맞는 라이브러리를 생성합니다.
사용 전 확인해야 할 사항
quiche는 저수준 API를 제공하므로, 소켓 처리와 이벤트 루프, 타이머 관리 등 네트워크 입출력 인프라를 직접 구현해야 합니다. 저장소에 포함된 클라이언트와 서버 예제 앱은 API 사용법을 보여주는 데 목적이 있으며, 성능, 보안, 신뢰성에 대한 보장이 없으므로 프로덕션 환경에 그대로 쓰면 안 됩니다. 프로덕션 배포를 계획한다면, BoringSSL 버전 호환성과 타겟 플랫폼(Windows, Android, iOS)별 추가 의존성(NASM, NDK, Xcode)을 미리 점검해야 합니다.
