跳到正文
ARTEX.sh

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。

  1. 01

    克隆仓库

    下载该分支的代码,并进入它的目录。

    git clone https://github.com/RuoJi6/ARTEX.git
    cd ARTEX
  2. 02

    创建 .env 文件

    打开 .env,填好 POSTGRES_PASSWORD。README 说初次部署请修改这个密码。可以在这里填 ANTHROPIC_API_KEY,也可以以后在网页控制台里设置。ARTEX_TAG 默认是 latest,README 说也可以固定为某个版本,例如 v0.3.17。

    cp .env.example .env
  3. 03

    启动

    这会拉取 ruoji6/artex 镜像和一个 Postgres 容器。README 把 ./skills 和 ./data 作为绑定挂载,重启后数据还在。

    docker compose up -d
  4. 04

    打开控制台

    访问 http://localhost:8787。第一次进入会跳到 /setup,在那里设置管理员密码。

其他安装方式

  1. 01

    一键安装脚本

    脚本会检测或自动安装 Docker,再让你选择全部用 Docker,还是本地编译运行。选 Docker 时,它会写好 .env 并执行 docker compose up -d。

    git clone https://github.com/RuoJi6/ARTEX.git
    cd ARTEX
    ./install.sh
  2. 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 SHA256SUMS
    cp config.example.json config.json
    ./start.sh
  3. 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
  4. 04

    以后升级

    README 里的 Docker 升级方法如下。升级会重启程序,请在没有任务运行时进行。

    docker compose pull artex
    docker compose up -d artex

安装 BaaRai/ARTEX:英文 README,用你自己的代码构建镜像。

出自 README 的 Quick start。来源:BaaRai/ARTEX 的 README。

  1. 01

    克隆仓库

    下载该分支的代码,并进入它的目录。

    git clone https://github.com/BaaRai/ARTEX.git
    cd ARTEX
  2. 02

    创建 .env 文件

    打开 .env,填好 POSTGRES_PASSWORD,也可以顺便填一个大模型 Key。

    cp .env.example .env
  3. 03

    构建并启动

    这会用你本地的代码构建镜像,并启动 PostgreSQL。README 说明没有可拉取的预构建镜像。

    docker compose up -d --build
  4. 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 和本站的运作原理页。

  1. 01

    创建管理员账号

    打开 /setup。RuoJi6 要你设置管理员密码,BaaRai 要你输入一次性初始化令牌。

  2. 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-...
  3. 03

    创建任务

    任务包含描述、目标、可选模板、允许与禁止规则,以及按顺序排列的 LLM 配置链。目标只填你自己的,或你有权测试的系统。

  4. 04

    观察运行并审批

    默认有三个工作智能体,数量在系统设置里调整。每次工具调用都要先过拦截规则,再过 LLM 裁判,最后由人把关。端口可以用 start.sh 的参数修改。

    ./start.sh -addr :8787 -proxy :8788
  5. 05

    查看发现

    每条发现都保留抓取到的请求和响应,复测智能体会重新检查修复情况。

安全使用:只测你自己的系统,或你获得授权的系统。

ARTEX 是攻击性安全工具。只能用在你自己的系统上,或者你获得明确授权的系统上:自己的实验环境、雇主资产并有书面范围,或者在公开规则之内的漏洞赏金目标。BaaRai 的 README 就是这样规定的。除此之外的使用,在你所在的地方可能构成犯罪。

请先读你选的分支的使用条款。RuoJi6 的 README 更严格:它把用途限定为学习、代码研究和本地隔离环境里的技术验证,并明确写着不得用它扫描任何网站或联网系统,即使已获授权或属于自己的资产也不行。按这份条款,只能在实验环境里用。

不要暴露到公网。TechCrunch 在 2026-11-06 报道,Censys 发现有 800 多个 ARTEX 部署无需密码就能访问。请只绑定本机地址,用 SSH 隧道或 VPN 访问,并设置高强度密码。

只使用该分支自己仓库构建的镜像和程序,或者从源码编译。不要拉取其他名为 artex 的 Docker Hub 镜像:tomicdd/artex 和 congdonglinux/artex 带有后门。

持续关注 ARTEX 动态。

新分支、新版本和新报告,均标注日期并附来源。

带有发光光柱的等距平面