SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor · Aktualisiert 2026-11-06

dsh auf VPS mit systemd ohne Terminal ausführen

dsh als systemd-Dienst auf einem VPS einrichten: eigener Benutzer, feste Version, Restart-Regeln, journalctl-Logs und SSH-Tunnel zur Weboberfläche.

dsh ohne Terminal auf einem VPS ausführen

dsh ohne Terminal auf einem VPS auszuführen, erfordert eine systemd-Unit-Datei und einen eigenen Benutzer, dem sie gehört. dsh ist der Befehlszeilenstarter für DeepSeek Harness, die Agent-Laufzeitumgebung von DeepSeek, die im August 2026 unter der MIT-Lizenz als Entwicklervorschau veröffentlicht wurde. Ein Harness ist das Programm um das Modell herum und nicht das Modell selbst. Unter systemd legen Sie daher die Schleife, die Tools und die Berechtigungen ab, nicht die Inferenz von DeepSeek. Die Schnellstartanleitung fordert Sie auf, npx @deepseek-ai/dsh web einzugeben. Das ist korrekt. Der Prozess wird jedoch beendet, sobald Sie Ihre SSH-Sitzung (Secure Shell) schließen.

Eine Unit-Datei löst vier Probleme gleichzeitig. Der Dienst wird nach einem Reboot wieder gestartet. Seine Ausgabe wird in das Journal geschrieben, statt an Ihnen vorbeizuscrollen. Er läuft unter einem Benutzerkonto, das nicht root ist. Außerdem läuft genau die von Ihnen ausgewählte Version. Das ist hier besonders wichtig, weil der Upstream ausdrücklich darauf hinweist:

DeepSeek Harness befindet sich derzeit in der Entwicklervorschau und wird schnell weiterentwickelt. ES WIRD ZU INKOMPATIBLEN ÄNDERUNGEN KOMMEN.

Diese Anleitung setzt voraus, dass dsh bei Ihnen bereits manuell funktioniert. Falls nicht, beginnen Sie mit der Installation von DeepSeek Harness auf einem VPS und fahren Sie fort, sobald npx @deepseek-ai/dsh web eine Seite bereitstellt.

Zuerst Node, denn npm-Warnungen reichen nicht aus

node -v

Das Ubuntu-24.04-Paket enthält Node 18 (Stand August 2026: 18.19.1). Für ein in diesem Jahr veröffentlichtes Paket ist das veraltet. npm prüft Node-Versionen selbst: In der Dokumentation steht, dass das engines-Feld eines Pakets nur Warnungen ausgibt, sofern Sie engine-strict nicht aktivieren. Die veröffentlichten @deepseek-ai/dsh-Manifeste enthalten überhaupt kein engines-Feld (am 27. Oktober 2026 für 0.1.0-rc.7, 0.2.1-rc.2 und 0.2.1-rc.4 geprüft), obwohl das Repository eines definiert. npm prüft jedoch auch die Engine-Anforderungen von Abhängigkeiten. Die festgelegte 0.2.1-rc.2-Version definiert commander: ^15.0.0, und Commander 15 erfordert Node >=22.12.0. Eine Installation unter Ubuntu mit Node 18 erzeugt daher bei den normalen npm-Einstellungen eine EBADENGINE-Warnung. Diese Warnung bricht die Installation standardmäßig nicht ab. Prüfen Sie Node daher, bevor ein Laufzeitfehler auftritt.

Die Mindestversion des Repositorys wurde ebenfalls angehoben. Der 0.2.1-rc.2-Quellcode akzeptiert ^22.19.0 || >=24.0.0. Das CLI-Paket im master-Branch definiert inzwischen jedoch >=24.9.0, was Node 22 nicht erfüllt. Installieren Sie Node 24 aus NodeSource. Diese Version gehört zur Long-Term-Support-Linie (LTS), befindet sich seit dem 20. Oktober 2026 in der Wartungsphase, und die aktuellen Builds erfüllen beide Bereiche. Node 26 wurde laut Node.js-Releaseplan am 28. Oktober 2026 zu LTS.

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 -v

node -v sollte jetzt eine v24-Version ausgeben, also 24.9.0 oder höher. Die less-Zeile ist enthalten, weil das direkte Weiterleiten eines Remoteskripts an bash Code ausführt, den Sie nicht gelesen haben.

Prüfen Sie den Betrieb, bevor Sie eine Unit schreiben

npx @deepseek-ai/dsh@0.2.1-rc.2 web

Lassen Sie den Prozess laufen. Öffnen Sie eine zweite SSH-Sitzung:

curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/

Jeder HTTP-Statuscode bedeutet, dass das Webprofil auf dem Loopback-Interface lauscht, an das es standardmäßig gebunden wird. Ein 401 ist zu erwarten und gilt als erfolgreicher Test: Die UI authentifiziert Browser mit einem Launch-Token in der ausgegebenen URL. Dieses wird gegen ein signiertes Sitzungscookie ausgetauscht. Eine Anfrage ohne beides erhält den Status 401. 000 zusammen mit curl: (7) Failed to connect to 127.0.0.1 port 3080 bedeutet, dass der Prozess nicht lauscht. Das erste Terminal zeigt den Grund. Beenden Sie den manuellen Lauf mit Ctrl+C, bevor Sie fortfahren: Eine Unit, die einen bereits belegten Port binden soll, schlägt mit Error: listen EADDRINUSE: address already in use 127.0.0.1:3080 fehl.

0.1.0-rc.7 war die am 18. August 2026 veröffentlichte Version. Sie stammt aus der Zeit vor der Browserauthentifizierung, auf die sich diese Anleitung stützt: Die Connection-README beschreibt die Sperre als Erreichbarkeitsrichtlinie und erklärt, dass „the Web carrier provides no authentication layer“. Am 11. Oktober 2026 verwies das Tag latest auf 0.2.0-rc.2. Am 27. Oktober 2026 verwies latest auf 0.2.1-rc.2 und next auf 0.2.1-rc.4. Daher legen die folgenden Befehle 0.2.1-rc.2 fest. Am 4. November 2026 zeigt die Versionsliste von npm sowohl latest als auch next mit 0.2.1-rc.5. Die folgenden Befehle behalten die vorhandene Festlegung bei. Prüfen Sie mit npm view @deepseek-ai/dsh version, welche Version aktuell ist, und legen Sie anschließend die von Ihnen verwendete Version fest.

Installieren Sie die festgelegte Version global

npx ist in einer Unit-Datei das falsche Werkzeug. Ohne Versionsangabe oder passende lokale Installation ermittelt es die Paketversion erst beim Start des Prozesses. Dadurch kann ein Neustart in drei Monaten einen anderen Build eines Preview-Agents starten, ohne dass Sie etwas geändert haben. Fehlende Pakete oder Cache-Daten erfordern ebenfalls Zugriff auf die npm-Registry. Eine langsame Registry kann den Start daher verzögern oder verhindern. npm unterstützt auch die Ausführung aus dem Cache und im Offline-Modus. Installieren Sie das Paket einmalig mit der dokumentierten Version:

sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dsh

command -v dsh gibt /usr/bin/dsh aus, wenn npm von NodeSource stammt, und /usr/local/bin/dsh, wenn es aus dem Ubuntu-eigenen Paket stammt. Verwenden Sie den tatsächlich ausgegebenen Pfad in der Unit-Datei. npm ls -g gibt die exakte Version aus. Diese Angabe benötigen Sie in sechs Wochen, wenn sich das Verhalten ändert und Sie sich nicht mehr erinnern, was Sie installiert haben. Wenn die Installation fehlschlägt, command -v dsh anschließend keine Ausgabe liefert oder die zurückgegebene Version nicht der angeforderten entspricht, arbeiten Sie die üblichen Fehler bei der Installation und Versionsprüfung von dsh durch, bevor Sie die Unit-Datei schreiben.

Ein Benutzer, dem der Dienst und nichts anderes gehört

Der Agent führt Shell-Befehle aus. Das ist seine Aufgabe. Wenn Sie ihn als root ausführen, wird jeder Tool-Aufruf mit root-Rechten ausgeführt. Richten Sie deshalb ein eigenes Konto ohne Login-Shell für ihn ein.

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 wird zu DSH_HOME, dem Verzeichnis, in dem dsh Profile speichert. Ein Profil ist ein benannter Stack aus Plugin-Bundles mit einer eigenen Patch-Ebene. Die Profile web und headless erstellen sich beim ersten Start anhand der mitgelieferten Templates selbst. Alles, was Sie diesem Stack später hinzufügen, wird als dieser Benutzer mit dem eigenen Datei- und Shell-Zugriff des Agenten ausgeführt. Deshalb gehört die Prüfung eines Plugins vor der Installation zur selben Aufgabe wie das Erstellen des Kontos. Beim ersten Start werden Dateien geschrieben und möglicherweise Bundles abgerufen. Führen Sie ihn daher manuell aus, damit Sie ihn beobachten können.

sudo -u dsh env HOME=/var/lib/dsh DSH_HOME=/var/lib/dsh/harness /usr/bin/dsh --profile web

Setzen Sie HOME explizit, statt darauf zu vertrauen, wie sudo damit umgeht. Ob sudo den Wert von HOME beibehält oder neu schreibt, hängt unter anderem von den Einstellungen env_reset, env_keep und always_set_home in /etc/sudoers ab. Bei einer falschen Einstellung versucht der erste Start, Ihr Home-Verzeichnis für Caches und Statusdaten zu verwenden. Das verursacht Berechtigungsfehler oder legt Statusdaten an einem Ort ab, den der Dienst später nicht verwendet. Beenden Sie den Vorgang mit Ctrl+C, sobald die curl-Prüfung einen Statuscode ausgibt.

Die Unit-Datei

Schreiben Sie /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.target

ExecStart= verwendet den absoluten Pfad, den Sie mit command -v dsh ermittelt haben. systemd durchsucht für einen einfachen Befehlsnamen eine feste Pfadliste. Diese Liste entspricht jedoch nicht der PATH Ihrer Shell. Ein absoluter Pfad verhindert daher, dass systemd den Pfad erraten muss.

WorkingDirectory= legt fest, wie relative Pfade aufgelöst werden. Außerdem starten dort Tool-Aufrufe, die ls ohne Argumente ausführen. Setzen Sie diesen Wert auf den Arbeitsbereich, den Sie dem Agenten übergeben. Fehlt das Verzeichnis oder kann der Dienstbenutzer es nicht betreten, schlägt die Unit mit status=200/CHDIR fehl, bevor dsh überhaupt ausgeführt wird.

ProtectHome=true verbirgt /home und /root vor dem Prozess. Das ist hier sicher, weil alles, worauf der Dienst zugreift, unter /var/lib/dsh liegt. Legen Sie den Arbeitsbereich unter einem Pfad unterhalb von /home an. Andernfalls meldet der Agent, dass das Verzeichnis nicht existiert. Das ist verwirrend, bis Sie sich an diese Zeile erinnern. ProtectSystem=full macht /usr, /boot und /etc schreibgeschützt. Der Dienst muss dort ohnehin nichts schreiben.

Eine weitergehende Absicherung ist verlockend, aber normalerweise falsch. ProtectSystem=strict macht das gesamte Dateisystem schreibgeschützt, abgesehen von den virtuellen Kernel-Dateisystemen und mit PrivateTmp=true, /tmp und /var/tmp. Dadurch schlagen Schreibzugriffe auf den Arbeitsbereich mit EROFS: read-only file system fehl. Wenn Sie diese Absicherung benötigen, fügen Sie bei derselben Bearbeitung ReadWritePaths=/var/lib/dsh hinzu.

Welches Type= gehört hierher?

Type=exec, weil dsh im Vordergrund bleibt und nie einen Fork ausführt. Das bietet gegenüber der Standardeinstellung eine echte Fehlermeldung. Bei Type=simple wertet systemd den Start als erfolgreich, sobald der Prozess einen Fork ausgeführt hat, bevor bekannt ist, ob die Binärdatei überhaupt existiert. Daher wird systemctl start dsh erfolgreich beendet, und der Fehler erscheint erst im Journal. Bei Type=exec wartet systemd, bis execve() erfolgreich beendet wurde. Ein Tippfehler in ExecStart= schlägt dadurch bei dem gerade eingegebenen Befehl fehl, sodass Sie ihn dort sehen.

Die beiden falschen Antworten führen beide zu einer Blockierung. Type=forking weist systemd an, auf das Beenden eines übergeordneten Prozesses zu warten. dsh wird jedoch nie beendet. Daher blockiert der Start, bis TimeoutStartSec abläuft (standardmäßig nach 90 Sekunden), und meldet dann Job for dsh.service failed because a timeout was exceeded.. Type=notify wartet über sd_notify auf eine READY=1-Nachricht. Ein Node-Prozess, der keine solche Nachricht sendet, führt daher ebenfalls zu einer entsprechenden Blockierung. Der vollständige Vergleich der systemd-Service-Typen behandelt die übrigen Fälle, einschließlich der Frage, wann sich die Einrichtung von notify lohnt.

Restart-Regeln, die Fehler deutlich anzeigen

Restart=on-failure wird bei einem Exit-Code ungleich 0 oder einem nicht sauberen Signal neu gestartet. Nach einem sauberen Exit bleibt die Unit beendet. systemd behandelt SIGHUP, SIGINT, SIGTERM und SIGPIPE für diesen Diensttyp als saubere Signale. Das ist das gewünschte Verhalten für einen Preview-Build. Falls dsh jemals mit 0 beendet wird, weil es eine Konfiguration eingelesen hat, die es nicht akzeptiert, stoppt die Unit und bleibt gestoppt. systemctl status dsh zeigt inactive (dead) an; dort können Sie den Grund sehen. Restart=always macht aus demselben Ereignis eine Neustartschleife, die aus der Entfernung wie ein gesunder Dienst wirkt.

Die Ratenbegrenzung wird häufig weggelassen. Die Standardwerte von systemd erlauben fünf Starts innerhalb von zehn Sekunden. Mit RestartSec=5s erreicht die Unit jedoch nie fünf Starts innerhalb eines Zeitfensters von zehn Sekunden. Eine Unit, die beim Start abstürzt, wird daher dauerhaft neu gestartet, und nur das Journal zeigt dies an. StartLimitIntervalSec=300 erlaubt zusammen mit StartLimitBurst=5 fünf Starts innerhalb von fünf Minuten. Danach verweigert systemd innerhalb dieses Zeitraums jeden weiteren Start. systemd gibt auf und setzt die Unit auf failed. Dabei wird Start request repeated too quickly. protokolliert. Setzen Sie diesen Zustand mit sudo systemctl reset-failed dsh zurück, sobald Sie die Ursache behoben haben. Beide Einstellungen gehören in [Unit], nicht in [Service]. Nicht erkannte Optionen erzeugen Warnmeldungen im Log, anstatt stillschweigend ignoriert zu werden.

Starten und überprüfen

sudo systemctl daemon-reload
sudo systemctl enable --now dsh
systemctl status dsh

enable --now erfüllt zwei Aufgaben. enable sorgt dafür, dass der Dienst nach einem Neustart wieder verfügbar ist, und --now startet ihn für die aktuelle Sitzung. Ein reiner systemctl start-Befehl geht nach dem nächsten Neustart verloren; Kernel-Updates erfordern solche Neustarts.

systemctl status dsh sollte eine Active: active (running)-, eine Main PID- und eine Memory:-Zeile anzeigen. Überprüfen Sie anschließend, auf welchem Port der Dienst lauscht:

sudo ss -lntp | grep 3080

Sie suchen nach 127.0.0.1:3080. Wenn Sie eine andere Adresse sehen, hat ein --host-Flag den Listener auf das entsprechende Netzwerk verschoben; dies liefert unverschlüsseltes HTTP, sofern kein TLS konfiguriert ist. Der Prozessname in dieser Ausgabe ist node, nicht dsh, da das dsh-Binary ein Node-Skript ist und pgrep -x dsh daher keine Ergebnisse liefert. Verwenden Sie stattdessen systemctl show -p MainPID dsh.

Führen Sie danach einen Neustart durch. Ein Dienst, der einen Neustart nicht übersteht, ist noch kein produktiver Dienst.

sudo reboot

Verbinden Sie sich erneut und führen Sie systemctl is-active dsh aus. Dies gibt active aus.

Protokolle mit journalctl lesen

Alles, was dsh in stdout und stderr schreibt, landet im Journal unter dem Namen der Unit.

journalctl -u dsh -f
journalctl -u dsh -n 200 --no-pager
journalctl -u dsh --since "10 min ago" -p err

-f folgt neuen Zeilen, -n zeigt die letzten N Einträge, -p err filtert nach Priorität. SyslogIdentifier=dsh in der Unit ist der Grund dafür, dass diese Zeilen mit dsh statt mit node gekennzeichnet sind. Das ist wichtig, wenn Sie erstmals eine nicht nach Unit gefilterte Journal-Ausgabe lesen.

Prüfen Sie, ob das Journal Neustarts übersteht, bevor Sie es benötigen:

journalctl -u dsh -b -1

Wenn dort Specifying boot ID or boot offset has no effect, no persistent journal was found ausgegeben wird, liegt das Journal in /run, und bei jedem Neustart wird es gelöscht. Mit Storage=auto erstellen Sie das Verzeichnis und starten den Daemon neu. Wenn Storage=volatile konfiguriert ist, ändern Sie den Wert zuerst in persistent:

sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journald

Führen Sie sudo journalctl --flush aus, um die persistente Speicherung zu aktivieren und die Logs des aktuellen Boots auf die Festplatte zu schreiben.

Die UI über einen SSH-Tunnel erreichen, statt über einen öffentlichen Port

dsh stellt die Web-UI (Benutzeroberfläche) standardmäßig auf 127.0.0.1:3080 bereit. Loopback ist die Voreinstellung, aber nicht die einzige Option: --host akzeptiert eine konkrete IPv4- oder IPv6-Adresse eines lokalen Interfaces. Jede Adresse außer Loopback stellt den Dienst über unverschlüsseltes HTTP im Netzwerk bereit, was beim Start mit einer Warnung quittiert wird, sofern Sie nicht zusätzlich --tls-cert und --tls-key übergeben. Was dsh verweigert, ist ein Wildcard-Bind. Fordern Sie --host 0.0.0.0 an, beginnt die Fehlermeldung wie folgt:

webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:

Dort wird weiter ausgeführt, dass das "Binden an alle Interfaces eine Remote Code Execution gegenüber dem Netzwerk exponieren würde", und man wird angewiesen, "stattdessen eine konkrete IPv4- oder IPv6-Adresse eines lokalen Interfaces zu binden". Ein Wert, der kein IP-Literal ist, wie etwa ein Hostname, führt stattdessen zu is not a concrete IPv4 or IPv6 address literal.

Behalten Sie die Standardeinstellung bei. Die Web-API (Programmierschnittstelle) steuert den Agenten, und der Agent führt Shell-Befehle aus. dsh schaltet zwar eine Authentifizierung vor diese API: Host- und Origin-Prüfungen sowie ein Launch-Token in der ausgegebenen URL, das die UI gegen ein signiertes Session-Cookie eintauscht. Über unverschlüsseltes HTTP wird dieses Token jedoch im Klartext übertragen, und die Dokumentation des Herstellers weist darauf hin, dass die Host-Prüfung den Listening-Port selbst nicht schützt. Wenn Sie die UI unter einem echten Hostnamen benötigen, beschreibt der Leitfaden für öffentliche Deployments von DeepSeek einen Reverse Proxy mit --public-url und --trusted-host oder natives TLS mit --tls-cert und --tls-key. Was die Zeile 127.0.0.1:3080 in der Startausgabe tatsächlich bedeutet zu lesen, ist ratsam, bevor Sie versuchen, diese zu ändern. Für einen Server, den nur Sie nutzen, leiten Sie den Port stattdessen von Ihrem eigenen Rechner weiter:

ssh -N -L 3080:127.0.0.1:3080 you@203.0.113.10

-L 3080:127.0.0.1:3080 öffnet Port 3080 auf Ihrem Laptop und leitet alles, was dort ankommt, an 127.0.0.1:3080 weiter, wie es auf dem VPS aufgelöst wird. -N bedeutet, dass kein Remote-Befehl ausgeführt wird; die Session hält also nur den Tunnel offen. Lassen Sie dies laufen, suchen Sie die URL, die dsh beim Start mit journalctl -u dsh -n 100 --no-pager ausgegeben hat, und öffnen Sie diese in Ihrem Browser. Diese URL enthält das Launch-Token. Öffnen Sie die nackte http://127.0.0.1:3080/ in einem Browser, der nicht angemeldet ist, erhalten Sie einen 401-Fehler. Das Token gehört zum laufenden Prozess, aber das Session-Cookie, das es erwirbt, überdauert diesen: Das Cookie ist mit einem Geheimnis signiert, das dsh in $DSH_HOME/.credentials.yaml speichert, und ist standardmäßig 30 Tage gültig. Ein Browser, der bereits angemeldet war, kann die nackte URL also auch nach einem Neustart wieder öffnen. Sie benötigen nur für einen neuen Browser oder nach Ablauf des Cookies eine frische URL aus dem Journal. Behandeln Sie die URL wie ein Passwort: Der Hersteller empfiehlt, sie nur mit autorisierten Benutzern zu teilen, und jeder, der das System-Journal lesen kann, kann auch die URL lesen. Sobald Sie eingeloggt sind, geben Sie dort unter Settings und Models den DeepSeek-API-Key ein und wählen das Arbeitsverzeichnis aus. Verweisen Sie das Arbeitsverzeichnis auf /var/lib/dsh/workspace, das Verzeichnis, das dem Dienstbenutzer gehört, sonst schlagen die Datei-Tools des Agenten mit EACCES: permission denied fehl.

Wenn Port 3080 auf Ihrem Laptop belegt ist, meldet ssh dies:

bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080

Wählen Sie einen anderen lokalen Port mit ssh -N -L 3081:127.0.0.1:3080 you@203.0.113.10 und öffnen Sie dann die ausgegebene URL, wobei Sie 3080 durch 3081 ersetzen. Sparen Sie sich die Tipparbeit in ~/.ssh/config auf Ihrem eigenen Rechner:

Host dsh-vps
  HostName 203.0.113.10
  User you
  LocalForward 3080 127.0.0.1:3080

Danach ist ssh -N dsh-vps der vollständige Befehl. Dieser Tunnel ist nun das einzige Tor zu Ihrem Agenten, daher schützt ihn der SSH-Daemon: nur Keys, keine Passwort-Authentifizierung, und der Rest von SSH auf Ihrem VPS absichern gilt hier noch dringender als üblich. Falls dieser VPS zu einem kleinen privaten Netzwerk heranwächst, mit einer Datenbank oder einem Staging-Server dahinter, erspart Ihnen diese Adressen mit einem Subnet-Router in Ihrem Tailnet bekannt zu machen eine Portweiterleitung pro Dienst, auch wenn die UI selbst bei der dsh-Standardeinstellung auf Loopback weiterhin über einen Tunnel erreicht wird.

Der Key gehört nicht in die Unit-Datei. Environment=-Werte werden von systemctl show dsh -p Environment ausgegeben, was jeder Benutzer auf dem System ausführen kann. Wenn ein Plugin, das Sie installieren, einen Key in der Umgebung benötigt, legen Sie ihn in /etc/dsh.env mit den Rechten 600 im Besitz von root ab und referenzieren Sie ihn mit EnvironmentFile=/etc/dsh.env. systemd liest diese Datei zur Laufzeit als root ein, und systemctl show gibt ihren Inhalt nicht aus. Welche Datei auf der Festplatte die jeweilige Einstellung tatsächlich enthält und was Ihren Server verlässt, wenn Sie dsh auf einen lokalen Ollama-Endpunkt statt auf die DeepSeek-API verweisen, ist Thema von dsh-Keys, Modelle und Endpunkte konfigurieren.

Kosten für den Betrieb

Die Inferenz findet über die API von DeepSeek statt, nicht auf Ihrem VPS. Ihr Server benötigt Ressourcen für den Node-Prozess, die von ihm bereitgestellte Benutzeroberfläche und jeden Befehl, den der Agent ausführt. Die ersten beiden Posten sind konstant und gering. Der dritte wird durch diese Unit-Datei nicht begrenzt.

Messen Sie die Grundlast auf Ihrem eigenen Server, statt einer Angabe von einem fremden System zu vertrauen:

systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2

MemoryCurrent wird in Bytes angegeben. Überwachen Sie den Wert, während der Agent arbeitet, nicht im Leerlauf.

Tool-Aufrufe sind untergeordnete Prozesse des Dienstes. Sie laufen daher in derselben Control Group und werden auf dieselben Limits angerechnet. Ein Agent, der npm install oder eine Testsuite im Workspace ausführt, kann deutlich mehr Speicher als der Harness selbst verwenden. Auf einem VPS mit 1 GB führt das zum Ausfall: Der Kernel wählt einen Prozess aus und beendet ihn. journalctl -k | grep -i "out of memory" zeigt die Zeile Out of memory: Killed process an, in der der ausgewählte Prozess genannt wird. Das ist häufig nicht der Prozess, der das Problem verursacht hat.

Die Lösung ist ein bewusst gesetztes Limit. MemoryMax= und CPUQuota= im Abschnitt [Service] halten die Auswirkungen auf die Unit begrenzt. Dadurch wird ein außer Kontrolle geratener Build beendet, statt den gesamten Server lahmzulegen. Speicher und CPU mit systemd begrenzen behandelt die Werte und das Fehlerverhalten. Auch der Speicherplatz wächst durch den Sitzungsverlauf unter DSH_HOME und durch alles, was der Agent in den Workspace schreibt. Überwachen Sie deshalb du -sh /var/lib/dsh mit dem Werkzeug, das Sie bereits zur Überwachung des Speicherplatzes verwenden.

Wenn Sie einen interaktiven Agenten benötigen, an den Sie sich an- und von dem Sie sich abmelden können, ist ein Dienst nicht die passende Form. Einen Agenten in einer dauerhaften tmux-Sitzung ausführen passt dafür besser. Führen Sie dsh als Unit aus, wenn der Dienst dauerhaft aktiv und über einen Tunnel erreichbar sein soll.

Fehlermodi und die zugehörigen Meldungen

status=203/EXEC. systemd konnte die Datei nicht ausführen, siehe Protokolle Failed to locate executable /usr/local/bin/dsh: No such file or directory. Der Pfad in ExecStart= stimmt nicht mit der Ausgabe von command -v dsh überein. Dies ist der Fehler, den Type=exec zum Zeitpunkt systemctl start meldet, anstatt ihn zu verbergen.

status=217/USER. systemd konnte die Benutzeranmeldeinformationen aus User= und Group= nicht ermitteln oder ändern, oder das User-Namespacing nicht einrichten. Die übliche Ursache für diese Unit ist ein nicht existierendes Konto. Überprüfen Sie dies mit id dsh.

status=200/CHDIR. WorkingDirectory= fehlt, oder der Dienstbenutzer kann nicht darauf zugreifen. sudo -u dsh ls /var/lib/dsh/workspace reproduziert dies direkt.

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080. Ein anderer Prozess belegt bereits den Port, meist ein in einem anderen Terminal offengebliebener npx-Prozess. sudo ss -lntp | grep 3080 nennt den Prozess.

EACCES: permission denied gefolgt von einem Pfad. Die Eigentumsverhältnisse unter /var/lib/dsh sind falsch, normalerweise weil ein erster Start als root oder mit der falschen HOME erfolgte. sudo chown -R dsh:dsh /var/lib/dsh korrigiert dies.

Start request repeated too quickly. Die Unit hat das Startratenlimit erreicht und abgebrochen. Der eigentliche Fehler steht in den Zeilen darüber. Führen Sie sudo systemctl reset-failed dsh aus, bevor Sie es erneut versuchen.

Die Unit ist active (running), aber der Browser zeigt nichts an. Führen Sie die Prüfung auf dem VPS durch: Wenn curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ dort einen Statuscode ausgibt, antwortet der Listener auf dem VPS; prüfen Sie daher als Nächstes die Portweiterleitung. Dieser Code beweist nicht, dass alles geladen wurde: Laut Upstream unterdrücken optionale Plugin-Fehler nicht die Bereitschaftsmeldung; lesen Sie daher auch journalctl -u dsh -n 200 --no-pager auf Plugin-Fehler. Ein 401 im Browser bedeutet, dass kein gültiges Sitzungs-Cookie vorhanden ist und die URL kein gültiges Start-Token enthielt – entweder weil Sie die nackte URL geöffnet haben oder weil das Token von vor dem letzten Neustart stammt. Öffnen Sie die URL, die der aktuelle Prozess ausgegeben hat.

Geplantes Upgrade

Durch Pinning wird ein Upgrade zu einem bewussten Vorgang, statt zu einem unvorhersehbaren Ereignis. Lesen Sie zuerst die Release Notes, da die Warnungen der Entwickler vor inkompatiblen Änderungen der eigentliche Grund für das Pinning sind. Erstellen Sie ein Backup des Verzeichnisses mit dem Programmzustand und tauschen Sie anschließend die Version aus:

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-pager

Ein Rollback erfolgt auf die gleiche Weise npm install -g mit der alten Version, zuzüglich der Wiederherstellung des Tarballs, was nur funktioniert, wenn Sie diesen zuvor erstellt haben. Eine Agent-Runtime im Preview-Stadium ist genau die Art von Software, bei der ein Upgrade das Konfigurationsformat im Hintergrund ändert.

FAQ

Warum beendet sich dsh, wenn ich meine SSH-Sitzung schließe?

Weil npx @deepseek-ai/dsh web ein Vordergrundprozess ist, der zu Ihrer Login-Sitzung gehört. Deshalb wird er beendet, sobald die Sitzung endet. Eine systemd-Unit gehört stattdessen zum Init-System. Deshalb läuft sie nach dem Trennen der Verbindung weiter und startet nach einem Reboot erneut. sudo systemctl enable --now dsh ist das Schrittpaar, das Ihnen beides bietet: enable für den Reboot und --now für diesen Boot.

Sollte ich für dsh Type=simple oder Type=exec verwenden?

Type=exec. dsh läuft im Vordergrund und führt niemals einen Fork aus. Daher funktionieren beide Varianten. Type=exec lässt systemd jedoch warten, bis execve() erfolgreich ausgeführt wurde, bevor der Start als erfolgreich gilt. Ein falscher Pfad in ExecStart= schlägt dann mit systemctl start und status=203/EXEC direkt vor Ihnen fehl. Mit Type=simple meldet derselbe Fehler einen erfolgreichen Start und bleibt im Journal verborgen. Type=forking und Type=notify sind hier beide falsch. Beide warten standardmäßig, bis TimeoutStartSec nach 90 Sekunden abläuft.

Wie öffne ich die dsh-Weboberfläche auf meinem Laptop?

Leiten Sie den Port über SSH weiter: ssh -N -L 3080:127.0.0.1:3080 you@your-vps. Öffnen Sie anschließend in Ihrem Browser die URL, die dsh beim Start ausgegeben hat. Sie finden sie mit journalctl -u dsh. Diese URL enthält das Starttoken. Ein Browser, der noch nicht angemeldet ist, erhält ohne dieses Token eine 401-Antwort. Nach der Anmeldung ist das Sitzungscookie standardmäßig 30 Tage gültig und bleibt bei einem Neustart des Dienstes erhalten. Lassen Sie den Dienst auf seiner standardmäßigen Loopback-Adresse. dsh weist einen Wildcard-Wert wie --host 0.0.0.0 als nicht angegebene Adresse zurück. Zwar akzeptiert dsh auch eine konkrete lokale Adresse, aber eine Bindung an eine Nicht-Loopback-Adresse stellt unverschlüsseltes HTTP bereit, sofern Sie kein TLS einrichten. Dadurch wird das Starttoken für einen Agenten, der Shell-Befehle über das Netzwerk ausführt, im Klartext übertragen.

Kann ich dsh als root ausführen, damit die Berechtigungen einfach bleiben?

Nein. Das Harness führt Befehle aus und schreibt Dateien. Daher verfügt der Agent über alle Berechtigungen, die der Dienst besitzt. Erstellen Sie mit useradd --system --shell /usr/sbin/nologin dsh ein Systemkonto, übertragen Sie mit diesem Konto den Besitz an /var/lib/dsh und fügen Sie NoNewPrivileges=true zur Unit hinzu. Wenn danach EACCES: permission denied auftritt, sind meist Dateien die Ursache, die ein früherer Lauf als root angelegt hat und die weiterhin root gehören. sudo chown -R dsh:dsh /var/lib/dsh bereinigt dieses Problem.

Welche dsh-Version sollte ich in der Unit festlegen?

Verwenden Sie die Version, die npm view @deepseek-ai/dsh version beim Einrichten des Dienstes meldet. Installieren Sie sie mit npm install -g @deepseek-ai/dsh@<that version> und dokumentieren Sie sie an einer Stelle, an der Sie sie wiederfinden. 0.1.0-rc.7 war am 18 August 2026 aktuell, 0.2.0-rc.2 am 11 October 2026 und 0.2.1-rc.2 am 27 October 2026. Zu diesem Zeitpunkt war next bereits bei 0.2.1-rc.4. Am 4 November 2026 verweisen sowohl latest als auch next auf 0.2.1-rc.5. Builds, die so alt wie 0.1.0-rc.7 sind, verfügen über keine Browserauthentifizierung. Legen Sie daher für das Webprofil keine dieser Versionen fest. Entscheidend ist nicht die Versionsnummer. Entscheidend ist, dass npx ohne Versionsangabe das Paket erst beim Start auflöst. Ein unbeaufsichtigter Neustart kann dadurch unbemerkt auf einen Build mit einem anderen Konfigurationsformat wechseln.

War dieser Artikel hilfreich?