ARTEX 安装与使用:原版已闭源,改装一个仍在维护的分支。
ARTEX 原版自 2026-10-08 起闭源,官方不再提供安装包,所以这里安装的是仍在维护的分支(fork)。每一条命令都抄自该分支自己的 README(下面有链接),日期截至 2026-11-16。本站不托管任何 ARTEX 代码,也不会替你安装。
准备工作:Docker、数据库和一个大模型 API Key。
两个分支需要的东西差不多,README 里是这样写的。
- 一台你自己能控制的机器,比如笔记本或实验用的虚拟机,不要用公网服务器。
- 走 Docker 方式,需要 Docker 和 Compose。RuoJi6 的 install.sh 脚本会检测并按需自动安装 Docker。
- PostgreSQL 数据库。Docker 方式会替你启动;二进制和源码方式,需要自备数据库并写进 config.json。
- 大模型 API Key:ANTHROPIC_API_KEY 或 OPENAI_API_KEY,也可以在网页控制台的 LLM 配置页里填。BaaRai 还支持本地 Ollama。
- Go 和 Node.js(含 npm),只有从源码编译时才需要。README 用的是 npm ci 和 go build。
- 空闲的 8787 端口(网页控制台与 API)和 8788 端口(流量录制代理),这是 start.sh 的默认值。
选哪个分支:要发布包选 RuoJi6,要英文 README 选 BaaRai。
星标、版本和最近推送时间取自本站的分支数据,日期 2026-11-16。
RuoJi6/ARTEX
- 星标
- 2,098
- 版本
- v0.3.30
- 最近推送
- 2026-11-14
主要的维护分支。提供五个平台的发布压缩包,以及由它自己的 GitHub Actions 构建的 Docker 镜像。README 是中文的,应用从 v0.3.28 起有英文界面。
BaaRai/ARTEX
- 星标
- 4,638
- 版本
- v0.6.0
- 最近推送
- 2026-11-16
英文翻译版,有自己的 v0.5 和 v0.6 版本线,README 为英文。没有预构建的 Docker 镜像,镜像由你本地的代码构建。控制台默认只监听 127.0.0.1,首次使用需要一次性的初始化令牌。
sharenjun/ARTEX-main 也在维护,但它的 README 仍指向已删除的原仓库,所以我们没有照抄它的命令。更多维护中的分支见分支页。 全部 ARTEX 分支
安装 RuoJi6/ARTEX:Docker Compose,四步完成。
出自 README 的 Docker Compose 一节。来源:RuoJi6/ARTEX 的 README。
- 01
克隆仓库
下载该分支的代码,并进入它的目录。
git clone https://github.com/RuoJi6/ARTEX.git cd ARTEX - 02
创建 .env 文件
打开 .env,填好 POSTGRES_PASSWORD。README 说初次部署请修改这个密码。可以在这里填 ANTHROPIC_API_KEY,也可以以后在网页控制台里设置。ARTEX_TAG 默认是 latest,README 说也可以固定为某个版本,例如 v0.3.17。
cp .env.example .env - 03
启动
这会拉取 ruoji6/artex 镜像和一个 Postgres 容器。README 把 ./skills 和 ./data 作为绑定挂载,重启后数据还在。
docker compose up -d - 04
打开控制台
访问 http://localhost:8787。第一次进入会跳到 /setup,在那里设置管理员密码。
其他安装方式
- 01
一键安装脚本
脚本会检测或自动安装 Docker,再让你选择全部用 Docker,还是本地编译运行。选 Docker 时,它会写好 .env 并执行 docker compose up -d。
git clone https://github.com/RuoJi6/ARTEX.git cd ARTEX ./install.sh - 02
预编译二进制
到 Releases 页面下载对应平台的 zip。最新版 v0.3.30 提供 Linux amd64 和 arm64、macOS amd64 和 arm64、Windows amd64 五个压缩包,另有 SHA256SUMS 文件。先核对下载文件,解压后编辑 config.json 填好数据库。按 README 的要求,请用 start.sh 启动,不要直接运行 ./artex。
sha256sum --ignore-missing --check SHA256SUMScp config.example.json config.json ./start.sh - 03
从源码编译
需要 Go 和 Node.js。下面是 README 里的命令,去掉了注释。
cd web && npm ci && npm run build:static && cd .. mkdir -p server/webui/dist cp -r web/out/. server/webui/dist CGO_ENABLED=0 go build -tags embedui -o artex ./cmd/artex ./start.sh - 04
以后升级
README 里的 Docker 升级方法如下。升级会重启程序,请在没有任务运行时进行。
docker compose pull artex docker compose up -d artex
安装 BaaRai/ARTEX:英文 README,用你自己的代码构建镜像。
出自 README 的 Quick start。来源:BaaRai/ARTEX 的 README。
- 01
克隆仓库
下载该分支的代码,并进入它的目录。
git clone https://github.com/BaaRai/ARTEX.git cd ARTEX - 02
创建 .env 文件
打开 .env,填好 POSTGRES_PASSWORD,也可以顺便填一个大模型 Key。
cp .env.example .env - 03
构建并启动
这会用你本地的代码构建镜像,并启动 PostgreSQL。README 说明没有可拉取的预构建镜像。
docker compose up -d --build - 04
领取控制台
先打印一次性的初始化令牌,再打开 http://localhost:8787,在 /setup 页面输入。
docker compose logs artex | grep "Setup token"
控制台默认只监听 127.0.0.1。README 写道,要从别的机器访问,可以在 .env 里设置 ARTEX_BIND_ADDR=0.0.0.0,或者保持本机回环,改用反向代理或 SSH 隧道。我们建议用 SSH 隧道。
BaaRai 的每个发布版都附带 SHA256SUMS、SBOM 和构建证明。README 里验证下载文件的方法如下。
sha256sum -c SHA256SUMS
gh attestation verify <zip> --repo BaaRai/ARTEX装好以后:先接入模型,再创建任务。
控制台的简短使用路径。模型和任务这两步,依据 README 和本站的运作原理页。
- 01
创建管理员账号
打开 /setup。RuoJi6 要你设置管理员密码,BaaRai 要你输入一次性初始化令牌。
- 02
接入你的模型
在控制台的 LLM 配置页填写 Key,或者在启动前先导出环境变量。README 里还列出 ARTEX_LLM_PROVIDER、ARTEX_LLM_MODEL、ARTEX_LLM_BASE_URL 和 ARTEX_LLM_PROXY。BaaRai 提醒:Anthropic 格式的 Base URL 不带 /v1,OpenAI 格式的则以 /v1 结尾。
export ANTHROPIC_API_KEY=sk-... - 03
创建任务
任务包含描述、目标、可选模板、允许与禁止规则,以及按顺序排列的 LLM 配置链。目标只填你自己的,或你有权测试的系统。
- 04
观察运行并审批
默认有三个工作智能体,数量在系统设置里调整。每次工具调用都要先过拦截规则,再过 LLM 裁判,最后由人把关。端口可以用 start.sh 的参数修改。
./start.sh -addr :8787 -proxy :8788 - 05
查看发现
每条发现都保留抓取到的请求和响应,复测智能体会重新检查修复情况。
安全使用:只测你自己的系统,或你获得授权的系统。
ARTEX 是攻击性安全工具。只能用在你自己的系统上,或者你获得明确授权的系统上:自己的实验环境、雇主资产并有书面范围,或者在公开规则之内的漏洞赏金目标。BaaRai 的 README 就是这样规定的。除此之外的使用,在你所在的地方可能构成犯罪。
请先读你选的分支的使用条款。RuoJi6 的 README 更严格:它把用途限定为学习、代码研究和本地隔离环境里的技术验证,并明确写着不得用它扫描任何网站或联网系统,即使已获授权或属于自己的资产也不行。按这份条款,只能在实验环境里用。
不要暴露到公网。TechCrunch 在 2026-11-06 报道,Censys 发现有 800 多个 ARTEX 部署无需密码就能访问。请只绑定本机地址,用 SSH 隧道或 VPN 访问,并设置高强度密码。
只使用该分支自己仓库构建的镜像和程序,或者从源码编译。不要拉取其他名为 artex 的 Docker Hub 镜像:tomicdd/artex 和 congdonglinux/artex 带有后门。
继续阅读:源码、分支和运作原理。
