krisarmstrong/network-tools
GitHub: krisarmstrong/network-tools
一套集成链路层发现、PCAP 解析、WiFi 分析、交换机管理和 TCP 监控的 Python 网络运维工具集。
Stars: 0 | Forks: 0
# network-tools
[](https://github.com/krisarmstrong/network-tools/actions/workflows/checks.yml)
[](https://github.com/krisarmstrong/network-tools/actions)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](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, 安全规则引擎, 无后门, 流量抓取与解析, 网络发现, 网络工具, 逆向工具