PcapPlusPlus

PcapPlusPlus هي مكتبة متعددة المنصات بلغة C++ لالتقاط وتحليل وإنشاء حزم الشبكة. صممت لتكون فعالة وقوية وسهلة الاستخدام.

تمكِّن PcapPlusPlus من فك تشفير وتشكيل مجموعة كبيرة من بروتوكولات الشبكة. كما توفر أغلفة سهلة الاستخدام بلغة C++ لأشهر محركات معالجة الحزم مثل libpcap, WinPcap, Npcap, DPDK, eBPF AF_XDP, WinDivert وPF_RING.

الترجمات: الإنجليزية · 正體中文 · 한국어 · 日本語 · Русский

جدول المحتويات

• جدول المحتويات
• تنزيل
  • صفحة الإصدارات على GitHub
  • Homebrew
  • Vcpkg
  • Conan
  • البناء بنفسك
  • التحقق من الحزم
• نظرة عامة على الميزات
• بدء الاستخدام
• توثيق API
• دعم المنصات المتعددة
• بروتوكولات الشبكة المدعومة
  • طبقة ربط البيانات (L2)
  • طبقة الشبكة (L3)
  • طبقة النقل (L4)
  • طبقة الجلسة (L5)
  • طبقة العرض (L6)
  • طبقة التطبيق (L7)
• دعم DPDK وPF_RING
• المقاييس
• تقديم الملاحظات
• المساهمة
• الترخيص

تنزيل

يمكنك الاختيار بين التنزيل من صفحة إصدارات GitHub، أو استخدام مدير حزم، أو بناء PcapPlusPlus بنفسك. لمزيد من التفاصيل، يرجى زيارة صفحة التنزيل في موقع PcapPlusPlus.

صفحة الإصدارات على GitHub

https://github.com/seladb/PcapPlusPlus/releases/latest

Homebrew

brew install pcapplusplus

صيغ Homebrew: https://formulae.brew.sh/formula/pcapplusplus

Vcpkg

ويندوز:

.\vcpkg install pcapplusplus

ماك/لينكس:

vcpkg install pcapplusplus

منفذ Vcpkg: https://github.com/microsoft/vcpkg/tree/master/ports/pcapplusplus

Conan

conan install "pcapplusplus/[>0]@" -u

الحزمة في ConanCenter: https://conan.io/center/pcapplusplus

البناء بنفسك

استنساخ مستودع git:

git clone https://github.com/seladb/PcapPlusPlus.git

اتبع تعليمات البناء حسب منصتك في صفحة البناء من المصدر في موقع PcapPlusPlus.

التحقق من الحزم

إصدارات PcapPlusPlus الأحدث من v23.09 موقعة بشهادة GitHub. جميع الشهادات موجودة هنا. يمكنك التحقق من شهادة هذه الحزم باستخدام GitHub CLI. للتحقق من الحزم، يمكنك اتباع أحدث التعليمات من gh attestation verify. للتعليمات البسيطة، استخدم الأمر التالي:

gh attestation verify <path-to-package-file> --repository seladb/PcapPlusPlus

وسترى المخرجات التالية في الطرفية:

✓ Verification succeeded!

نظرة عامة على الميزات

• التقاط الحزم من خلال غلاف C++ سهل الاستخدام لمحركات التقاط الحزم الشهيرة مثل libpcap, WinPcap, Npcap, Intel DPDK, eBPF AF_XDP, WinDivert, PF_RING من ntop وsockets الخام [المزيد]
• تحليل وإنشاء الحزم بما في ذلك التحليل المفصل للبروتوكولات والطبقات، وتوليد الحزم وتحريرها لمجموعة كبيرة من بروتوكولات الشبكة [المزيد]
• قراءة وكتابة الحزم من/إلى الملفات بصيغتي PCAP و__PCAPNG__ [المزيد]
• معالجة الحزم بسرعة الخط من خلال غلاف C++ فعال وسهل الاستخدام لـ DPDK, eBPF AF_XDP وPF_RING [المزيد]
• دعم متعدد المنصات - PcapPlusPlus مدعومة بالكامل على Linux وMacOS وWindows وAndroid وFreeBSD
• إعادة تجميع الحزم - تطبيق فريد لـ إعادة تجميع TCP والذي يتضمن إعادة إرسال TCP وحزم TCP خارج الترتيب وبيانات TCP المفقودة، و__تجزئة IP وإعادة التجميع__ لإنشاء وتجميع أجزاء IPv4 وIPv6 [المزيد]
• تصفية الحزم التي تجعل مرشحات BPF الخاصة بـ libpcap أكثر سهولة [المزيد]
• بصمة TLS - تنفيذ C++ لبصمة JA3 وJA3S الخاصة بـ TLS [المزيد]

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

كتابة التطبيقات باستخدام PcapPlusPlus سهلة وبديهية للغاية. إليك تطبيق بسيط يوضح كيفية قراءة حزمة من ملف PCAP وتحليلها:

#include <iostream>
#include "IPv4Layer.h"
#include "Packet.h"
#include "PcapFileDevice.h"

int main(int argc, char* argv[])
{
    // open a pcap file for reading
    pcpp::PcapFileReaderDevice reader("1_packet.pcap");
    if (!reader.open())
    {
        std::cerr << "Error opening the pcap file" << std::endl;
        return 1;
    }

    // read the first (and only) packet from the file
    pcpp::RawPacket rawPacket;
    if (!reader.getNextPacket(rawPacket))
    {
        std::cerr << "Couldn't read the first packet in the file" << std::endl;
        return 1;
    }