seladb/pcapplusplusمكتبة C++ متعددة المنصات لالتقاط حزم الشبكة عالية الأداء، وتحليلها، وتشكيلها، وفحصها. تدعم libpcap، DPDK، AF_XDP، PF_RING، وتتضمن إعادة تجميع TCP، وبصمة TLS، وفك تشفير البروتوكولات.
<div align="center">
[](https://pcapplusplus.github.io)
[](https://github.com/seladb/PcapPlusPlus/actions?query=workflow%3A%22Build+and+test%22)
[](https://github.com/seladb/PcapPlusPlus/actions?query=workflow%3A%22CodeQL%22)
[](https://app.codecov.io/github/seladb/PcapPlusPlus)
[](https://scorecard.dev/viewer/?uri=github.com/seladb/PcapPlusPlus)
[](https://github.com/seladb/PcapPlusPlus/graphs/contributors)
[](https://x.com/intent/follow?screen_name=seladb)
[]()
</div>
[PcapPlusPlus](https://pcapplusplus.github.io/) هي مكتبة C++ متعددة المنصات لالتقاط حزم الشبكة وتحليلها وإنشائها. صُممت لتكون فعّالة وقوية وسهلة الاستخدام.
توفّر PcapPlusPlus قدرات فك الترميز والتزوير لمجموعة كبيرة ومتنوعة من بروتوكولات الشبكة. كما توفّر أغلفة C++ سهلة الاستخدام لأشهر محركات معالجة الحزم مثل [libpcap](https://www.tcpdump.org/)، و[WinPcap](https://www.winpcap.org/)، و[Npcap](https://nmap.org/npcap/)، و[DPDK](https://www.dpdk.org/)، و[eBPF AF_XDP](https://www.kernel.org/doc/html/next/networking/af_xdp.html)، و[WinDivert](https://reqrypt.org/windivert.html)، و[PF_RING](https://www.ntop.org/products/packet-capture/pf_ring/).
الترجمات: English · [正體中文](https://github.com/seladb/pcapplusplus/blob/master/translation/README-zh-tw.md) · [한국어](https://github.com/seladb/pcapplusplus/blob/master/translation/README-kor.md) · [日本語](https://github.com/seladb/pcapplusplus/blob/master/translation/README-ja.md) · [Русский](https://github.com/seladb/pcapplusplus/blob/master/translation/README-rus.md)
## جدول المحتويات
- [جدول المحتويات](#table-of-contents)
- [التنزيل](#download)
- [صفحة إصدارات GitHub](#github-release-page)
- [Homebrew](#homebrew)
- [Vcpkg](#vcpkg)
- [Conan](#conan)
- [بنائها بنفسك](#build-it-yourself)
- [التحقق من حزمك](#verify-your-packages)
- [نظرة عامة على الميزات](#feature-overview)
- [البدء](#getting-started)
- [توثيق واجهة برمجة التطبيقات](#api-documentation)
- [دعم المنصات المتعددة](#multi-platform-support)
- [بروتوكولات الشبكة المدعومة](#supported-network-protocols)
- [طبقة ربط البيانات (L2)](#data-link-layer-l2)
- [طبقة الشبكة (L3)](#network-layer-l3)
- [طبقة النقل (L4)](#transport-layer-l4)
- [طبقة الجلسة (L5)](#session-layer-l5)
- [طبقة العرض (L6)](#presentation-layer-l6)
- [طبقة التطبيقات (L7)](#application-layer-l7)
- [دعم DPDK و PF_RING](#dpdk-and-pf_ring-support)
- [المقاييس المرجعية](#benchmarks)
- [تقديم الملاحظات](#provide-feedback)
- [المساهمة](#contributing)
- [الترخيص](#license)
## التنزيل
يمكنك الاختيار بين التنزيل من صفحة إصدارات GitHub، أو استخدام مدير حزم، أو بناء PcapPlusPlus بنفسك. لمزيد من التفاصيل يُرجى زيارة صفحة [التنزيل](https://pcapplusplus.github.io/docs/install) على موقع PcapPlusPlus الإلكتروني.
[](https://tooomm.github.io/github-release-stats/?username=seladb&repository=PcapPlusPlus)
### صفحة إصدارات GitHub
<https://github.com/seladb/PcapPlusPlus/releases/latest>
### Homebrew
```shell
brew install pcapplusplus
```
صيغ Homebrew: <https://formulae.brew.sh/formula/pcapplusplus>
### Vcpkg
Windows:
```text
.\vcpkg install pcapplusplus
```
MacOS/Linux:
```text
vcpkg install pcapplusplus
```
منفذ Vcpkg: <https://github.com/microsoft/vcpkg/tree/master/ports/pcapplusplus>
### Conan
```text
conan install "pcapplusplus/[>0]@" -u
```
الحزمة في ConanCenter: <https://conan.io/center/pcapplusplus>
### بنائها بنفسك
استنسخ مستودع git:
```shell
git clone https://github.com/seladb/PcapPlusPlus.git
```
اتبع تعليمات البناء وفقًا لمنصتك في صفحة [البناء من المصدر](https://pcapplusplus.github.io/docs/install#build-from-source) على موقع PcapPlusPlus الإلكتروني.
### التحقق من حزمك
إصدارات PcapPlusPlus الأحدث من v23.09 موقّعة باستخدام GitHub attestation. يمكن العثور على جميع الـ attestations [هنا](https://github.com/seladb/PcapPlusPlus/attestations). يمكنك التحقق من attestation لهذه الحزم باستخدام GitHub CLI. للتحقق من الحزم يمكنك اتباع أحدث التعليمات من [gh attestation verify](https://cli.github.com/manual/gh_attestation_verify). للحصول على تعليمات بسيطة يمكنك استخدام الأمر التالي:
```shell
gh attestation verify <path-to-package-file> --repository seladb/PcapPlusPlus
```
ويجب أن ترى المخرجات التالية في الطرفية:
```shell
✓ Verification succeeded!
```
## نظرة عامة على الميزات
- __التقاط الحزم__ من خلال غلاف C++ سهل الاستخدام لمحركات التقاط الحزم الشائعة مثل [libpcap](https://www.tcpdump.org/)، و[WinPcap](https://www.winpcap.org/)، و[Npcap](https://nmap.org/npcap/)، و[Intel DPDK](https://www.dpdk.org/)، و[eBPF AF_XDP](https://www.kernel.org/doc/html/next/networking/af_xdp.html)، و[WinDivert](https://reqrypt.org/windivert.html)، و[ntop’s PF_RING](https://www.ntop.org/products/packet-capture/pf_ring/) و[raw sockets](https://en.wikipedia.org/wiki/Network_socket#Raw_socket) [[اعرف المزيد](https://pcapplusplus.github.io/docs/features#packet-capture)]
- __تحليل الحزم وإنشاؤها__ بما في ذلك التحليل التفصيلي للبروتوكولات والطبقات، وتوليد الحزم وتحرير الحزم لمجموعة كبيرة ومتنوعة من [بروتوكولات الشبكة](https://pcapplusplus.github.io/docs/features#supported-network-protocols) [[اعرف المزيد](https://pcapplusplus.github.io/docs/features#packet-parsing-and-crafting)]
- __قراءة وكتابة الحزم من/إلى الملفات__ بصيغتي __PCAP__ و__PCAPNG__ [[اعرف المزيد](https://pcapplusplus.github.io/docs/features#read-and-write-packets-fromto-files)]
- __معالجة الحزم بمعدل الخط__ من خلال غلاف C++ فعّال وسهل الاستخدام لـ [DPDK](https://www.dpdk.org/)، و[eBPF AF_XDP](https://www.kernel.org/doc/html/next/networking/af_xdp.html) و[PF_RING](https://www.ntop.org/products/packet-capture/pf_ring/) [[اعرف المزيد](https://pcapplusplus.github.io/docs/features#dpdk-support)]
- __دعم المنصات المتعددة__ - PcapPlusPlus مدعومة بالكامل على Linux وMacOS وWindows وAndroid وFreeBSD
- __إعادة تجميع الحزم__ - تنفيذ فريد لـ __TCP Reassembly__ الذي يتضمن إعادة إرسال TCP، وحزم TCP غير المرتبة، وبيانات TCP المفقودة، و__تجزئة وإلغاء تجزئة IP__ لإنشاء وإعادة تجميع أجزاء IPv4 وIPv6 [[اعرف المزيد](https://pcapplusplus.github.io/docs/features#packet-reassembly)]
- __تصفية الحزم__ التي تجعل مرشحات BPF الخاصة بـ libpcap أكثر سهولة في الاستخدام [[اعرف المزيد](https://pcapplusplus.github.io/docs/features#packet-filtering)]
- __بصمة TLS__ - تنفيذ C++ لـ [JA3 و JA3S](https://github.com/salesforce/ja3) لبصمة TLS [[اعرف المزيد](https://pcapplusplus.github.io/docs/features#tls-fingerprinting)]
## البدء
كتابة التطبيقات باستخدام PcapPlusPlus سهلة وبديهية للغاية. إليك تطبيق بسيط يوضح كيفية قراءة حزمة من ملف PCAP وتحليلها:
```cpp
#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;
}
// parse the raw packet into a parsed packet
pcpp::Packet parsedPacket(&rawPacket);
// verify the packet is IPv4
if (parsedPacket.isPacketOfType(pcpp::IPv4))
{
// extract source and dest IPs
pcpp::IPv4Address srcIP = parsedPacket.getLayerOfType<pcpp::IPv4Layer>()->getSrcIPv4Address();
pcpp::IPv4Address destIP = parsedPacket.getLayerOfType<pcpp::IPv4Layer>()->getDstIPv4Address();
// print source and dest IPs
std::cout << "Source IP is '" << srcIP << "'; Dest IP is '" << destIP << "'" << std::endl;
}
// close the file
reader.close();
return 0;
}
```
يمكنك العثور على مزيد من المعلومات في صفحة [البدء](https://pcapplusplus.github.io/docs/quickstart) على موقع PcapPlusPlus الإلكتروني. سترشدك هذه الصفحة عبر بضع خطوات سهلة لتشغيل تطبيقك.
## توثيق واجهة برمجة التطبيقات
تتكون PcapPlusPlus من 3 مكتبات:
1. __Packet++__ - مكتبة لتحليل وإنشاء وتحرير حزم الشبكة
2. __Pcap++__ - مكتبة لاعتراض الحزم وإرسالها، وتوفير معلومات الشبكة وبطاقة الشبكة والإحصاءات، إلخ. وهي في الواقع غلاف C++ لمحركات التقاط الحزم مثل libpcap وWinPcap وNpcap وDPDK وAF_XDP وWinDivert وPF_RING
3. __Common++__ - مكتبة تحتوي على بعض الأدوات البرمجية الشائعة المستخدمة من قبل كلٍ من Packet++ وPcap++
يمكنك العثور على توثيق موسّع لواجهة برمجة التطبيقات في [قسم توثيق واجهة برمجة التطبيقات](https://pcapplusplus.github.io/docs/api) على موقع PcapPlusPlus الإلكتروني.
إذا لاحظت أي بيانات مفقودة يُرجى [الاتصال بنا](#provide-feedback).
## دعم المنصات المتعددة
PcapPlusPlus مدعومة حاليًا على
__Windows__
<picture>
<img src="https://raw.githubusercontent.com/PcapPlusPlus/pcapplusplus.github.io/master/static/img/os-logos/logo-windows.png" alt="" width="16" height="16"/>
</picture>,
__Linux__
<picture>
<img src="https://raw.githubusercontent.com/PcapPlusPlus/pcapplusplus.github.io/master/static/img/os-logos/logo-linux.png" alt="" width="16" height="16"/>
</picture>,
__MacOS__
<picture><source media="(prefers-color-scheme: dark)" srcset="https://github.com/PcapPlusPlus/pcapplusplus.github.io/raw/master/static/img/os-logos/logo-apple-dark.png"/>
<img src="https://raw.githubusercontent.com/PcapPlusPlus/pcapplusplus.github.io/master/static/img/os-logos/logo-apple.png" alt="" width="16" height="16"/>
</picture>,
__Android__
<picture>
<img src="https://raw.githubusercontent.com/PcapPlusPlus/pcapplusplus.github.io/master/static/img/os-logos/logo-android.png" alt="" width="16" height="16"/>
</picture> و
__FreeBSD__
<picture>
<img src="https://raw.githubusercontent.com/PcapPlusPlus/pcapplusplus.github.io/master/static/img/os-logos/logo-freebsd.png" alt="" width="16" height="16"/>
</picture>.
يُرجى زيارة موقع PcapPlusPlus الإلكتروني للاطلاع على جميع [المنصات المدعومة](https://pcapplusplus.github.io/docs/platforms) والرجوع إلى قسم [التنزيل](#download) لبدء استخدام PcapPlusPlus على منصتك.
## بروتوكولات الشبكة المدعومة
تدعم PcapPlusPlus حاليًا تحليل وتحرير وإنشاء حزم البروتوكولات التالية:
### طبقة ربط البيانات (L2)
1. Cisco HDLC
2. Ethernet II
3. IEEE 802.3 Ethernet
4. LLC (Only BPDU supported)
5. Null/Loopback
6. Packet trailer (a.k.a footer or padding)
7. PPPoE
8. SLL (Linux cooked capture)
9. SLL2 (Linux cooked capture v2)
10. STP
11. VLAN
12. VXLAN
13. Wake on LAN (WoL)
14. NFLOG (Linux Netfilter NFLOG) - التحليل فقط (بدون قدرات تحرير)
### طبقة الشبكة (L3)
15. ARP
16. GRE
17. ICMP
18. ICMPv6
19. IGMP (IGMPv1 وIGMPv2 وIGMPv3 مدعومة)
20. IPv4
21. IPv6
22. MPLS
23. NDP
24. Raw IP (IPv4 & IPv6)
25. VRRP (IPv4 & IPv6)
26. WireGuard
### طبقة النقل (L4)
27. COTP
28. GTP (v1 & v2)
29. IPSec AH & ESP - التحليل فقط (بدون قدرات تحرير)
30. QUIC v1 - التحليل فقط (بدون قدرات تحرير)
31. TCP
32. TPKT
33. UDP
### طبقة الجلسة (L5)
34. SDP
35. SIP
### طبقة العرض (L6)
36. SSL/TLS - التحليل فقط (بدون قدرات تحرير)
### طبقة التطبيقات (L7)
37. ASN.1 decoder and encoder
38. BGP (v4)
38. Cryptographic key decoders
40. DHCP
41. DHCPv6
42. DNS
43. DoIP
44. FTP
45. GVCP
46. HTTP headers (request & response)
47. LDAP
48. Modbus
49. MySQL - التحليل فقط (بدون قدرات تحرير)
50. NTP (v3, v4)
51. PEM decoder and encoder
52. PostgreSQL Wire Protocol (PGWire) - التحليل فقط (بدون قدرات تحرير)
53. Radius
54. S7 Communication (S7comm)
55. SMTP
56. SOME/IP
57. SSH - التحليل فقط (بدون قدرات تحرير)
58. Telnet - التحليل فقط (بدون قدرات تحرير)
59. X509 certificates - التحليل فقط (بدون قدرات تحرير)
60. Generic payload
## دعم DPDK و PF_RING
[The Data Plane Development Kit (DPDK)](https://www.dpdk.org/) هي مجموعة من مكتبات مستوى البيانات ومشغلات وحدات التحكم بواجهة الشبكة لمعالجة الحزم بسرعة.
[PF_RING™](https://www.ntop.org/products/packet-capture/pf_ring/) هو نوع جديد من مقابس الشبكة يحسّن سرعة التقاط الحزم بشكل كبير.
يوفّر كلا الإطارين معالجة سريعة جدًا للحزم (حتى سرعة الخط) ويُستخدمان في العديد من تطبيقات الشبكة مثل الموجّهات وجدران الحماية وموازنات التحميل، إلخ.
توفّر PcapPlusPlus طبقة تجريد C++ فوق DPDK وPF_RING. توفّر طبقة التجريد هذه واجهة سهلة الاستخدام تزيل الكثير من الأعمال الروتينية المتضمنة في استخدام هذه الأطر. يمكنك معرفة المزيد من خلال زيارة صفحتي دعم [DPDK](https://pcapplusplus.github.io/docs/dpdk) و[PF_RING](https://pcapplusplus.github.io/docs/features#pf_ring-support) على موقع PcapPlusPlus الإلكتروني.
## المقاييس المرجعية
استخدمنا مشروع [packet-capture-benchmarks](https://github.com/mfontanini/packet-capture-benchmarks) الخاص بـ Matias Fontanini لمقارنة أداء PcapPlusPlus مع مكتبات C++ أخرى مشابهة (مثل `libtins` و`libcrafter`).
يمكنك رؤية النتائج في صفحة [المقاييس المرجعية](https://pcapplusplus.github.io/docs/benchmark) على موقع PcapPlusPlus الإلكتروني.
## تقديم الملاحظات
سنكون سعداء جدًا بتلقّي ملاحظاتكم، لا تترددوا في التواصل معنا بأي من الطرق التالية:
- افتح تذكرة على GitHub
- انشر رسالة في مجموعة PcapPlusPlus على Google: <https://groups.google.com/d/forum/pcapplusplus-support>
- اطرح سؤالًا على Stack Overflow: <https://stackoverflow.com/questions/tagged/pcapplusplus>
- أرسل بريدًا إلكترونيًا إلى: <[email protected]>
- تابعنا على X: <https://x.com/seladb>
إذا أعجبك هذا المشروع يُرجى __إضافة نجمة لنا على GitHub — فهذا يساعد!__ :star: :star:
يُرجى زيارة [موقع PcapPlusPlus الإلكتروني](https://pcapplusplus.github.io/community) لمعرفة المزيد.
## المساهمة
نقدّر بشدة أي مساهمة في هذا المشروع. إذا كنت مهتمًا بالمساهمة يُرجى زيارة [صفحة المساهمة](https://pcapplusplus.github.io/community#contribute) على موقع PcapPlusPlus الإلكتروني.
## الترخيص
يتم إصدار PcapPlusPlus تحت [ترخيص Unlicense](https://choosealicense.com/licenses/unlicense/).
[](https://choosealicense.com/licenses/unlicense/)