seladb/pcapplusplusBiblioteca C++ multiplataforma para captura, análisis, creación y procesamiento de paquetes de red de alto rendimiento. Compatible con libpcap, DPDK, AF_XDP, PF_RING, e incluye reensamblado TCP, huellas dactilares TLS y decodificación de protocolos.
<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/) es una biblioteca multiplataforma de C++ para la captura, el análisis y la creación de paquetes de red. Está diseñada para ser eficiente, potente y fácil de usar.
PcapPlusPlus ofrece capacidades de decodificación y forjado para una gran variedad de protocolos de red. También proporciona envoltorios de C++ fáciles de usar para los motores de procesamiento de paquetes más populares, como [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) y [PF_RING](https://www.ntop.org/products/packet-capture/pf_ring/).
Traducciones: 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)
## Tabla de contenidos
- [Tabla de contenidos](#tabla-de-contenidos)
- [Descarga](#descarga)
- [Página de versiones de GitHub](#página-de-versiones-de-github)
- [Homebrew](#homebrew)
- [Vcpkg](#vcpkg)
- [Conan](#conan)
- [Compílalo tú mismo](#compílalo-tú-mismo)
- [Verifica tus paquetes](#verifica-tus-paquetes)
- [Resumen de características](#resumen-de-características)
- [Primeros pasos](#primeros-pasos)
- [Documentación de la API](#documentación-de-la-api)
- [Compatibilidad multiplataforma](#compatibilidad-multiplataforma)
- [Protocolos de red compatibles](#protocolos-de-red-compatibles)
- [Capa de enlace de datos (L2)](#capa-de-enlace-de-datos-l2)
- [Capa de red (L3)](#capa-de-red-l3)
- [Capa de transporte (L4)](#capa-de-transporte-l4)
- [Capa de sesión (L5)](#capa-de-sesión-l5)
- [Capa de presentación (L6)](#capa-de-presentación-l6)
- [Capa de aplicación (L7)](#capa-de-aplicación-l7)
- [Compatibilidad con DPDK y PF_RING](#compatibilidad-con-dpdk-y-pf_ring)
- [Benchmarks](#benchmarks)
- [Envía tus comentarios](#envía-tus-comentarios)
- [Contribuir](#contribuir)
- [Licencia](#licencia)
## Descarga
Puedes elegir entre descargarlo desde la página de versiones de GitHub, usar un gestor de paquetes o compilar PcapPlusPlus tú mismo. Para más detalles, visita la página [Download](https://pcapplusplus.github.io/docs/install) en el sitio web de PcapPlusPlus.
[](https://tooomm.github.io/github-release-stats/?username=seladb&repository=PcapPlusPlus)
### Página de versiones de GitHub
<https://github.com/seladb/PcapPlusPlus/releases/latest>
### Homebrew
```shell
brew install pcapplusplus
```
Fórmulas de Homebrew: <https://formulae.brew.sh/formula/pcapplusplus>
### Vcpkg
Windows:
```text
.\vcpkg install pcapplusplus
```
MacOS/Linux:
```text
vcpkg install pcapplusplus
```
Puerto de Vcpkg: <https://github.com/microsoft/vcpkg/tree/master/ports/pcapplusplus>
### Conan
```text
conan install "pcapplusplus/[>0]@" -u
```
El paquete en ConanCenter: <https://conan.io/center/pcapplusplus>
### Compílalo tú mismo
Clona el repositorio de git:
```shell
git clone https://github.com/seladb/PcapPlusPlus.git
```
Sigue las instrucciones de compilación según tu plataforma en la página [Build From Source](https://pcapplusplus.github.io/docs/install#build-from-source) del sitio web de PcapPlusPlus.
### Verifica tus paquetes
Las versiones de PcapPlusPlus posteriores a la v23.09 están firmadas con atestación de GitHub. Todas las atestaciones se pueden encontrar [aquí](https://github.com/seladb/PcapPlusPlus/attestations). Puedes verificar la atestación de estos paquetes con GitHub CLI. Para verificar los paquetes puedes seguir las instrucciones más recientes de [gh attestation verify](https://cli.github.com/manual/gh_attestation_verify). Para instrucciones sencillas puedes usar el siguiente comando:
```shell
gh attestation verify <path-to-package-file> --repository seladb/PcapPlusPlus
```
y deberías ver la siguiente salida en tu terminal:
```shell
✓ Verification succeeded!
```
## Resumen de características
- __Captura de paquetes__ mediante un envoltorio de C++ fácil de usar para motores de captura de paquetes populares como [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/) y [raw sockets](https://en.wikipedia.org/wiki/Network_socket#Raw_socket) [[Más información](https://pcapplusplus.github.io/docs/features#packet-capture)]
- __Análisis y creación de paquetes__, incluyendo el análisis detallado de protocolos y capas, la generación de paquetes y la edición de paquetes para una gran variedad de [protocolos de red](https://pcapplusplus.github.io/docs/features#supported-network-protocols) [[Más información](https://pcapplusplus.github.io/docs/features#packet-parsing-and-crafting)]
- __Lectura y escritura de paquetes desde/hacia archivos__ en formatos __PCAP__ y __PCAPNG__ [[Más información](https://pcapplusplus.github.io/docs/features#read-and-write-packets-fromto-files)]
- __Procesamiento de paquetes a velocidad de línea__ mediante un envoltorio de C++ eficiente y fácil de usar para [DPDK](https://www.dpdk.org/), [eBPF AF_XDP](https://www.kernel.org/doc/html/next/networking/af_xdp.html) y [PF_RING](https://www.ntop.org/products/packet-capture/pf_ring/) [[Más información](https://pcapplusplus.github.io/docs/features#dpdk-support)]
- __Compatibilidad multiplataforma__ - PcapPlusPlus es totalmente compatible con Linux, MacOS, Windows, Android y FreeBSD
- __Reensamblado de paquetes__ - implementación única de __TCP Reassembly__ que incluye retransmisión TCP, paquetes TCP fuera de orden y datos TCP faltantes, y __Fragmentación y desfragmentación IP__ para crear y reensamblar fragmentos IPv4 e IPv6 [[Más información](https://pcapplusplus.github.io/docs/features#packet-reassembly)]
- __Filtrado de paquetes__ que hace que los filtros BPF de libpcap sean mucho más fáciles de usar [[Más información](https://pcapplusplus.github.io/docs/features#packet-filtering)]
- __Huella TLS__ - una implementación en C++ de la huella TLS [JA3 y JA3S](https://github.com/salesforce/ja3) [[Más información](https://pcapplusplus.github.io/docs/features#tls-fingerprinting)]
## Primeros pasos
Escribir aplicaciones con PcapPlusPlus es muy fácil e intuitivo. Aquí tienes una aplicación sencilla que muestra cómo leer un paquete de un archivo PCAP y analizarlo:
```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;
}
```
Puedes encontrar mucha más información en la página [Getting Started](https://pcapplusplus.github.io/docs/quickstart) del sitio web de PcapPlusPlus. Esta página te guiará a través de unos pocos pasos sencillos para tener una aplicación en funcionamiento.
## Documentación de la API
PcapPlusPlus consta de 3 bibliotecas:
1. __Packet++__ - una biblioteca para analizar, crear y editar paquetes de red
2. __Pcap++__ - una biblioteca para interceptar y enviar paquetes, proporcionando información de red y NIC, estadísticas, etc. En realidad es un envoltorio de C++ para motores de captura de paquetes como libpcap, WinPcap, Npcap, DPDK, AF_XDP, WinDivert y PF_RING
3. __Common++__ - una biblioteca con algunas utilidades de código comunes usadas tanto por Packet++ como por Pcap++
Puedes encontrar una extensa documentación de la API en la [sección de documentación de la API](https://pcapplusplus.github.io/docs/api) del sitio web de PcapPlusPlus.
Si ves que falta algún dato, por favor [contáctanos](#envía-tus-comentarios).
## Compatibilidad multiplataforma
Actualmente PcapPlusPlus es compatible con
__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> y
__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>.
Visita el sitio web de PcapPlusPlus para ver todas las [plataformas compatibles](https://pcapplusplus.github.io/docs/platforms) y consulta la sección [Descarga](#descarga) para empezar a usar PcapPlusPlus en tu plataforma.
## Protocolos de red compatibles
Actualmente PcapPlusPlus admite el análisis, la edición y la creación de paquetes de los siguientes protocolos:
### Capa de enlace de datos (L2)
1. Cisco HDLC
2. Ethernet II
3. IEEE 802.3 Ethernet
4. LLC (solo se admite BPDU)
5. Null/Loopback
6. Packet trailer (también conocido como footer o 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) - solo análisis (sin capacidades de edición)
### Capa de red (L3)
15. ARP
16. GRE
17. ICMP
18. ICMPv6
19. IGMP (se admiten IGMPv1, IGMPv2 e IGMPv3)
20. IPv4
21. IPv6
22. MPLS
23. NDP
24. Raw IP (IPv4 e IPv6)
25. VRRP (IPv4 e IPv6)
26. WireGuard
### Capa de transporte (L4)
27. COTP
28. GTP (v1 y v2)
29. IPSec AH y ESP - solo análisis (sin capacidades de edición)
30. QUIC v1 - solo análisis (sin capacidades de edición)
31. TCP
32. TPKT
33. UDP
### Capa de sesión (L5)
34. SDP
35. SIP
### Capa de presentación (L6)
36. SSL/TLS - solo análisis (sin capacidades de edición)
### Capa de aplicación (L7)
37. Decodificador y codificador ASN.1
38. BGP (v4)
38. Decodificadores de claves criptográficas
40. DHCP
41. DHCPv6
42. DNS
43. DoIP
44. FTP
45. GVCP
46. Cabeceras HTTP (petición y respuesta)
47. LDAP
48. Modbus
49. MySQL - solo análisis (sin capacidades de edición)
50. NTP (v3, v4)
51. Decodificador y codificador PEM
52. PostgreSQL Wire Protocol (PGWire) - solo análisis (sin capacidades de edición)
53. Radius
54. S7 Communication (S7comm)
55. SMTP
56. SOME/IP
57. SSH - solo análisis (sin capacidades de edición)
58. Telnet - solo análisis (sin capacidades de edición)
59. Certificados X509 - solo análisis (sin capacidades de edición)
60. Carga útil genérica
## Compatibilidad con DPDK y PF_RING
[The Data Plane Development Kit (DPDK)](https://www.dpdk.org/) es un conjunto de bibliotecas de plano de datos y controladores de interfaz de red para el procesamiento rápido de paquetes.
[PF_RING™](https://www.ntop.org/products/packet-capture/pf_ring/) es un nuevo tipo de socket de red que mejora drásticamente la velocidad de captura de paquetes.
Ambos frameworks proporcionan un procesamiento de paquetes muy rápido (hasta velocidad de línea) y se usan en muchas aplicaciones de red como routers, firewalls, balanceadores de carga, etc.
PcapPlusPlus proporciona una capa de abstracción de C++ sobre DPDK y PF_RING. Esta capa de abstracción proporciona una interfaz fácil de usar que elimina gran parte del código repetitivo que implica el uso de estos frameworks. Puedes obtener más información visitando las páginas de compatibilidad con [DPDK](https://pcapplusplus.github.io/docs/dpdk) y [PF_RING](https://pcapplusplus.github.io/docs/features#pf_ring-support) en el sitio web de PcapPlusPlus.
## Benchmarks
Usamos el proyecto [packet-capture-benchmarks](https://github.com/mfontanini/packet-capture-benchmarks) de Matias Fontanini para comparar el rendimiento de PcapPlusPlus con otras bibliotecas de C++ similares (como `libtins` y `libcrafter`).
Puedes ver los resultados en la página [Benchmarks](https://pcapplusplus.github.io/docs/benchmark) del sitio web de PcapPlusPlus.
## Envía tus comentarios
Estaremos encantados de recibir comentarios; no dudes en ponerte en contacto con nosotros de cualquiera de las siguientes formas:
- Abre un ticket en GitHub
- Publica un mensaje en el grupo de Google de PcapPlusPlus: <https://groups.google.com/d/forum/pcapplusplus-support>
- Haz una pregunta en Stack Overflow: <https://stackoverflow.com/questions/tagged/pcapplusplus>
- Envía un correo electrónico a: <[email protected]>
- Síguenos en X: <https://x.com/seladb>
Si te gusta este proyecto, por favor __danos una estrella en GitHub — ¡ayuda!__ :star: :star:
Visita el [sitio web de PcapPlusPlus](https://pcapplusplus.github.io/community) para obtener más información.
## Contribuir
Agradeceríamos mucho cualquier contribución a este proyecto. Si estás interesado en contribuir, visita la [página de contribución](https://pcapplusplus.github.io/community#contribute) en el sitio web de PcapPlusPlus.
## Licencia
PcapPlusPlus se publica bajo la [licencia Unlicense](https://choosealicense.com/licenses/unlicense/).
[](https://choosealicense.com/licenses/unlicense/)