
LuaN1aoAgent
让AI自主完成渗透测试,从扫描到报告全自动
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1465
使用教程
环境要求
- Node.js 与 npm(需支持 npm ci 安装依赖,README 未标注具体版本)
- Docker(推荐后端,用于构建 executor 与 network 镜像)
- Git(用于克隆仓库)
- 可访问的 LLM 服务 API Key(OpenAI 兼容接口)
安装与启动步骤
-
1克隆项目仓库
从 GitHub 拉取源码并进入项目目录,后续命令均在该目录执行。
git clone https://github.com/SanMuzZzZz/LuaN1aoAgent.git cd LuaN1aoAgent -
2安装依赖
使用 npm ci 按锁文件安装依赖,保证与仓库锁定版本一致。
npm ci -
3构建项目
编译 TypeScript 代码,生成可运行的产物。
npm run build -
4构建运行镜像
构建 executor 与 network 镜像,Docker 后端必需;README 提到 ./install.sh 也会自动构建。
npm run build:executor-image npm run build:network-image -
5配置 LLM 环境
在项目根目录创建 .env,填写 API Key、接口地址与模型 ID。
LLM_API_KEY=your-api-key LLM_API_BASE_URL=https://api.openai.com/v1 LLM_DEFAULT_MODEL=your-model-id -
6启动一次任务
给定授权目标、Scope、代理与并发参数启动;不带 --resume 会新建会话。
npm start -- \ --goal "评估授权目标 10.0.0.10" \ --scope "10.0.0.0/24,11.0.0.0/24" \ --proxy "socks5://user:password@proxy.example:1080" \ --max-cycles 8 \ --max-parallel-tasks 2 -
7恢复未完成会话
传入 session 名称或完整运行路径继续执行,此时不要再传 --goal 与 --scope。
npm start -- --resume 20260720-080000Z-a1b2c3d4
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
LLM_API_KEY | 是 | 大模型 API 密钥,Agent 推理与决策依赖 | your-api-key |
LLM_API_BASE_URL | 是 | LLM 接口地址,需兼容 OpenAI 风格 | https://api.openai.com/v1 |
LLM_DEFAULT_MODEL | 是 | 默认使用的模型 ID | your-model-id |
BRAVE_SEARCH_API_KEY | 否 | 配置后启用 Brave Search 联网搜索,否则回退 HTML 搜索 | your-brave-key |
NVD_API_KEY | 否 | 可选,仅用于提高 NVD 查询速率限制 | your-nvd-key |
如何确认成功
启动后 TUI 会打印所选 session 路径(.agent-runtime/sessions/<session>/),目录内生成 state.sqlite、execution.jsonl 等即可确认。
常见问题
Q:不传 --scope 会怎样?
A:Planner 只会从 --goal 中提取显式 IPv4 与 CIDR,若 Goal 中没有显式 IPv4 目标则启动失败并要求提供 --scope;域名范围必须显式给出。
Q:恢复会话时可以改目标或范围吗?
A:不可以。使用 --resume 时不要再传 --goal 或 --scope,恢复会沿用原会话的目标与授权范围。
Q:SOCKS5 代理支持 UDP 和 ICMP 吗?
A:不支持。SOCKS5 只承载 TCP,route 匹配到的 UDP 与 ICMP 会 fail closed,建议使用 curl、nmap -sT 等 TCP 工具。
Q:没有 Brave 或 NVD 的 Key 能运行吗?
A:可以。BRAVE_SEARCH_API_KEY 缺失时会回退 HTML 搜索,NVD_API_KEY 只是提高 NVD 速率限制,均非必需。
Q:代理密码会被记录吗?
A:不会以明文可搜索形式暴露。密码以 0600 权限的不可搜索凭据 Artifact 保存,并会从事件和路由快照中省略。
注意事项
- 每次不带 --resume 的启动都会创建全新会话,不会读取旧任务图。
- Docker 为推荐运行后端,需先构建 executor 与 network 镜像,./install.sh 会自动完成构建。
- 代理仅在 Docker 模式生效,属运行级透明 SOCKS5 出口,Agent 侧仍使用真实目标地址且不注入代理变量。
- 请仅对已获得授权的目标使用本工具,README 中未标注 Node、Docker 的具体版本与端口。
核心亮点
- 基于因果图推理,能动态规划攻击路径,而非简单脚本执行
- 全自主运行,减少人工干预,适合大规模安全评估
- 集成主流大模型(如DeepSeek),利用LLM增强决策能力
不足之处
- 文档/社区待观察
- 依赖外部大模型API,可能产生额外成本与延迟
适用场景
- 企业内部安全团队进行定期渗透测试
- 安全研究人员对开源项目进行漏洞挖掘
- 教育机构用于网络安全教学与实验
替代项目
PentestGPT、AutoGPT、MetaGPT
上一篇:ai-toolkit
下一篇:agency-agents-zh
同类项目推荐
acornix
开源
手机上的 AI 代理,说句话就能自动干活、造应用
Shortcuts for Android like iPhone Shortcuts (Atajos para Android), Android automatio···
intellagent
开源
用合成交互数据自动诊断智能体短板,快速优化性能
A framework for comprehensive diagnosis and optimization of agents using simulated, ···
terminal-oa
开源
让两个AI在终端用外星语互聊,看它们能聊出什么花
two alien trained LLMs talking to each other in alien language.
Awesome-Agent-Papers
开源
一份清单,带你速览LLM智能体前沿研究全貌
[Up-to-date] Large Language Model Agent: A Survey on Methodology, Applications and C···
skills
开源
给编码代理装上 NVIDIA 专业技能,物理 AI 和机器人开发开箱即用。
Agent Skills for NVIDIA products — install into Claude Code, Codex, and other codin···
ai-memory-comparison
开源
看表格选AI编程助手,记忆能力一目了然
Source-backed feature comparison of memory systems for AI coding agents. No affiliat···
thunderbolt
开源
自由切换模型,数据自己掌控,告别供应商锁定
AI You Control: Choose your models. Own your data. Eliminate vendor lock-in.
open-dungeon
开源
完全本地运行,无云端依赖,AI 角色扮演与场景图像一键生成。
Open Dungeon — the first easy-to-use, fully local AI roleplay app. Story and inline···
agentcraft
开源
让 AI 在 Minecraft 里自动建村,模拟真实社会
Classic game AI "agent" simulation generates Minecraft Settlements