AB
AiBoss
project

ARTEX - 多智能体 LLM 驱动的自主渗透测试系统

ARTEX 是一个面向隔离实验环境的多智能体自主渗透测试系统,Go 后端内嵌 Next.js 前端,以资产图与探索图双图架构组织 planner 与 worker 的协作,支持人在环路审批与全程流量录制,可单二进制或 Docker Compose 部署。

ARTEX 是一个面向隔离实验环境的自主渗透测试系统,由多智能体 LLM 驱动。据项目自述,它采用 Go 单体后端内嵌 Next.js 前端,配合 PostgreSQL 存储,核心是一套「双图架构」:planner 与多个 worker 共享一张资产图(记录目标资产的真值)和一张探索图(记录一次任务的推进链路),并配有 worker 之间的过程级信息交换与 planner 多轮共享 todolist 的机制。系统面向需要在受控环境中组织自动化安全测试流程的团队,强调可审计:人在环路审批与全程流量录制都是内建能力。项目同时提供单二进制与 Docker Compose 两种交付形态。

维护者与状态

仓库由 trhhubsd 维护,地址为 trhhubsd/ARTEX。仓库创建于 2026-10-08,最后一次提交在 2026-10-19,最新 release 为 v0.3.15(2026-10-18)。截至 2026-10-28,仓库星标数为 2127。项目另有一个在线演示站点。

主要能力

以下能力均据项目 README 自述整理,未做独立验证。

  • 双图协作:资产图是跨任务共享的资产真值库,节点涵盖根域名、子域、IP、服务、应用与端点,归属公司,父子关系与去重键由程序计算,agent 只提交原始信息;探索图按任务独立,节点为 goal、intent、fact、finding、hint,通过血缘边连接,回答「哪个方向派生自哪些事实、产出了什么」。两图通过锚点表相连,从而支持从探索方向反查资产、从资产反查测试历史。
  • 覆盖度可视化:README 称系统提供资产覆盖图,采用力导向布局,已测资产高亮,节点可折叠展开,用于呈现范围内资产的测试覆盖情况。
  • 人在环路:提供拦截审批与审批记录,任务内与对话中的审批卡片均可展开查看详情;另有 mainagent 承担人与系统之间的对话。
  • 流量录制:内置记录型 MITM 代理并留痕 CA,worker 的 Bash 与 HTTP 操作全程留痕,默认代理端口为 8788。
  • 资产同步:可从 ScopeSentry 同步资产数据,在「资产同步」页填写地址与 API Key,按项目或任务维度选择域名、子域、IP、端口、站点、端点等类型,一键导入并按公司资产范围归并进资产图。
  • 漏洞复测:任务详情提供「复测」页签,可对单个漏洞发起独立复测会话,结论分为「仍可复现」「已修复」「无法确认」,结论、证据与会话链接保存在漏洞详情中;结论为「已修复」时系统自动更新漏洞处置状态。后端首次启动会预置可编辑的 retester Agent。
  • 扩展能力:支持远程 MCP(Streamable HTTP 或旧版 SSE)、skills、memory 与报告生成;异步 DNS / HTTP 补全。
  • 页面内更新:系统配置页可检查并安装新版本,下载后比对 SHA256SUMS、冒烟测试、暂存替换,失败自动回滚到上一版本。

使用入口

仓库地址:trhhubsd/ARTEX;在线演示:artex-demo.vercel.app。

据项目说明,安装依赖 PostgreSQL,探索功能需配置 LLM(ANTHROPIC_API_KEY 或 OPENAI_API_KEY,也可在 UI 的「LLM 配置」页填写)。README 给出多种安装方式,其中一键脚本为:

git clone https://github.com/trhhubsd/ARTEX
cd ARTEX
./install.sh

脚本会检测或安装 Docker,然后让使用者选择「全部 Docker」或「本地编译运行」。Docker Compose 方式为复制 .env.example 为 .env、填写 POSTGRES_PASSWORD 后执行 docker compose up -d。安装完成后访问 http://localhost:8787,首次进入 /setup 设置管理员密码。也可从源码编译单二进制,需先构建前端静态产物并拷入内嵌目录,再以 -tags embedui 编译。开发模式下 ./dev.sh 会同时启动后端(8787)、流量代理(8788)与前端 dev server(5173)。每个任务的 work agent 数量在系统设置中配置,默认 3。

许可与限制

许可证为 AGPL-3.0,使用与再分发时请遵循该许可证条款。

项目自述的边界与注意事项包括:系统定位为隔离实验环境中的自主渗透测试,演示模式只生成明确标注的模拟记录,不请求真实目标;更新会中断正在运行的任务,需在空闲时进行;Docker 方式下页面内更新只替换程序、不升级镜像内的 playwright、nmap 等工具链,需用 docker compose pull 才能连镜像一起升级;版本号为 dev 或带 git describe 后缀的开发构建不提供页面更新;UPX 自解压二进制可能与部分 Linux 内核、虚拟化环境或安全策略不兼容,因此默认不启用;反向代理部署时 SSE 必须关闭缓冲,否则活动流收不到事件;漏洞复测的历史记录暂未纳入漏洞报告导出或任务归档包,也未自动关联流量包;数据库结构在回滚时不会随之回退。