Installer l'agent poison0 sur Linux
Installer, déployer, vérifier et retirer l'agent poison0 sur Linux.
Prérequis
| Prérequis | Détails |
|---|---|
| Processeur | x86-64 avec AVX2 (Intel Haswell, 2013, ou plus récent, AMD Zen ou plus récent), ou ARM64 avec i8mm, par exemple AWS Graviton 3 ou 4 et Ampere One. AWS Graviton 2 et Ampere Altra ne sont pas pris en charge. |
| Noyau | Un noyau 5.13 ou plus récent avec Landlock actif, comme sur Ubuntu 22.04, Debian 12 et RHEL 9.6 ou plus récent. Sinon, ajoutez landlock au paramètre de démarrage lsm=. |
| Conteneurs | Le profil seccomp par défaut de Docker bloque les appels système de Landlock. Utilisez un profil adapté. |
| Droits | Des droits root. L'installeur s'exécute via sudo. |
| Clé d'installation | Une clé d'installation de la console, sous Appareils → Déployer plusieurs appareils avec une clé. |
| Agents IA | Au moins un agent IA parmi les agents pris en charge. |
Installer une machine
Lancez cette commande dans un terminal.
curl -fsSL https://poisonzero.com/install.sh | sudo PZ_ENROLL_CODE="<install-key>" sh
L'installeur vérifie le programme avec SHA256SUMS et s'arrête en cas d'écart. Puis il installe le service et enregistre la machine. Si le bureau n'a pas d'outil de dialogue pour les demandes de confirmation, il tente d'installer zenity. Dans un terminal, l'installeur demande s'il faut envoyer le nom de l'appareil à la console. Vous répondez Oui ou Non, il n'y a pas de valeur par défaut. Oui envoie le nom d'hôte de la machine, Non n'envoie aucun nom. Avec Ansible et les scripts sans terminal, il ne demande rien et n'envoie aucun nom.
Pour changer les valeurs par défaut, définissez les variables d'environnement sous Référence.
Vérifier la machine
- Lancez
systemctl status poisonzero. Le service doit être actif.journalctl -u poisonzeroaffiche son journal. - Lancez
poison0 doctordans votre session de bureau. Il nomme ce qui ne va pas. - Ouvrez la console. La machine apparaît sous Appareils.
poison0 répond aussi à p0 et pz. Si un autre programme utilise déjà l'un de ces noms, cet alias n'est pas créé.
Après la première installation, le modèle se télécharge en arrière-plan. Les règles fixes protègent tout de suite.
Déployer sur plusieurs machines
Utilisez Ansible ou un autre script exécuté en root.
1. Installer l'agent
Sans terminal, passez la clé en variable d'environnement. Sur un serveur sans bureau, définissez aussi PZ_HEADLESS.
PZ_ENROLL_CODE="<install-key>" sh -c "$(curl -fsSL https://poisonzero.com/install.sh)"
2. Facultatif : configurer /pz et la ligne d'état
PoisonZero configure lui-même la protection des agents d'IA après l'installation, dans chaque compte utilisateur et pour tous les agents pris en charge. Si vous voulez en plus /pz et la ligne d'état, lancez ces commandes une fois dans le compte utilisateur. La seconde ajoute la ligne d'état.
poison0 setup-claude poison0 setup-claude --statusline-only
Intune (Linux)
Intune exécute des scripts Bash sur Ubuntu Desktop 24.04 et 26.04 ainsi que sur Red Hat Enterprise Linux 9 et 10. La machine doit être inscrite dans Intune.
- Dans la console, ouvrez Appareils, choisissez Télécharger le paquet Intune, puis Linux. La console télécharge le script.
- Dans Intune, ajoutez un script sous Appareils → Scripts et correctifs → Scripts de plateforme → Ajouter → Linux et chargez le fichier.
- Choisissez Root comme contexte d'exécution. La fréquence importe peu ; par défaut, Intune exécute le script toutes les 15 minutes. Indiquez par exemple 3 pour Nouvelles tentatives.
- Affectez le script à un groupe d'appareils.
Le script n'enregistre pas une seconde fois une machine déjà enregistrée. Lors de la première exécution, Intune peut demander le consentement de l'utilisateur. Le script contient une clé d'installation que voient tous les administrateurs Intune ayant un accès en lecture aux scripts. La console la liste sous le nom Intune Linux avec la date. Elle est valable un an ; révoquez-la après le déploiement.
Machines privées : configuration signée
Une machine privée ne reçoit aucun paramètre du cloud. Elle lit un client-config.json signé.
- Dans la console, ouvrez le profil et choisissez Exporter pour les privés.
- Passez le fichier à l'installeur avec
PZ_CONFIG, comme ci-dessous. - Ou placez-le avec la tâche Ansible que la console affiche après l'export.
curl -fsSL https://poisonzero.com/install.sh | sudo \ PZ_ENROLL_CODE="<install-key>" PZ_CONFIG="./client-config.json" sh
L'installeur vérifie le fichier avec poison0 config verify et le place dans /etc/poisonzero/client-config.json, lisible uniquement par root.
Mise à jour
Les appareils cloud se mettent à jour eux-mêmes. Pour le désactiver par appareil, utilisez Settings → Protection et appareils → Mises à jour dans la console. Les appareils privés ne se mettent pas à jour eux-mêmes.
Pour une mise à jour manuelle, relancez la commande d'installation. Elle garde les identifiants. Plus d'informations dans Mises à jour et cycle de vie.
À partir de cette version, le fichier du programme est /usr/local/bin/poison0. poisonzero pointe vers lui et continue de fonctionner, et les exclusions de dossiers restent valables. Pour les exclusions de fichiers ou de processus, ajoutez poison0 et gardez poisonzero, car les hooks des agents l'appellent encore.
Désinstaller
curl -fsSL https://poisonzero.com/install.sh | sudo sh -s -- --uninstall
La désinstallation retire d'abord les hooks d'agent de tous les utilisateurs et s'arrête si cela échoue. Ensuite, elle retire le service, le notifier, les commandes, le programme et le répertoire de données.
Retirez une installation .deb ou .rpm avec le gestionnaire de paquets. Il retire d'abord les hooks.
sudo apt remove poisonzero # .deb sudo dnf remove poisonzero # .rpm
Cas de quarantaine ouverts
La désinstallation liste chaque cas de quarantaine ouvert avec son chemin d'origine, la copie en quarantaine (*.infection.pz) et la façon de le restaurer. Une copie reste dans /var/lib/poisonzero-quarantine, lisible uniquement par root.
Mettez PZ_UNINSTALL_SKIP_QUARANTINE_COPY=1 pour ne pas conserver cette copie. Rien n'est restauré automatiquement. Vérifiez chaque fichier avant de le restaurer.
La désinstallation abandonne les modifications retenues qui attendent encore une vérification. Pour en garder une, approuvez-la d'abord : listez-les avec poison0 quarantine pending, puis lancez poison0 quarantine pending approve <id>.
Dépannage
| Symptôme | Cause | Correction |
|---|---|---|
| Le moteur ne démarre pas. | Landlock n'est pas actif. | Activez Landlock comme décrit sous Prérequis. |
poison0 doctor indique que le téléchargement du modèle a échoué. | Le téléchargement en arrière-plan après la première installation n'a pas abouti. | Lancez sudo poison0 model pour réessayer tout de suite. poison0 doctor affiche la raison. |
poison0 exec0 status indique que Claude Code n'appelle pas le hook exec0. | Les paramètres Claude Code viennent de la console d'administration de claude.ai. Claude Code ignore alors 50-poisonzero-exec0.json. | Définissez "managedSourcesBehavior": "merge" dans cette source (Claude Code 2.1.242 ou plus récent), ou copiez-y le contenu du fichier. |
poison0 doctor signale que les hooks gérés sont désactivés. | Les paramètres gérés de Claude Code définissent "disableAllHooks": true. Cela désactive aussi les hooks gérés de l'agent. | Retirez le réglage là où il est défini : dans managed-settings.json, un autre fichier de managed-settings.d/ ou la console d'administration de claude.ai. L'agent ne modifie jamais ces sources. |
| L'installation s'arrête après l'enregistrement, et la configuration signée n'est pas placée. | poison0 config verify a rejeté client-config.json. Un fichier existant reste en place. | Cherchez le code de sortie sous Référence. |
| La désinstallation s'arrête et ne retire rien. | Elle n'a pas pu retirer les hooks d'agent de tous les utilisateurs. | Mettez PZ_UNINSTALL_FORCE=1 et retirez à la main les entrées restantes. |
Référence
Variables d'environnement
Définissez-les avant le lancement de l'installeur. Un flag, passé après sh -s --, l'emporte sur sa variable.
| Variable | Effet |
|---|---|
PZ_ENROLL_CODE | La clé d'installation de la console. Sur une machine enregistrée, une nouvelle clé l'enregistre à nouveau. |
PZ_APP_ID | Seulement pour un code à usage unique fourni avec un App ID. |
PZ_HEADLESS | Le traitement des demandes de confirmation quand aucun utilisateur de bureau ne peut répondre. none (par défaut) suit l'utilisateur connecté, standard traite toujours la machine comme sans bureau, strict est le plus strict. Flag : --headless. |
PZ_DEVICE_NAME | Le nom de l'appareil dans la console, enregistré en minuscules, chiffres et tirets, 63 caractères au maximum. L'installateur montre comment le nom est enregistré. Les autres options sont décrites dans l'onboarding. |
PZ_SETUP_AGENTS | Ajoute la commande locale de statistiques /poison0 aux agents indiqués, par exemple claude,codex. |
PZ_SETUP_STATUSLINE | Mettez 1 pour ajouter la ligne d'état à Claude Code. Une ligne d'état existante est conservée. |
PZ_SETUP_EXEC0 | Mettez off pour garder exec0 désactivé, aussi après les mises à jour. Les autres valeurs sont ignorées. Activez-le dans le profil de la console ou avec sudo poison0 exec0 observe ou enforce. |
PZ_SETUP_LEAK0 | Appareils privés uniquement. Définit le mode leak0 : enforce, observe ou off. Sans la variable et sans terminal, leak0 reste désactivé. |
PZ_BACKEND | cpu (par défaut) ou gpu. Le profil de la console définit si la machine utilise le GPU. |
PZ_TIER | enterprise (par défaut) ou ultra. Avec ultra, l'installeur s'arrête avec une erreur. Définissez donc Ultra dans le profil de la console. |
PZ_NO_SHORT_ALIAS | Mettez 1 pour ne pas créer la commande courte p0. |
PZ_FETCH_ONLY | Mettez 1 pour seulement télécharger et vérifier le programme, sans service ni droits root. Il va dans ./poison0 ou dans PZ_FETCH_DEST. |
PZ_DRY_RUN | Mettez 1 pour afficher le mode d'installation et quitter avant toute modification. |
POISONZERO_DATA_DIR | Change le répertoire de données de l'installeur et de l'agent. |
PZ_CONFIG | Chemin d'un client-config.json signé pour une machine privée. Flag : --config. |
PZ_QUARANTINE_RETENTION_DAYS | Appareils privés uniquement. Nombre de jours de conservation d'un cas de quarantaine, de 1 à 3650. Flag : --quarantine-retention-days. |
PZ_AUDIT_MAX_MB | Appareils privés uniquement. Taille en Mo à partir de laquelle le journal d'audit tourne, de 1 à 1024. Flag : --audit-max-mb. |
Chemins et service
| Élément | Emplacement |
|---|---|
| Le programme et ses commandes. | /usr/local/bin/poison0. Les commandes poisonzero, p0 et pz pointent vers lui. |
| Le répertoire de données. | /var/lib/poisonzero, propriétaire poisonzero:poisonzero. Il contient les identifiants, les journaux et la quarantaine. |
| Le répertoire de configuration. | /etc/poisonzero. Il contient le fichier enroll /etc/poisonzero/enroll et la configuration signée. |
| Le service. | L'unité systemd poisonzero.service. Elle démarre au boot et s'exécute en root. |
| Le notifier des demandes de confirmation. | Il démarre dans chaque session de bureau via l'autostart XDG, /etc/xdg/autostart/poisonzero-notifier.desktop. |
| Le journal du service. | daemon.log dans le répertoire de données, rotation à 5 Mo. Les mêmes lignes vont dans le journal système. |
| Les hooks exec0 pour Claude Code. | Une installation système (install.sh, .deb ou .rpm) utilise le fichier séparé /etc/claude-code/managed-settings.d/50-poisonzero-exec0.json, aussi sur WSL. Une installation Homebrew sous un préfixe de l'utilisateur utilise ~/.claude/settings.json à la place. |
Hooks exec0 dans Claude Code
L'agent ne modifie jamais votre managed-settings.json ni les autres fichiers de managed-settings.d/. Pour désactiver ou activer exec0 pour Claude Code :
# turn off sudo poison0 setup-claude --toolgate-off # turn on sudo poison0 setup-claude --toolgate
Codes de sortie de la configuration signée
poison0 config verify renvoie ces codes. L'installeur place le fichier seulement pour 0 ou 6.
| Code de sortie | Signification |
|---|---|
| 0 | Le fichier est valide. |
| 6 | La licence n'est pas encore là. Le service vérifie le fichier au démarrage. |
| 1 | Le fichier est illisible. |
| 3 | Le fichier n'est pas signé pour cet appareil. |
| 4 | Le fichier est périmé ou a expiré. |
| 5 | Le fichier est invalide ou trop récent pour cette version de l'agent. |
| 7 | La machine est un appareil cloud, qui ignore le fichier. |
À lire ensuite
Autres systèmes d'exploitation : vue d'ensemble de l'installation. Matériel : Configuration requise. Isolation du moteur : bac à sable Linux.