Download lsquic - download do código-fonte lsquic

lsquic

Outras categorias

1.0.0

Baixar

Biblioteca LiteSpeed QUIC (LSQUIC) README

Descrição

A biblioteca LiteSpeed QUIC (LSQUIC) é uma implementação de código aberto da funcionalidade QUIC e HTTP/3 para servidores e clientes. A maior parte do código desta distribuição é usada em nossos próprios produtos: LiteSpeed Web Server, LiteSpeed ADC e OpenLiteSpeed.

As versões QUIC atualmente suportadas são v1, v2, Internet-Draft versões 29 e 27; e as versões QUIC mais antigas do "Google" Q043, Q046 e Q050.

Conformidade Padrão

LiteSpeed QUIC é principalmente compatível com os seguintes RFCs:

RFC 9000 QUIC: Um transporte multiplexado e seguro baseado em UDP
RFC 9001 usando TLS para proteger QUIC
RFC 9002 Detecção de perda e controle de congestionamento QUIC
RFC 9114HTTP/3
RFC 9204 QPACK: compactação de campo para HTTP/3

Extensões de protocolo QUIC

As seguintes extensões de protocolo QUIC são implementadas:

Negociação de versão compatível com RFC 9368 para QUIC
RFC 9369 QUIC versão 2
Esquema de priorização extensível RFC 9218 para HTTP
RFC 9221 Uma extensão de datagrama não confiável para QUIC
RFC 9287 Lubrificando a broca QUIC
Frequência ACK

Documentação

A documentação está disponível em https://lsquic.readthedocs.io/en/latest/.

Além disso, veja exemplos de programas para uso de API e EXAMPLES.txt para algumas opções de compilação e tempo de execução.

Requisitos

Para construir LSQUIC, você precisa de CMake, zlib e BoringSSL. O programa de exemplo usa libevent para fornecer o loop de eventos.

Construindo ChatoSSL

BoringSSL não é empacotado; você tem que construí-lo sozinho. O processo é simples. Você precisará go .

Clone o BoringSSL emitindo o seguinte comando:

 git clone https://boringssl.googlesource.com/boringssl
cd boringssl

Pode ser necessário instalar pré-requisitos como zlib e libevent.

Use uma versão específica do BoringSSL

 git checkout 9fc1c33e9c21439ce5f87855a6591a9324e569fd

Ou apenas experimente o branch master mais recente.

Compilar a biblioteca

 cmake . &&  make

Lembre-se de onde estão as fontes do BoringSSL:

 BORINGSSL=$PWD

Se você quiser ativar as otimizações, faça

 cmake -DCMAKE_BUILD_TYPE=Release . && make

Se você deseja construir como uma biblioteca (necessário para construir o próprio lsquic como uma biblioteca compartilhada), faça:

 cmake -DBUILD_SHARED_LIBS=1 . && make

Construindo Biblioteca LSQUIC

http_client , http_server e os testes do LSQUIC vinculam as bibliotecas BoringSSL estaticamente. Seguindo a seção anterior, você pode construir LSQUIC da seguinte forma:

Obtenha o código-fonte

 git clone https://github.com/litespeedtech/lsquic.git
cd lsquic
git submodule update --init

Compilar a biblioteca

Estaticamente:

 # $BORINGSSL is the top-level BoringSSL directory from the previous step
cmake -DBORINGSSL_DIR=$BORINGSSL .
make

Como uma biblioteca dinâmica:

 cmake -DLSQUIC_SHARED_LIB=1 -DBORINGSSL_DIR=$BORINGSSL .
make

Execute testes

 make test

Construindo com Docker

A biblioteca e o cliente e servidor de exemplo podem ser construídos com Docker.

Inicialize os submódulos do Git:

 cd lsquic
git submodule update --init

Construa a imagem do Docker:

 docker build -t lsquic .

Então você pode usar os exemplos da linha de comando. Por exemplo:

 sudo docker run -it --rm lsquic http_client -s www.google.com  -p / -o version=h3
sudo docker run -p 12345:12345/udp -v /path/to/certs:/mnt/certs -it --rm lsquic http_server -c www.example.com,/mnt/certs/chain,/mnt/certs/key