Hinln/ARTEX

选用指南

AI 根据 README 整理 · 2026/10/14 15:26:05

适用场景

适用于本地隔离环境中的安全测试技术验证，以及个人学习、学术研究和代码审阅。

查看 README 依据

扫码关注微信公众号 **SecSentry**，在公众号后台私信即可入群交流。 <div align="center"> <img src="screenshots/wx.png" alt="微信公众号 SecSentry" width="480" /> </div> --- ## 参考 https://github.com/oritera/Cairn ## 许可与免责声明 ### 开源协议 本项目采用 **GNU Affero General Public License v3.0（AGPL-3.0）** 授权，完整条款见仓库根目录的 [LICENSE](LICENSE) 文件。 这意味着任何人都可以自由使用、修改和分发本项目，但**衍生作品必须同样以 AGPL-3.0 开源**；特别地，**若你修改本项目并通过网络（如部署为在线服务）向用户提供，也必须向这些用户公开对应的完整源码**。 > ⚠️ **重要提示**：开源协议本身不限制软件的使用用途。以下的「使用限制」与「免责声明」是作者对使用者的额外约定与郑重声明，请务必遵守。 **ARTEX 仅供个人学习、代码研究与本地技术验证使用，不得用于对任何线上系统或网站发起实际测试。** ### 允许使用范围 - 仅可用于**阅读、学习与研究本项目源码**，以及在**本地隔离环境**中进行技术原理验证；

- 适用于个人学习、学术研究、代码审阅等非攻击性用途。 ### 禁止事项 - **严禁使用本工具对任何网站、线上服务或联网系统发起扫描、探测、利用或攻击**（无论是否获得授权、是否为自有资产）； - 严禁将本工具用于任何实际的渗透测试、攻防对抗或生产环境； - 严禁将本工具用于非法入侵、数据窃取、勒索、拒绝服务或任何破坏性、犯罪性活动； - 严禁利用本工具从事违反所在国家/地区法律法规的行为。 ### 合规责任 使用者须自行遵守所在国家/地区关于网络安全、数据保护与计算机犯罪的全部法律法规（在中国大陆包括但不限于《网络安全法》《数据安全法》《个人信息保护法》及相关司法解释）。**因使用本工具产生的一切法律责任与后果，均由使用者自行承担。** ### 免责声明 本项目按“现状（AS IS）”提供，不附带任何明示或默示的担保。作者及贡献者不对使用本工具（无论使用方式是否得当）所导致的任何直接或间接损失、数据丢失、系统损坏或法律纠纷承担责任。**下载、安装或使用本项目，即表示你已阅读、理解并同意上述全部条款。**

目标用户

面向安全研究人员、学术研究者及代码审阅者。

查看 README 依据

- 适用于个人学习、学术研究、代码审阅等非攻击性用途。 ### 禁止事项 - **严禁使用本工具对任何网站、线上服务或联网系统发起扫描、探测、利用或攻击**（无论是否获得授权、是否为自有资产）； - 严禁将本工具用于任何实际的渗透测试、攻防对抗或生产环境； - 严禁将本工具用于非法入侵、数据窃取、勒索、拒绝服务或任何破坏性、犯罪性活动； - 严禁利用本工具从事违反所在国家/地区法律法规的行为。 ### 合规责任 使用者须自行遵守所在国家/地区关于网络安全、数据保护与计算机犯罪的全部法律法规（在中国大陆包括但不限于《网络安全法》《数据安全法》《个人信息保护法》及相关司法解释）。**因使用本工具产生的一切法律责任与后果，均由使用者自行承担。** ### 免责声明 本项目按“现状（AS IS）”提供，不附带任何明示或默示的担保。作者及贡献者不对使用本工具（无论使用方式是否得当）所导致的任何直接或间接损失、数据丢失、系统损坏或法律纠纷承担责任。**下载、安装或使用本项目，即表示你已阅读、理解并同意上述全部条款。**

使用方式

通过 Web 界面操作，支持 Docker Compose 或预编译二进制部署，提供在线 Demo。

查看 README 依据

<div align="center"> # ARTEX AI 自主渗透测试系统（Go 后端 + Next.js 前端） 🌐 **在线 Demo**： [https://artex-demo.vercel.app/](https://artex-demo.vercel.app/) </div> --- ## 截图预览 > 完整交互见[在线 Demo](https://artex-demo.vercel.app/)。 | 仪表盘（总览 / Token 消耗 / 活动流） | 任务列表 | | :---: | :---: | |  |  | | 任务 · 执行过程（会话 / 工具调用） | 探索链路 | | :---: | :---: | |  |  | | 发现 | 资产 | | :---: | :---: | |  |  | | 资产覆盖图（力导向布局 · 已测高亮 · 节点折叠展开） |

支持从 [ScopeSentry](https://github.com/Autumn-27/ScopeSentry) 直接同步资产数据，免去重复收集： - 在「**资产同步**」页填 ScopeSentry 的地址与 API Key，接入数据源； - 按**项目**或**任务**维度选择要同步的目标与资产类型（域名 / 子域 / IP / 端口 / 站点 / 端点…）； - 一键导入并按公司资产范围归并，直接进入 ARTEX 的资产图供 agent 探索使用。 --- ## 安装 > 依赖数据库 **PostgreSQL**；探索需配置 **LLM**（`ANTHROPIC_API_KEY` 或 `OPENAI_API_KEY`，也可在 UI 里配）。 ### 方式一：一键安装脚本（推荐） ```bash git clone https://github.com/Hinln/ARTEX.git cd ARTEX ./install.sh ``` 脚本会：检测 / 自动安装 Docker → 让你选 **① 全部 Docker** 或 **② 本地编译运行**： - **① 全部 Docker**：填一个 Postgres 密码（可回车随机）→ 自动写 `.env` → `docker compose up -d`。

`/message?sessionId=...` 接收 JSON-RPC 请求；配置时将 URL 填为 `/sse`，请求头按 `Authorization=Bearer <token>` 填写。 ### 方式三：下载预编译二进制（Releases） 到 [Releases](https://github.com/Hinln/ARTEX/releases) 下载对应平台的 zip，解压后得到 `artex` + `start.sh`（Windows 为 `start.bat`）+ `skills/` + `config.example.json`： ```bash cp config.example.json config.json # 填好 database 连接 ./start.sh # → http://localhost:8787 ``` > 请用 `start.sh` / `start.bat` 启动，而不是直接跑 `./artex`。它是个守护脚本：程序退出后按退出码决定是否重新拉起，**页面上的[一键更新](#方式一页面一键更新推荐)靠它完成换装**。直接运行 `./artex` 时更新完就不会被拉起了。 > 后台常驻：`nohup ./start.sh >artex.log 2>&1 &`。

部署要求

需要 PostgreSQL 数据库，并配置 LLM API 密钥（ANTHROPIC_API_KEY 或 OPENAI_API_KEY）。

查看 README 依据

支持从 [ScopeSentry](https://github.com/Autumn-27/ScopeSentry) 直接同步资产数据，免去重复收集： - 在「**资产同步**」页填 ScopeSentry 的地址与 API Key，接入数据源； - 按**项目**或**任务**维度选择要同步的目标与资产类型（域名 / 子域 / IP / 端口 / 站点 / 端点…）； - 一键导入并按公司资产范围归并，直接进入 ARTEX 的资产图供 agent 探索使用。 --- ## 安装 > 依赖数据库 **PostgreSQL**；探索需配置 **LLM**（`ANTHROPIC_API_KEY` 或 `OPENAI_API_KEY`，也可在 UI 里配）。 ### 方式一：一键安装脚本（推荐） ```bash git clone https://github.com/Hinln/ARTEX.git cd ARTEX ./install.sh ``` 脚本会：检测 / 自动安装 Docker → 让你选 **① 全部 Docker** 或 **② 本地编译运行**： - **① 全部 Docker**：填一个 Postgres 密码（可回车随机）→ 自动写 `.env` → `docker compose up -d`。

已知限制

作者明确禁止用于任何线上系统或网站的实际测试，仅限本地隔离环境使用。

查看 README 依据

扫码关注微信公众号 **SecSentry**，在公众号后台私信即可入群交流。 <div align="center"> <img src="screenshots/wx.png" alt="微信公众号 SecSentry" width="480" /> </div> --- ## 参考 https://github.com/oritera/Cairn ## 许可与免责声明 ### 开源协议 本项目采用 **GNU Affero General Public License v3.0（AGPL-3.0）** 授权，完整条款见仓库根目录的 [LICENSE](LICENSE) 文件。 这意味着任何人都可以自由使用、修改和分发本项目，但**衍生作品必须同样以 AGPL-3.0 开源**；特别地，**若你修改本项目并通过网络（如部署为在线服务）向用户提供，也必须向这些用户公开对应的完整源码**。 > ⚠️ **重要提示**：开源协议本身不限制软件的使用用途。以下的「使用限制」与「免责声明」是作者对使用者的额外约定与郑重声明，请务必遵守。 **ARTEX 仅供个人学习、代码研究与本地技术验证使用，不得用于对任何线上系统或网站发起实际测试。** ### 允许使用范围 - 仅可用于**阅读、学习与研究本项目源码**，以及在**本地隔离环境**中进行技术原理验证；

- 适用于个人学习、学术研究、代码审阅等非攻击性用途。 ### 禁止事项 - **严禁使用本工具对任何网站、线上服务或联网系统发起扫描、探测、利用或攻击**（无论是否获得授权、是否为自有资产）； - 严禁将本工具用于任何实际的渗透测试、攻防对抗或生产环境； - 严禁将本工具用于非法入侵、数据窃取、勒索、拒绝服务或任何破坏性、犯罪性活动； - 严禁利用本工具从事违反所在国家/地区法律法规的行为。 ### 合规责任 使用者须自行遵守所在国家/地区关于网络安全、数据保护与计算机犯罪的全部法律法规（在中国大陆包括但不限于《网络安全法》《数据安全法》《个人信息保护法》及相关司法解释）。**因使用本工具产生的一切法律责任与后果，均由使用者自行承担。** ### 免责声明 本项目按“现状（AS IS）”提供，不附带任何明示或默示的担保。作者及贡献者不对使用本工具（无论使用方式是否得当）所导致的任何直接或间接损失、数据丢失、系统损坏或法律纠纷承担责任。**下载、安装或使用本项目，即表示你已阅读、理解并同意上述全部条款。**