
Demultiplexador de pacotes TCP/IP. Baixar de:
Downloads: https://github.com/simsong/tcpflow/releases
A compilação com Autotools é o caminho suportado de CI e de release. Execute as verificações a partir de
um checkout com make -f Makefile.ci bootstrap native; distcheck também recompila,
testa, instala e desinstala a distribuição de código-fonte gerada.
Após ./configure, make ci compila e testa o diretório de compilação atual,
inclusive compilações in-tree; seus testes de regressão são executados em série. Alvos separados
asan, tsan, ubsan, clang-analyzer, clang-tidy, cppcheck e coverage
usam diretórios .build/ isolados. A CI também executa testes de runtime no Windows,
verificações de compatibilidade com Debian e FreeBSD/OpenBSD. O CodeQL é executado separadamente
por meio da configuração padrão existente do GitHub no repositório. Consulte o detalhado
procedimento de CI/release e a comparação com os repositórios de referência.
Uma tag anotada v<version> em um commit já mesclado em main dispara
todos os portões de release e produz um .tar.gz de código-fonte, pacotes .snap
nativos amd64/arm64, um tcpflow64.exe autônomo assinado com Authenticode e SHA256SUMS.
O EXE não requer DLLs de aplicação e processa arquivos PCAP offline; sua compilação
não inclui captura ao vivo, filtros BPF, decodificação Wi-Fi ou relatórios PDF do Cairo.
O Windows substitui os dois-pontos nos componentes de nome de arquivo gerados de IPv6/MAC/timestamp
por sublinhados; os valores de endereço de rede nos relatórios mantêm seu formato normal.
Os Snaps mantêm suporte nativo a PCAP/PDF e são publicados apenas no GitHub.
O workflow verifica os downloads do rascunho completo antes de publicá-lo.
Configuration (ne jamais mettre de valeurs secrètes dans les fichiers sources) :
| Variável | Finalidade |
|---|---|
CI_JOBS | Trabalhos de compilação paralelos, padrão 2; as regressões de shell são executadas em série. |
CI_BUILD_ROOT | Raiz isolada de compilação/relatórios, padrão .build sob o diretório de invocação. |
CONTAINER_ENGINE, CHECK | CLI de contêiner (padrão finch) e alvos do Makefile.ci para container-check. |
CC, CXX, CPPFLAGS, CFLAGS, CXXFLAGS, LDFLAGS, LIBS, PKG_CONFIG_LIBDIR | Configurações padrão de compilador, include/biblioteca e pkg-config de destino. |
SDKROOT | SDK do macOS instalado, selecionado explicitamente para análise local com Clang. |
ASAN_OPTIONS, TSAN_OPTIONS, UBSAN_OPTIONS | Diagnósticos de runtime dos sanitizers; a CI para em erros e habilita a detecção de vazamentos no Linux. |
WINDOWS_DEPS | Prefixo de dependências estáticas do MinGW para o alvo windows. |
VCPKG_ROOT, VCPKG_COMMIT | Diretório de dependências do Windows e revisão fixada do vcpkg na CI. |
SNAPCRAFT_BUILD_ENVIRONMENT | Provedor de compilação do Snapcraft; a CI usa lxd. |
FONTCONFIG_FILE, XDG_CACHE_HOME | Configuração de fontes empacotadas fornecida pelo Snap e local gravável de cache de fontes para relatórios PDF. |
RELEASE_TAG, RELEASE_COMMIT | Tag de versão anotada e commit de código-fonte imutável exato para a verificação prévia. |
EXE | Caminho do executável autônomo para windows-test. |
CODECOV_TOKEN | Segredo do GitHub para envio de cobertura autenticado. |
AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_SUBSCRIPTION_ID | Configurações de identidade não secretas para login OIDC do GitHub. |
AZURE_SIGNING_ENDPOINT, AZURE_SIGNING_ACCOUNT, AZURE_SIGNING_PROFILE | Configurações não secretas do serviço/perfil de Assinatura de Artefatos. |
WINDOWS_PUBLISHER | Assunto exato do certificado público exigido pelo verificador de assinatura. |
GH_TOKEN | Token do GitHub fornecido pelo workflow para criação de rascunho, verificação de download e publicação. |
O GitHub fornece as variáveis de contexto GITHUB_* e RUNNER_*. A assinatura é restrita
ao ambiente protegido windows-signing; nenhuma chave de assinatura privada é armazenada
no repositório. O CMake permanece como caminho de compilação legado e não é um portão de release.
A maioria das distribuições GNU/Linux mais comuns inclui o tcpflow em seus repositórios. Assim, no Debian/Ubuntu/etc você pode dizer
sudo apt-get install tcpflow
e no Fedora/RedHat/CentOS/etc você pode usar
sudo dnf install tcpflow
E é isso. Se isso não for suficiente por qualquer motivo, você pode compilar a partir do código-fonte:
Para compilar para Linux
Certifique-se de ter os pré-requisitos necessários. Há arquivos no diretório raiz que farão isso por você, dependendo do seu sistema operacional hospedeiro:
CONFIGURE_ARCH_17_8.sh CONFIGURE_FEDORA_18.sh CONFIGURE_FEDORA_26.sh CONFIGURE_UBUNTU_16_04.sh
Dependendo do seu SO, basta:
# sudo bash CONFIGURE_<SEUSO>.sh
Depois de configurar seu SO, compile e instale com:
./configure
make
sudo make install
Se você quiser baixar a árvore de desenvolvimento com git, certifique-se de fazer um checkout completo com --recursive e então executar bootstrap.sh, configure e make:
git clone --recursive https://github.com/simsong/tcpflow.git
cd tcpflow
bash bootstrap.sh
./configure
make
sudo make install
Para baixar e compilar para Amazon AMI:
ssh ec2-user@<sua instância 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 com mingw no Fedora Core:
yum -y install mingw64-gcc mingw64-gcc-c++ mingw64-boost mingw64-cairo mingw64-zlib
mingw64-configure
make
Para usar CMake, consulte as instruções detalhadas: cmake/README.md
A partir de um repositório limpo como usuário normal (não root):
./bootstrap.sh # Gera o arquivo ./configure
./configure # Gera o arquivo tcpflow.spec
rpmbuild -bb tcpflow.spec --build-in-place
Verifique o specfile e o RPM resultante:
rpmlint tcpflow.spec
rpmlint ~/rpmbuild/RPMS/x86_64/tcpflow-....rpm
Instale:
sudo dnf install ~/rpmbuild/RPMS/x86_64/tcpflow-....rpm
tcpflow é um programa que captura dados transmitidos como parte de conexões TCP (fluxos) e armazena os dados de uma forma conveniente para análise de protocolos e depuração. Cada fluxo TCP é armazenado em seu próprio arquivo. Assim, o fluxo TCP típico será armazenado em dois arquivos, um para cada direção. O tcpflow também pode processar fluxos de pacotes 'tcpdump' armazenados.
O tcpflow armazena todos os dados capturados em arquivos que têm nomes no formato:
[timestampT]sourceip.sourceport-destip.destport[--VLAN][cNNNN]
onde: timestamp é um timestamp opcional do momento em que o primeiro pacote foi visto T é um delimitador que indica que um timestamp foi fornecido sourceip é o endereço IP de origem sourceport é a porta de origem destip é o endereço IP de destino destport é a porta de destino VLAN é a porta VLAN c é um delimitador que indica que múltiplas conexões estão presentes NNNN é um contador de conexões, quando há múltiplas conexões com a mesma combinação de [time]/sourceip/sourceport/destip/destport. Observe que a contagem de conexões raramente ocorre quando o prefixo de timestamp é aplicado.
AQUI estão alguns exemplos: