Discuter de ce sujet avec une IA

Vous obtenez une réponse tirée de la documentation et la page d'où elle vient.

Installation et exploitation

Installer l'agent poison0 sur Linux

Installer, déployer, vérifier et retirer l'agent poison0 sur Linux.

~4 min de lecture · Installation et exploitation

Prérequis

PrérequisDétails
Processeurx86-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.
NoyauUn 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=.
ConteneursLe profil seccomp par défaut de Docker bloque les appels système de Landlock. Utilisez un profil adapté.
DroitsDes droits root. L'installeur s'exécute via sudo.
Clé d'installationUne clé d'installation de la console, sous Appareils → Déployer plusieurs appareils avec une clé.
Agents IAAu moins un agent IA parmi les agents pris en charge.

Installer une machine

Lancez cette commande dans un terminal.

bashTerminal
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

  1. Lancez systemctl status poisonzero. Le service doit être actif. journalctl -u poisonzero affiche son journal.
  2. Lancez poison0 doctor dans votre session de bureau. Il nomme ce qui ne va pas.
  3. 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.

bashEn root
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.

bashUtilisateur
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.

  1. Dans la console, ouvrez Appareils, choisissez Télécharger le paquet Intune, puis Linux. La console télécharge le script.
  2. Dans Intune, ajoutez un script sous Appareils → Scripts et correctifs → Scripts de plateforme → Ajouter → Linux et chargez le fichier.
  3. 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.
  4. 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é.

  1. Dans la console, ouvrez le profil et choisissez Exporter pour les privés.
  2. Passez le fichier à l'installeur avec PZ_CONFIG, comme ci-dessous.
  3. Ou placez-le avec la tâche Ansible que la console affiche après l'export.
bashTerminal
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

bashTerminal
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.

bashPaquets
sudo apt remove poisonzero   # .deb
sudo dnf remove poisonzero   # .rpm
Ne supprimez pas le programme à la main. Des hooks Claude Code qui pointent vers un programme absent bloquent chaque appel d'outil.

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ômeCauseCorrection
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.

VariableEffet
PZ_ENROLL_CODELa clé d'installation de la console. Sur une machine enregistrée, une nouvelle clé l'enregistre à nouveau.
PZ_APP_IDSeulement pour un code à usage unique fourni avec un App ID.
PZ_HEADLESSLe 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_NAMELe 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_AGENTSAjoute la commande locale de statistiques /poison0 aux agents indiqués, par exemple claude,codex.
PZ_SETUP_STATUSLINEMettez 1 pour ajouter la ligne d'état à Claude Code. Une ligne d'état existante est conservée.
PZ_SETUP_EXEC0Mettez 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_LEAK0Appareils privés uniquement. Définit le mode leak0 : enforce, observe ou off. Sans la variable et sans terminal, leak0 reste désactivé.
PZ_BACKENDcpu (par défaut) ou gpu. Le profil de la console définit si la machine utilise le GPU.
PZ_TIERenterprise (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_ALIASMettez 1 pour ne pas créer la commande courte p0.
PZ_FETCH_ONLYMettez 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_RUNMettez 1 pour afficher le mode d'installation et quitter avant toute modification.
POISONZERO_DATA_DIRChange le répertoire de données de l'installeur et de l'agent.
PZ_CONFIGChemin d'un client-config.json signé pour une machine privée. Flag : --config.
PZ_QUARANTINE_RETENTION_DAYSAppareils privés uniquement. Nombre de jours de conservation d'un cas de quarantaine, de 1 à 3650. Flag : --quarantine-retention-days.
PZ_AUDIT_MAX_MBAppareils 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émentEmplacement
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 :

bashexec0 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 sortieSignification
0Le fichier est valide.
6La licence n'est pas encore là. Le service vérifie le fichier au démarrage.
1Le fichier est illisible.
3Le fichier n'est pas signé pour cet appareil.
4Le fichier est périmé ou a expiré.
5Le fichier est invalide ou trop récent pour cette version de l'agent.
7La 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.