PcapAnalyzer
西班牙语版本:README.es.md。
几秒内定位网络故障,而不是几小时。上传一个 .pcap / .pcapng 抓包文件(也支持 gzip),PcapAnalyzer 会告诉你哪里出了问题、为什么,以及接下来该检查什么。它运行在你自己的机器上,抓包文件永远不会离开你的网络。
免费且开源(Apache 2.0)。状态:beta。
- 无需安装即可试用:https://pcap-analyzer-seven.vercel.app/#demo
- 下载:https://sebaandrada6.gumroad.com/l/hspgx(免费)或克隆此仓库。
功能
- 27 个检测器会针对每个抓包文件运行,每个都有严重级别和下一步建议:TCP:防火墙拦截(SYN→RST)、重传、重复 ACK、丢包与乱序、零窗口与满窗口、握手后的重置、慢握手。路径:PMTUD 黑洞、低 MSS、IP 分片、ICMP 错误、路由环路。名称与地址服务:无响应或缓慢的 DNS、SERVFAIL、NXDOMAIN 突发、DHCP NAK / DECLINE / 无响应、重复 IP、ARP 风暴。应用:HTTP 4xx / 5xx 和慢响应、TLS 告警、SSL 3.0 / TLS 1.0 / 1.1。隧道:IPsec(IKE 和 ESP)、WireGuard、OpenVPN、GRE、L2TP 和 Teredo 单向、从不响应握手或反复重新协商。安全:端口扫描和扫描探测、明文登录(FTP、POP3、IMAP、SMTP AUTH、HTTP Basic;凭据从不存储或显示)、Telnet / SMBv1 / SNMP v1-v2c、ARP 欺骗、重叠 IP 分片。
- TCP:防火墙拦截(SYN→RST)、重传、重复 ACK、丢包与乱序、零窗口与满窗口、握手后的重置、慢握手。
- 路径:PMTUD 黑洞、低 MSS、IP 分片、ICMP 错误、路由环路。
- 名称与地址服务:无响应或缓慢的 DNS、SERVFAIL、NXDOMAIN 突发、DHCP NAK / DECLINE / 无响应、重复 IP、ARP 风暴。
- 应用:HTTP 4xx / 5xx 和慢响应、TLS 告警、SSL 3.0 / TLS 1.0 / 1.1。
- 隧道:IPsec(IKE 和 ESP)、WireGuard、OpenVPN、GRE、L2TP 和 Teredo 单向、从不响应握手或反复重新协商。
- 安全:端口扫描和扫描探测、明文登录(FTP、POP3、IMAP、SMTP AUTH、HTTP Basic;凭据从不存储或显示)、Telnet / SMBv1 / SNMP v1-v2c、ARP 欺骗、重叠 IP 分片。
- 抓包质量优先。当抓包本身限制了结果时它会发出警告:镜像端口导致的重复帧、单向流量、截断的数据包、抓包开始时已经打开的连接。
- Wireshark 风格视图:对整个抓包文件应用真实 Wireshark 显示过滤器的数据包列表、着色、CSV 导出、专家信息、HTTP / DNS / DHCP / TLS 表格、响应时间以及每个会话的流图。
- AI 调查(可选):AI 使用工具(真实过滤器、流详情、统计)调查抓包文件,并为每项结论引用背后的数据包。随后你可以提出追问。它使用你自己的 Anthropic API key;没有 key 时,演示模式会用基于分析生成的文本运行完整流程,且不产生费用。
- PDF 报告,西班牙语和英语界面,浅色和深色主题。
快速开始
你需要带 Docker Compose 的 Docker。在 Windows 上,请从 Git Bash 或 WSL 运行脚本。
git clone https://github.com/sebaandrada-cell/PcapAnalyzer.git
cd PcapAnalyzer
./start.sh
脚本会创建一个随机访问令牌(只显示一次,存储在 .env 中)并启动应用。构建完成后,打开 http://localhost:8080,将令牌粘贴到右上角的 "API token" 字段,然后上传一个抓包文件,或点击 "Try the sample capture"。
应用只监听 127.0.0.1。不要在未配置带身份验证的反向代理的情况下将其暴露到网络上:该 API 可以使用你的 AI 账户。QUICKSTART.md 中有详细说明、AI 配置和故障排查。
不使用 Docker
你需要 Python 3.9+、Node 20+ 和 tshark(随 Wireshark 安装)。
cd backend
python3 -m venv .venv
.venv/bin/pip install -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
打开 http://localhost:5173 并粘贴同一个 token。如果 tshark 不在你的 PATH 中,请将 TSHARK_PATH 设置为该二进制文件的路径。
隐私
- 抓包数据在你的机器上进行分析。在 AI 调查进行期间,它会以加密形式保留(60 分钟无操作后,或直到你按下“Delete capture now”),随后被删除。
- AI 是可选的。它只能看到其工具返回的内容(数据包元数据;仅当你为该会话开启时才会看到数据包内容),永远看不到 pcap 文件。
- 自托管版本没有遥测,也没有账户。
测试
cd backend && .venv/bin/python -m pytest -q # needs tshark
cd frontend && npm test
反馈
PcapAnalyzer 处于 beta 阶段。它已使用合成测试夹具和公开样本抓包进行过测试,最有用的反馈是一份它漏报了某个问题、或误报了某个并不存在的问题的抓包。请在 https://github.com/sebaandrada-cell/PcapAnalyzer/issues 提交 issue 并描述该情况。不要附上包含真实凭据或客户数据的抓包;请先将其匿名化,或描述其特征模式。
技术参考(JSON schema、检测器阈值、限制、API 错误)在 README.es.md 中,为西班牙语。
许可证
Apache License 2.0。第三方软件见 NOTICE:tshark / Wireshark(GPL)作为独立程序运行,不随 PcapAnalyzer 分发。