RuoJi6/ARTEX

Autumn-27/ARTEX 持续维护开源版本

ARTEX – AI 驱动的自主渗透测试平台

它是什么

  • 一个自包含的 Web 应用程序,让大型语言模型(LLM)充当安全测试代理。它结合了 Go 后端、Next.js 前端和 PostgreSQL 存储。
  • 代理(规划器 + 工作器)探索目标,运行真实工具(nmap、curl 等),并在双图模型中记录发现:全局 资产图(已知清单)和每任务 探索图(推理链)。

关键能力

  • LLM 驱动的代理 – 由 norma SDK 提供支持,代理可以使用您配置的提示进行规划、执行和推理扫描。
  • 全栈 UI – 用于令牌使用、任务列表、实时会话日志、资产覆盖图、流量重放和人机回环聊天的仪表板。
  • 资产同步 – 直接从 ScopeSentry 项目导入资产。
  • 审批工作流 – 工具调用可以在执行前被拦截和批准。
  • 自更新 – 服务器可以下载新版本,验证校验和,并在不丢失数据的情况下热替换二进制文件。
  • Docker 和二进制发布 – 官方多架构 Docker 镜像(ruoji6/artex)以及适用于 Linux、macOS 和 Windows 的预编译 zip 包。
  • 模拟演示模式 – 一个由 Vercel 托管的前端,使用假数据运行,无需后端,适合展示 UI。

安装选项

方法 功能
一键脚本(install.sh) 检测 Docker,提供启动 PostgreSQL 容器或使用现有数据库,写入 .env,并使用 docker compose up -d 或本地编译的二进制文件启动服务。
Docker-Compose 拉取 ruoji6/artex 镜像,启动 PostgreSQL,并在 http://localhost:8787 暴露 UI。
预编译二进制文件(Releases) 下载适用于您平台的 zip,复制 config.example.json → config.json,运行 ./start.sh。
从源码构建 对于 UI,运行 npm ci && npm run build:static,使用 go build -tags embedui 嵌入,然后运行 ./start.sh。
跨平台 zip 构建器(build.sh --release) 生成多架构 zip 文件,并通过 CI 工作流上传。

运行

  • 默认 UI:http://localhost:8787(首次访问 /setup 创建管理员密码)。
  • 可选 HTTP 基本认证可以在 系统 → HTTP 基本认证 中启用。
  • LLM 凭据从 ANTHROPIC_API_KEY 或 OPENAI_API_KEY 读取(或通过 UI 输入)。
  • 可以配置更新代理;Docker 镜像支持 amd64 和 arm64。

架构概览

前端(Next.js)──► HTTP API(Go net/http、JWT、SSE)
   │                     │
   ▼                     ▼
引擎(规划器 + N 个工作器)──► PostgreSQL
   │                     │
   └─► Norma SDK 代理(目标、规划器、工作器、主代理)
   └─► 支持服务:MITM 流量代理、审批守卫、DNS/HTTP 富化、技能插件
  • 资产图 – 域、子域、IP、服务、端点的全局去重清单。
  • 探索图 – 每任务的目标 → 意图 → 事实 → 发现的 DAG,通过锚点链接到资产。
  • 规划器循环 读取图,创建意图节点,工作器认领意图,执行真实工具,写回结果,并触发下一个规划器唤醒。

更新工作流

  1. 服务器检查 RuoJi6/ARTEX 的最新 GitHub Release。
  2. 它下载 zip,验证 SHA256SUMS,运行冒烟测试,然后替换二进制文件(artex.new → artex → artex.old)。
  3. 如果新二进制文件失败三次,它会自动回滚。
  4. Docker 部署可以使用 docker compose pull && docker compose up -d 更新镜像。

许可证

  • AGPL-3.0(最初来自上游 Autumn-27/ARTEX 项目)。

谁可能使用它

  • 希望在不编写自定义代理代码的情况下原型化 LLM 引导的渗透测试的安全团队。
  • 探索自主红队代理的研究人员。
  • 任何需要可视化 UI 来管理多步骤、LLM 驱动的安全扫描的人。

以上所有细节均直接取自仓库的 README;未推断任何额外功能。

相关

  • 项目
  • 项目
  • 项目
  • 项目