Strix 설치 가이드: Ubuntu VPS에 AI 침투 테스트 Agent 배포하기 (2026)

2026년, Strix는 GitHub에서 가장 인기 있는 오픈소스 AI 침투 테스트 도구 중 하나가 되었습니다. 멀티 Agent 협업으로 실제 해커 행동을 시뮬레이션하고, 취약점을 발견하는 것뿐 아니라 재현 가능한 PoC(개념 검증)로 각 발견을 검증하여 기존 스캐너의 오탐률을 크게 낮춥니다.

이 글은 보안 엔지니어와 DevSecOps 팀을 위한 실습 설치 가이드입니다. Ubuntu VPS에서 Strix를 처음부터 배포하고, LLM 설정, 첫 스캔, cloud-init으로 「부팅 즉시 사용」 자동화까지 다룹니다.

법적 고지: Strix는 소유하거나 서면 허가를 받은 대상에만 사용할 수 있습니다. 무단 침투 테스트는 법률 위반일 수 있으며, 사용자는 전적인 책임을 집니다.

Strix란? 누구를 위한 것?

Strix는 Apache 2.0 라이선스의 오픈소스 AI 침투 테스트 프레임워크입니다. 기존 SAST/DAST 스캐너와 달리 Agent는 다음을 수행합니다:

• 동적 타겟 실행——로컬 코드 디렉터리, GitHub 저장소 또는 온라인 Web 앱 스캔
• 멀티 Agent 협업——정찰, 익스플로잇, 검증을 다른 Agent가 분담, 실제 레드팀과 유사
• PoC 검증——각 취약점에 재현 가능한 공격 단계를 포함, PoC 없이는 보고하지 않음
• 개발자 친화적——CLI 원클릭 실행, 결과는 strix_runs/에 저장, strix view로 로컬 대시보드 열기

일반적인 사용 시나리오:

왜 로컬이 아닌 Ubuntu VPS?

Strix는 Linux, macOS, Windows(WSL2)에서 실행할 수 있지만, Agent를 독립 VPS에 배포하면 명확한 이점이 있습니다:

1. 트래픽 격리——침투 테스트로 발생하는 비정상 요청이 사내 네트워크 출구를 거치지 않아 IP 오차단 위험 감소
2. 온디맨드 삭제——테스트 완료 후 인스턴스 삭제, 스캔 흔적과 민감 API Key 미보존
3. 리소스 전용——Docker 샌드박스 컨테이너는 메모리를 소비하므로 8GB VPS가 노트북 백그라운드 실행보다 안정적
4. 자동화 친화적——cloud-init 스크립트는 모든 클라우드 공급자에서 재사용 가능, 5분 내 「침투 테스트 머신」 가동

Ubuntu 22.04 / 24.04 LTS가 1순위: Docker 공식 지원이 충실하고 커뮤니티 문서가 풍부하며, Strix 설치 스크립트는 Debian 계열에서 가장 검증되었습니다.

환경 요구사항과 VPS 선택

공식 최소 요구사항

• OS: Linux (본 글은 Ubuntu 24.04 LTS 예시)
• Python: 3.12+ (설치 스크립트가 자동 처리)
• Docker: 설치 완료 및 daemon 실행 중
• 메모리: 최소 4GB, 8GB 권장
• 디스크: 5GB+ (샌드박스 이미지 약 2GB, 스캔 결과 별도)
• LLM API Key: OpenAI, Anthropic, Google 등 지원 공급자 중 하나

권장 VPS 사양

VPS 선택 시 주의:

• 대상 앱에 지연 시간이 낮은 리전 우선 (아시아·태평양 대상은 싱가포르/도쿄 노드)
• 공급자가 아웃바운드 침투 테스트 트래픽을 허용하는지 확인 (일부 저가 VPS는 포트 스캔 금지)
• 로그인은 SSH 키 권장, 비밀번호 로그인 비활성화

수동 설치: 6단계로 배포

아래 명령은 SSH로 새 Ubuntu 24.04 VPS(root 또는 sudo 권한 사용자)에 로그인한 상태를 가정합니다.

1단계: 시스템 업데이트

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git ca-certificates gnupg

2단계: Docker Engine 설치

# 添加 Docker 官方 GPG 密钥与仓库
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin

# 将当前用户加入 docker 组（避免每次 sudo）
sudo usermod -aG docker $USER
newgrp docker

# 验证 Docker 运行正常
docker ps

3단계: Strix 설치

curl -sSL https://strix.ai/install | bash

설치 스크립트는 Python 가상 환경을 자동 설정하고 strix를 PATH에 추가합니다. 설치 확인:

strix --version

4단계: (선택) 샌드박스 이미지 사전 풀

첫 스캔 시 약 2GB Docker 샌드박스 이미지가 자동 다운로드됩니다. 사전 풀으로 스캔 중 긴 대기 시간 방지:

docker pull ghcr.io/usestrix/sandbox:latest

5단계: LLM 설정

다음 섹션에서 자세히 설명합니다.

6단계: 첫 스캔 실행

「첫 보안 평가 실행」 섹션을 참조하세요.

LLM 공급자 설정

Strix Agent의 추론 능력은 대규모 언어 모델에 전적으로 의존합니다. 두 환경 변수로 설정:

# 选择模型（格式：provider/model-name）
export STRIX_LLM="openai/gpt-5.4"
export LLM_API_KEY="sk-your-api-key-here"

주요 공급자 예시

선택적 환경 변수

# 推理深度（默认 high；quick 扫描用 medium）
export STRIX_REASONING_EFFORT="high"

# 启用联网搜索能力（Perplexity）
export PERPLEXITY_API_KEY="pplx-your-key"

# 本地模型 API 地址
export LLM_API_BASE="http://localhost:11434/v1"

설정은 자동으로 ~/.strix/cli-config.json에 저장되어 다음 로그인 시 재입력이 필요 없습니다.

첫 보안 평가 실행

블랙박스 Web 앱 스캔

# 扫描你有授权的目标 URL
strix --target https://your-app.example.com

# 无交互模式（适合 VPS / CI）
strix -n --target https://your-app.example.com

화이트박스 코드 감사

# 扫描本地项目目录
strix --target ./my-app

# 扫描 GitHub 仓库
strix --target https://github.com/your-org/your-repo

인증 포함 그레이박스 테스트

strix --target https://your-app.example.com \
  --instruction "使用测试账号 admin:TestPass123 进行登录后测试，重点关注 IDOR 与权限提升"

스캔 결과 확인

스캔 중 Strix는 결과를 strix_runs/<run-name>/에 실시간으로 기록합니다. 완료 후:

# 打开最近一次扫描的 Web 仪表盘
strix view

# 打开指定 run
strix view my-run-name

strix view는 127.0.0.1에 바인딩하는 로컬 Web 서비스를 시작합니다. 원격 VPS에서 실행하는 경우 SSH 포트 포워딩으로 확인:

# 在本地机器执行（将 VPS 上的仪表盘映射到本地）
ssh -L 8787:127.0.0.1:8787 user@your-vps-ip

그 후 로컬 브라우저에서 터미널 출력 URL을 엽니다.

cloud-init 원클릭 초기화 스크립트

침투 테스트 VPS를 자주 생성·삭제하는 경우, 위 단계를 cloud-init 스크립트로 묶어 인스턴스 생성 시 자동 실행할 수 있습니다:

#!/bin/bash
# cloud-init: Strix pentest VPS bootstrap
# 使用前替换下方的 LLM 配置

set -euo pipefail
export DEBIAN_FRONTEND=noninteractive

# ── 系统更新 ──
apt-get update -y
apt-get upgrade -y
apt-get install -y curl git ca-certificates gnupg

# ── 安装 Docker ──
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
chmod a+r /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo ${VERSION_CODENAME}) stable" > /etc/apt/sources.list.d/docker.list
apt-get update -y
apt-get install -y docker-ce docker-ce-cli containerd.io

# ── 安装 Strix ──
curl -sSL https://strix.ai/install | bash

# ── 配置 LLM（替换为你的密钥）──
cat >> /root/.bashrc <<'EOF'
export STRIX_LLM="openai/gpt-5.4"
export LLM_API_KEY="REPLACE_WITH_YOUR_KEY"
EOF

# ── 预拉取沙箱镜像 ──
docker pull ghcr.io/usestrix/sandbox:latest

echo "✅ Strix pentest VPS ready. SSH in and run: strix --target <url>"

고급 사용법과 CI/CD 통합

스캔 모드

# 快速扫描（适合 PR 门禁，成本更低）
strix -n -t ./ --scan-mode quick

# 标准深度扫描
strix -n -t ./ --scan-mode standard

# 仅扫描 PR diff 变更（需 git 历史）
strix -n -t ./ --scan-mode quick --scope-mode diff --diff-base origin/main

GitHub Actions 예시

name: strix-penetration-test

on:
  pull_request:

jobs:
  security-scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

      - name: Install Strix
        run: curl -sSL https://strix.ai/install | bash

      - name: Run Strix
        env:
          STRIX_LLM: ${{ secrets.STRIX_LLM }}
          LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
        run: strix -n -t ./ --scan-mode quick

CI에서 Strix가 취약점을 발견하면 0이 아닌 종료 코드로 종료하여 불안전한 코드 병합을 직접 차단할 수 있습니다.

다중 타겟 일괄 스캔

# 同时扫描代码仓库和线上环境
strix -t https://github.com/org/app -t https://app.example.com

# 从文件读取目标列表
strix --target-list ./targets.txt

VPS 보안 강화 권장사항

침투 테스트 VPS 자체도 보호가 필요합니다——LLM API Key를 보유하고 Agent는 샌드박스에서 임의 명령을 실행합니다:

1. 방화벽: SSH(22)만 개방, 다른 인바운드 포트 차단
2. SSH 강화: 비밀번호 로그인 비활성화, 키 인증만 허용; 비표준 포트 변경도 고려
3. API Key 격리: Strix 전용 LLM API Key 생성, 사용량 상한 설정
4. 정기 삭제: 평가 완료 후 VPS 삭제, 장기 공격 표면 노출 방지
5. 로그 감사: /var/log/cloud-init-output.log 보존, 설치 문제 해결에 활용

# UFW 基础规则示例
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow OpenSSH
sudo ufw enable

자주 묻는 문제 해결

sudo usermod -aG docker $USER
newgrp docker
# 或重新 SSH 登录

# 手动拉取并检查网络
docker pull ghcr.io/usestrix/sandbox:latest

# 若 ghcr.io 不可达，配置 Docker 镜像加速（视云厂商而定）

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
strix --version

# 查看 cloud-init 日志
sudo cat /var/log/cloud-init-output.log
sudo journalctl -u cloud-init --no-pager

요약

Ubuntu VPS에서 Strix를 배포하는 핵심 경로는 명확합니다:

1. 8GB 메모리 Ubuntu VPS 준비, Docker 설치
2. curl -sSL https://strix.ai/install | bash 실행
3. STRIX_LLM과 LLM_API_KEY 설정
4. 허가된 대상에 strix --target <url> 실행
5. strix view로 PoC 포함 취약점 보고서 확인

cloud-init 스크립트와 결합하면 모든 클라우드 공급자에서 5분 내 전용 침투 테스트 머신을 가동하고, 테스트 후 삭제하여 흔적 없이 운영할 수 있습니다. 지속적인 보안 게이트가 필요한 팀에는 GitHub Actions 통합으로 각 PR이 자동으로 AI 침투 테스트를 거칩니다.

본 글은 Strix 공식 문서와 2026년 7월 최신 버전을 기반으로 작성되었습니다. 도구는 자주 업데이트되므로 docs.strix.ai를 참조하세요.