s-b-repo/rustsploit

# Rustsploit 用于嵌入式目标的模块化攻击工具，使用 Rust 编写，灵感来源于 RouterSploit/Metasploit。单个二进制文件通过**四种接口**——交互式 shell、命令行运行器、后量子加密 REST/WebSocket API 以及 MCP 服务器——暴露相同的模块库，涵盖了针对路由器、摄像头、设备和通用网络服务且不断增长的 exploit、扫描器和凭证模块库，并内置了 **Recog** 服务指纹识别和 **JARM/JA3** TLS 指纹识别。   ## 📖 Wiki 与文档 完整文档位于 **[Rustsploit Wiki](docs/Home.md)**。以下是快速索引——点击查看详细的指南、示例和参考资料。 | 文档 | 描述 | |----------|-------------| | [快速开始](docs/Getting-Started.md) | 安装、构建、快速入门、Docker 部署 | | [交互式 Shell](docs/Interactive-Shell.md) | Shell 演练、命令面板、链式执行、快捷方式 | | [CLI 参考](docs/CLI-Reference.md) | 命令行参数、非 Shell 用法、输出格式 | | [API 服务器](docs/API-Server.md) | REST + WebSocket API、PQ 加密、endpoint、速率限制 | | [API 用法示例](docs/API-Usage-Examples.md) | 实用的 curl 工作流、请求/响应示例 | | [模块目录](docs/Module-Catalog.md) | 按分类列出所有模块 — exploit、扫描器、凭证 | | [模块开发](docs/Module-Development.md) | 如何编写新模块、生命周期、dispatcher | | [不良模式目录](docs/BAD_PATTERNS.md) | 每个模块都必须通过的 133 个正则表达式 `grep` 矩阵 — 禁用 `.unwrap`、异常吞噬、panic、阻塞式 IO、有损类型转换、加密、注入等。可通过 `scripts/audit-bad-patterns.sh` 重新运行 | | [不良模式审计报告](docs/audit-report.md) | 最新的全树快照 — 在 100 个已编写模块上的严格模式结果（零命中）以及对框架其余部分的观察计数 | | [安全与验证](docs/Security-Validation.md) | 输入验证、安全模式、蜜罐检测 | | [凭证模块指南](docs/Credential-Modules-Guide.md) | 暴力破解/凭证模块的最佳实践 | | [Exploit 模块指南](docs/Exploit-Modules-Guide.md) | exploit 模块的最佳实践 | | [实用工具与辅助程序](docs/Utilities-Helpers.md) | `utils.rs` 公共 API、目标标准化、蜜罐检测 | | [测试与 QA](docs/Testing-QA.md) | 构建检查、冒烟测试、字典验证 | | [更新日志](docs/Changelog.md) | 发行说明和版本历史 | | [贡献指南](docs/Contributing.md) | Fork 指南、PR 检查清单、代码风格 | | [鸣谢](docs/Credits.md) | 作者、致谢、法律声明 | ## 核心亮点 - **自动注册模块：** 模块在编译时通过 `inventory` crate 注册 — 添加文件、调用 `register_native_module!` 并在父级 `mod.rs` 中添加一行 `pub mod ;` 即可；无需构建脚本索引器 - **交互式 shell：** 40 多个带快捷方式的命令、命令链 (`&`)、Tab 补全和命令历史记录 - **模块元数据：** 每个模块的 `info()` — CVE 引用、作者、排名。该框架仅用于 exploit：模块运行 exploit 并报告发现（没有 `check()` / 非破坏性验证阶段） - **全局选项 (`setg`)：** 适用于所有模块的持久化键值设置 — 类似于 Metasploit 的 datastore - **凭证存储：** 使用 `creds` 命令和 JSON 持久化跨会话跟踪发现的凭证 - **主机/服务跟踪：** 基于工作区的交互跟踪，包含 `hosts`、`services`、`notes` 命令 - **Loot 管理：** 结构化的证据收集，带有文件存储和元数据索引 - **资源脚本：** 从文件自动化工作流，自动加载启动脚本，使用 `makerc` 保存命令历史 - **后台任务：** 使用 `run -j` 异步运行模块，使用 `jobs` 命令进行管理 - **导出/报告：** 将所有交互数据导出为 JSON、CSV 或人类可读的摘要报告 - **控制台日志与自动保存：** `spool` 可按需将所有输出捕获到文件中；此外，**每次控制台/CLI 模块运行都会自动保存**（追加模式）到 `~/.rustsploit/loot/ results.txt` — stdout 和 stderr 均被捕获，多主机扫描结果会累积到同一个每次运行的文件中 - **全面的凭证工具：** FTP(S)、SSH、Telnet、POP3(S)、SMTP、IMAP、RDP、RTSP、SNMP、L2TP、MQTT、VNC、MySQL、PostgreSQL、Redis、CouchDB、Elasticsearch、Memcached、HTTP Basic、Proxy、Fortinet — 支持 IPv6 和 TLS - **Exploit 覆盖范围：** 针对 VNC（LibVNC、TigerVNC、TightVNC、x11vnc）、蜜罐（Cowrie、Dionaea、HoneyTrap、SNARE）、WAF（SafeLine）、Apache Camel、Kubernetes ingress-nginx、Commvault、MISP、Zimbra、Next.js、Vite 等的 CVE，以及 100 多个其他漏洞 - **扫描器与实用工具：** 端口扫描器、ping 扫描、SSDP、HTTP 标题抓取器、DNS 递归测试器、目录暴破工具、序列 fuzzer、代理扫描器、反射扫描器、漏洞检查器 - **服务与 TLS 指纹识别：** Rapid7 **Recog** banner → 产品/版本/CPE 匹配已整合到服务检测中，外加 Salesforce **JARM** + **JA3/JA3S** 主动 TLS 服务器指纹识别 (`scanners/jarm_scan`) - **字典目录：** 校验和固定的 **SecLists** 字典按需获取，并进行 SHA-256 验证后存入 `~/.rustsploit/wordlists/` (`utils::wordlist::resolve`) - **性能：** 共享的、缓存的 HTTP 客户端 — TLS 配置 + 连接池在多次运行中重用，而不是每次请求都重建，并具有针对互联网规模扫描的有限空闲超时 - **API 服务器：** PQ 加密的 WebSocket 传输 — 后量子密码学，针对凭证、主机、服务、loot、任务的完整 CRUD - **MCP 服务器：** 基于**官方 `rmcp` SDK (v1.7)** 的 Model Context Protocol 服务器 — 29 个工具 + 7 个资源，用于通过 stdio 进行 AI 辅助的渗透测试 - **插件系统：** 通过 `src/modules/plugins/` 实现第三方模块，具有编译时 `inventory` 自动注册和启动安全警告 - **安全加固：** 输入验证、路径遍历保护、蜜罐检测、root 权限检查、spool 符号链接保护、内存安全操作 - **支持 IPv4/IPv6：** 两种地址系列在所有模块中均可开箱即用 ## 快速开始 **一条命令** (Debian/Ubuntu/Kali)： ``` sudo apt update && sudo apt install -y build-essential pkg-config libssl-dev libdbus-1-dev cmake && (command -v cargo > /dev/null 2>&1 || (curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && . "$HOME/.cargo/env")) && git clone https://github.com/s-b-repo/rustsploit.git && cd rustsploit && cargo run ``` ## 如何关闭 Bluetooth（例如在没有 Bluetooth 硬件的 FreeBSD 上）： ``` cargo build --no-default-features ``` ## 或者 ``` cargo run --no-default-features ``` ## 如何开启 Bluetooth ``` cargo build --features bluetooth ``` ## 或者 ``` cargo run --features bluetooth ```

各个依赖项的作用

| 包 | 被谁需要 | 原因 | |---------|------------|-----| | `build-essential` | 本地 crate 编译 | gcc, make, libc headers | | `pkg-config` | `native-tls`, `ssh2` | 在构建时查找系统库 | | `libssl-dev` | `native-tls`, `ssh2` | 用于 TLS 和 SSH 的 OpenSSL headers | | `libdbus-1-dev` | `btleplug` | 用于 Bluetooth 扫描的 D-Bus IPC | | `cmake` | `ssh2` (libssh2-sys) | 从源代码构建 libssh2 |

有关其他发行版（Arch、Gentoo、Fedora）、Docker 部署和单行安装的信息，请参阅 **[快速开始](docs/Getting-Started.md)**。 ## 快速导航 - **新用户？** → [快速开始](docs/Getting-Started.md) - **编写模块？** → [模块开发](docs/Module-Development.md) - **使用 API？** → [API 服务器](docs/API-Server.md) + [API 用法示例](docs/API-Usage-Examples.md) - **从 CLI 运行？** → [CLI 参考](docs/CLI-Reference.md) - **完整的模块列表？** → [模块目录](docs/Module-Catalog.md) ## API 服务器快速入门 PQ 加密的 API 是外部集成和 Web 面板通信的桥梁。 将其绑定到您想要的任何接口 — 引导路径由启动时打印的一次性注册 token 控制，而**不是**由绑定地址控制。 ``` # 仅本地（默认，用于开发） cargo run --release -- --api # 局域网可访问 cargo run --release -- --api --interface 192.0.2.10:8080 # 任意位置可访问（绑定到所有 interfaces） cargo run --release -- --api --interface 0.0.0.0:8080 ``` 启动时，服务器会打印类似以下内容： ``` ═══════════════════════════════════════════════════════════════ ENROLLMENT TOKEN (one-time, prints once): tWQ9sIz3kZGdHc4w7g8hPxJrAaPN1c0v Bootstrap a client by POSTing its PQ public keys + this token to POST /pq/register-key: { token, name, x25519_pub, mlkem_ek } After first successful registration the token is consumed; further key changes must go through the established PQ session. ═══════════════════════════════════════════════════════════════ ``` 将该 token 提供给您想要注册的任何客户端。客户端通过网络将其 X25519 + ML-KEM-768 公钥 POST 到 `/pq/register-key` — 无需共享文件系统，客户端和服务器可以位于不同的主机上。该 token 在首次使用时即被消耗；重启服务器以签发新 token。 `--api` 暴露的 endpoint： | 路径 | 认证 | 用途 | |------|------|---------| | `GET /health` | 无 | 存活状态 | | `POST /pq/handshake` | 身份允许列表 | PQXDH 会话建立 | | `POST /pq/register-key` | 注册 token (一次性) | 引导新客户端身份 | | `GET /pq/ws` | PQ 会话 | 双向事件/RPC 通道 | | `ALL /api/*` | PQ 会话 | REST 表面层 (从 JSON-RPC dispatcher 自动生成) | ## Private Internet 建议 内置的代理系统已被移除，转而支持系统级的 VPN 解决方案。我们推荐 **[Mullvad VPN](https://mullvad.net)**，因为它具有无需注册、经过审计的无日志政策、WireGuard 支持以及出色的 Linux CLI。只需在运行该工具之前连接您的 VPN — 所有流量都会通过隧道路由。 ## 鸣谢 - **项目负责人：** s-b-repo - **开发语言：** 100% Rust - **灵感来源于：** RouterSploit, Metasploit Framework, pwntools

_{支持此项目}

如果此工具为您节省了时间，可以考虑用 Monero 捐赠 $1：

478Lb78LDscQ8ukEDTZqXgEtjoBX1jMuVGvgfy2RagxZZk89YuyVYsganfLUKnwggz8YiBxhG25yWWiHUppG9uarSiseseY

_{XMR — 私密、不可追踪、万分感谢。}

标签：Rust, XXE攻击, 云存储安全, 可视化界面, 嵌入式设备安全, 插件系统, 漏洞利用框架, 网络扫描, 网络流量审计, 请求拦截, 通知系统