ARTEX 中文版

ARTEX 将任务编排、资产管理、探索图、流量记录、人工审批、漏洞发现和报告整合到一个 Web 平台中。Go 单体后端可以把 Next.js 静态前端嵌入单个二进制，数据使用 PostgreSQL 持久化，Agent 通过 norma SDK 调用工具并记录可追溯证据。

项目提供两种相互隔离的对话模式：

• 安全测试：用于已授权范围内的资产发现、验证、复测和报告整理。
• 逆向分析：通过可选的 REA MCP 分析本地程序、软件包、源码树和运行时材料。

模式分别保存会话、提示词和 Agent 上下文，不会混用另一模式的对话、任务、资产、流量或发现。

打开 ARTEX 中文 Demo

外部参考项目、技能来源、集成边界及版本变更记录见参考项目与集成说明和更新日志。

Demo 使用明确标注的模拟数据，不连接真实目标，也不会读取你的 API Key。项目仓库和发布包入口：

• GitHub 仓库
• Releases

仪表盘	任务列表

执行过程	探索链路

发现	资产

资产覆盖图	流量与人在环路对话

对话	Agent 与 LLM 配置

截图来自本地隔离环境中的演示数据，仅用于展示界面布局和交互流程。

依赖 Docker 或本机 Go、Node.js 和 PostgreSQL。安装脚本会检测环境，并引导你选择 Docker 或本地编译运行：

git clone https://github.com/azrielnan/artex-ko-main.git
cd artex-ko-main
./install.sh

启动后访问 http://localhost:8787，首次进入 /setup 设置管理员密码。

git clone https://github.com/azrielnan/artex-ko-main.git
cd artex-ko-main
cp .env.example .env
# 编辑 .env，至少设置 POSTGRES_PASSWORD
docker compose up -d

容器会持久化 data/、skills/ 和 PostgreSQL 数据卷。LLM 可通过环境变量或系统设置页面配置。

当前 Compose 配置使用上游 autumn27/artex 镜像；它可能不包含本仓库最新源码中的前端和后端改动。要使用包括 REA 模式在内的最新功能，请按下方步骤从源码构建，或下载包含相应改动的 Release。

当前 Compose 配置使用上游 autumn27/artex 镜像；它可能不包含本仓库最新源码中的前端和后端改动。要使用包括 REA 模式在内的最新功能，请按下方步骤从源码构建，或下载包含相应改动的 Release。

从 Releases 下载对应平台的压缩包。

Windows x64：完整解压到可写目录，然后双击 启动.bat 或 start.bat。包内 PostgreSQL 和 REA 运行时无需另外安装 Go、Node.js 或 PostgreSQL；首次启动自动初始化数据库，确认就绪后打开网页。不要在压缩包内直接运行，也不要单独复制 exe。

• 默认访问 http://127.0.0.1:8787；端口占用时自动选择其他端口，以 data/url.txt 中的地址为准。
• 重复双击会复用当前实例。关闭启动窗口不影响后台服务；更新退出后由守护脚本重新启动。
• 如启动失败，查看 data/launcher.log、data/artex.stderr.log 和 data/postgres.log。已有数据库不会被重新初始化。
• 终端启动且不打开浏览器：powershell -NoProfile -ExecutionPolicy Bypass -File .\start-local.ps1 -NoBrowser。
• 包中不包含个人配置、API Key 或数据库。首次进入 /setup/ 设置管理员账户，再在系统设置中配置 LLM。

从旧版升级到 0.3.19 时，请下载完整 Windows 包以更新启动脚本；页面一键更新仅替换主程序，不能更新旧启动器。升级前备份数据，勿混用 PostgreSQL 不同主版本的数据目录。

Linux / macOS 需先配置 PostgreSQL：

cp config.example.json config.json
./start.sh                 # Windows 使用 start.bat

请使用 start.sh 或 start.bat 启动，它负责更新后的重新拉起和失败回滚；不要直接运行二进制代替守护脚本。

cd web
npm ci
npm run build:static
cd ..
rm -rf server/webui/dist
mkdir -p server/webui/dist
cp -a web/out/. server/webui/dist/
CGO_ENABLED=0 go build -tags embedui -o artex ./cmd/artex
./start.sh

构建跨平台发布包：

./build.sh --release

复制 config.example.json 为 config.json，填写 PostgreSQL 连接；也可以使用 ARTEX_PG_DSN 覆盖配置。

可以在系统设置页面填写供应商、模型、Base URL 和 API Key，也可以通过环境变量配置：

export ANTHROPIC_API_KEY=<your-key>
# 或：export OPENAI_API_KEY=<your-key>

本仓库不包含任何真实 API Key、密码或私有连接信息。请勿把 config.json、.env、data/ 或运行日志提交到 Git。

逆向模式默认关闭，不会在启动 ARTEX 时自动下载或运行第三方分析器。启用步骤：

1. 使用 GitHub Release 分发包时无需另装 Node.js；源码开发或需要运行外部分析器时，再准备 Node.js 22.19+、24.11+ 或 26+。
2. 在「系统设置 → MCP」中启用预置的 REA 服务。GitHub Release 分发包优先使用包内 Node.js/REA 运行时；源码环境没有内置运行时时才回退到 npx -y rea-agents@6.5.0 mcp。
3. 按 REA 中文文档 配置具体分析器及其依赖。
4. 在聊天页切换到「逆向分析」，上传或指定本地材料后开始分析。

内置技能说明见 skills/rea-reverse-engineering/SKILL.md。REA 与 Node.js 会随 GitHub Release 分发包按上游许可证提供；外部分析器不随 ARTEX 重新分发，请以各上游许可证和版本说明为准。

./dev.sh                         # 后端 8787、代理 8788、前端 5173
go test ./... -p 1 -parallel 1   # 后端测试
cd web && npm run dev            # 前端热更新

仅查看界面时可以使用模拟数据：

cd web
NEXT_PUBLIC_MOCK=1 npm run dev

更完整的安装、更新、反向代理、架构和复测说明见 README.zh.md。

flowchart LR
  UI[Next.js 前端] --> API[Go REST / SSE]
  API --> ENG[任务引擎]
  ENG --> AG[Planner / Worker / Agent]
  AG --> DB[(PostgreSQL)]
  AG --> TOOLS[MCP / Skills / 工具]
  AG --> PROXY[流量记录代理]

前端通过同源 REST 和 SSE 访问 Go 后端；任务引擎调度 Agent，将资产、探索节点、活动、发现和证据写入 PostgreSQL。安全测试与逆向分析在会话模式字段、API 查询、数据库记录和前端历史列表层面保持隔离。

本项目采用 GNU Affero General Public License v3.0。使用者必须只在自己拥有或已取得明确书面授权的环境中运行安全测试功能，并自行遵守所在地关于网络安全、数据安全、个人信息和计算机犯罪的法律法规。

在中国大陆，使用者应特别遵守《网络安全法》《数据安全法》《个人信息保护法》及相关司法解释；未经授权访问、扫描、探测、利用或破坏他人系统可能承担民事、行政或刑事责任。

本项目按“现状”（AS IS）提供，不对适用性、准确性、可用性或不间断运行作任何明示或默示保证。因使用、修改、部署或分发本项目造成的损失、数据泄露、系统损坏或法律后果，由使用者自行承担。下载、安装或使用本项目，即表示你已阅读并同意 LICENSE 及本免责声明。