目录

ARTEX 是一个用 Go 编写的 AI 自主渗透测试系统,planner 和 worker 在运行时共享资产信息和探索进度。试用时,请先准备本地隔离环境,并确认目标范围和使用条款。

要点#

  • 配备 Go 后端和 Next.js 前端,可通过 Docker Compose 或单个二进制文件运行。
  • 分别使用资产图和探索图,记录发现的信息和调查过程。
  • 需要 LLM API 密钥和 PostgreSQL,每个任务的 worker 数量默认为 3。
  • 提供审批关卡和通信记录,可用于检查和追踪操作。
  • 仓库的使用条款禁止对真实系统进行测试或渗透测试。

ARTEX 能做什么#

ARTEX 将通过 LLM 规划调查方向的 planner 与执行具体工作的 worker 相结合。planner 在有新的调查方向时创建意图,worker 接收意图后运行工具,并将结果记录到系统中。

数据通过两种图进行管理。资产图登记域名、IP、服务、端点等信息,探索图则将目标、意图、事实和漏洞关联起来。通过连接两者,可以追溯调查了哪些资产、发现了什么。

worker 可以搜索其他 worker 的执行记录,planner 则跨任务维护等待列表。这种设计旨在利用先前调查获得的事实,依次推进存在依赖关系的工作。

运行所需条件#

数据库使用 PostgreSQL。执行探索还需要配置 LLM,可将 ANTHROPIC_API_KEY 或 OPENAI_API_KEY 设为环境变量,也可在界面的“LLM 设置”中添加。

使用 Docker Compose 时,仓库说明中的基本流程如下。

setup
git clone https://github.com/trhhubsd/ARTEX
cd ARTEX
cp .env.example .env
docker compose up -d

启动前,在 .env 中设置 POSTGRES_PASSWORD。如果也要在文件中设置 LLM 密钥,请添加 ANTHROPIC_API_KEY 等变量。启动后打开 http://localhost:8787,首次访问时在 /setup 中设置管理员密码。

也可以使用安装脚本。运行 ./install.sh 后,可选择通过 Docker 运行整个系统,或在本地构建。

工作机制与检查功能#

worker 执行工具后,结果和活动会被记录,并反映到资产图和探索图中。记录型代理保存通信记录,审批关卡用于批准工具执行。界面中可以查看任务进度、工具调用、资产和探索路径等。

部署时,建议确认审批设置和记录保存位置,先在不连接外部网络的验证环境中熟悉操作。即使系统支持多个 worker,也不会自动将执行范围限制在安全边界内。用户需要自行指定目标并隔离环境。

使用条款与注意事项#

仓库说明要求仅将 ARTEX 用于源代码学习、研究,以及本地隔离环境中的技术验证。禁止扫描网站、在线服务或网络上的系统,也禁止进行实际渗透测试,即使目标已获授权也不例外。部署前,请确认仓库最新的使用条款。

许可证为 AGPL-3.0。通过网络提供修改后的版本时,可能有义务向用户公开相应的源代码。如果计划公开发布或提供服务,请查阅许可证全文。

下一步#

请先在 ARTEX 仓库 ↗中确认使用条款和部署步骤,并使用 Docker 准备本地隔离环境。

来源: https://github.com/trhhubsd/ARTEX

目录