thedarkonejesus/ShibaCuddles

# ShibaCuddles - 高级网络扫描与安全测试套件 ## 🎯 快速开始 ### CLI 模式 ``` # 基础扫描 python main.py 192.168.1.0/24 # 带有 service detection 的激进扫描 python main.py 192.168.1.0/24 --aggressive -vv # 导出结果 python main.py 192.168.1.0/24 --output results.json --format json ``` ### GUI 模式 ``` python gui_launcher.py ``` ## 📦 安装 ### 前置条件 - Python 3.8+ - pip - 对于 WiFi 功能：aircrack-ng 套件 ### 设置 ``` # Clone repository git clone https://github.com/thedarkonejesus/ShibaCuddles.git cd ShibaCuddles # 安装依赖 pip install -r requirements.txt # 安装 WiFi tools (Linux) sudo apt-get install aircrack-ng # Ubuntu/Debian sudo dnf install aircrack-ng # Fedora brew install aircrack-ng # macOS ``` ## 🚀 功能 ### 网络扫描 ✅ **设备发现** - ICMP ping 扫描 - ARP 扫描 - 主机名解析 - MAC 地址检测 ✅ **端口扫描** - TCP 端口扫描 (1-65535) - UDP 端口检测 - Banner 抓取 - 服务版本检测 ✅ **高级分析** - 服务指纹识别（20+ 种服务） - 操作系统指纹识别（基于 TTL） - 漏洞检测 - 实时统计 ### GUI 界面 ✅ **用户友好的仪表板** - 实时扫描进度 - 动态结果表格 - 统计数据可视化 - 全面的日志记录 - 多格式导出 ### WiFi 安全测试 ⚠️ **取消认证（需要 aircrack-ng）** - 设备取消认证 - 广播取消认证攻击 - 监听模式控制 - 网络扫描 - 信道干扰分析 ⚠️ **高级功能** - 创建恶意 AP - 流量分析 - 网络中断测试 ## 📊 CLI 用法 ### 基本命令 ``` # 默认扫描（端口 1-1024） python main.py 192.168.1.0/24 # 特定端口 python main.py 192.168.1.0/24 --ports 22,80,443 python main.py 192.168.1.0/24 --ports 1-5000 # 使用 threading python main.py 192.168.1.0/24 --threads 20 # 带有 services 和 OS detection python main.py 192.168.1.0/24 --service-detection --os-detection # 激进扫描（所有功能） python main.py 192.168.1.0/24 --aggressive # 详细输出 python main.py 192.168.1.0/24 -vv # 自定义 timeout python main.py 192.168.1.0/24 --timeout 10 ``` ### 输出选项 ``` # JSON 导出（默认） python main.py 192.168.1.0/24 --output results.json # CSV 导出 python main.py 192.168.1.0/24 --output results.csv --format csv # XML 导出 python main.py 192.168.1.0/24 --output results.xml --format xml # 文本导出 python main.py 192.168.1.0/24 --output results.txt --format txt ``` ## 🖥️ GUI 功能 ### 扫描配置 - 网络目标（CIDR 表示法） - 自定义端口范围 - 线程数（1-64） - 连接超时 - 切换 ping 扫描 - 切换服务检测 - 切换操作系统指纹识别 - 激进模式 ### 结果查看 - 实时结果表格 - IP 地址、状态、端口、服务、操作系统 - 统计仪表板 - 实时日志输出 - 导出为多种格式 ## ⚠️ WiFi 取消认证（高级） ### 法律警告 **未经授权干扰无线网络在大多数司法管辖区都是违法的。** 仅在以下情况下使用此功能： - 测试您自己的网络 - 授权的渗透测试 - 教育目的 ### 用法 ``` from src.deauth import WiFiDeauthenticator deauth = WiFiDeauthenticator() # 启用 monitor mode deauth.enable_monitor_mode('wlan0') # 对特定设备进行 Deauth target = DeauthTarget( mac_address='AA:BB:CC:DD:EE:FF', gateway_mac='11:22:33:44:55:66', ssid='TestNetwork', channel=6, interface='wlan0mon' ) deauth.deauthenticate_device(target) # 禁用 monitor mode deauth.disable_monitor_mode('wlan0mon') ``` ## 🔍 扫描示例 ### 小型办公网络 ``` python main.py 10.0.0.0/24 --threads 15 --ports 22,80,443,3306,5432 ``` ### 家庭网络安全审计 ``` python main.py 192.168.0.0/24 --aggressive --service-detection --os-detection ``` ### 企业网络评估 ``` python main.py 172.16.0.0/16 --threads 32 --ports 1-10000 --aggressive -vv ``` ## 📊 理解结果 ### JSON 输出格式 ``` [ { "ip": "192.168.1.1", "alive": true, "open_ports": [22, 80, 443], "services": { "22": {"name": "SSH", "version": "OpenSSH 8.2"}, "80": {"name": "HTTP", "version": "Apache 2.4.29"} }, "os_info": {"name": "Linux/Unix", "ttl": 64, "confidence": 95}, "scan_time": 2.34 } ] ``` ## 🛠️ 故障排除 ### 问题：权限被拒绝（WiFi 功能） **解决方案：** ``` sudo chmod +u+s /usr/bin/airmon-ng sudo chmod +u+s /usr/bin/aireplay-ng ``` ### 问题：找不到 PyQt6 **解决方案：** ``` pip install PyQt6 PyQt6-Charts ``` ### 问题：扫描超时 **解决方案：** 增加超时值 ``` python main.py 192.168.1.0/24 --timeout 15 ``` ### 问题：高漏报率 **解决方案：** 禁用 ping 扫描 ``` python main.py 192.168.1.0/24 --no-ping ``` ## 📈 性能提示 1. **多线程**：对于较大的网络使用更多线程 python main.py 10.0.0.0/16 --threads 64 2. **端口范围**：优先扫描常用端口 python main.py 192.168.1.0/24 --ports 22,80,443,3306,5432,8080 3. **速率限制**：降低网络负载 python main.py 192.168.1.0/24 --rate-limit 0.1 4. **超时**：根据网络状况进行调整 python main.py 192.168.1.0/24 --timeout 3 ## 🔐 安全注意事项 - 在扫描网络之前始终获得书面许可 - 遵守当地法律法规 - 不要在您不拥有的网络上使用取消认证功能 - 注意类似 DoS 的行为 - 尊重网络资源 ## 📝 配置文件 创建 `config.yaml` 以设置默认配置： ``` scanning: threads: 20 timeout: 5.0 rate_limit: 0.0 batch_size: 50 features: ping_sweep: true service_detection: false os_detection: false aggressive: false output: format: json export_path: ./results/ ``` ## 📄 许可证 MIT 许可证 - 详情请参阅 [LICENSE](LICENSE) 文件。 ## ⚠️ 免责声明 **ShibaCuddles 按“原样”提供，仅用于教育和授权的安全测试目的。** 未经授权访问计算机系统是违法的。用户有责任确保在对任何网络或系统使用此工具之前已获得适当的授权。 ## 🐙 关于 ShibaCuddles - “因为每个网络都需要一个可爱的扫描仪！” 专为安全专业人员和网络管理员打造，以执行高效、全面的网络评估。 如需了解更多信息，请访问：https://github.com/thedarkonejesus/ShibaCuddles

标签：Python, WiFi安全, 云存储安全, 安全测试, 插件系统, 攻击性安全, 无后门, 网络扫描, 逆向工具, 防御绕过