Guide d'installation Strix : déployer un agent de pentest IA sur Ubuntu VPS (2026)

En 2026, Strix figure parmi les outils de pentest IA open source les plus populaires sur GitHub. Grâce à la collaboration multi-agents, il simule le comportement de vrais attaquants : il ne se contente pas de détecter des vulnérabilités, il vérifie chaque découverte avec un PoC reproductible (Proof of Concept), réduisant fortement le taux de faux positifs des scanners traditionnels.

Cet article est un guide d'installation pratique pour les ingénieurs sécurité et les équipes DevSecOps : déployer Strix de zéro sur un Ubuntu VPS, configurer le LLM, lancer le premier scan et automatiser le démarrage avec cloud-init.

Avertissement juridique : Strix ne peut être utilisé que sur des cibles que vous possédez ou pour lesquelles vous disposez d'une autorisation écrite. Les tests de pénétration non autorisés peuvent être illégaux — la responsabilité incombe à l'utilisateur.

Qu'est-ce que Strix ? Pour qui ?

Strix est un framework de pentest IA open source sous licence Apache 2.0. Contrairement aux scanners SAST/DAST classiques, ses agents :

• Exécutent dynamiquement les cibles — répertoires de code locaux, dépôts GitHub ou applications Web en production
• Collaborent en multi-agents — reconnaissance, exploitation et vérification par des agents distincts, comme une vraie red team
• Vérifient par PoC — chaque vulnérabilité inclut des étapes d'attaque reproductibles ; pas de PoC, pas de rapport
• Sont adaptés aux développeurs — CLI en un clic, résultats dans strix_runs/, tableau de bord via strix view

Cas d'usage typiques :

Pourquoi un Ubuntu VPS plutôt qu'une machine locale ?

Strix fonctionne sous Linux, macOS ou Windows (WSL2), mais déployer l'agent sur un VPS dédié offre des avantages nets :

1. Isolation du trafic — les requêtes anormales du pentest ne passent pas par le réseau d'entreprise ; moindre risque de blocage IP
2. Destruction à la demande — supprimez l'instance après le test, sans traces de scan ni clés API sensibles
3. Ressources dédiées — les conteneurs sandbox Docker consomment de la RAM ; 8 Go sur VPS plus stable qu'en arrière-plan sur un portable
4. Automatisation facilitée — scripts cloud-init réutilisables chez tout fournisseur cloud ; une « machine de pentest » en 5 minutes

Ubuntu 22.04 / 24.04 LTS est le choix privilégié : support Docker officiel complet, documentation communautaire riche, et le script d'installation Strix est le mieux validé sur les distributions Debian.

Prérequis et choix du VPS

Exigences minimales officielles

• Système d'exploitation : Linux (cet article utilise Ubuntu 24.04 LTS comme exemple)
• Python : 3.12+ (géré automatiquement par le script d'installation)
• Docker : installé et daemon en cours d'exécution
• Mémoire : 4 Go minimum, 8 Go recommandés
• Disque : 5 Go+ (image sandbox ~2 Go, résultats de scan en sus)
• Clé API LLM : OpenAI, Anthropic, Google ou tout autre fournisseur pris en charge

Spécifications VPS recommandées

Lors du choix du VPS :

• Privilégiez une région à faible latence vers l'application cible (Singapour/Tokyo pour les cibles APAC)
• Vérifiez que le fournisseur autorise le trafic de pentest sortant (certains VPS bon marché interdisent le scan de ports)
• Connexion par clé SSH recommandée, désactivez la connexion par mot de passe

Installation manuelle : déploiement en six étapes

Les commandes suivantes supposent une connexion SSH sur un VPS Ubuntu 24.04 neuf (utilisateur root ou avec droits sudo).

Étape 1 : Mettre à jour le système

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

Étape 2 : Installer 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

Étape 3 : Installer Strix

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

Le script configure automatiquement un environnement virtuel Python et ajoute strix au PATH. Vérifier l'installation :

strix --version

Étape 4 : (Optionnel) Pré-télécharger l'image sandbox

Le premier scan télécharge automatiquement une image Docker sandbox d'environ 2 Go. Un pré-téléchargement évite une longue attente pendant le scan :

docker pull ghcr.io/usestrix/sandbox:latest

Étape 5 : Configurer le LLM

Voir la section suivante.

Étape 6 : Lancer le premier scan

Voir la section « Lancer la première évaluation de sécurité ».

Configurer le fournisseur LLM

Les capacités de raisonnement des agents Strix dépendent entièrement du grand modèle de langage. Configuration via deux variables d'environnement :

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

Exemples de fournisseurs courants

Variables d'environnement optionnelles

# 推理深度（默认 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"

La configuration est enregistrée automatiquement dans ~/.strix/cli-config.json — pas de ressaisie à la prochaine connexion.

Lancer la première évaluation de sécurité

Scan boîte noire d'application Web

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

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

Audit code boîte blanche

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

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

Test boîte grise avec authentification

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

Consulter les résultats du scan

Pendant le scan, Strix écrit les résultats en temps réel dans strix_runs/<run-name>/. Une fois terminé :

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

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

strix view démarre un service Web local sur 127.0.0.1. Sur un VPS distant, utilisez le transfert de port SSH :

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

Ouvrez ensuite l'URL affichée dans le terminal depuis votre navigateur local.

Script d'initialisation cloud-init en un clic

Si vous créez et détruisez fréquemment des VPS de pentest, regroupez les étapes ci-dessus dans un script cloud-init exécuté automatiquement à la création de l'instance :

#!/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>"

Usages avancés et intégration CI/CD

Modes de scan

# 快速扫描（适合 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

Exemple 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

En CI, Strix se termine avec un code de sortie non nul si des vulnérabilités sont trouvées — bloquant directement les fusions non sécurisées.

Scan par lot multi-cibles

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

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

Recommandations de durcissement VPS

Le VPS de pentest lui-même doit être protégé — il contient des clés API LLM et l'agent exécute des commandes arbitraires dans la sandbox :

1. Pare-feu : n'ouvrir que SSH (22), fermer tous les autres ports entrants
2. Durcissement SSH : désactiver la connexion par mot de passe, authentification par clé uniquement ; port non standard envisageable
3. Isolation des clés API : créer une clé LLM dédiée pour Strix, définir une limite d'usage
4. Destruction régulière : détruire le VPS après l'évaluation, ne pas laisser la surface d'attaque exposée
5. Audit des logs : conserver /var/log/cloud-init-output.log pour le dépannage d'installation

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

Dépannage des problèmes courants

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

Résumé

Le chemin essentiel pour déployer Strix sur Ubuntu VPS est clair :

1. Préparer un VPS Ubuntu 8 Go, installer Docker
2. Exécuter curl -sSL https://strix.ai/install | bash
3. Configurer STRIX_LLM et LLM_API_KEY
4. Lancer strix --target <url> sur des cibles autorisées
5. Consulter les rapports avec PoC via strix view

Avec un script cloud-init, lancez une machine de pentest dédiée chez n'importe quel fournisseur cloud en 5 minutes — testez et détruisez, sans résidu. Pour les équipes avec une porte de sécurité continue, l'intégration GitHub Actions fait passer chaque PR par un pentest IA automatique.

Cet article s'appuie sur la documentation officielle Strix et la version de juillet 2026. L'outil évolue rapidement — référez-vous à docs.strix.ai.