PcapAnalyzer – self-hosted pcap analyzer with 27 problem detectors

Hacker News by 4 min read 45x views
PcapAnalyzer – self-hosted pcap analyzer with 27 problem detectors

Share Post

Versión en español: README.es.md.

Find the network error in seconds, not hours. Upload a .pcap / .pcapng capture (gzip too) and PcapAnalyzer tells you what is failing, why, and what to inspect next. It runs on your own machine, so captures never depart your network.

Free and open origin (Apache 2.0). Status: beta.

  • 27 detectors that run on all capture, all alongside a severity and a next step:
    • TCP: firewall blocks (SYN→RST), retransmissions, copy ACKs, defeat and reordering, zero and complete windows, resets following the handshake, dilatory handshakes.
    • Path: PMTUD dreary holes, low MSS, IP fragmentation, ICMP errors, routing loops.
    • Name and location services: unanswered or dilatory DNS, SERVFAIL, NXDOMAIN bursts, DHCP NAK / DECLINE / no answer, copy IPs, ARP storms.
    • Applications: HTTP 4xx / 5xx and dilatory responses, TLS alerts, SSL 3.0 / TLS 1.0 / 1.1.
    • Tunnels: IPsec (IKE and ESP), WireGuard, OpenVPN, GRE, L2TP and Teredo that are one-way, never answer a handshake or keep renegotiating.
    • Security: harbor scans and sweeps, cleartext logins (FTP, POP3, IMAP, SMTP AUTH, HTTP Basic; credentials are never stored or shown), Telnet / SMBv1 / SNMP v1-v2c, ARP spoofing, overlapping IP fragments.
  • Capture norm first. It warns whenever the grasp itself limits the result: frames duplicated by a mirror port, traffic seen in one direction only, truncated packets, connections already open whenever the grasp started.
  • Wireshark-style views: packet catalog alongside genuine Wireshark display filters complete the whole capture, colouring, CSV export, expert info, HTTP / DNS / DHCP / TLS tables, response times and a stream diagram per conversation.
  • AI inquiry (optional): an AI investigates the grasp alongside tools (real filters, stream detail, statistics) and cites the packets rearward all claim. You can afterward ask follow-up questions. It uses your own Anthropic API key; without one, a demo manner runs the complete stream alongside content generated from the analysis, at no cost.
  • PDF report, Spanish and English interface, ray and dreary theme.

You need Docker alongside Docker Compose. On Windows, run the manuscript from Git Bash or WSL.

git copy https://github.com/sebaandrada-cell/PcapAnalyzer.git cd PcapAnalyzer ./start.sh

The manuscript creates a random admission token (shown once, stored in .env) and starts the app. When the build finishes, open http://localhost:8080, paste the token into the "API token" site (top right) and upload a capture, or click "Try the example capture".

The app listens on 127.0.0.1 only. Do not disclose it on a network without an authenticated reverse proxy: the API can use your AI account. QUICKSTART.md has the details, the AI setup and troubleshooting.

You need Python 3.9+, Node 20+ and tshark (installed alongside Wireshark).

cd backend python3 -m venv .venv .venv/bin/pip instal -r requirements-dev.txt export API_TOKENS="$(openssl rand -hex 32)" .venv/bin/uvicorn app.main:app --reload
cd frontend npm install npm run dev

Open http://localhost:5173 and paste the identical token. If tshark is not on your PATH, set TSHARK_PATH to the binary.

  • The grasp is analysed on your machine. While an AI inquiry lasts it is kept encrypted (60 minutes of inactivity, or until you media "Delete grasp now") and is then deleted.
  • The AI is optional. It lone sees what its tools come back (packet metadata; packet content lone if you toggle it on for that session), never the pcap file.
  • No telemetry and no accounts for the self-hosted version.
cd backend && .venv/bin/python -m pytest -q # needs tshark cd frontend && npm test

PcapAnalyzer is a beta. It has been tested alongside synthetic fixtures and community sample captures, and the most helpful feedback is a grasp anywhere it misses a issue or reports one that is not real. Please open an matter at https://github.com/sebaandrada-cell/PcapAnalyzer/issues and depict the case. Do not nexus captures that merge genuine credentials or client data; anonymise them archetypal or depict the pattern.

The specialized citation (JSON schema, detector thresholds, limits, API errors) is in README.es.md, in Spanish.

Apache License 2.0. See NOTICE for third-party software: tshark / Wireshark (GPL) runs as a distinct program and is not distributed alongside PcapAnalyzer.

Other Article Hacker News
↑
Close Right Ads
Close Left Ads