+0
日增长
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 queTop issues
#1001can't capture any traffic on ubuntu 24.04 for chrome/firefox broswer.6 comments · 2026-05-09#999Feature Request: Add libnnzsrv.so (Oracle) TLS master secret extraction support0 comments · 2026-05-07
Discussions
#952Could this work for applications run by wine?1 comments · 2026-03-15#756请问下贵团队有没有意向托管至国内其他平台呢,寻求一个联系方式🤝1 comments · 2025-03-27#738OpenSSL/BoringSSL version detection2 comments · 2025-02-16#732目前不支持在x86手机上运行吗?没有看到对应的ecapture包2 comments · 2025-02-12#711How to Capture Browser Traffic1 comments · 2024-12-31#703Capture network traffic of http3 quic using eCapture1 comments · 2024-12-23#702Try to capture http3/quic packet but failed2 comments · 2024-12-23#675How to more accurately detect OpenSSL 3.0 and later versions from the shared object libssl.so3 comments · 2024-11-26
Latest release
eCapture v2.11.0 v2.11.0 2026-11-14What'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