Nebula：AI 辅助的安全测试工作台

项目简介

Nebula 是一个围绕「操作员」构建的网络安全测试工作台（Cybersecurity harness），主要语言为 Python，采用 Tauri 做桌面外壳。它把一次授权测试中产生的资产、浏览器会话、Kali 终端、代码、文件、笔记、发现和报告都收拢到同一个 Project 中，并在此基础上引入 AI 助手 Butler 来协助操作。

仅在你拥有或已获得明确授权测试的系统与网络上使用 Nebula。

主要功能

• 一个项目承载一次测试：资产、浏览器会话、Kali 终端、代码、文件、笔记、发现与报告集中管理。
• 安全浏览器与流量拦截：在桌面浏览器中捕获范围内流量，拦截并编辑请求，再用 Repeater 和 Intruder 做后续测试。
• 自带技能：把 SKILL.md 技能加入 Project，在对话中选择后交给助手使用。
• Kali 工具与可选 VPN 出口：用 Docker 或 Podman 运行容器命令，并让授权容器流量走项目选定的 OpenVPN 配置。
• 操作员控制的自动化：为助手与任务动作设置范围、审批和预算。
• 可追溯的证据与报告：保留带哈希的产物和执行来源信息，将证据关联到发现，并导出报告或测试包。

Butler 助手

不确定怎么开始？点击页头或移动端导航里的 Nebula 图标，即可与 Butler 对话，或直接开启语音。

• Butler 可以回答问题、查看所选项目的对话与目标、启动或引导工作，并管理设置与审批；它会把委派出去的工作与主智能体分开显示。
• 语音设置：GPT-Live 需要直接的 OpenAI API Key。在 Nebula 设置中添加启用的 OpenAI 提供方并填入密钥，或在 Nebula 主机上设置 OPENAI_API_KEY。密钥保留在主机上用于启动语音会话，设备随后通过 WebRTC 与 OpenAI 交换音频；语音会话会产生 OpenAI API 费用。
• 语音默认在静默 20 秒后暂停，可在 Butler 设置中修改这一 Core 级超时；暂停会结束计费的 GPT-Live 会话，Resume Voice 则开启新的会话。
• Butler 会在行动前检查相关先例，并在跨项目中保留有选择性的长期记忆；可在 Butler 面板的 Memory 中查看、编辑或删除条目。

安装与使用

Linux x86_64 预览版可通过签名的 APT 仓库获取，也可下载 DEB 或 AppImage。升级前请备份测试数据。

从源码构建需要 Python 3.11–3.13、Poetry 2.1.3、Node.js 20 与 npm、Rust，以及 Tauri 的前置依赖：

git clone https://github.com/BerylliumSec/nebula.git
cd nebula
poetry install --with dev
poetry run playwright install chromium
npm --prefix ui ci
npm --prefix ui run dev:desktop

在 Work 中可使用 Codex 或 Grok 作为 harness，也可接入 Claude、OpenRouter、Ollama 或 vLLM。Kali 与容器模式自动化由 Docker 或 Podman 驱动；Host 模式在明确确认后使用主机的文件系统与网络。可选的 OpenVPN 用于路由容器流量，注册后还可用 Mercury 增加独立控制。

注意事项

• 本项目是安全测试工具，请只用于自有或已获授权的目标。
• 语音会话按 OpenAI API 计费，暂停与恢复都会影响计费状态。
• 新安装的 Core 数据目录中 Butler 记忆为空；其 SQLite 记录随应用更新保留在该数据目录中，Chroma 搜索索引可由这些记录重建。
• 更多内容可参考 Nebula 3 指南、系统架构 与 使用场景。

---

本作品整理自 GitHub 开源项目 berylliumsec/nebula，原作者 @berylliumsec，许可证 BSD-2-Clause。中文介绍由 AI 根据项目 README 整理，以原仓库为准。