hakterderu/portwhisper
GitHub: hakterderu/portwhisper
一款基于异步的轻量级端口扫描器,提供服务指纹识别与 JSON/CSV 导出能力。
Stars: 0 | Forks: 0
# portwhisper
A lightweight async port scanner with service fingerprinting and JSON/CSV export support.
## 安装
```
pip install portwhisper
```
Or install from source:
```
git clone https://github.com/youruser/portwhisper.git && cd portwhisper && pip install .
```
## 用法
Scan a host across a range of ports and export the results:
```
# 基本扫描
portwhisper scan 192.168.1.1 --ports 1-1024
# 启用服务指纹识别和 JSON 导出的扫描
portwhisper scan example.com --ports 22,80,443,8080 --fingerprint --output results.json
# 导出为 CSV
portwhisper scan 10.0.0.1 --ports 1-65535 --output results.csv
# 设置自定义连接超时(秒)
portwhisper scan 192.168.1.1 --ports 1-1024 --timeout 2.0
```
You can also use it programmatically:
```
import asyncio
from portwhisper import Scanner
async def main():
scanner = Scanner(host="192.168.1.1", ports=range(1, 1025))
results = await scanner.run(fingerprint=True)
scanner.export(results, path="output.json")
asyncio.run(main())
```
## 功能
- ⚡ 异步优先设计,实现快速非阻塞扫描
- 🔍 在开放端口上进行服务指纹识别
- 📄 将结果导出为 JSON 或 CSV
- 🎯 灵活的端口目标设定(范围、列表或单个端口)
- ⏱️ 每个扫描可配置连接超时时间
## 许可
This project is licensed under the [MIT License](LICENSE).
标签:JSON导出, Linux工具, pip安装, Python异步, Scrypt密钥派生, URL短链接分析, 二进制发布, 云存储安全, 开源工具, 异步扫描, 批量端口扫描, 数据统计, 服务指纹识别, 服务探测, 灵活端口范围, 端口扫描, 端口探测, 网络扫描, 计算机取证, 跨平台扫描, 连接超时配置, 逆向工具