gojue /ecapture

Capture SSL/TLS plaintext with eBPF—no MITM proxy or custom CA installation. Supports Linux and Android on x86_64\arm64 and loong64.

★ 15,540⑂ 1,651👁 97⑃ 558● 478▤ 108
CApache-2.0Created 2022-03-13ecapture.cc
Download: eCapture v2.11.0eCapture-2.11.0 ↓2.11.02026-11-14
+0
Daily
15,540
stars
1,651
forks
97
watchers
558
prs
478
issues
108
releases

README

eCapture (旁观者)
  Capture SSL/TLS plaintext with eBPF—no MITM proxy or custom CA installation.



  English · 汉字
  
  
  



  
    
      
      
      
    
  
  
    
      
      
      
    
  


 [!IMPORTANT]
 Supports Linux on x86_64 (kernel 4.18+), aarch64 (kernel 5.5+), and LoongArch64 loong64 (kernel 6.6+). Android supports x86_64 and aarch64 with the existing kernel minimums.
 Requires root privileges or specific Linux capabilities.
 Does not support Windows or macOS.

----


- Introduction
- Getting started
  - Download
    - ELF binary file
    - Docker image
  - Capture OpenSSL plaintext data
  - Modules
    - OpenSSL module
    - GoTLS module
    - Other modules
  - Videos
- Star History
- Security & operations
- Contributing
- Compilation


 Introduction

 Captures plaintext TLS/SSL traffic from OpenSSL, LibreSSL, BoringSSL, GnuTLS, and NSS/NSPR libraries.
 Supports plaintext capture for Go TLS programs, including HTTPS/TLS traffic in Go applications.
 Audits bash and zsh command history for host security monitoring.
 Audits MySQL queries and supports MySQL 5.6/5.7/8.0 and MariaDB.

Run ecapture --help for the commands and flags available in your installed version.

 Getting started

 Download

 ELF binary file

 [!TIP]
 Supports Linux on x86_64, aarch64, and LoongArch64; Android supports x86_64 and aarch64.

Download the ELF binary package from the releases page, extract it, and run:

shell
sudo ecapture --help


 Docker image

 [!TIP]
 Linux only.

shell
 Pull the Docker image
docker pull gojue/ecapture:latest

 Run it
docker run --rm --privileged=true --net=host -v ${HOST_PATH}:${CONTAINER_PATH} gojue/ecapture ARGS


 ⚠️ Security note: --privileged=true grants full host access. For production use, prefer specific capabilities instead. See the Minimum Privileges Guide.

See Docker Hub for more information.

 Capture OpenSSL plaintext data

shell
sudo ecapture tls


eCapture automatically detects the system's OpenSSL library and selects a capture interface: it prefers an up Ethernet interface on the lowest-metric IPv4/IPv6 default route, then falls back to interface traffic counters or an up interface. A startup warning names the selected interface and explains how to override it with -i eth0 or --ifname eth0. Only that interface is captured; use -i lo for loopback traffic. Generate an HTTPS request with an OpenSSL-linked client to see the reconstructed request and response. This synthetic HTTP/1.1 example illustrates the text format:

text
[2026-01-01T12:00:00.000000000Z] http/1.1 request 192.0.2.1:43210 - 192.0.2.2:443 host="example.com" domain_source="Host" connection="17-4-client/192.0.2.1:43210--192.0.2.2:443/tcp2"
GET / HTTP/1.1
Host: example.com



 📄 For output formats and verification examples, see docs/example-outputs.md.

 Modules

The eCapture tool includes 8 modules that can capture plaintext data from TLS/SSL libraries such as OpenSSL, GnuTLS, NSS/NSPR, BoringSSL, and GoTLS. It also supports auditing commands and que

Top issues

Discussions

Latest release

eCapture v2.11.0 v2.11.0 2026-11-14
What's Changed
 ci: parallelize release builds by architecture by @cfc4n in https://github.com/gojue/ecapture/pull/1083
 ci: clean LoongArch E2E artifacts after each job by @cfc4n in https://github.com/gojue/ecapture/pull/1085
 docs: prioritize pcapng for core TLS modules [skip ci] by @cfc4n in https://github.com/gojue/ecapture/pull/1086
 capture: preserve PID and Comm through pcapng decryption by @cfc4n in https://github.com/gojue/ecapture/pull/1087
 pcapng: capture up to 256 bytes of process arguments by @cfc4n in https://github.com/gojue/ecapture/pull/1088
 ecaptureq: expose process argumen

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON