neo4-svg/packet-mirage
GitHub: neo4-svg/packet-mirage
一款集成流量混淆、ARP 网络侦察和 WiFi 渗透测试功能的轻量级 Python 网络安全工具包。
Stars: 1 | Forks: 0
# Packet Mirage
**Packet Mirage** 是一个轻量级的网络工具包,提供了三个功能强大的 Python 工具,用于网络混淆、侦察和 WiFi 安全测试。
它将噪声生成(HTTP、DNS、ICMP)与网络分析功能结合在一起,适用于防御性研究、授权的安全测试和教育演示。
## 📋 包含内容
Packet Mirage 包含三个独立的工具:
| 工具 | 用途 | 风险等级 | 主要功能 |
|------|---------|-----------|---------------|
| **packet_mirage.py** | 流量混淆 | 较低 | HTTP/DNS/ICMP 噪声,5 个强度级别 |
| **arp.py** | 网络侦察 | 中等 | ARP 映射,拓扑发现,JSON 导出 |
| **wifi_poison.py** | WiFi 安全测试 | **高** | Deauth 攻击,监控模式,可配置功率 |
## ⚠️ 重要的法律声明
**未经授权使用是违法行为** - 每个工具都有特定的法律含义:
- **packet_mirage.py:** 风险较低,但逃避监控需要获得授权
- **arp.py:** 风险中等,网络侦察需要书面许可
- **wifi_poison.py:** **高风险** - 未经授权即构成网络攻击
**在使用所有工具之前,必须获得网络所有者的明确书面许可。**
违规行为可能导致:
- 🚨 最高 **10 年监禁**(CFAA、《计算机滥用法》)
- 💰 巨额罚款(GDPR、NIS2、各州法律)
- 🔒 在大多数司法管辖区受到刑事起诉
**在继续之前,请仔细阅读 [Disclaimer.md](Disclaimer.md) 和 [terms_of_use.md](terms_of_use.md)。**
## 安装说明
```
git clone https://github.com/neo4-svg/packet-mirage.git
cd packet-mirage
pip install scapy # Required for all tools
```
## 🔧 工具文档
### 1. packet_mirage.py - 流量混淆
生成随机虚假网络流量以掩盖真实活动。
#### 快速开始
```
sudo python3 packet_mirage.py
```
#### 交互式提示
**选择模式:**
- `http` - 虚假 HTTP 请求
- `dns` - 虚假 DNS 查询
- `icmp` - 虚假 ICMP ping 请求
- `mixed` - 所有类型的随机组合
**选择强度:**
- `low` - 数据包之间延迟 2.0 秒(温和)
- `medium` - 延迟 1.0 秒(默认,平衡)
- `high` - 延迟 0.5 秒(激进)
- `max` - 延迟 0.1 秒(非常激进)
- `insane` - 延迟 0.01 秒(极端 - **不推荐**,请参阅警告)
**持续时间:**
- 输入以秒为单位的时间以限制持续时间
- 留空则为无限运行
#### 示例会话
```
=== Packet Mirage ===
Select mode [http/dns/icmp/mixed]: mixed
Select intensity [low/medium/high/max/insane]: high
Duration in seconds (blank = infinite): 120
Running Mirage: mode=mixed, intensity=high, duration=120s
```
#### 工作原理
- **HTTP 模式:** 向 example.com(端口 80)发送随机的 HTTP GET 请求
- **DNS 模式:** 向 8.8.8.8(端口 53)发送随机的 DNS 查询
- **ICMP 模式:** 向 8.8.8.8 发送随机的 ICMP 数据包
- **混合模式:** 每次迭代在 HTTP、DNS 和 ICMP 之间随机选择
#### 前置条件
- sudo/root 权限(用于原始套接字访问)
- 仅限 Linux
### 2. arp.py - 网络侦察
嗅探并分析 ARP(地址解析协议)活动以映射网络关系。
#### 快速开始
```
sudo python3 arp.py
```
#### 功能
- **ARP 活动追踪** - 映射 IP 到 IP 的通信模式
- **网络统计** - 跟踪唯一 IP、数据包计数、主要通信者
- **ARP 频率热图** - ARP 活动的可视化表示
- **JSON 导出** - 导出网络拓扑数据以供分析
- **实时日志记录** - 将 ARP 活动记录到 `arp_log.txt`
#### 交互式设置
1. **法律确认:** 工具会询问是否在合法环境中运行
2. **接口检测:** 自动检测合适的网络接口
3. **ARP 嗅探:** 开始捕获并分析 ARP 数据包
#### 输出表格
**ARP 活动图:**
```
Source IP | Targets
192.168.1.1 | 192.168.1.100, 192.168.1.101
192.168.1.100 | 192.168.1.1, 192.168.1.254
```
**ARP 统计数据:**
```
Metric | Value
Total ARP Packets | 1024
Unique IPs Seen | 42
Top Talker | 192.168.1.1
```
#### 文件输出
- **arp_log.txt** - 逐行记录 ARP 活动
- **arp_export.json** - 导出网络拓扑和统计数据的 JSON
#### 前置条件
- sudo/root 权限
- 仅限 Linux
- Scapy 库
- 网络所有者的许可
#### 示例输出
```
{
"arp_graph": {
"192.168.1.1": ["192.168.1.100", "192.168.1.101"],
"192.168.1.100": ["192.168.1.1", "192.168.1.254"]
},
"unique_ips": ["192.168.1.1", "192.168.1.100", "192.168.1.101"],
"packet_count": 1024,
"arp_frequency": {"192.168.1.1": 512, "192.168.1.100": 256}
}
```
### 3. wifi_poison.py - WiFi 安全测试
发送 IEEE 802.11 取消认证帧以进行 WiFi 渗透测试。
#### ⚠️ 严重警告:高风险工具
**此工具会直接对 WiFi 网络发起攻击。未经授权使用属于刑事犯罪。**
#### 快速开始
```
sudo python3 wifi_poison.py
```
#### 前置条件
#### 交互式设置
**监控接口:**
- 默认:`wlan0mon`
- 工具会自动将接口置于监控模式
- 攻击结束后退出监控模式
**目标路由器 BSSID:**
- 输入 WiFi 路由器的 MAC 地址
- 示例:`AA:BB:CC:DD:EE:FF`
- 使用 WiFi 扫描工具查找 BSSID
**目标客户端 MAC:**
- 特定要断开连接的客户端 MAC,或
- 留空则为 `ff:ff:ff:ff:ff:ff`(所有客户端)
**功率级别:**
- `low` - 40 个数据包/秒(温和断开)
- `medium` - 100 个数据包/秒(效果好,默认)
- `high` - 200 个数据包/秒(强烈攻击)
- `insane` - 350 个数据包/秒(非常激进)
**持续时间:**
- 以秒为单位指定攻击持续时间(默认:15)
#### 示例会话
```
=== Packet Mirage - WiFi Poison Mode ===
Enter monitor interface [wlan0mon]: wlan0mon
[+] Putting wlan0 into monitor mode...
[+] Monitor mode activated.
Are you running this in a legal environment? [y/n] > y
Enter Target Router BSSID (MAC Address): AA:BB:CC:DD:EE:FF
Target Client MAC (press Enter for all clients):
Choose power level (medium): high
Attack duration in seconds (15): 30
🚀 Starting HIGH WiFi Poison Attack...
Target AP : AA:BB:CC:DD:EE:FF
Target Client: ff:ff:ff:ff:ff:ff
Duration : 30 seconds
Power : HIGH (200 packets/sec)
[+] Sent 300 deauth packets...
✅ Attack finished. 1200 packets sent.
Clients should reconnect automatically.
```
#### 技术细节
- **协议:** IEEE 802.11 取消认证帧
- **机制:** 发送原因代码为 7 (CLASS3_FRAME_FROM_NONASSOC_STA) 的取消认证帧
- **效果:** 强制 WiFi 客户端断开连接并重新连接
- **持续时间:** 可配置的攻击窗口
#### 安全与法律
✅ **授权使用:**
- 您自己的 WiFi 网络
- 网络所有者的书面授权
- 渗透测试合同
- 受控实验室环境
- 经许可的课堂演示
❌ **禁止事项:**
- 任何未获得明确书面授权的网络
- 公共 WiFi 网络
- 邻居的网络
- 未经 IT 批准的企业网络
- 恶意破坏或骚扰
#### 前置条件
- sudo/root 权限
- 仅限 Linux
- 支持监控模式的 WiFi 适配器
- Scapy 库
- **网络所有者的明确书面授权**
## 前置条件
- **Linux**(不支持 macOS/Windows - 没有原始套接字)
- **Python 3.8+**
- **sudo/root 权限**(所有工具都需要原始套接字或监控模式访问权限)
- **Scapy**(用于数据包构造和 WiFi 功能)
安装依赖项:
```
sudo pip install scapy
```
## 🚨 警告与安全提示
### Insane 模式 - 不推荐
packet_mirage.py 中的“insane”强度(0.01 秒延迟)具有严重的风险:
**风险:**
- 🔥 可能导致家用/小型办公室路由器崩溃
- 🚨 ISP 监控系统可能会将其标记为攻击(暂停账户、IP 列入黑名单)
- 💥 可能使整个网络不可用
- ⚠️ 可能会损坏网络硬件
**安全的替代方案:** 在正常操作中使用 `high` 强度(0.5 秒延迟)。
### WiFi Poison 的法律风险
未经授权的 WiFi 攻击可能导致:
- **10 年以上监禁**(CFAA - 美国)
- **刑事起诉**(大多数国家)
- 来自网络所有者的**民事责任**
- 因射频干扰受到的 **FCC 罚款**
### 网络侦察风险
未经授权的 ARP 嗅探/映射可能导致:
- **违反《计算机滥用法》**(英国,最高 10 年)
- **未经授权访问指控**(CFAA - 美国)
- **违反 NIS2**(欧盟,巨额罚款)
- 来自网络所有者的**民事责任**
## 工作原理
### packet_mirage.py
- 创建原始 TCP/UDP 套接字
- 生成发往指定目的地的随机数据包
- 以可配置的间隔发送
- 通过噪声提供流量混淆
### arp.py
- 使用 Scapy 嗅探网络数据包
- 过滤 ARP 协议帧
- 构建 IP 关系图
- 跟踪数据包频率和通信模式
- 以 JSON 格式导出数据
### wifi_poison.py
- 在无线接口上启用监控模式
- 构造 IEEE 802.11 取消认证帧
- 以指定的功率级别注入数据帧
- 管理接口模式的设置/卸除
## 法律与道德
使用 Packet Mirage,即表示您同意:
- ✅ 在测试任何网络之前获得明确的书面授权
- ✅ 仅将工具用于合法目的
- ✅ 遵守所有适用法律(CFAA、《计算机滥用法》、NIS2 等)
- ✅ 对您的行为承担全部法律责任
- ✅ 不将工具用于未经授权的攻击或破坏
**有关完整的法律信息,请参阅 [Disclaimer.md](Disclaimer.md) 和 [terms_of_use.md](terms_of_use.md)。**
## 许可证
MIT 许可证 - 有关详细信息,请参阅 [LICENSE](LICENSE)
## 参考文献
- **Scapy 文档:** https://scapy.readthedocs.io/
- **IEEE 802.11 取消认证:** RFC 802.11
- **ARP 协议:** RFC 826
- **计算机欺诈和滥用法:** https://www.law.cornell.edu/uscode/text/18/1030
- **《计算机滥用法 1990》:** https://www.legislation.gov.uk/ukpga/1990/18/contents
- **GDPR:** https://gdpr-info.eu/
**由 @neo4-svg 制作** | 教育安全研究工具
⚠️ **记住:** 能力越大,责任越大。请明智、合法、符合道德地使用。
标签:逆向工具