Assistant IA sur son serveur
Vous voulez un assistant IA sur votre serveur, sans lui confier les clés de la maison. Installons-le sur un compte réservé, avec une sauvegarde derrière nous, puis regardons l'alternative qui tourne chez vous.
- Parcours
- Tutoriel 28 sur 35
- Durée
- 25 min de lecture
- Vérifié avec
- Debian 13.7, Claude Code 2.1.318
Ce que vous saurez faire
- Choisir entre un assistant en ligne et un modèle local.
- Créer un compte réservé à l'assistant et sauvegarder avant de commencer.
- Installer l'assistant, puis le lancer et vous connecter.
- Choisir le mode de permission de l'assistant, et savoir quel matériel un modèle local demande.
Avant de commencer : Première connexion en SSH, Sécuriser SSH : couper les mots de passe, Utilisateurs, sudo et droits.
Sommaire
Comment héberger un assistant IA sur son serveur ? Vous avez une machine sous Debian et des commandes que vous ne connaissez pas encore par cœur. Un assistant lit vos fichiers et propose les bonnes lignes, à une condition : qu'il ne puisse casser que ce que vous avez prévu. Ce tutoriel installe l'assistant dans un coin fermé du serveur, puis explique quand un modèle local est une meilleure idée. Prévenons tout de suite : l'assistant en ligne demande un compte en ligne payant, détaillé à l'étape 4. Le modèle local n'en demande aucun.
Deux façons d'avoir un assistant sur son serveur
Deux options existent. L'assistant en ligne est installé sur le serveur, mais il réfléchit chez son éditeur. Le modèle local réfléchit sur le serveur lui-même. Ici, l'assistant en ligne est Claude Code, un programme édité par Anthropic. Voici ce qui les distingue :
- Un assistant en ligne est un programme que vous lancez dans le terminal et à qui vous écrivez en français. Il lit vos fichiers, propose des commandes et les exécute si vous acceptez. Il est léger et demande un compte en ligne payant, car sa réflexion se fait sur les machines de l'éditeur, par Internet.
- Un modèle local est le « cerveau » de l'IA, un gros fichier que votre serveur fait tourner lui-même. Rien ne sort de chez vous, mais il lui faut de la mémoire et, idéalement, une carte graphique.
Nous commençons par l'assistant en ligne, parce que le calcul se fait chez l'éditeur : votre serveur n'a besoin que de 4 Go de mémoire. Le modèle local a son chapitre plus bas. Un compte Linux est une identité sur la machine, avec son dossier personnel et ses droits. L'assistant lance ses commandes avec les droits du compte qui l'a démarré. Fabriquons-lui donc un compte à sa taille.
Texte alternatif : votre ordinateur se connecte en SSH à mon-serveur. Sur mon-serveur, deux comptes : alice avec sudo, et assistant sans sudo. Le compte assistant envoie ses questions à un service en ligne par Internet.
1Créer un compte réservé à l'assistant
Créez un compte à part, sans droit d'administrateur. Le préfixe sudo prête ces droits le temps d'une commande, et ce compte n'y aura pas droit. L'assistant ne pourra ainsi pas modifier le système lui-même. Le rappel complet se trouve dans Utilisateurs, sudo et droits. Connectez-vous d'abord par SSH, comme dans Première connexion en SSH. Ici, alice est un nom d'exemple : remplacez-le par votre propre utilisateur. Lancez ces deux commandes. La première crée le compte assistant sans mot de passe : tant que vous n'y ajoutez pas de clé, personne ne peut s'y connecter par SSH. La seconde, id, prouve que le compte existe en affichant ses numéros. Vous y entrerez depuis alice, à l'étape 3.
sudo adduser --disabled-password --gecos "" assistant
id assistantuid=1001(assistant) gid=1001(assistant) groups=1001(assistant),100(users)Les numéros peuvent varier chez vous. Vérifiez maintenant qu'il n'a aucun droit d'administrateur. Cette commande demande à sudo (-l liste les droits, -U désigne le compte) ce que le compte Linux assistant a le droit de faire.
sudo -l -U assistantUser assistant is not allowed to run sudo on mon-serveur.Vérifiez que son dossier personnel est fermé aux autres comptes Linux. L'option -d de ls montre le dossier lui-même, pas son contenu. Les droits drwx------ signifient que seul le propriétaire y entre.
ls -ld /home/assistant /home/alicedrwx------ 2 alice alice 4096 Nov 6 09:19 /home/alice
drwx------ 2 assistant assistant 4096 Nov 6 09:19 /home/assistantLes dates seront les vôtres. Les autres comptes n'entrent donc pas dans le dossier d'alice. Il reste à vous protéger des erreurs de l'assistant lui-même.
2Sauvegarder avant
Faites une copie de /etc, le dossier des réglages du système, avant de laisser l'assistant approcher quoi que ce soit. Une sauvegarde est une copie de réserve, pour revenir en arrière si une manœuvre tourne mal. Ici, la copie sera un seul fichier, une archive, rangé chez alice, dossier fermé aux autres comptes à l'étape précédente. Elle contient vos réglages, y compris les mots de passe chiffrés des comptes : gardez-la là et nulle part ailleurs.
mkdir -p ~/sauvegardes
sudo tar -czf ~/sauvegardes/etc-avant-assistant.tar.gz -C / etc
sudo chown alice: ~/sauvegardes/etc-avant-assistant.tar.gz
chmod 600 ~/sauvegardes/etc-avant-assistant.tar.gz
ls -lh ~/sauvegardestotal 96K
-rw------- 1 alice alice 94K Nov 6 10:51 etc-avant-assistant.tar.gzLa taille et la date seront les vôtres. tar range un dossier entier dans un seul fichier : -c crée l'archive, -z la comprime, -f donne son nom et -C / se place d'abord à la racine du système, le dossier /. Ensuite chown donne le fichier à alice, et chmod 600 le réserve à elle seule : il contient des mots de passe chiffrés. Cette archive protège les réglages ; pour vos données, passez par Première sauvegarde avec rsync, qui copie vers une autre machine.
Reprendre un fichier de l'archive
Pour retrouver un fichier, extrayez-le dans un dossier à part, sans toucher à /etc. Ici, -x extrait et etc/hostname nomme le fichier voulu. Il apparaît dans ~/restauration/etc/hostname : vous l'ouvrez à côté du fichier actuel de /etc, puis vous ne recopiez que la ligne à rétablir.
mkdir -p ~/restauration
tar -xzf ~/sauvegardes/etc-avant-assistant.tar.gz -C ~/restauration etc/hostname
ls ~/restauration/etc3Installer l'assistant
Installez Claude Code depuis le compte assistant. Claude Code demande Debian 10 ou plus et 4 Go de RAM, la mémoire de travail de la machine. Il faut aussi curl, le programme qui télécharge une adresse web. Depuis alice, la commande suivante installe curl, ou vous dit qu'il est déjà là.
sudo apt install -y curlPour travailler dans le compte assistant, ouvrez-y une session depuis alice. L'option -u assistant désigne le compte à ouvrir, et -i règle la session comme si l'assistant venait de se connecter. Vous en sortirez avec exit, qui ferme la session et vous ramène en alice.
sudo -iu assistantVous êtes maintenant dans le compte assistant. L'installateur est un script de l'éditeur : un fichier de commandes que bash, le programme du terminal, lit ligne à ligne. Téléchargez-le d'abord dans un fichier, lisez-le avec less (q pour quitter), puis lancez-le. Vous y verrez surtout des téléchargements depuis des adresses de l'éditeur et des copies dans ~/.local. Si le texte vous semble illisible ou parle d'autres sites, arrêtez-vous et demandez conseil.
curl -fsSL https://claude.ai/install.sh -o install.sh
less install.sh
bash install.shSetting up Claude Code...
Checking installation status...
Installing Claude Code native build latest...
Setting up launcher and shell integration...
Setup notes:
* Native installation exists but ~/.local/bin is not in your PATH. Run:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
Claude Code successfully installed!
Version: 2.1.318
Location: ~/.local/bin/claude
Next: Run claude --help to get started
Setup notes:
* Native installation exists but ~/.local/bin is not in your PATH. Run:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
Installation complete!Le numéro de version sera sûrement plus récent. L'installateur dit que le PATH, la liste des dossiers où le terminal cherche les programmes, ne contient pas encore ~/.local/bin. Il propose une commande pour l'ajouter, que vous pouvez ignorer : à la connexion suivante, Debian ajoute ce dossier toute seule. C'est ce que la commande suivante vérifie. Vous restez dans le compte assistant, mais exec bash -l remplace votre terminal par un neuf, comme à la connexion (-l veut dire « login »). Puis vous demandez la version.
exec bash -l
claude --version2.1.318 (Claude Code)Cette installation se met à jour toute seule en arrière-plan. Pour une mise à jour immédiate, tapez claude update.
4Le premier lancement
L'assistant se connecte à votre compte en ligne chez l'éditeur, à ne pas confondre avec le compte Linux. Un compte gratuit ne suffit pas. Deux formules existent :
- Un abonnement payant chez l'éditeur, qui inclut l'usage de Claude Code. Le prix est fixe chaque mois, c'est ce que je conseille pour débuter.
- Un compte Console, l'espace développeur de l'éditeur, où vous versez une somme à l'avance. Chaque question en consomme un peu : vous payez ce que vous utilisez, donc la facture varie.
Les prix changent : lisez la page officielle des offres, sur le site de l'éditeur, avant de payer. Vous êtes encore dans le compte Linux assistant. Créez un dossier de travail, puis lancez claude à l'intérieur.
mkdir -p ~/travail
cd ~/travail
claude --permission-mode manualL'option --permission-mode choisit le mode de permission, expliqué plus bas. Ses valeurs possibles s'affichent avec claude --help.
L'assistant vous demande si vous faites confiance à ce dossier : répondez oui, c'est le vôtre. Il propose ensuite de vous connecter. Votre serveur n'a pas de navigateur, alors il affiche une adresse. Copiez-la, ouvrez-la sur votre ordinateur et connectez-vous à votre compte en ligne. Le navigateur affiche alors un code. Collez-le si l'assistant le demande, à l'invite Paste code here if prompted (« collez le code ici si on vous le demande »). Le terminal annonce Login successful.
Pour vérifier la connexion, quittez l'assistant avec /exit (il ferme l'assistant seulement, alors que exit ferme la session du compte) et interrogez l'outil. Il affiche quelques lignes de réglages : cherchez la ligne loggedIn, qui doit finir par true. Cette commande n'est utile que si vous doutez de votre connexion. Avec false, voyez « Si ça échoue ».
claude auth statusRelancez claude --permission-mode manual dans ~/travail, puis posez une première question sans danger : « Quelle version de Debian tourne ici et combien d'espace disque reste-t-il ? » S'il veut lancer une commande, il doit demander la permission : vous la lisez, puis vous acceptez ou vous refusez. S'il ne demande rien, voyez « Si ça échoue ». Voyons pourquoi cette permission compte.
Ce qu'il peut exécuter, et comment le cadrer
L'assistant peut lancer n'importe quelle commande permise au compte Linux assistant. Le mode de permission règle ce qu'il fait sans vous demander. Retenez celui-ci :
manual: il lit seul, mais demande avant de modifier ou d'exécuter. C'est le mode du lancement de l'étape 4, et le bon pour débuter.
La documentation en décrit d'autres, comme acceptEdits (il modifie les fichiers sans demander) ou auto, qui laissent l'assistant agir de plus en plus librement. Gardez-les pour plus tard ; le plus risqué, bypassPermissions, supprime tout garde-fou. Il se réserve aux conteneurs, c'est-à-dire des mini-machines jetables, isolées du reste de la vôtre.
Quatre habitudes complètent ce réglage :
- Pas de sudo pour ce compte Linux. Quand une commande demande les droits d'administrateur, vous la lancez vous-même en alice, après l'avoir lue.
- Pas de secrets à portée. Il lit tout ce que son compte lit (ses propres dossiers, mais aussi la plupart des réglages dans
/etc), et ce qu'il lit part vers le service en ligne. Gardez mots de passe et clés hors de~/travail, par exemple dans le dossier d'alice. - Pas de contenu inconnu collé tel quel. Un texte piégé peut tenter de lui donner des ordres, ce qu'on appelle une injection de prompt. Relisez ce que vous lui donnez à lire.
- Pas de mode sans garde-fou. L'éditeur le réserve aux conteneurs, et l'outil refuse de le lancer en root, l'administrateur.
Avec un compte Linux limité et le mode manuel, l'assistant ne peut modifier que ce que son compte touche. La sauvegarde, elle, ne limite rien : elle vous permet de revenir en arrière. Il peut en revanche lire ce que son compte lit, et cela part chez l'éditeur. Si vous préférez que rien ne parte chez un tiers, il faut regarder l'autre voie.
L'alternative : un modèle local
Un modèle local garde vos données sur le serveur, mais il demande plus de matériel et répond moins bien qu'un grand service en ligne. Le tableau compare les deux voies.
| Critère | Assistant en ligne | Modèle local |
|---|---|---|
| Où il réfléchit | Chez l'éditeur | Sur votre serveur |
| Ce qui quitte le serveur | Ce qu'il lit et vos questions | Rien |
| Matériel | 4 Go de RAM au minimum | Assez de mémoire disponible pour loger le modèle, plus de la marge |
| Coût | Un compte en ligne payant | Le matériel et l'électricité |
| Agir sur le serveur | Il propose et lance des commandes | Il répond à vos questions, sans agir |
Ollama est un programme qui télécharge et fait tourner un modèle local. Vous pouvez l'utiliser à la place de Claude Code, ou en plus : c'est un assistant qui répond à vos questions sans toucher au serveur. On l'installe et on le lance depuis alice, car son installation demande sudo, que le compte assistant n'a pas. Ce qui décide : la mémoire du serveur doit avoir assez de place libre pour contenir le modèle, tant qu'il tourne. Le nom llama3.2:1b désigne un petit modèle (1b : un milliard de réglages internes), qui pèse 1,3 Go à télécharger. Le modèle travaille en mémoire avec des données en plus de son poids : prévoyez au moins le double de 1,3 Go, soit 2,6 Go ici. Lisez la colonne available de cette commande : c'est la mémoire que les programmes peuvent encore obtenir.
free -h total used free shared buff/cache available
Mem: 62Gi 11Gi 1.8Gi 753Mi 51Gi 51Gi
Swap: 8.0Gi 136Mi 7.9GiL'installation et un premier essai tiennent en cinq commandes :
apt installajoutezstd, dont l'installateur a besoin pour décompresser.curltélécharge le script d'Ollama dans un fichier, sans l'exécuter.lessl'ouvre : flèches pour défiler,qpour quitter. Vous y verrez des téléchargements depuis ollama.com ; si le texte parle d'autres sites, arrêtez-vous.shl'exécute (ce script est écrit poursh, à la différence de celui de l'étape 3). Il peut demander votre mot de passe sudo en cours de route.ollama runtélécharge le modèle, patientez, et ouvre une conversation en texte ;/byeen sort.
sudo apt install -y zstd
curl -fsSL https://ollama.com/install.sh -o install.sh
less install.sh
sh install.sh
ollama run llama3.2:1bCarte graphique et mémoire du modèle
Une carte graphique (GPU) calcule bien plus vite que le processeur. Ollama s'en sert avec une carte NVIDIA compatible et un pilote en version 550 ou plus (le programme de NVIDIA qui fait parler le système à la carte). Sans carte, il utilise le processeur, plus lentement. Une fois le modèle chargé, la commande ollama ps montre la mémoire qu'il occupe.
Si ça échoue
Quatre situations reviennent :
claude: command not found. Vous n'avez pas rouvert le compte après l'installation, donc le terminal ne cherche pas encore dans~/.local/bin. Tapezexitpour revenir en alice, puis rouvrez le compte avecsudo -iu assistant. Sans le-i, un simplesudo -u assistantne lit pas le profil, le fichier de réglages que le terminal lit à la connexion, et reproduit l'erreur.Not logged in · Please run /login,loggedInàfalse, ou un code refusé. L'outil est installé mais pas connecté. Lancezclaude, tapez/loginet suivez l'adresse affichée. Si l'adresse ne s'ouvre pas ou si le code est refusé, relancez/loginpour en obtenir un neuf.curl: command not found. Le script d'installation ne se télécharge pas, donc rien ne s'installe. Faites-le dans cet ordre. Tapezexitpour revenir en alice. Installezcurlavecsudo apt install -y curl. Rouvrez le compte avecsudo -iu assistant. Reprenez enfin l'étape 3 au téléchargement deinstall.sh.- L'assistant exécute des commandes sans rien demander. Il n'est pas en mode manuel. Quittez-le avec
/exit, puis relancezclaude --permission-mode manual: l'option est écrite à la fin de la ligne de lancement.
La suite
Votre assistant vit désormais dans un compte Linux limité, et une copie de /etc est rangée chez alice. Il vous aide quand vous êtes devant l'écran, mais il ne vous prévient de rien quand vous dormez. L'article suivant, Supervision simple, installe la surveillance qui vous alerte quand le serveur va mal.