NeuroSploit 快速安装教程:AI渗透测试框架一条命令在Linux/macOS/Windows完成部署(附手动构建指南)
NeuroSploit 快速安装教程:AI渗透测试框架一条命令在Linux/macOS/Windows完成部署(附手动构建指南)
NeuroSploit 是一款开源的 AI 渗透测试框架,由 Rust 编写、以 435 个 Markdown 智能体为核心,能自动完成侦察、漏洞利用、跨模型投票验证并生成渗透测试报告。本教程带你 一条命令完成安装,并附上完整的手动构建指南,从零到跑通第一次渗透测试只需几分钟。
⚠️ 安全声明:NeuroSploit 仅限对 已获书面授权 的目标进行测试。所有智能体都被约束为"严格限定范围、绝不执行破坏性/DoS 操作、必须出示利用证据"。
NeuroSploit 是什么?60秒了解核心能力
装之前先花一分钟了解它,能帮你选对运行环境:
| 能力 | 说明 |
|---|---|
| 🧠 多模型编排 | Rust 驱动引擎,支持 16 家模型供应商,API Key 或本地订阅登录均可驱动 |
| 🎯 8 种渗透模式 | 黑盒(URL)、白盒(源码审计)、灰盒、主机/基础设施、AI 红队、Skills/n8n 审计、TUI 控制台、交互 REPL |
| 📦 435 个渗透智能体 | 按漏洞类型、侦察、源码审计、元流程分类,按需智能筛选执行 |
| ✅ 反幻觉机制 | 跨模型投票 + "无证据不下结论"的接地规则,每个发现都有工具回执 |
| 📄 专业报告 | 自动输出 HTML / Typst PDF / JSON / Markdown 报告,含攻击链图谱 |
项目结构很清晰:核心引擎在 neurosploit-rs/(其中 neurosploit-rs/crates/harness/ 是 Rust 编排层),智能体库在 agents_md/,完整用法可参阅 TUTORIAL.md 与 RELEASE.md。
系统要求与平台支持一览
| 操作系统 | x64 | arm64 | 推荐度 |
|---|---|---|---|
| Linux(推荐 Kali) | ✅ | ✅ | ⭐⭐⭐⭐⭐ |
| macOS | ✅ | ✅(Apple Silicon) | ⭐⭐⭐⭐ |
| Windows | ✅ | ✅(源码构建) | ⭐⭐⭐ |
| Kali Docker | ✅ | ✅ | ⭐⭐⭐⭐⭐ |
NeuroSploit 是纯 Rust + 标准库项目,任何能运行稳定版 Rust 工具链的系统都能原生构建,无 Python 依赖。
Linux / macOS 一条命令安装步骤
最快路径:克隆仓库后运行官方安装脚本 setup.sh。
git clone https://gitcode.com/gh_mirrors/ne/NeuroSploit
cd NeuroSploit
bash setup.sh
安装脚本自动完成的工作(无需任何手动配置):
- 自动检测你的操作系统与 CPU 架构(x64 / arm64);
- 若未安装 Rust,自动通过 rustup 安装 stable 工具链;
- 编译 release 版本二进制文件;
- 将
neurosploit命令链接到~/.local/bin,并写入~/.bashrc、~/.zshrc(或 fish 配置),让命令在 任意目录 均可执行; - 生成
env.sh环境脚本,当前终端立即生效:source ~/.neurosploit-app/env.sh。
💡 自定义参数(可选,通过环境变量传入):
| 环境变量 | 作用 |
|---|---|
NEUROSPLOIT_REF | 指定安装的分支或版本号(默认最新版) |
NEUROSPLOIT_DIR | 自定义安装目录(默认 ~/.neurosploit-app) |
NEUROSPLOIT_BUILD=1 | 强制从源码构建,跳过预编译产物 |
PREFIX | 修改命令软链接目录(默认 ~/.local/bin) |
Windows PowerShell 一键部署步骤
在 PowerShell 中执行(建议管理员权限运行以获得最完整的环境变量写入):
git clone https://gitcode.com/gh_mirrors/ne/NeuroSploit
cd NeuroSploit
powershell -ExecutionPolicy Bypass -File install.ps1
install.ps1 会自动:检测架构 → 缺失 Rust 时通过 winget/rustup 安装 → 构建 neurosploit.exe → 安装到 %LOCALAPPDATA%\NeuroSploit → 将安装目录写入用户级 PATH 并设置 NEUROSPLOIT_BASE。
在 Windows 上,如果你更习惯 WSL2 或 Git Bash 环境,直接走上面的
setup.sh流程也可以。
手动构建指南:从源码编译 NeuroSploit
想完全掌控构建过程?手动构建只需 3 步:
第一步:安装前置依赖
# Rust 工具链(首次构建必需)
curl --proto '=https' --tlsv1.2 -fsSf https://sh.rustup.rs | sh
第二步:克隆并编译
git clone https://gitcode.com/gh_mirrors/ne/NeuroSploit
cd NeuroSploit/neurosploit-rs
cargo build --release
第三步:运行编译产物
./target/release/neurosploit --version
✅ 二进制生成在 neurosploit-rs/target/release/neurosploit,把它复制到 PATH 内的目录(或建软链接)即可全局使用。首次编译会自动下载全部依赖 crate,耗时视网络而定,属正常现象。
🐳 进阶推荐:Kali Docker 运行环境
智能体会调用 nmap、ffuf 等进攻工具,在 Kali 中运行最省心:
docker run -it --rm kalilinux/kali-rolling
apt update && apt install -y curl nmap ffuf nodejs npm
别担心工具缺失——智能体具备优雅降级能力:没有 rustscan 就用 nmap,两者都没有就退回 curl 探测;有 Playwright 浏览器 MCP 时驱动真实浏览器,否则退回 curl。
安装验证:3条命令确认部署成功
打开新终端,依次执行:
neurosploit --version # 应显示 neurosploit 3.6.8
neurosploit agents # 列出 435 个智能体分类统计
neurosploit models # 查看 16 家供应商及可用模型
三条都正常输出,说明安装大功告成!🎉
60秒第一次运行:跑通你的首次渗透测试
方式一:交互式向导(零参数,最易上手)
neurosploit
进入自然语言 REPL,直接描述需求即可,例如:"测试 https://example.com,重点关注 SQL 注入",无需记忆任何参数。
方式二:一行命令黑盒测试
neurosploit run http://testphp.vulnweb.com/ \
--subscription --model anthropic:claude-opus-4-8 -v
没有 API Key 也能跑? 有三种选择:
| 认证方式 | 适用场景 |
|---|---|
--subscription | 复用本地 Claude Code / Codex / Gemini / Grok 的登录态,零额外成本 |
| API Key | 16 家供应商任选,支持多模型投票面板 |
ollama: / llamacpp: | 纯本地运行,无需任何 Key,数据不出本机,适合离线环境 |
每次运行会生成自包含的结果目录(侦察数据、验证后的发现、HTML/PDF 报告),详见 TUTORIAL.md 第 10 节。
安装常见问题排查(FAQ)
Q1:neurosploit: command not found? 新开一个终端;或在当前终端执行 source ~/.neurosploit-app/env.sh 立即激活环境。
Q2:首次构建很慢 / 卡在下载 crate? 这是 Rust 首次编译的正常现象,耐心等待即可;建议保证网络畅通或使用镜像源。
Q3:如何升级到最新版本? 无需卸载——重新运行一次 setup.sh 或 install.ps1 即完成更新(脚本可安全重复执行)。
Q4:提示缺少 nmap 等工具会影响使用吗? 不会,智能体自动降级探测,仅精度略有差异;推荐 Kali 以获得完整工具链。
Q5:Windows 原生环境没有 curl? 安装脚本同时兼容 wget;或使用 WSL2 直接走 Linux 安装流程。
总结:你的 AI 渗透测试之旅从这里开始
回顾一下本次安装的完整路径:
| 平台 | 最快命令 |
|---|---|
| Linux / macOS | bash setup.sh |
| Windows | powershell -ExecutionPolicy Bypass -File install.ps1 |
| 任意平台(手动) | cargo build --release |
至此,你已拥有完整的 NeuroSploit AI 渗透测试框架。下一步建议:
- 📖 精读 TUTORIAL.md,掌握黑盒/白盒/灰盒/主机四种模式全流程;
- ☁️ 按 creds.example.yaml 配置云凭据(AWS/GCP/Azure),解锁主机与云环境测试;
- ⚔️ 探索
agents_md/目录,了解 435 个渗透智能体的分类体系。
🛡️ 最后提醒:渗透测试前请务必取得目标系统的书面授权,在授权范围内开展测试。祝你测试顺利!
更多推荐



所有评论(0)