Exécuter dsh en service systemd sur un VPS
Apprenez à configurer dsh en mode headless avec systemd pour éviter l'arrêt du processus après votre déconnexion SSH. Gérez les logs via journalctl et sécurisez l'accès.
Exécuter dsh en mode headless sur un VPS, hors d'un terminal
Exécuter dsh en mode headless sur un VPS nécessite un fichier d'unité systemd et un utilisateur dédié pour le gérer. dsh est le lanceur en ligne de commande de DeepSeek Harness, l'environnement d'exécution d'agents de DeepSeek, publié sous licence MIT en version developer preview en août 2026. Un harness est le programme entourant le modèle plutôt que le modèle lui-même ; ce que vous placez sous systemd est donc la boucle, les outils et les permissions, et non l'inférence de DeepSeek. Le guide de démarrage rapide vous indique de taper npx @deepseek-ai/dsh web, ce qui est correct, mais ce processus s'arrête dès que vous fermez votre session SSH (secure shell).
Un fichier d'unité règle quatre problèmes simultanément. Le service redémarre automatiquement après un reboot. Sa sortie est envoyée vers le journal au lieu de défiler sous vos yeux. Il s'exécute avec un compte qui n'est pas root. Enfin, la version utilisée est celle que vous avez choisie, ce qui est ici plus important que d'habitude, car le projet amont le précise en majuscules :
DeepSeek Harness est actuellement en developer preview et évolue rapidement. IL Y AURA DES CHANGEMENTS INCOMPATIBLES AVEC LES VERSIONS PRÉCÉDENTES.
Ce guide suppose que dsh fonctionne déjà manuellement pour vous. Si ce n'est pas le cas, commencez par installer DeepSeek Harness sur un VPS et revenez une fois que npx @deepseek-ai/dsh web affiche une page.
Node d'abord, car les avertissements npm ne suffisent pas
node -vLe paquet natif d'Ubuntu 24.04 est Node 18 (18.19.1 en août 2026), ce qui est ancien pour un paquet publié cette année. npm vérifie lui-même les versions de Node : sa documentation indique que le champ engines d'un paquet "ne produira que des avertissements" à moins d'activer engine-strict. Les manifestes @deepseek-ai/dsh publiés ne contiennent aucun champ engines (vérifié le 27 octobre 2026 pour 0.1.0-rc.7, 0.2.1-rc.2 et 0.2.1-rc.4), bien que le dépôt en déclare un, mais npm vérifie également les exigences de moteur des dépendances. La version 0.2.1-rc.2 épinglée déclare commander: ^15.0.0, et Commander 15 nécessite Node >=22.12.0, donc l'installation sur le Node 18 d'Ubuntu produit un avertissement EBADENGINE avec les paramètres npm par défaut. Cet avertissement n'interrompt pas l'installation par défaut, vérifiez donc Node avant d'atteindre une erreur à l'exécution.
Le seuil minimal du dépôt a également évolué. La source 0.2.1-rc.2 accepte ^22.19.0 || >=24.0.0, mais le paquet CLI sur la branche master déclare désormais >=24.9.0, ce que Node 22 ne satisfait pas. Installez Node 24 depuis NodeSource. Il s'agit d'une version de support à long terme (LTS), en maintenance depuis le 20 octobre 2026, et ses builds actuels respectent les deux plages. Node 26 est devenu LTS le 28 octobre 2026, selon le calendrier des versions de Node.js.
curl -fsSL https://deb.nodesource.com/setup_24.x -o /tmp/nodesource_setup.sh
less /tmp/nodesource_setup.sh
sudo -E bash /tmp/nodesource_setup.sh
sudo apt install -y nodejs
node -vnode -v doit maintenant afficher une version v24, 24.9.0 ou plus récente. La ligne less est présente car rediriger un script distant directement dans bash exécute du code que vous n'avez jamais lu.
Vérifiez le fonctionnement avant de rédiger une unité
npx @deepseek-ai/dsh@0.2.1-rc.2 webLaissez ce processus tourner. Depuis une seconde session SSH :
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/Tout code d'état HTTP signifie que le profil web écoute sur le loopback, là où il se lie par défaut. Attendez-vous à un 401 et considérez cela comme un succès : l'interface authentifie les navigateurs avec un jeton de lancement présent dans l'URL affichée, qu'elle échange contre un cookie de session signé ; une requête ne contenant ni l'un ni l'autre reçoit un 401. 000 accompagné de curl: (7) Failed to connect to 127.0.0.1 port 3080 signifie qu'il n'écoute pas, et le premier terminal vous en indique la raison. Arrêtez l'exécution manuelle avec Ctrl+C avant d'aller plus loin : une unité qui tente de lier un port déjà occupé par un autre processus échouera avec Error: listen EADDRINUSE: address already in use 127.0.0.1:3080.
0.1.0-rc.7 était la version publiée le 18 août 2026, et elle est antérieure à l'authentification par navigateur sur laquelle ce guide s'appuie : son fichier README de connexion indique que la protection est une politique d'accessibilité et que "le support Web ne fournit aucune couche d'authentification". Le 11 octobre 2026, le tag latest pointait vers 0.2.0-rc.2. Le 27 octobre 2026, latest pointait vers 0.2.1-rc.2 et next vers 0.2.1-rc.4, les commandes ici fixent donc 0.2.1-rc.2. Le 4 novembre 2026, la liste des versions npm montre à la fois latest et next à 0.2.1-rc.5 ; les commandes ici conservent le verrouillage actuel. Vérifiez quelle est la version actuelle avec npm view @deepseek-ai/dsh version, puis fixez celle que vous décidez d'exécuter.
Installer la version épinglée, globalement
npx est l'outil inadapté à l'intérieur d'un fichier d'unité. Sans version spécifiée ou installation locale correspondante, il résout la version du paquet au démarrage du processus. Ainsi, un redémarrage dans trois mois peut déployer une version différente d'un agent en phase de prévisualisation, sans aucune intervention de votre part. L'absence de paquets ou de données de cache nécessite également le registre npm ; un registre lent peut donc retarder ou faire échouer le démarrage. npm prend aussi en charge l'exécution en cache et hors ligne. Installez une seule fois, avec une version que vous avez notée :
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dshcommand -v dsh affiche /usr/bin/dsh lorsque npm provient de NodeSource, et /usr/local/bin/dsh lorsqu'il provient du paquet natif d'Ubuntu. Utilisez le chemin affiché dans le fichier d'unité. npm ls -g affiche la version exacte, ce qui est la réponse dont vous aurez besoin dans six semaines si le comportement change et que vous ne vous souvenez plus de ce que vous avez installé. Si l'installation échoue, si command -v dsh n'affiche rien, ou si la version obtenue n'est pas celle demandée, traitez les échecs habituels d'installation et de version dsh avant de rédiger le fichier d'unité.
Un utilisateur propriétaire du service et rien d'autre
L'agent exécute des commandes shell. C'est sa fonction. L'exécuter en tant que root transforme chaque appel d'outil en un appel root. Créez donc un compte dédié sans shell de connexion.
sudo useradd --system --create-home --home-dir /var/lib/dsh --shell /usr/sbin/nologin dsh
sudo install -d -o dsh -g dsh -m 750 /var/lib/dsh/harness /var/lib/dsh/workspace
id dsh/var/lib/dsh/harness devient DSH_HOME, le répertoire où dsh conserve les profils. Un profil est une pile nommée de bundles de plugins avec votre propre couche de correctifs par-dessus. Les profils web et headless se construisent eux-mêmes à partir des modèles fournis lors du premier démarrage. Tout ce que vous ajoutez à cette pile par la suite s'exécute avec cet utilisateur, en utilisant ses propres accès aux fichiers et au shell. Par conséquent, vérifier un plugin avant de l'installer fait partie intégrante de la création du compte. Ce premier démarrage écrit des fichiers et peut récupérer des bundles ; effectuez-le donc manuellement pour pouvoir le surveiller.
sudo -u dsh env HOME=/var/lib/dsh DSH_HOME=/var/lib/dsh/harness /usr/bin/dsh --profile webDéfinissez HOME explicitement plutôt que de vous fier à la gestion par sudo. La manière dont sudo préserve ou réécrit HOME dépend de paramètres incluant env_reset, env_keep et always_set_home dans /etc/sudoers. En cas d'erreur, la première exécution tentera d'utiliser votre répertoire personnel pour les caches et l'état, ce qui provoquera des erreurs de permission ou placera les données à un emplacement que le service n'utilisera pas par la suite. Interrompez le processus avec Ctrl+C une fois que la vérification curl affiche un code de statut.
Le fichier d'unité
Écrivez /etc/systemd/system/dsh.service :
[Unit]
Description=DeepSeek Harness (dsh) web profile
Documentation=https://github.com/deepseek-ai/deepseek-harness
After=network-online.target
Wants=network-online.target
StartLimitIntervalSec=300
StartLimitBurst=5
[Service]
Type=exec
User=dsh
Group=dsh
WorkingDirectory=/var/lib/dsh/workspace
Environment=HOME=/var/lib/dsh
Environment=DSH_HOME=/var/lib/dsh/harness
ExecStart=/usr/bin/dsh --profile web
Restart=on-failure
RestartSec=5s
TimeoutStopSec=30s
SyslogIdentifier=dsh
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=full
ProtectHome=true
[Install]
WantedBy=multi-user.targetExecStart= prend le chemin absolu que vous avez obtenu avec command -v dsh. systemd recherche un nom de commande simple dans une liste de chemins fixe, mais cette liste n'est pas le PATH de votre shell ; un chemin absolu évite donc toute incertitude.
WorkingDirectory= est l'endroit où les chemins relatifs sont résolus, et c'est là qu'un appel d'outil qui exécute ls sans argument démarre. Pointez-le vers l'espace de travail que vous fournissez à l'agent. Si le répertoire est absent ou si l'utilisateur du service ne peut pas y accéder, l'unité échoue avec status=200/CHDIR avant même que dsh ne s'exécute.
ProtectHome=true masque /home et /root au processus. C'est sécurisé ici car tout ce que le service manipule se trouve sous /var/lib/dsh. Pointez l'espace de travail vers un chemin sous /home et l'agent signalera que le répertoire n'existe pas, ce qui est déroutant tant que vous ne vous souvenez pas de cette ligne. ProtectSystem=full rend /usr, /boot et /etc en lecture seule, ce dont le service n'a jamais besoin pour écrire.
Aller plus loin est tentant et généralement une erreur. ProtectSystem=strict rend tout le système de fichiers en lecture seule, à l'exception des pseudo-systèmes de fichiers du noyau et, avec les PrivateTmp=true, /tmp et /var/tmp de cette unité, les écritures dans l'espace de travail échouent donc avec EROFS: read-only file system. Si vous souhaitez ce niveau de sécurité, ajoutez ReadWritePaths=/var/lib/dsh dans la même modification.
Quel Type= utiliser ici
Type=exec, car dsh reste au premier plan et ne fait jamais de fork. L'avantage par rapport au comportement par défaut est d'obtenir un véritable message d'erreur. Avec Type=simple, systemd considère le démarrage comme réussi dès que le fork est effectué, avant même de savoir si le binaire existe. Ainsi, systemctl start dsh renvoie un succès immédiat et l'échec n'apparaît que dans le journal. Avec Type=exec, systemd attend que execve() réussisse. Une faute de frappe dans ExecStart= fait donc échouer la commande que vous venez de saisir, ce qui vous permet de la voir immédiatement.
Les deux autres options provoquent un blocage. Type=forking demande à systemd d'attendre la fin du processus parent, or dsh ne se termine jamais. Le démarrage reste donc bloqué jusqu'à l'expiration du délai TimeoutStartSec (90 secondes par défaut), renvoyant alors une erreur Job for dsh.service failed because a timeout was exceeded.. Type=notify attend un message READY=1 via sd_notify ; un processus Node qui n'en envoie jamais provoquera le même blocage. La comparaison complète des types de service systemd détaille le reste, y compris les cas où la configuration de notify justifie l'effort.
Règles de redémarrage qui échouent bruyamment
Restart=on-failure redémarre sur un code de sortie non nul ou un signal anormal, et laisse l'unité tranquille après une sortie propre ; systemd traite SIGHUP, SIGINT, SIGTERM et SIGPIPE comme des signaux propres pour ce type de service. C'est le comportement souhaité pour une version de prévisualisation. Si dsh sort avec un code 0 parce qu'il a lu une configuration qu'il n'apprécie pas, l'unité s'arrête et reste arrêtée, et systemctl status dsh affiche inactive (dead) où vous pouvez le constater. Restart=always transforme ce même événement en une boucle de redémarrage qui semble saine vue de loin.
La limite de débit est l'élément que les gens oublient. Les valeurs par défaut de systemd sont cinq démarrages en dix secondes, et avec RestartSec=5s vous n'atteignez jamais cinq démarrages dans une fenêtre de dix secondes, donc une unité qui plante au démarrage redémarre indéfiniment et seul le journal est au courant. StartLimitIntervalSec=300 avec StartLimitBurst=5 autorise cinq démarrages en cinq minutes, puis refuse tout nouveau démarrage dans cet intervalle. systemd abandonne et place l'unité dans l'état failed, en consignant Start request repeated too quickly.. Effacez cet état avec sudo systemctl reset-failed dsh une fois que vous avez corrigé la cause. Les deux paramètres doivent figurer dans [Unit], et non dans [Service] ; les options non reconnues produisent des journaux d'avertissement au lieu d'être ignorées silencieusement.
Démarrez-le, puis vérifiez-le
sudo systemctl daemon-reload
sudo systemctl enable --now dsh
systemctl status dshenable --now effectue deux tâches. enable est ce qui permet au service de revenir après un redémarrage, et --now le démarre pour la session actuelle. Un simple systemctl start disparaît après le prochain redémarrage, et les mises à jour du noyau impliquent des redémarrages.
systemctl status dsh doit afficher Active: active (running), un Main PID, et une ligne Memory:. Confirmez ensuite sur quel port il écoute :
sudo ss -lntp | grep 3080Vous devez obtenir 127.0.0.1:3080. Si vous voyez une autre adresse, un flag --host a déplacé l'écouteur sur le réseau auquel appartient cette adresse, diffusant du HTTP en clair à moins que le TLS ne soit configuré. Le nom du processus dans cette sortie est node, et non dsh, car le binaire dsh est un script Node, donc pgrep -x dsh ne trouve rien. Utilisez systemctl show -p MainPID dsh à la place.
Redémarrez ensuite une fois. Un service qui n'a jamais survécu à un redémarrage n'est pas encore un service.
sudo rebootReconnectez-vous et exécutez systemctl is-active dsh. Il affiche active.
Lecture des journaux avec journalctl
Tout ce que dsh écrit vers stdout et stderr est consigné dans le journal sous le nom de l'unité.
journalctl -u dsh -f
journalctl -u dsh -n 200 --no-pager
journalctl -u dsh --since "10 min ago" -p err-f suit les nouvelles lignes, -n affiche les N dernières, -p err filtre par priorité. SyslogIdentifier=dsh dans l'unité explique pourquoi ces lignes sont marquées dsh plutôt que node, ce qui est important lors de la première lecture d'une sortie de journal non filtrée par unité.
Vérifiez que le journal survit aux redémarrages avant d'en avoir besoin :
journalctl -u dsh -b -1Si cela affiche Specifying boot ID or boot offset has no effect, no persistent journal was found, le journal réside dans /run et chaque redémarrage le supprime. Avec Storage=auto, créez le répertoire et redémarrez le démon ; si Storage=volatile est configuré, modifiez-le d'abord en persistent :
sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journaldExécutez sudo journalctl --flush pour passer au stockage persistant et vider les journaux du boot actuel sur le disque.
Accéder à l'interface utilisateur via un tunnel SSH, et non via un port public
Par défaut, dsh sert l'interface utilisateur (UI) sur 127.0.0.1:3080. Le loopback est le choix par défaut, mais pas le seul : --host accepte une adresse IPv4 ou IPv6 concrète d'une interface locale. Toute adresse autre que le loopback sert le réseau auquel elle appartient via HTTP en clair, avec un avertissement au démarrage, sauf si vous passez également --tls-cert et --tls-key. Ce que dsh refuse, c'est un wildcard. Demandez --host 0.0.0.0 et l'erreur commence ainsi :
webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:Elle précise ensuite que « lier chaque interface exposerait l'exécution de code à distance au réseau » et vous conseille de « lier plutôt une adresse IPv4 ou IPv6 concrète d'une interface locale ». Une valeur qui n'est pas un littéral IP, comme un nom d'hôte, échoue avec is not a concrete IPv4 or IPv6 address literal.
Gardez le réglage par défaut. L'API web (interface de programmation d'application) pilote l'agent, et l'agent exécute des commandes shell. dsh place une authentification devant cette API : vérifications de Host et d'Origin, ainsi qu'un jeton de lancement dans l'URL affichée que l'UI échange contre un cookie de session signé. En HTTP clair, cependant, ce jeton circule sur le réseau en texte brut, et la documentation officielle indique que la vérification de Host ne protège pas le port d'écoute lui-même. Si vous avez besoin de l'UI sur un nom d'hôte réel, le guide de déploiement public de DeepSeek couvre un reverse proxy avec --public-url et --trusted-host, ou le TLS natif avec --tls-cert et --tls-key. Il est utile de lire ce que signifie réellement la ligne 127.0.0.1:3080 dans la sortie de démarrage avant de tenter de la modifier. Pour une machine que vous seul utilisez, transférez plutôt le port depuis votre propre machine :
ssh -N -L 3080:127.0.0.1:3080 you@203.0.113.10-L 3080:127.0.0.1:3080 ouvre le port 3080 sur votre ordinateur portable et envoie tout ce qui y arrive vers 127.0.0.1:3080 tel que résolu sur le VPS. -N signifie qu'aucune commande distante n'est exécutée, donc la session maintient uniquement le tunnel ouvert. Laissez-le tourner, trouvez l'URL que dsh a affichée au démarrage avec journalctl -u dsh -n 100 --no-pager, et ouvrez-la dans votre navigateur. Cette URL contient le jeton de lancement. Ouvrez l'URL http://127.0.0.1:3080/ brute dans un navigateur qui n'est pas connecté et vous obtiendrez une erreur 401. Le jeton appartient au processus en cours, mais le cookie de session qu'il permet d'obtenir lui survit : le cookie est signé avec une clé secrète que dsh conserve dans $DSH_HOME/.credentials.yaml et dure 30 jours par défaut. Un navigateur déjà connecté peut donc rouvrir l'URL brute, même après un redémarrage. Vous n'avez besoin d'une nouvelle URL du journal que pour un nouveau navigateur, ou une fois que ce cookie a expiré. Traitez l'URL comme une information d'identification : la documentation indique de ne la partager qu'avec les utilisateurs autorisés, et quiconque peut lire le journal système peut la lire. Une fois connecté, c'est là que vous saisissez la clé API DeepSeek, sous Settings puis Models, et où vous choisissez le répertoire de travail. Pointez le répertoire de travail vers /var/lib/dsh/workspace, le répertoire appartenant à l'utilisateur du service, sinon les outils de fichiers de l'agent échoueront avec EACCES: permission denied.
Si le port 3080 est occupé sur votre ordinateur portable, ssh vous l'indique :
bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080Choisissez un port local différent avec ssh -N -L 3081:127.0.0.1:3080 you@203.0.113.10, puis ouvrez l'URL affichée avec 3080 remplacé par 3081. Économisez la saisie dans ~/.ssh/config sur votre propre machine :
Host dsh-vps
HostName 203.0.113.10
User you
LocalForward 3080 127.0.0.1:3080Après cela, ssh -N dsh-vps est la commande complète. Ce tunnel est désormais la seule porte d'entrée vers votre agent, c'est donc le démon SSH qui le protège : clés uniquement, pas d'authentification par mot de passe, et le reste de la sécurisation SSH sur votre VPS s'applique avec plus de rigueur que d'habitude. Si ce VPS devient un petit réseau privé, avec une base de données ou une machine de staging derrière, annoncer ces adresses à votre tailnet avec un routeur de sous-réseau vous évite un transfert par service, bien qu'avec dsh sur son réglage par défaut (loopback), l'UI elle-même arrive toujours via un tunnel.
La clé n'a pas sa place dans le fichier d'unité. Les valeurs Environment= sont affichées par systemctl show dsh -p Environment, que n'importe quel utilisateur sur la machine peut exécuter. Si un plugin que vous installez nécessite une clé dans l'environnement, placez-la dans /etc/dsh.env avec le mode 600 appartenant à root et référencez-la avec EnvironmentFile=/etc/dsh.env. systemd lit ce fichier en tant que root au moment de l'exécution, et systemctl show n'en affiche pas le contenu. Quel fichier sur le disque reçoit chaque paramètre, et ce qui quitte votre machine lorsque vous pointez dsh vers un endpoint Ollama local au lieu de l'API de DeepSeek, fait l'objet de la configuration des clés, modèles et endpoints de dsh.
Coûts d'exécution
L'inférence s'effectue via l'API de DeepSeek, et non sur votre VPS. Votre machine supporte le processus Node, l'interface utilisateur qu'il sert et chaque commande que l'agent décide d'exécuter. Les deux premiers éléments sont stables et légers. Le troisième n'est limité par rien dans ce fichier d'unité.
Mesurez la consommation de base sur votre propre machine plutôt que de vous fier aux chiffres d'autrui :
systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2MemoryCurrent est exprimé en octets. Surveillez cette valeur pendant que l'agent travaille, et non lorsqu'il est inactif.
Les appels d'outils sont des processus enfants du service ; ils se trouvent donc dans le même groupe de contrôle et sont soumis aux mêmes limites. Un agent qui exécute npm install ou une suite de tests dans l'espace de travail peut consommer beaucoup plus de mémoire que le processus principal. Sur un VPS de 1 Go, c'est là que les problèmes surviennent : le noyau choisit un processus et le tue, et journalctl -k | grep -i "out of memory" affiche la ligne Out of memory: Killed process désignant la victime choisie. Ce processus n'est souvent pas celui qui a causé le problème.
La solution consiste à définir une limite volontaire. MemoryMax= et CPUQuota= dans la section [Service] maintiennent les dégâts à l'intérieur de l'unité. Ainsi, une compilation incontrôlée est tuée au lieu de bloquer toute la machine. Limiter la mémoire et le CPU avec systemd détaille les valeurs et le comportement en cas d'échec. L'espace disque augmente également, à cause de l'historique des sessions sous DSH_HOME et de tout ce que l'agent écrit dans l'espace de travail. Intégrez donc du -sh /var/lib/dsh à votre outil de surveillance disque habituel.
Si vous souhaitez un agent interactif auquel vous pouvez vous attacher et vous détacher, un service n'est pas la solution adaptée ; exécuter un agent dans une session tmux persistante est plus approprié. Exécutez dsh en tant qu'unité lorsque vous voulez qu'il soit toujours actif et accessible via un tunnel.
Modes de défaillance et messages associés
status=203/EXEC. systemd n'a pas pu exécuter le fichier, et les journaux indiquent Failed to locate executable /usr/local/bin/dsh: No such file or directory. Le chemin dans ExecStart= ne correspond pas à ce que command -v dsh a affiché. C'est l'erreur que Type=exec signale au moment de systemctl start au lieu de la masquer.
status=217/USER. systemd a échoué à déterminer ou à modifier les identifiants utilisateur depuis User= et Group=, ou à configurer le namespacing utilisateur. Pour cette unité, la cause habituelle est un compte inexistant. Vérifiez avec id dsh.
status=200/CHDIR. WorkingDirectory= est manquant, ou l'utilisateur du service ne peut pas y accéder. sudo -u dsh ls /var/lib/dsh/workspace le reproduit directement.
Error: listen EADDRINUSE: address already in use 127.0.0.1:3080. Un processus occupe déjà le port, généralement une exécution de npx restée ouverte dans un autre terminal. sudo ss -lntp | grep 3080 identifie le processus.
EACCES: permission denied suivi d'un chemin. Les droits d'accès sous /var/lib/dsh sont incorrects, normalement parce qu'une première exécution a eu lieu en tant que root ou avec le mauvais HOME. sudo chown -R dsh:dsh /var/lib/dsh corrige cela.
Start request repeated too quickly. L'unité a atteint la limite de taux de démarrage et a abandonné. L'erreur réelle se trouve dans les lignes précédentes. Exécutez sudo systemctl reset-failed dsh avant de réessayer.
L'unité est active (running) mais le navigateur n'affiche rien. Effectuez la vérification sur le VPS : si curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ affiche un code de statut, le service répond bien sur le VPS, examinez donc ensuite la redirection de port. Ce code ne prouve pas que tout est chargé : l'upstream indique que les échecs de plugins optionnels n'empêchent pas l'état "ready", consultez donc journalctl -u dsh -n 200 --no-pager pour les erreurs de plugins également. Une erreur 401 dans le navigateur signifie qu'il n'a pas de cookie de session valide et que l'URL ne contenait aucun jeton de lancement valide, soit parce que vous avez ouvert l'URL brute, soit parce que le jeton date d'avant le dernier redémarrage. Ouvrez l'URL affichée par le processus actuel.
Mise à niveau volontaire
Le « pinning » signifie qu'une mise à niveau est une action que vous initiez, et non un événement subi. Lisez d'abord les notes de version, car les avertissements des développeurs sur les changements cassant la compatibilité sont la raison même de ce verrouillage. Sauvegardez le répertoire d'état, puis remplacez la version :
sudo systemctl stop dsh
sudo tar czf /root/dsh-home-$(date +%F).tgz -C /var/lib/dsh harness
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
sudo systemctl start dsh
journalctl -u dsh -n 50 --no-pagerLe retour en arrière (rollback) s'effectue de la même manière npm install -g avec l'ancienne version, en plus de la restauration de l'archive tar, ce qui ne fonctionne que si vous l'avez créée. Un agent en phase de prévisualisation est typiquement le genre de logiciel dont la mise à niveau peut modifier le format de configuration à votre insu.
FAQ
Pourquoi dsh s'arrête-t-il quand je ferme ma session SSH ?
Parce que npx @deepseek-ai/dsh web est un processus au premier plan appartenant à votre session de connexion ; il est donc terminé lorsque la session se ferme. Une unité systemd appartient au système init, c'est pourquoi elle continue de s'exécuter après votre déconnexion et redémarre après un reboot. sudo systemctl enable --now dsh est la paire de commandes qui vous permet d'obtenir les deux : enable pour le redémarrage, --now pour cette session.
Dois-je utiliser Type=simple ou Type=exec pour dsh ?
Type=exec. dsh s'exécute au premier plan et ne fait jamais de fork, donc les deux fonctionnent, mais Type=exec force systemd à attendre que execve() réussisse avant de considérer le démarrage comme effectif. Un chemin erroné dans ExecStart= fait alors échouer systemctl start avec status=203/EXEC sous vos yeux. Avec Type=simple, la même erreur renvoie un succès et se cache dans le journal. Type=forking et Type=notify sont tous deux inadaptés ici, et provoquent un blocage jusqu'à ce que TimeoutStartSec expire après 90 secondes par défaut.
Comment ouvrir l'interface web de dsh depuis mon ordinateur portable ?
Transférez le port via SSH : ssh -N -L 3080:127.0.0.1:3080 you@your-vps, puis ouvrez l'URL que dsh a affichée au démarrage, que vous pouvez retrouver avec journalctl -u dsh, dans votre navigateur. Cette URL contient le jeton de lancement, et un navigateur qui ne s'est pas connecté reçoit une erreur 401 sans celui-ci. Une fois connecté, le cookie de session dure 30 jours par défaut et survit à un redémarrage du service. Laissez le service sur sa valeur par défaut de loopback. dsh rejette un joker tel que --host 0.0.0.0 comme adresse non spécifiée, et bien qu'il accepte une adresse locale concrète, une liaison sur une interface autre que loopback diffuse du HTTP en clair à moins de configurer TLS, ce qui enverrait le jeton de lancement d'un agent exécutant des commandes shell sur le réseau en clair.
Puis-je exécuter dsh en tant que root pour simplifier les permissions ?
Non. L'outil est conçu pour exécuter des commandes et écrire des fichiers ; les privilèges du service sont donc ceux de l'agent. Créez un compte système avec useradd --system --shell /usr/sbin/nologin dsh, donnez-lui la propriété de /var/lib/dsh, et ajoutez NoNewPrivileges=true à l'unité. Si vous rencontrez EACCES: permission denied par la suite, la cause habituelle est une exécution précédente en tant que root ayant laissé des fichiers appartenant à root, et sudo chown -R dsh:dsh /var/lib/dsh permet de nettoyer cela.
Quelle version de dsh dois-je fixer dans l'unité ?
Celle que npm view @deepseek-ai/dsh version indique lorsque vous configurez le service, installée avec npm install -g @deepseek-ai/dsh@<that version> et notée à un endroit où vous pourrez la retrouver. 0.1.0-rc.7 était la version actuelle le 18 août 2026, 0.2.0-rc.2 le 11 octobre 2026, et 0.2.1-rc.2 le 27 octobre 2026, avec next déjà à 0.2.1-rc.4. Le 4 novembre 2026, latest et next pointent tous deux vers 0.2.1-rc.5. Les builds aussi anciens que 0.1.0-rc.7 ne disposent pas de l'authentification par navigateur, ne fixez donc pas l'une d'entre elles pour le profil web. L'important n'est pas le numéro, mais le fait que npx sans version résout le paquet au moment du démarrage ; un redémarrage automatique peut donc vous faire passer silencieusement sur une version avec un format de configuration différent.