ARTEX 설치 방법:원본이 닫혔으므로 유지 관리되는 포크를 실행합니다.
ARTEX 원본은 2026-10-08부터 비공개 소스이므로 내려받을 공식 설치 파일이 없습니다. 그래서 이 글은 유지 관리되는 포크를 설치합니다. 모든 명령어는 아래에 링크한 해당 포크의 README에서 그대로 가져왔으며 기준일은 2026-11-16입니다. 이 사이트는 ARTEX 코드를 호스팅하지 않고 대신 설치해 주지도 않습니다.
필요한 것:Docker, 데이터베이스, LLM 키.
두 포크가 요구하는 것은 거의 같습니다. README에는 다음과 같이 적혀 있습니다.
- 직접 관리하는 컴퓨터. 노트북이나 실습용 가상 머신이면 됩니다. 공개 서버는 안 됩니다.
- Docker 방식에는 Docker와 Compose가 필요합니다. RuoJi6의 install.sh 스크립트는 Docker를 감지하고 필요하면 설치해 줍니다.
- PostgreSQL. Docker 방식에서는 자동으로 띄워 줍니다. 바이너리와 소스 방식에서는 직접 준비한 데이터베이스를 config.json에 적어야 합니다.
- LLM API 키: 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용 zip과 SHA256SUMS 파일이 있습니다. 받은 파일을 대조한 뒤 압축을 풀고 config.json에 데이터베이스를 채웁니다. README대로 ./artex가 아니라 start.sh로 시작하십시오.
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를 설정하고, 원하면 LLM 키도 넣습니다.
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 설정 페이지에 키를 입력하거나, 시작하기 전에 환경 변수로 내보냅니다. README에는 ARTEX_LLM_PROVIDER, ARTEX_LLM_MODEL, ARTEX_LLM_BASE_URL, ARTEX_LLM_PROXY도 나옵니다. BaaRai는 Anthropic 형식의 기본 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가 비밀번호 없이 접속되는 ARTEX 배포를 800개 넘게 찾았다고 보도했습니다. 로컬 주소에만 바인딩하고 SSH 터널이나 VPN으로 접속하며 강한 비밀번호를 설정하십시오.
해당 포크 저장소가 직접 빌드한 이미지와 바이너리만 쓰거나 소스에서 빌드하십시오. artex라는 이름의 다른 Docker Hub 이미지는 받지 마십시오. tomicdd/artex와 congdonglinux/artex에는 백도어가 있었습니다.
이어서 읽기:소스 코드, 포크, 작동 원리.
