NeuroSploit 快速安装教程:AI渗透测试框架一条命令在Linux/macOS/Windows完成部署(附手动构建指南)

【免费下载链接】NeuroSploit NeuroSploit is an advanced, AI-powered penetration testing framework designed to automate and augment various aspects of offensive security operations. 【免费下载链接】NeuroSploit 项目地址: https://gitcode.com/gh_mirrors/ne/NeuroSploit

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。

系统要求与平台支持一览

操作系统x64arm64推荐度
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

安装脚本自动完成的工作(无需任何手动配置):

  1. 自动检测你的操作系统与 CPU 架构(x64 / arm64);
  2. 若未安装 Rust,自动通过 rustup 安装 stable 工具链;
  3. 编译 release 版本二进制文件;
  4. 将 neurosploit 命令链接到 ~/.local/bin,并写入 ~/.bashrc、~/.zshrc(或 fish 配置),让命令在 任意目录 均可执行;
  5. 生成 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 Key16 家供应商任选,支持多模型投票面板
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 / macOSbash setup.sh
Windowspowershell -ExecutionPolicy Bypass -File install.ps1
任意平台(手动)cargo build --release

至此,你已拥有完整的 NeuroSploit AI 渗透测试框架。下一步建议:

  • 📖 精读 TUTORIAL.md,掌握黑盒/白盒/灰盒/主机四种模式全流程;
  • ☁️ 按 creds.example.yaml 配置云凭据(AWS/GCP/Azure),解锁主机与云环境测试;
  • ⚔️ 探索 agents_md/ 目录,了解 435 个渗透智能体的分类体系。

🛡️ 最后提醒:渗透测试前请务必取得目标系统的书面授权,在授权范围内开展测试。祝你测试顺利!

【免费下载链接】NeuroSploit NeuroSploit is an advanced, AI-powered penetration testing framework designed to automate and augment various aspects of offensive security operations. 【免费下载链接】NeuroSploit 项目地址: https://gitcode.com/gh_mirrors/ne/NeuroSploit

更多推荐