krisarmstrong/network-tools

GitHub: krisarmstrong/network-tools

一套集成链路层发现、PCAP 解析、WiFi 分析、交换机管理和 TCP 监控的 Python 网络运维工具集。

Stars: 0 | Forks: 0

# network-tools [![检查](https://static.pigsec.cn/wp-content/uploads/repos/2026/06/b447d5d5e0022922.svg)](https://github.com/krisarmstrong/network-tools/actions/workflows/checks.yml) [![CI](https://static.pigsec.cn/wp-content/uploads/repos/2026/06/74f919c6cf022928.svg)](https://github.com/krisarmstrong/network-tools/actions) [![许可证: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/) [![代码风格: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) 以前位于 `network_discovery`、`network_discovery_listener`、`network_discovery_parser`、 `pcap_parser` 和 `packet_listener_linux_perf_test` 中的所有内容现在都集中在这里了。 ``` pip install . network-tools --help ``` ## 命令 ### `network-tools listen` 实时(`--interface eth0`)或从 PCAP 文件(`--pcap capture.pcap`)捕获 CDP/LLDP/EDP/FDP 数据包。 结果会追加到 `--output` 指定的文件中(默认为 `discovery_log.txt`)。 ### `network-tools parse-json` 解析 NetAlly 的 `discovery.json` 主机列表,打印格式化的主机信息,并统计有效的 IPv4 地址数量。 ``` network-tools parse-json discovery.json ``` ### `network-tools filter-pcap` 过滤 NetAlly reflector 流量(MAC 前缀 `00:c0:17`,UDP/TCP 端口 3842)并导出数据包详细信息。 ``` network-tools filter-pcap reflector_capture.pcap reflector_report.txt ``` ## 开发与 CI ``` python -m venv .venv && source .venv/bin/activate pip install -e .[test] python -m pytest ``` 本仓库自带 `nox -s tests` 和 `.github/workflows/ci.yml`;版本信息存储在 `pyproject.toml` 中, 并且 release-please 负责管理标签和更新日志条目。 ## 数据包性能监听器 最初基于 C 语言的高性能监听器(来自 `packet_listener_linux_perf_test`)已被保留在 `extras/packet_listener_linux/` 目录下。当你需要进行 raw-socket 吞吐量测试时,可以在 Linux 主机上使用 `cmake` 或 `gcc` 进行构建。 ## WiFi 分析 全面的 Wi-Fi 数据包解析与分析功能(合并自 wi-fi-packet-parser)。 ### 功能 - PCAP 文件解析 - Wi-Fi 帧分析 - OUI 查询与厂商识别 - 信道与信号强度分析 ## 交换机管理 网络交换机端口查询与管理功能(合并自 switch-port-query)。 ### 功能 - 基于 SNMP 的端口查询 - 端口配置管理 - VLAN 信息检索 - PoE 状态监控 ## 网络监控 TCP 连接监控工具(合并自 tping-monitor)。 ### 功能 - TCP ping (tcping) 功能 - 持续网络监控 - 连接延迟跟踪 - 可用性报告 ## 文档 - [WiFi 数据包解析器](docs/WIFI_PARSER.md) - [交换机端口查询](docs/SWITCH_QUERY.md) - [TCP Ping 监控器](docs/TPING_MONITOR.md) 基于以下项目增强而来: - wi-fi-packet-parser - switch-port-query - tping-monitor ## 开发 运行完整的本地检查: ``` ./check.sh ```
标签:Bash脚本, Maven构建, PCAP解析, Python, 安全规则引擎, 无后门, 流量抓取与解析, 网络发现, 网络工具, 逆向工具