seladb/pcapplusplusPlattformübergreifende C++-Bibliothek für leistungsstarke Netzwerkpaket-Erfassung, -Parsen, -Erstellung und -Analyse. Unterstützt libpcap, DPDK, AF_XDP, PF_RING und beinhaltet TCP-Reassemblierung, TLS-Fingerprinting und Protokoll-Dekodierung.
<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/) ist eine plattformübergreifende C++-Bibliothek zum Erfassen, Analysieren und Erstellen von Netzwerkpaketen. Sie ist auf Effizienz, Leistungsfähigkeit und einfache Nutzung ausgelegt.
PcapPlusPlus bietet Dekodierungs- und Erstellungsfunktionen für eine große Vielfalt von Netzwerkprotokollen. Außerdem stellt es einfach zu verwendende C++-Wrapper für die beliebtesten Paketverarbeitungs-Engines wie [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) und [PF_RING](https://www.ntop.org/products/packet-capture/pf_ring/) bereit.
Übersetzungen: Englisch · [正體中文](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)
## Inhaltsverzeichnis
- [Inhaltsverzeichnis](#inhaltsverzeichnis)
- [Download](#download)
- [GitHub Release Page](#github-release-page)
- [Homebrew](#homebrew)
- [Vcpkg](#vcpkg)
- [Conan](#conan)
- [Selbst kompilieren](#selbst-kompilieren)
- [Pakete verifizieren](#pakete-verifizieren)
- [Funktionsübersicht](#funktionsübersicht)
- [Erste Schritte](#erste-schritte)
- [API-Dokumentation](#api-dokumentation)
- [Multi-Plattform-Unterstützung](#multi-plattform-unterstützung)
- [Unterstützte Netzwerkprotokolle](#unterstützte-netzwerkprotokolle)
- [Data Link Layer (L2)](#data-link-layer-l2)
- [Network Layer (L3)](#network-layer-l3)
- [Transport Layer (L4)](#transport-layer-l4)
- [Session Layer (L5)](#session-layer-l5)
- [Presentation Layer (L6)](#presentation-layer-l6)
- [Application Layer (L7)](#application-layer-l7)
- [DPDK- und PF_RING-Unterstützung](#dpdk-und-pf_ring-unterstützung)
- [Benchmarks](#benchmarks)
- [Feedback geben](#feedback-geben)
- [Mitwirken](#mitwirken)
- [Lizenz](#lizenz)
## Download
Sie können zwischen dem Download von der GitHub-Release-Seite, der Verwendung eines Paketmanagers oder dem Selbstkompilieren von PcapPlusPlus wählen. Weitere Details finden Sie auf der Seite [Download](https://pcapplusplus.github.io/docs/install) auf der PcapPlusPlus-Website.
[](https://tooomm.github.io/github-release-stats/?username=seladb&repository=PcapPlusPlus)
### GitHub Release Page
<https://github.com/seladb/PcapPlusPlus/releases/latest>
### Homebrew
```shell
brew install pcapplusplus
```
Homebrew-Formeln: <https://formulae.brew.sh/formula/pcapplusplus>
### Vcpkg
Windows:
```text
.\vcpkg install pcapplusplus
```
MacOS/Linux:
```text
vcpkg install pcapplusplus
```
Vcpkg-Port: <https://github.com/microsoft/vcpkg/tree/master/ports/pcapplusplus>
### Conan
```text
conan install "pcapplusplus/[>0]@" -u
```
Das Paket in ConanCenter: <https://conan.io/center/pcapplusplus>
### Selbst kompilieren
Klonen Sie das Git-Repository:
```shell
git clone https://github.com/seladb/PcapPlusPlus.git
```
Folgen Sie den Build-Anweisungen für Ihre Plattform auf der Seite [Build From Source](https://pcapplusplus.github.io/docs/install#build-from-source) auf der PcapPlusPlus-Website.
### Pakete verifizieren
PcapPlusPlus-Releases, die neuer als v23.09 sind, sind mit GitHub-Attestierung signiert. Alle Attestierungen finden Sie [hier](https://github.com/seladb/PcapPlusPlus/attestations). Sie können die Attestierung dieser Pakete mit der GitHub CLI verifizieren. Um Pakete zu verifizieren, können Sie den aktuellsten Anweisungen unter [gh attestation verify](https://cli.github.com/manual/gh_attestation_verify) folgen. Für einfache Anweisungen können Sie den folgenden Befehl verwenden:
```shell
gh attestation verify <path-to-package-file> --repository seladb/PcapPlusPlus
```
und Sie sollten die folgende Ausgabe in Ihrem Terminal sehen:
```shell
✓ Verification succeeded!
```
## Funktionsübersicht
- __Paketerfassung__ durch einen einfach zu verwendenden C++-Wrapper für beliebte Paketerfassungs-Engines wie [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/) und [raw sockets](https://en.wikipedia.org/wiki/Network_socket#Raw_socket) [[Mehr erfahren](https://pcapplusplus.github.io/docs/features#packet-capture)]
- __Paketanalyse und -erstellung__ einschließlich detaillierter Analyse von Protokollen und Schichten, Paketgenerierung und Paketbearbeitung für eine große Vielfalt von [Netzwerkprotokollen](https://pcapplusplus.github.io/docs/features#supported-network-protocols) [[Mehr erfahren](https://pcapplusplus.github.io/docs/features#packet-parsing-and-crafting)]
- __Pakete aus/in Dateien lesen und schreiben__ in den Formaten __PCAP__ und __PCAPNG__ [[Mehr erfahren](https://pcapplusplus.github.io/docs/features#read-and-write-packets-fromto-files)]
- __Paketverarbeitung mit Line Rate__ durch einen effizienten und einfach zu verwendenden C++-Wrapper für [DPDK](https://www.dpdk.org/), [eBPF AF_XDP](https://www.kernel.org/doc/html/next/networking/af_xdp.html) und [PF_RING](https://www.ntop.org/products/packet-capture/pf_ring/) [[Mehr erfahren](https://pcapplusplus.github.io/docs/features#dpdk-support)]
- __Multi-Plattform-Unterstützung__ - PcapPlusPlus wird vollständig auf Linux, MacOS, Windows, Android und FreeBSD unterstützt
- __Paket-Reassembly__ - einzigartige Implementierung von __TCP Reassembly__, die TCP-Retransmission, TCP-Pakete außer der Reihe und fehlende TCP-Daten umfasst, sowie __IP-Fragmentierung und Defragmentierung__ zum Erstellen und Zusammensetzen von IPv4- und IPv6-Fragmenten [[Mehr erfahren](https://pcapplusplus.github.io/docs/features#packet-reassembly)]
- __Paketfilterung__, die die BPF-Filter von libpcap deutlich benutzerfreundlicher macht [[Mehr erfahren](https://pcapplusplus.github.io/docs/features#packet-filtering)]
- __TLS-Fingerprinting__ - eine C++-Implementierung des [JA3- und JA3S](https://github.com/salesforce/ja3) TLS-Fingerprintings [[Mehr erfahren](https://pcapplusplus.github.io/docs/features#tls-fingerprinting)]
## Erste Schritte
Das Schreiben von Anwendungen mit PcapPlusPlus ist sehr einfach und intuitiv. Hier ist eine einfache Anwendung, die zeigt, wie man ein Paket aus einer PCAP-Datei liest und analysiert:
```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;
}
```
Weitere Informationen finden Sie auf der Seite [Getting Started](https://pcapplusplus.github.io/docs/quickstart) auf der PcapPlusPlus-Website. Diese Seite führt Sie durch einige einfache Schritte, um eine App zum Laufen zu bringen.
## API-Dokumentation
PcapPlusPlus besteht aus 3 Bibliotheken:
1. __Packet++__ - eine Bibliothek zum Analysieren, Erstellen und Bearbeiten von Netzwerkpaketen
2. __Pcap++__ - eine Bibliothek zum Abfangen und Senden von Paketen, die Netzwerk- und NIC-Informationen, Statistiken usw. bereitstellt. Sie ist tatsächlich ein C++-Wrapper für Paketerfassungs-Engines wie libpcap, WinPcap, Npcap, DPDK, AF_XDP, WinDivert und PF_RING
3. __Common++__ - eine Bibliothek mit einigen allgemeinen Code-Dienstprogrammen, die sowohl von Packet++ als auch von Pcap++ verwendet werden
Eine umfangreiche API-Dokumentation finden Sie im [API-Dokumentationsbereich](https://pcapplusplus.github.io/docs/api) auf der PcapPlusPlus-Website.
Wenn Ihnen Daten fehlen, [kontaktieren Sie uns bitte](#feedback-geben).
## Multi-Plattform-Unterstützung
PcapPlusPlus wird derzeit unterstützt auf
__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> und
__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>.
Bitte besuchen Sie die PcapPlusPlus-Website, um alle [unterstützten Plattformen](https://pcapplusplus.github.io/docs/platforms) zu sehen, und lesen Sie den Abschnitt [Download](#download), um PcapPlusPlus auf Ihrer Plattform zu verwenden.
## Unterstützte Netzwerkprotokolle
PcapPlusPlus unterstützt derzeit das Analysieren, Bearbeiten und Erstellen von Paketen der folgenden Protokolle:
### Data Link Layer (L2)
1. Cisco HDLC
2. Ethernet II
3. IEEE 802.3 Ethernet
4. LLC (nur BPDU unterstützt)
5. Null/Loopback
6. Packet trailer (auch bekannt als Footer oder 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) - nur Analyse (keine Bearbeitungsfunktionen)
### Network Layer (L3)
15. ARP
16. GRE
17. ICMP
18. ICMPv6
19. IGMP (IGMPv1, IGMPv2 und IGMPv3 werden unterstützt)
20. IPv4
21. IPv6
22. MPLS
23. NDP
24. Raw IP (IPv4 & IPv6)
25. VRRP (IPv4 & IPv6)
26. WireGuard
### Transport Layer (L4)
27. COTP
28. GTP (v1 & v2)
29. IPSec AH & ESP - nur Analyse (keine Bearbeitungsfunktionen)
30. QUIC v1 - nur Analyse (keine Bearbeitungsfunktionen)
31. TCP
32. TPKT
33. UDP
### Session Layer (L5)
34. SDP
35. SIP
### Presentation Layer (L6)
36. SSL/TLS - nur Analyse (keine Bearbeitungsfunktionen)
### Application Layer (L7)
37. ASN.1-Decoder und -Encoder
38. BGP (v4)
38. Kryptografische Schlüssel-Decoder
40. DHCP
41. DHCPv6
42. DNS
43. DoIP
44. FTP
45. GVCP
46. HTTP-Header (Anfrage & Antwort)
47. LDAP
48. Modbus
49. MySQL - nur Analyse (keine Bearbeitungsfunktionen)
50. NTP (v3, v4)
51. PEM-Decoder und -Encoder
52. PostgreSQL Wire Protocol (PGWire) - nur Analyse (keine Bearbeitungsfunktionen)
53. Radius
54. S7 Communication (S7comm)
55. SMTP
56. SOME/IP
57. SSH - nur Analyse (keine Bearbeitungsfunktionen)
58. Telnet - nur Analyse (keine Bearbeitungsfunktionen)
59. X509-Zertifikate - nur Analyse (keine Bearbeitungsfunktionen)
60. Generischer Payload
## DPDK- und PF_RING-Unterstützung
[Das Data Plane Development Kit (DPDK)](https://www.dpdk.org/) ist eine Sammlung von Data-Plane-Bibliotheken und Netzwerkschnittstellencontroller-Treibern für schnelle Paketverarbeitung.
[PF_RING™](https://www.ntop.org/products/packet-capture/pf_ring/) ist ein neuer Typ von Netzwerk-Socket, der die Paketerfassungsgeschwindigkeit drastisch verbessert.
Beide Frameworks bieten sehr schnelle Paketverarbeitung (bis zu Line Speed) und werden in vielen Netzwerkanwendungen wie Routern, Firewalls, Load Balancern usw. eingesetzt.
PcapPlusPlus bietet eine C++-Abstraktionsschicht über DPDK und PF_RING. Diese Abstraktionsschicht bietet eine einfach zu verwendende Schnittstelle, die einen Großteil des Boilerplate-Codes beseitigt, der bei der Verwendung dieser Frameworks anfällt. Weitere Informationen finden Sie auf den Support-Seiten [DPDK](https://pcapplusplus.github.io/docs/dpdk) und [PF_RING](https://pcapplusplus.github.io/docs/features#pf_ring-support) auf der PcapPlusPlus-Website.
## Benchmarks
Wir haben Matias Fontaninis Projekt [packet-capture-benchmarks](https://github.com/mfontanini/packet-capture-benchmarks) verwendet, um die Leistung von PcapPlusPlus mit anderen ähnlichen C++-Bibliotheken (wie `libtins` und `libcrafter`) zu vergleichen.
Die Ergebnisse finden Sie auf der Seite [Benchmarks](https://pcapplusplus.github.io/docs/benchmark) auf der PcapPlusPlus-Website.
## Feedback geben
Wir freuen uns sehr über Feedback. Bitte kontaktieren Sie uns auf eine der folgenden Arten:
- Öffnen Sie ein GitHub-Ticket
- Schreiben Sie eine Nachricht in die PcapPlusPlus-Google-Gruppe: <https://groups.google.com/d/forum/pcapplusplus-support>
- Stellen Sie eine Frage auf Stack Overflow: <https://stackoverflow.com/questions/tagged/pcapplusplus>
- Senden Sie eine E-Mail an: <[email protected]>
- Folgen Sie uns auf X: <https://x.com/seladb>
Wenn Ihnen dieses Projekt gefällt, __geben Sie uns bitte einen Stern auf GitHub — das hilft!__ :star: :star:
Bitte besuchen Sie die [PcapPlusPlus-Website](https://pcapplusplus.github.io/community), um mehr zu erfahren.
## Mitwirken
Wir würden uns sehr über jeden Beitrag zu diesem Projekt freuen. Wenn Sie daran interessiert sind, etwas beizutragen, besuchen Sie bitte die [Beitragsseite](https://pcapplusplus.github.io/community#contribute) auf der PcapPlusPlus-Website.
## Lizenz
PcapPlusPlus wird unter der [Unlicense-Lizenz](https://choosealicense.com/licenses/unlicense/) veröffentlicht.
[](https://choosealicense.com/licenses/unlicense/)