تنزيل lsquic - تنزيل كود المصدر lsquic

lsquic

فئات أخرى

1.0.0

تنزيل

التمهيدي لمكتبة LiteSpeed QUIC (LSQUIC).

وصف

مكتبة LiteSpeed QUIC (LSQUIC) عبارة عن تطبيق مفتوح المصدر لوظائف QUIC وHTTP/3 للخوادم والعملاء. يتم استخدام معظم التعليمات البرمجية الموجودة في هذا التوزيع في منتجاتنا الخاصة: LiteSpeed Web Server، وLiteSpeed ADC، وOpenLiteSpeed.

إصدارات QUIC المدعومة حاليًا هي v1 وv2 وإصدارات Internet-Draft 29 و27؛ والإصدارات الأقدم من Google QUIC Q043 وQ046 وQ050.

الامتثال للمعايير

يتوافق LiteSpeed QUIC في الغالب مع طلبات RFC التالية:

RFC 9000 QUIC: نقل متعدد الإرسال وآمن قائم على UDP
RFC 9001 استخدام TLS لتأمين QUIC
RFC 9002 QUIC كشف الخسارة والتحكم في الازدحام
RFC 9114 HTTP/3
RFC 9204 QPACK: ضغط الحقل لـ HTTP/3

ملحقات بروتوكول QUIC

يتم تنفيذ ملحقات بروتوكول QUIC التالية:

RFC 9368 التفاوض بشأن الإصدار المتوافق مع QUIC
RFC 9369 كويك الإصدار 2
RFC 9218 نظام تحديد الأولويات القابل للتوسيع لـ HTTP
RFC 9221 ملحق مخطط بيانات غير موثوق به لـ QUIC
RFC 9287 تشحيم بت QUIC
تردد الاك

التوثيق

الوثائق متاحة على https://lsquic.readthedocs.io/en/latest/.

بالإضافة إلى ذلك، راجع نماذج البرامج لاستخدام واجهة برمجة التطبيقات (API) وEXAMPLES.txt للتعرف على بعض خيارات التجميع ووقت التشغيل.

متطلبات

لإنشاء LSQUIC، تحتاج إلى CMake وzlib وBoringSSL. يستخدم البرنامج المثال libevent لتوفير حلقة الحدث.

بناء مملةSSL

لم يتم حزم BoringSSL؛ عليك أن تبنيها بنفسك. العملية واضحة ومباشرة. سوف تحتاج go التثبيت.

استنساخ BoringSSL عن طريق إصدار الأمر التالي:

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

قد تحتاج إلى تثبيت المتطلبات المسبقة مثل zlib وlievent.

استخدم إصدار BoringSSL محددًا

 git checkout 9fc1c33e9c21439ce5f87855a6591a9324e569fd

أو، فقط جرب أحدث فرع رئيسي.

تجميع المكتبة

 cmake . &&  make

تذكر أين توجد مصادر BoringSSL:

 BORINGSSL=$PWD

إذا كنت تريد تشغيل التحسينات، فقم بذلك

 cmake -DCMAKE_BUILD_TYPE=Release . && make

إذا كنت تريد الإنشاء كمكتبة، (من الضروري إنشاء lsquic نفسها كمكتبة مشتركة) فقم بما يلي:

 cmake -DBUILD_SHARED_LIBS=1 . && make

بناء مكتبة LSQUIC

تربط http_client و http_server والاختبارات الخاصة بـ LSQUIC مكتبات BoringSSL بشكل ثابت. باتباع القسم السابق، يمكنك بناء LSQUIC على النحو التالي:

احصل على الكود المصدري

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

تجميع المكتبة

بشكل ثابت:

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

كمكتبة ديناميكية:

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

تشغيل الاختبارات

 make test

البناء باستخدام Docker

يمكن إنشاء المكتبة ومثال العميل والخادم باستخدام Docker.

تهيئة وحدات Git الفرعية:

 cd lsquic
git submodule update --init

بناء صورة عامل الميناء:

 docker build -t lsquic .

ثم يمكنك استخدام الأمثلة من سطر الأوامر. على سبيل المثال:

 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