SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor

dsh Web: Warum 127.0.0.1:3080 nicht erreichbar ist

dsh zeigt http://127.0.0.1:3080, weil die Web UI nur an localhost bindet. Erreichen Sie sie sicher per SSH-Tunnel und erfahren Sie, warum Port 3080 nicht öffentlich sein sollte.

Was dsh web: http://127.0.0.1:3080 bedeutet

Wenn Sie das DeepSeek Harness-Webprofil auf einem VPS starten, gibt es eine Zeile wie diese aus und wartet anschließend:

dsh web: http://127.0.0.1:3080/?token=...

127.0.0.1 ist die Loopback-Adresse. Das ist die Adresse, über die ein Rechner mit sich selbst kommuniziert. Ein Socket, der an 127.0.0.1 gebunden ist, akzeptiert Verbindungen von Prozessen auf demselben Rechner, aber von keinem anderen Rechner. Diese Zeile zeigt Ihnen daher gleichzeitig zwei Dinge: an welcher Adresse die Weboberfläche lauscht und wer sie erreichen darf. Das ist ausschließlich der Rechner, auf dem dsh läuft. Der Teil ?token= am Ende ist eine neue zufällige Zugangsinformation, die der Prozess bei jedem Start erzeugt. Mehr dazu weiter unten.

Deshalb bewirkt die URL nichts, wenn Sie sie im Browser auf Ihrem Laptop einfügen. Die 127.0.0.1 Ihres Laptops ist Ihr Laptop. Das Harness lauscht auf der 127.0.0.1 des VPS, also auf einem anderen Rechner mit einem anderen Loopback-Stack. Es ist nichts defekt. Sie müssen die Verbindung über eine Weiterleitung herstellen.

Die offizielle README beschreibt den Standard eindeutig: „Der Befehl startet die Weboberfläche standardmäßig unter http://127.0.0.1:3080 und öffnet sie bei einem lokalen Start im Standardbrowser.“ Bei einer SSH-Verbindung gibt es keinen Browser, der geöffnet werden kann. Daher müssen Sie die URL manuell verwenden. Die Bind-Adresse stammt aus dem Webserver-Host-Plugin @deepseek-ai/dsh-host-webserver. In der Version 0.2.0-rc.2, auf die diese Anleitung festgelegt ist, ist der Schlüssel host als „Listen-Host; die beiden unterstützten Werte sind loopback und all-interfaces“ dokumentiert. Standardmäßig wird Loopback verwendet, sofern Sie diese Einstellung nicht ändern. Wenn Ports für Sie neu sind, erklärt wie Ports unter Linux funktionieren das Modell aus Adresse und Port, auf dem dies alles basiert.

Warum die Weboberfläche nur an localhost gebunden ist

dsh ist ein Agent-Harness, also das Programm um das Modell herum: Es steuert die Schleife, die Tool-Aufrufe und die Berechtigungen, unter denen diese Aufrufe ausgeführt werden. Der Browser-Tab ist eine Steueroberfläche für einen Prozess, der Shell-Befehle ausführt, Dateien im von Ihnen ausgewählten Arbeitsverzeichnis liest und schreibt und Ihren Model-API-Key verwendet. Jeder, der diese Seite laden kann, kann all das als der Benutzer tun, unter dem dsh läuft. Der Netzwerkzugriff ist außerdem nicht der einzige Weg zu diesen Berechtigungen: Ein installiertes Plugin läuft im selben Prozess mit denselben Berechtigungen. Deshalb verdient die Prüfung eines dsh-Plugins vor der Installation dieselbe Sorgfalt wie die Entscheidung, auf welcher Adresse der Server lauscht.

Port 3080 ist also kein schreibgeschütztes Dashboard. Das Laden dieser Seite ermöglicht die Ausführung von Befehlen auf dem Server.

Öffnen Sie die ausgegebene URL. Sie gelangen direkt zur Sitzungsliste. Es gibt keine Anmeldeseite und keine Benutzerkonten. Die Seite wird durch das Token am Ende der URL geschützt: Die Root-Seite tauscht es gegen ein signiertes Sitzungs-Cookie aus und leitet dann auf eine bereinigte Adresse weiter. Danach erhält jeder RPC-Aufruf und jeder WebSocket-Stream der Weboberfläche ohne gültiges Cookie 401 Unauthorized. Allerdings ist nicht alles auf diesem Port geschützt. Die Dokumentation des Connection-Plugins erklärt, dass statische Ressourcen öffentlich bleiben. Außerdem verfügt der Webserver selbst über keine serverweite Authentifizierung und keine Origin-Richtlinie. Daher setzt jedes Plugin, das eine Route bereitstellt, seine eigenen Regeln durch. Auf diesen geschützten Routen antwortet das Connection-Plugin außerdem mit 403, wenn der Host-Header weder eine Loopback-Adresse noch einen Host enthält, dem Sie ausdrücklich vertraut haben. Auf Loopback ist das eine sinnvolle zweite Schutzschicht hinter der eigentlichen Zugriffskontrolle: Das Betriebssystem lässt nur lokale Prozesse durch. Das ist kein Grund, den Port zu veröffentlichen. Das Token steht im Scrollback Ihres Terminals und in jedem Log, das die Startausgabe erfasst hat. Die Anleitung des Projekts für einen Reverse Proxy erklärt ausdrücklich, dass weder die Host-Prüfung noch die beworbene URL den lauschenden Port selbst schützt. Die Webserver-Dokumentation warnt, dass das Binden an eine Nicht-Loopback-Adresse „weiterhin ungeschützte Routen und statische Ressourcen für dieses Netzwerk verfügbar macht“. In 0.2.0-rc.2 verfügt das Webserver-Plugin außerdem über keine eigene TLS-Unterstützung. Automatisierte Scanner durchsuchen ungewöhnliche Ports kontinuierlich. Behandeln Sie einen veröffentlichten Port 3080 daher als entdeckt.

Öffnen Sie Port 3080 nicht in Ihrer Firewall. Setzen Sie den host des Webservers auf einem öffentlichen VPS weder auf 0.0.0.0 noch auf Ihre öffentliche IP-Adresse. Diese Kombination macht die Befehlsausführung auf Ihrem Server für jeden, der eine Verbindung herstellt, nur eine durchgesickerte URL entfernt.

Aktuelle Releases führen Sie bereits in diese Richtung: Das --host-Flag der Webanwendung selbst verweigert die Bindung an alle Schnittstellen. In 0.2.0-rc.2 akzeptiert der Konfigurationsschlüssel host des Webserver-Plugins jedoch weiterhin 0.0.0.0. Eine Änderung der Konfiguration kann den Zugriff daher noch immer nach außen öffnen. Die Webserver-Dokumentation im Standard-Branch des Projekts und im Release 0.2.1-rc.5, auf das der npm-Tag latest jetzt zeigt, geht noch weiter: Sie weist eine nicht spezifizierte Adresse beim Laden zurück und ergänzt eine optionale Einstellung tls. Eine konkrete Adresse einer lokalen Schnittstelle wird weiterhin akzeptiert. Wenn Sie host auf die öffentliche IP-Adresse Ihres VPS setzen, wird die Weboberfläche daher ebenfalls nach außen exponiert.

Dieselbe Überlegung gilt für jede Agent-Laufzeit, die Sie auf einem Server betreiben. Deshalb beginnt der sichere Betrieb eines Coding-Agenten auf einem VPS mit derselben Regel: Der Steuerungsport des Agenten bleibt privat, und nur eine von Ihnen vertrauenswürdige Komponente stellt die Verbindung dorthin her.

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

Dafür gibt es drei sinnvolle Möglichkeiten. Bei allen bleibt das Harness an die Loopback-Schnittstelle gebunden.

  • Einen SSH-Tunnel. Dabei lauscht nichts zusätzlich an der öffentlichen Schnittstelle, und Sie haben die Zugangsdaten bereits. Diese Variante sollten Sie verwenden.
  • Ein privates Overlay-Netzwerk. Dadurch ist die Weboberfläche von Ihren eigenen Geräten aus erreichbar und für alle anderen unsichtbar.
  • Einen Reverse Proxy, der TLS (Transport Layer Security) terminiert und ein Passwort verlangt, bevor er Anfragen weiterleitet.

Der Unterschied liegt darin, was Ihren Browser mit der Loopback-Schnittstelle verbindet. Keine dieser Varianten sollte das Harness von der Loopback-Schnittstelle lösen.

Erreichbarkeit über einen SSH-Tunnel

Führen Sie dies auf Ihrem Laptop aus, nicht auf dem VPS:

ssh -N -L 3080:127.0.0.1:3080 you@your-vps

Lassen Sie den Befehl laufen. Öffnen Sie dann die ausgegebene vollständige URL dsh mit dem enthaltenen Token http://127.0.0.1:3080/?token=... in Ihrem lokalen Browser. Die Weboberfläche wird geladen, tauscht das Token gegen ein Session-Cookie aus und entfernt das Token aus der Adressleiste. Ihr Browser sendet 127.0.0.1:3080 als Host. Dieser Wert ist die Loopback-Adresse. Daher besteht der Tunnel die Host-Prüfung ohne zusätzliche Konfiguration.

Das Argument -L enthält drei durch Doppelpunkte getrennte Felder. Das erste Feld ist der Port, der auf Ihrem Laptop geöffnet wird. Das zweite und dritte Feld enthalten die Adresse und den Port, an die jede Verbindung weitergeleitet wird. Wichtig ist: 127.0.0.1 im mittleren Feld wird vom SSH-Server auf dem VPS aufgelöst, nachdem der Datenverkehr dort angekommen ist. Gemeint ist die Loopback-Adresse des VPS, nicht die Ihres Laptops. Genau diese Adresse wurde von dsh ausgegeben. Deshalb funktioniert der Tunnel, während eine direkte Browserverbindung fehlschlägt.

-N weist SSH an, keinen Remote-Befehl auszuführen. Sie erhalten also nur einen Forwarder und keine Shell. Für einen Hintergrundtunnel, der Fehler sichtbar meldet, statt sie still zu ignorieren:

ssh -N -f -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -L 3080:127.0.0.1:3080 you@your-vps

-f verschiebt den Prozess nach der Authentifizierung in den Hintergrund. ExitOnForwardFailure=yes ist wichtiger, als es zunächst wirkt: Ohne diese Option stellt SSH die Verbindung auch dann erfolgreich her, wenn die Weiterleitung nicht eingerichtet werden konnte. Sie erhalten dann eine funktionierende Sitzung und einen nicht funktionierenden Tunnel ohne Warnung. ServerAliveInterval=30 sendet alle 30 Sekunden ein Keepalive. Dadurch übersteht ein inaktiver Tunnel NAT-Zeitüberschreitungen (Network Address Translation) auf Routern in Cafés und Hotels.

Erwartete Ausgabe

Prüfen Sie auf dem VPS, welcher Prozess tatsächlich lauscht:

ss -ltnp | grep 3080

Eine korrekte Ausgabe nennt die Loopback-Adresse:

LISTEN 0  511  127.0.0.1:3080  0.0.0.0:*  users:(("node",pid=1042,fd=21))

Wenn die Spalte für die lokale Adresse stattdessen 0.0.0.0:3080 enthält, ist die Weboberfläche an alle Schnittstellen gebunden, einschließlich der öffentlichen Schnittstelle. Die öffentliche IP-Adresse Ihres VPS in dieser Spalte bedeutet dieselbe Gefährdung. Stoppen Sie den Dienst und korrigieren Sie die Bind-Adresse, bevor Sie etwas anderes tun. Wenn ss den Socket ausgibt, das Feld users: jedoch leer bleibt, führen Sie den Befehl mit sudo aus. Andernfalls wird der Prozessname eines Sockets ausgeblendet, der einem anderen Benutzer gehört.

Wenn der Tunnel nicht gestartet werden kann

SSH gibt Folgendes aus und beendet sich:

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

Das betrifft Ihren Laptop, nicht den Server. Ein anderer lokaler Prozess verwendet bereits Port 3080. Häufig handelt es sich um einen früheren Tunnel, den Sie vergessen haben. Verwenden Sie stattdessen einen freien lokalen Port:

ssh -N -L 3081:127.0.0.1:3080 you@your-vps

Nur das erste Feld wurde geändert. Sie rufen nun http://127.0.0.1:3081/?token=... mit demselben Token auf, während der Harness weiterhin auf Port 3080 lauscht. Die beiden Portnummern müssen nicht übereinstimmen. Das Session-Cookie ist an den Host und den Port in der Adressleiste gebunden. Bei einem neuen lokalen Port benötigen Sie die Token-URL daher erneut.

Wenn der Tunnel gestartet wird, der Browser jedoch eine abgelehnte Verbindung oder eine leere Antwort meldet, hat der Datenverkehr den VPS erreicht, dort aber am Ziel nichts gefunden. Entweder wurde dsh beendet oder der Dienst wurde an einen anderen Port gebunden. Prüfen Sie dies mit ss -ltnp | grep 3080 auf dem Server. Wenn die Seite stattdessen 401 Unauthorized beantwortet, funktioniert der Tunnel. Ihr Browser besitzt für diese Adresse lediglich kein gültiges Cookie. Öffnen Sie die ausgegebene URL erneut, einschließlich des Tokens. Nach einem Neustart müssen Sie die URL aus der neuen Ausgabe verwenden, da jeder Prozess ein neues Token erzeugt.

Ein weiterer Punkt verursacht hier häufig Probleme. Ein im Vordergrund laufendes npx @deepseek-ai/dsh web wird beendet, sobald die Shell geschlossen wird. Der Harness stoppt daher unmittelbar nach dem Abmelden. Starten Sie ihn innerhalb von tmux oder unter einem systemd-Benutzerdienst. Damit wird dasselbe Problem gelöst wie in einen Coding-Agent auf einem VPS weiterlaufen lassen. Unter systemd wird die dsh web:-Zeile einschließlich Token im Dienstprotokoll gespeichert. Lesen Sie sie daher dort aus. Während Sie die SSH-Seite einrichten, sollten Sie außerdem zuerst SSH auf Ihrem VPS absichern. Der Tunnel macht Ihre SSH-Anmeldung zum einzigen Zugang zum Agenten.

Über ein privates Overlay-Netzwerk darauf zugreifen

Ein Overlay-Netzwerk weist Ihrem VPS und Ihrem Laptop Adressen in einem privaten Netzwerk zu, dem nur Ihre Geräte beitreten. Tailscale ist die übliche Wahl, und der Befehl serve passt genau zu diesem Fall: tailscaled wird auf dem VPS ausgeführt und verbindet sich mit localhost:3080 selbst, sodass der Harness weiterhin auf Loopback bleibt.

tailscale serve --bg localhost:3080
tailscale serve status

Die Benutzeroberfläche ist dann unter dem Namen Ihres Geräts innerhalb Ihres Tailnets über HTTPS erreichbar, ohne dass an der öffentlichen Schnittstelle ein Port geöffnet werden muss. Dafür müssen HTTPS-Zertifikate für Ihr Tailnet aktiviert sein. Andernfalls kann serve kein Zertifikat bereitstellen. Da Ihr Browser diesen Tailnet-Namen jetzt als Host sendet, starten Sie den Harness mit diesem Namen als vertrauenswürdigem Host. Andernfalls werden seine API-Aufrufe mit 403 abgelehnt. Ein Eintrag ohne Port gilt für jeden Port:

npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host your-vps.your-tailnet.ts.net

Öffnen Sie anschließend https://your-vps.your-tailnet.ts.net/?token=... und übernehmen Sie dabei das Token aus der ausgegebenen Zeile. Um den Dienst wieder zu beenden, wiederholen Sie den Befehl mit off:

tailscale serve --https=443 off

Verwenden Sie serve, niemals funnel. Funnel veröffentlicht dasselbe Ziel im öffentlichen Internet. Dadurch läuft eine Agent-Runtime an einem offenen Port, die nur durch ein URL-Token geschützt ist. Die beiden Befehle sehen fast identisch aus, bewirken aber das Gegenteil. Lesen Sie daher den Unterschied zwischen Tailscale Serve und Funnel, bevor Sie einen der beiden Befehle eingeben. Tailscale als privates Netzwerk beschreibt die Einrichtung selbst.

Über einen Reverse Proxy mit Passwortprüfung darauf zugreifen

Mit dieser Option wird tatsächlich ein Port ins Internet veröffentlicht. Damit ist die Authentifizierung die einzige Hürde zwischen einer fremden Person und der Befehlsausführung auf Ihrem Server. Wählen Sie diese Option, wenn mehrere Personen die Benutzeroberfläche benötigen und ein eigener Tunnel pro Person unpraktisch ist.

Der Harness bleibt auf 127.0.0.1:3080. nginx läuft auf demselben System und kann daher den Loopback erreichen. Er lauscht auf 443 mit einem Zertifikat und einer Passwortdatei.

server {
    listen 443 ssl;
    server_name dsh.example.com;

    ssl_certificate     /etc/letsencrypt/live/dsh.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/dsh.example.com/privkey.pem;

    auth_basic           "dsh";
    auth_basic_user_file /etc/nginx/dsh.htpasswd;

    location / {
        proxy_pass http://127.0.0.1:3080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_read_timeout 3600s;
        proxy_buffering off;
    }
}

Erstellen Sie die Passwortdatei und laden Sie nginx neu:

sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/dsh.htpasswd you
sudo nginx -t && sudo systemctl reload nginx

nginx -t sollte syntax is ok gefolgt von test is successful ausgeben. Ein Reload mit einer fehlerhaften Datei schlägt fehl und lässt die laufende Konfiguration unverändert. Lesen Sie daher die Fehlermeldung, statt blind neu zu starten.

Drei dieser Proxy-Zeilen sind erforderlich. Die Header Upgrade und Connection ermöglichen den WebSocket-Handshake. Ohne sie wird die Seite geladen, aber nie aktualisiert. proxy_read_timeout 3600s erhöht das Inaktivitäts-Timeout von nginx von 60 Sekunden auf eine Stunde. Es begrenzt nicht die Gesamtdauer eines Agent-Laufs. Die festgelegte Version 0.2.0-rc.2 sendet standardmäßig bereits alle zwei Sekunden WebSocket-Pings. Dadurch bleibt die Verbindung während eines langen Agent-Schritts aktiv. proxy_buffering off deaktiviert das Puffern von HTTP-Antworten durch den Proxy. Es steuert keine WebSocket-Frames. Eine nginx-Reverse-Proxy-Konfiguration, Zeile für Zeile erklärt die übrigen Einstellungen. Die Auswahl zwischen nginx, Caddy und Traefik beschreibt dieselbe Einrichtung mit automatischen Zertifikaten.

Auch der Harness muss den Proxy kennen. proxy_set_header Host $host übergibt den für den Browser sichtbaren Namen unverändert. Das verlangt die Proxy-Anleitung des Projekts. Starten Sie dsh daher mit diesem Namen als vertrauenswürdigem Namen. Andernfalls antwortet es mit 403:

npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host dsh.example.com

Jede Person öffnet anschließend einmal https://dsh.example.com/?token=... und verwendet dabei das Token aus der Zeile dsh web:. Danach behält der Browser das Sitzungscookie. Das Backend setzt dieses Cookie ohne das Flag Secure. Die Proxy-Anleitung verlangt, dass der Proxy dieses Flag bei HTTPS ergänzt. Bei nginx 1.19.3 oder neuer erledigt proxy_cookie_flags ~ secure; im Block location dies.

Lassen Sie 3080 unabhängig von der gewählten Proxy-Lösung in der Firewall geschlossen. Der einzige Zugriffsweg sollte über den authentifizierten Proxy führen. Grundlagen der ufw-Firewall erläutert die Regeln. Die Basisauthentifizierung über TLS ist eine Mindestmaßnahme, aber kein vollständiges Sicherheitsmodell: Wer das Passwort und die Token-URL besitzt, hat Zugriff auf eine Shell auf Ihrem Server. Verwenden Sie nach Möglichkeit den Tunnel.

Wie ändere ich den Port, auf dem der dsh-Webserver lauscht?

--port gehört zur Webanwendung, nicht zum Launcher. Die CLI-Dokumentation enthält direkt das folgende Beispiel:

dsh --profile web --port 8080

dsh web ist ein Alias für --profile web. Daher ist dsh web --port 8080 derselbe Befehl. Der Launcher verarbeitet nur seine eigenen Flags und übergibt alles danach an das gestartete Profil. Die Launcher-Flags müssen daher zuerst kommen. Das erste Token, das der Launcher nicht erkennt, leitet die Argumente der Anwendung ein. Setzen Sie --port nach dem Profil, niemals davor.

Lesen Sie die URL, die der Befehl ausgibt, statt sie anzunehmen. Diese Zeile enthält die Adresse, an die der Server tatsächlich gebunden ist, sowie das benötigte Token. Aktualisieren Sie anschließend das letzte Feld Ihres Tunnels entsprechend:

ssh -N -L 3080:127.0.0.1:8080 you@your-vps

Für eine dauerhafte Änderung wird der Port in der Profilkonfiguration statt in der Befehlszeile festgelegt. Die Profile web und headless werden bei der ersten Verwendung automatisch anhand der mitgelieferten Vorlagen initialisiert, und zwar unter ~/.dsh. In diesem Verzeichnis befinden sich auch Ihre API-Key- und Model-Endpoint-Einstellungen. Daher ist dsh-Keys, Modelle und Endpunkte konfigurieren die passende Ergänzung, wenn Sie diese Dateien ohnehin bearbeiten. So sehen Sie, welche Einstellungen nach dem Zusammenführen aller Ebenen tatsächlich wirksam sind:

dsh --dump-config

Die Listen-Adresse stammt aus zwei Schlüsseln des Webserver-Plugins: host und port. In 0.2.0-rc.2 konfigurieren die übrigen Schlüssel nur die Antwortkomprimierung. 0.2.1-rc.2 und der Default-Branch fügen außerdem einen optionalen Schlüssel tls hinzu. Wenn Sie port auf 0 setzen, fordert das Betriebssystem einen freien Port an. Dies ist mit „zero requests an OS-assigned port“ dokumentiert. Dadurch vermeiden Sie Portkonflikte. Für einen Tunnel ist diese Einstellung jedoch ungeeignet, weil sich die Portnummer bei jedem Neustart ändert.

Warum schlägt dsh mit der Meldung „address already in use“ fehl?

Ein anderer Prozess verwendet diese Adresse und diesen Port bereits. Deshalb verweigert der Kernel den zweiten Bind-Vorgang. Node meldet das so:

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080

Ermitteln Sie den belegenden Prozess, bevor Sie etwas ändern:

sudo ss -ltnp | grep 3080

Das Feld users:(("node",pid=1042,fd=21)) nennt den Prozess und seine PID. In der Regel handelt es sich um eine frühere dsh-Instanz, von der Sie dachten, sie sei beendet. Häufig läuft sie noch in einem abgekoppelten tmux-Fenster. Beenden Sie diese Instanz mit kill 1042 oder starten Sie die neue Instanz auf einem anderen Port. Beachten Sie, dass 127.0.0.1:3080 und 0.0.0.0:3080 ebenfalls miteinander kollidieren. Das Binden an alle Schnittstellen schließt die Loopback-Schnittstelle bereits ein.

Version festlegen, weil dies eine Entwicklervorschau ist

Die README ist eindeutig: DeepSeek Harness befindet sich in der Entwicklervorschau und wird schnell weiterentwickelt. Dabei wird es zu inkompatiblen Änderungen kommen. Falls dieses Tempo der Grund für Ihre Zurückhaltung ist, vergleicht wie sich dsh mit Claude Code und Omnigent vergleicht die Anwendung mit zwei Harnesses, die sich an unterschiedlichen Punkten derselben Entwicklungskurve befinden.

Ein ungepinntes npx @deepseek-ai/dsh web enthält keine Versionsangabe. Sie haben daher keine Kontrolle darüber, welcher Build gestartet wird. In der Dokumentation von npm steht, dass ein Paketname ohne Spezifizierer „mit der Version abgeglichen wird, die im lokalen Projekt vorhanden ist“. Fehlt das Paket im Projekt, wird es in ein Verzeichnis im npm-Cache installiert. Welcher Build gestartet wird, hängt davon ab, was auf dem jeweiligen Rechner vorhanden ist. Ein Neustart kann daher eine andere CLI als die getestete starten, mit anderen Flags. Legen Sie die Version fest, damit ein Neustart kein Upgrade ausführt:

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

Am November 2026 (geprüft am 2026-11-01) verweist der npm-Tag latest auf 0.2.1-rc.5, das am 2026-10-30 auf GitHub veröffentlicht wurde. GitHub führt 0.2.1-rc.4 als am 2026-10-28 um 02:49 UTC veröffentlicht. Das war ungefähr vier Tage und elf Stunden nach 0.2.1-rc.3 am 2026-10-23 um 15:26 UTC. Auf einem Rechner ohne lokale Kopie lädt ein einfaches npx @deepseek-ai/dsh daher derzeit einen Release Candidate der Version 0.2.1 und nicht den Build, auf den diese Anleitung festgelegt ist. Das festgelegte 0.2.0-rc.2 wurde am 2026-09-29 auf GitHub veröffentlicht. Der 0.1.0-rc.7-Build, auf den diese Anleitung im August festgelegt wurde, liegt inzwischen viele Vorschauversionen zurück, über den restlichen Zweig 0.1 hinweg bis in 0.2 hinein. Prüfen Sie, was ein einfaches npx laden würde, bevor Sie es akzeptieren:

npm view @deepseek-ai/dsh version

npm view @deepseek-ai/dsh dist-tags listet alle Tags gleichzeitig auf. So erkennen Sie vor dem Festlegen, ob es sich um einen Release Candidate oder eine Alpha-Version handelt.

Falls die Installation mit dem festgelegten Wert fehlschlägt oder npx nach dem Festlegen einer neuen Version weiterhin den alten Build startet, behandelt dies die dabei auftretenden Installations- und Versionsfehler. Dort wird beschrieben, wie Sie den npx-Cache leeren und prüfen, welches npm Ihr Node bündelt.

Bei Vorschauversionen wechseln Flags zwischen dem Launcher und der Webanwendung. Falls sich --port nicht mehr so verhält, wie in dieser Anleitung beschrieben, fragen Sie die Anwendung nach ihrer eigenen Flag-Liste, anstatt die Werte zu erraten:

dsh --profile web --help

Informationen zur Installation, zur Einrichtung des Workspace und zum Model-Key finden Sie unter DeepSeek Harness auf einem VPS installieren. Eine kürzere Anleitung nur für den Zugriffsschritt bietet die dsh-Weboberfläche auf einem VPS erreichen. Dort wird der Tunnel ohne die Erläuterungen behandelt.

FAQ

Warum kann ich http://127.0.0.1:3080 im Browser meines Laptops nicht öffnen?

Weil 127.0.0.1 den Rechner bezeichnet, auf dem Sie den Befehl eingeben. Die DeepSeek Harness Web UI ist an die Loopback-Adresse des VPS gebunden. Deshalb können nur Prozesse auf dem VPS eine Verbindung zu ihr herstellen. Ihr Laptop hat eine eigene Loopback-Adresse. Dort lauscht kein Prozess auf Port 3080. Leiten Sie den Port mit ssh -N -L 3080:127.0.0.1:3080 you@your-vps über SSH weiter. Öffnen Sie anschließend lokal die vollständig ausgegebene URL http://127.0.0.1:3080/?token=.... Das mittlere Feld des Arguments -L wird serverseitig aufgelöst. Dadurch verweist es auf den Harness. Wenn Sie das Token weglassen, erhalten Sie 401 Unauthorized, bis Ihr Browser ein Session-Cookie besitzt.

Ist es sicher, die dsh Web UI auf einem öffentlichen VPS an 0.0.0.0 zu binden?

Nein. Die Web UI ist die Steuerungsschnittstelle für einen Agenten, der Shell-Befehle ausführt und Dateien als der Benutzer bearbeitet, der dsh ausführt. Es gibt keine Benutzerkonten und keine Anmeldeseite. Das einzige Anmeldemerkmal ist das Token in der ausgegebenen URL. Statische Inhalte werden ohne dieses Token ausgeliefert. Die Dokumentation des Projekts weist außerdem darauf hin, dass der Listening-Port selbst nicht geschützt ist. Wenn Sie die Web UI an alle Interfaces einer öffentlichen IP-Adresse binden, ist die Befehlsausführung auf Ihrem Server nur noch eine weitergegebene URL von jedem entfernt, der Port 3080 erreicht. Die direkte Bindung an die öffentliche IP-Adresse birgt dasselbe Risiko. Lassen Sie die Bindung auf 127.0.0.1 bestehen, halten Sie Port 3080 in der Firewall geschlossen und verwenden Sie einen SSH-Tunnel, ein privates Overlay-Netzwerk oder einen Reverse Proxy mit erforderlichem Passwort.

Wie lasse ich die dsh Web UI nach dem Schließen meiner SSH-Sitzung weiterlaufen?

Ein npx @deepseek-ai/dsh web im Vordergrund ist ein Kindprozess Ihrer Login-Shell. Er wird beendet, sobald diese Shell beendet wird. Starten Sie ihn innerhalb einer tmux-Sitzung und trennen Sie die Sitzung mit Ctrl-b d. Alternativ können Sie ihn als systemd-Benutzerdienst mit aktiviertem Lingering ausführen. Tunnel und Harness sind unabhängig voneinander. Sie können den SSH-Tunnel beliebig oft trennen und neu aufbauen, ohne den laufenden Harness zu beeinflussen. Das gilt, solange der Harness selbst einen übergeordneten Prozess hat, der Ihre Login-Sitzung überdauert.

Warum friert die dsh Web UI bei einem langen Agentenlauf hinter nginx nach einiger Zeit ein?

Prüfen Sie die WebSocket-Verbindung und das nginx-Fehlerprotokoll. Der Standardwert von nginx für proxy_read_timeout beträgt 60 Sekunden zwischen zwei Lesevorgängen. Die festgelegte Version 0.2.0-rc.2 sendet jedoch standardmäßig alle zwei Sekunden WebSocket-Pings. Daher löst ein langer Agentenschritt allein dieses Timeout nicht aus. proxy_read_timeout 3600s; erhöht die zulässige Inaktivitätsdauer auf eine Stunde. proxy_buffering off; deaktiviert das Puffern von HTTP-Antworten, nicht von WebSocket-Frames. Übergeben Sie die Header Upgrade und Connection mit proxy_http_version 1.1;, damit der WebSocket-Handshake erfolgreich ist. Ohne diese Header wird die Seite geladen, empfängt aber keine Aktualisierungen.

War dieser Artikel hilfreich?