
Demultiplexor de paquetes TCP/IP. Descargar desde:
Descargas: https://github.com/simsong/tcpflow/releases
La compilación con Autotools es la ruta compatible de CI y de versiones. Ejecute las comprobaciones desde una
copia de trabajo con make -f Makefile.ci bootstrap native; distcheck también recompila,
prueba, instala y desinstala la distribución de código fuente generada.
Después de ./configure, make ci compila y prueba el directorio de compilación actual,
incluidas las compilaciones dentro del árbol; sus pruebas de regresión se ejecutan en serie. Los objetivos separados
asan, tsan, ubsan, clang-analyzer, clang-tidy, cppcheck y coverage
utilizan directorios .build/ aislados. La CI también ejecuta pruebas de tiempo de ejecución de Windows,
comprobaciones de compatibilidad con Debian y de FreeBSD/OpenBSD. CodeQL se ejecuta por separado
mediante la configuración predeterminada de GitHub existente en el repositorio. Consulte el detallado
procedimiento de CI/versiones y la comparación con los repositorios de referencia.
Una etiqueta anotada v<version> en un commit ya fusionado en main activa
todas las compuertas de versión y produce un .tar.gz de código fuente, paquetes .snap
nativos amd64/arm64, un tcpflow64.exe independiente firmado con Authenticode y SHA256SUMS.
El EXE no requiere DLLs de aplicación y procesa archivos PCAP sin conexión; su compilación
no incluye captura en vivo, filtros BPF, decodificación Wi-Fi ni informes PDF de Cairo.
Windows reemplaza los dos puntos en los componentes generados de nombres de archivo de IPv6/MAC/marca de tiempo
con guiones bajos; los valores de direcciones de red en los informes conservan su formato normal.
Los Snaps conservan el soporte nativo de PCAP/PDF y se publican solo en GitHub.
El flujo de trabajo verifica las descargas del borrador completo antes de publicarlo.
Configuración (nunca coloques valores secretos en los archivos fuente):
| Variable | Propósito |
|---|---|
CI_JOBS | Trabajos de compilación en paralelo, predeterminado 2; las regresiones de shell se ejecutan en serie. |
CI_BUILD_ROOT | Raíz aislada de compilación/informes, predeterminada .build bajo el directorio de invocación. |
CONTAINER_ENGINE, CHECK | CLI de contenedor (predeterminado finch) y objetivos de Makefile.ci para container-check. |
CC, CXX, CPPFLAGS, CFLAGS, CXXFLAGS, LDFLAGS, LIBS, PKG_CONFIG_LIBDIR | Configuración estándar de compilador, inclusión/biblioteca y pkg-config de destino. |
SDKROOT | SDK de macOS instalado seleccionado explícitamente para el análisis local de Clang. |
ASAN_OPTIONS, TSAN_OPTIONS, UBSAN_OPTIONS | Diagnósticos de tiempo de ejecución de los sanitizadores; la CI se detiene ante errores y habilita la detección de fugas en Linux. |
WINDOWS_DEPS | Prefijo de dependencias estáticas de MinGW para el objetivo windows. |
VCPKG_ROOT, VCPKG_COMMIT | Directorio de dependencias de Windows y revisión fijada de vcpkg en la CI. |
SNAPCRAFT_BUILD_ENVIRONMENT | Proveedor de compilación de Snapcraft; la CI usa lxd. |
FONTCONFIG_FILE, XDG_CACHE_HOME | Configuración de fuentes incluidas proporcionada por Snap y ubicación de caché de fuentes escribible para informes PDF. |
RELEASE_TAG, RELEASE_COMMIT | Etiqueta de versión anotada y commit de código fuente inmutable exacto para la verificación previa. |
EXE | Ruta del ejecutable independiente para windows-test. |
CODECOV_TOKEN | Secreto de GitHub para el envío autenticado de cobertura. |
AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_SUBSCRIPTION_ID | Configuración de identidad no secreta para el inicio de sesión OIDC de GitHub. |
AZURE_SIGNING_ENDPOINT, AZURE_SIGNING_ACCOUNT, AZURE_SIGNING_PROFILE | Configuración no secreta del servicio/perfil de Artifact Signing. |
WINDOWS_PUBLISHER | Asunto exacto del certificado público requerido por el verificador de firmas. |
GH_TOKEN | Token de GitHub proporcionado por el flujo de trabajo para la creación de borradores, la verificación de descargas y la publicación. |
GitHub proporciona las variables de contexto GITHUB_* y RUNNER_*. La firma está restringida
al entorno protegido windows-signing; no se almacena ninguna clave de firma privada
en el repositorio. CMake sigue siendo una ruta de compilación heredada y no es una compuerta de versión.
La mayoría de las distribuciones comunes de GNU/Linux incluyen tcpflow en sus repositorios. Así que en Debian/Ubuntu/etc. puede decir
sudo apt-get install tcpflow
y en Fedora/RedHat/CentOS/etc puedes ejecutar
sudo dnf install tcpflow
Y eso es todo. Si esto no es suficiente por algún motivo, puedes compilar desde el código fuente:
Para compilar en Linux
Asegúrate de tener los prerrequisitos necesarios. Hay archivos en el directorio raíz que harán esto por ti, dependiendo de tu sistema operativo anfitrión:
CONFIGURE_ARCH_17_8.sh CONFIGURE_FEDORA_18.sh CONFIGURE_FEDORA_26.sh CONFIGURE_UBUNTU_16_04.sh
Dependiendo de tu SO, simplemente:
# sudo bash CONFIGURE_<TU_SO>.sh
Una vez que hayas configurado tu SO, compila e instala con:
./configure
make
sudo make install
Si quieres descargar el árbol de desarrollo con git, asegúrate de hacer un checkout completo con --recursive y luego ejecutar bootstrap.sh, configure y make:
git clone --recursive https://github.com/simsong/tcpflow.git
cd tcpflow
bash bootstrap.sh
./configure
make
sudo make install
Para descargar y compilar para Amazon AMI:
ssh ec2-user@<tu instancia ec2>
sudo bash yum -y install git make gcc-c++ automake autoconf boost-devel cairo-devel libpcap-devel openssl-devel zlib-devel
git clone --recursive https://github.com/simsong/tcpflow.git
sh bootstrap.sh
Para compilar para Windows con mingw en Fedora Core:
yum -y install mingw64-gcc mingw64-gcc-c++ mingw64-boost mingw64-cairo mingw64-zlib
mingw64-configure
make
Para usar CMake, consulta las instrucciones detalladas: cmake/README.md
Desde un repositorio limpio como usuario normal (no root):
./bootstrap.sh # Genera el archivo ./configure
./configure # Genera el archivo tcpflow.spec
rpmbuild -bb tcpflow.spec --build-in-place
Verifica el archivo spec y el RPM resultante:
rpmlint tcpflow.spec
rpmlint ~/rpmbuild/RPMS/x86_64/tcpflow-....rpm
Instalar:
sudo dnf install ~/rpmbuild/RPMS/x86_64/tcpflow-....rpm
tcpflow es un programa que captura los datos transmitidos como parte de conexiones TCP (flujos) y almacena los datos de una forma conveniente para el análisis de protocolos y la depuración. Cada flujo TCP se almacena en su propio archivo. Así, el flujo TCP típico se almacenará en dos archivos, uno por cada dirección. tcpflow también puede procesar flujos de paquetes 'tcpdump' almacenados.
tcpflow almacena todos los datos capturados en archivos que tienen nombres con la forma:
[timestampT]sourceip.sourceport-destip.destport[--VLAN][cNNNN]