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

DSH-Weboberfläche auf dem VPS erreichen

Die DSH-Weboberfläche bindet an 127.0.0.1:3080. Erfahren Sie, warum die VPS-URL nicht auf Ihrem Laptop öffnet und welche drei sicheren Wege funktionieren.

Warum die DSH-Weboberfläche auf Ihrem Laptop nicht geöffnet wird

Die DSH-Weboberfläche ist an die Loopback-Schnittstelle gebunden. Daher funktioniert die von Ihrem Terminal ausgegebene URL nur auf dem Computer, auf dem sie ausgegeben wurde. npx @deepseek-ai/dsh web meldet eine Start-URL der Form http://127.0.0.1:3080/?token=.... 127.0.0.1 bedeutet für den Computer, der diese Adresse liest, „der Computer, auf dem die Adresse gelesen wird“. Ihr Laptop liest die Adresse, prüft seine eigene Loopback-Schnittstelle und findet dort keinen Prozess, der Verbindungen entgegennimmt. Falls die Adresse selbst unklar ist, erläutert warum dsh überhaupt http://127.0.0.1:3080 ausgibt die Hintergründe ausführlicher. Ändern Sie nicht, an welche Schnittstelle DSH gebunden ist. Richten Sie stattdessen einen authentifizierten Pfad von Ihrem Laptop zur Loopback-Adresse des VPS ein.

Die Loopback-Standardeinstellung ist korrekt, und alle Methoden auf dieser Seite behalten sie bei. Hinter Port 3080 läuft ein Agent, der Shell-Befehle auf Ihrem Server ausführt. Die Weboberfläche enthält keine Anmeldeseite. DSH authentifiziert den Browser inzwischen mit einem Start-Token: Bei jedem Prozessstart wird ein neues Token erzeugt, die ausgegebene URL enthält dieses Token, und beim ersten Aufruf wird es gegen ein Session-Cookie ausgetauscht. Dieses Token ist ein einzelnes Bearer-Credential in einer URL. Daher bleibt Loopback die wichtigste Schutzschicht: Direkte Verbindungen zum Socket müssen vom VPS ausgehen, einschließlich Verbindungen, die per SSH oder über einen Proxy weitergeleitet werden.

Woran DSH gebunden ist und wie Sie Ihre Konfiguration prüfen

Zum Stand vom 4. November 2026 besagt die README von DeepSeek Harness, dass npx @deepseek-ai/dsh web „die Weboberfläche standardmäßig unter http://127.0.0.1:3080 startet“. Die CLI-Referenz im selben Repository gibt an, dass der Standardport weiterhin 3080 ist, dass --host „eine konkrete lokale Adresse und keinen Wildcard-Wert enthalten muss“ und dass --host 0.0.0.0 mit einem Verwendungsfehler beendet wird. DSH ist eine Entwicklervorschau. Die README warnt in Großbuchstaben vor inkompatiblen Änderungen. Prüfen Sie beide Werte in Ihrer eigenen Installation, statt einer beliebigen Seite zu vertrauen, auch dieser hier.

dsh --profile web --dump-config
ss -ltnp | grep 3080

--dump-config gibt den zusammengesetzten Konfigurationsbaum aus, ohne den Agent zu starten. Ausdrücke werden dabei nicht ausgewertet und Argumente der Anwendung nicht aufgelöst. Daher ist dies keine Ausgabe des tatsächlich verwendeten Hosts und Ports zur Laufzeit. ss zeigt, worauf derzeit tatsächlich gelauscht wird. Eine funktionsfähige Zeile sieht so aus:

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

Lesen Sie die lokale Listening-Adresse, nicht die Peer-Adresse. 127.0.0.1:3080 ist ausschließlich an Loopback gebunden. Das ist die gewünschte Einstellung. Auch andere Adressen in 127/8, ::1 und deren auf Loopback abgebildete Formen halten DSH lokal. Eine Nicht-Loopback-Adresse stellt den Dienst für das Netzwerk bereit, zu dem diese Adresse gehört. Das kann auch das öffentliche Netzwerk sein. Wenn ss überhaupt keine Zeile ausgibt, lauscht auf Port 3080 nichts. Prüfen Sie vor dem Einrichten eines Tunnels, ob DSH beendet wurde oder einen anderen Port verwendet. Wie Sie diesen Punkt erreichen, wird unter DeepSeek Harness auf einem VPS installieren und ausführen beschrieben.

Flags gelten nur für einen einzelnen Lauf. Damit ein Wert dauerhaft übernommen wird, bearbeiten Sie stattdessen die Patch-Ebene des Profils. dsh --profile <name> startet das Profil unter $DSH_HOME/profiles/<name>. Die Ebenen werden in dieser Reihenfolge übereinandergelegt: Bundle-Patches, das eigene cordis.patch.yml des Profils, das $DSH_HOME/cordis.patch.yml auf Home-Ebene und anschließend ein mögliches --patch-Overlay. Die Listening-Einstellungen befinden sich unter dem Plugin @deepseek-ai/dsh-host-webserver als host und port. Lesen Sie vor der Bearbeitung mit --dump-config Ihren eigenen zusammengesetzten Baum aus. Das Webprofil wird beim ersten Start aus einer mitgelieferten Vorlage erstellt, und die Vorschau ändert die Struktur dieser Vorlage weiterhin.

Die Startzeile zeigt auch, woher Ihre Anmeldedaten stammen. DSH gibt die Root-URL mit dem Prozesstoken in einer token-Abfrage aus. Der Browser kann es nur als GET /?token=... und niemals in einem Authorization-Header übermitteln. Für API-Aufrufer gibt es einen separaten GET /connect?token=...-Austausch. Dieser ist nicht für den Browser vorgesehen. Die Root-Anfrage setzt ein signiertes, nur für den Host gültiges HttpOnly-SameSite=Strict-Cookie und leitet anschließend auf eine bereinigte URL weiter. Bei jedem Prozessstart wird ein neues Token erzeugt. Das Cookie läuft standardmäßig nach 30 Tagen ab. Dieser Wert wird durch cookieMaxAgeDays festgelegt. Eine Anfrage nach dem Dokument oder einer API ohne gültige Anmeldedaten erhält den Status 401. Statische Ressourcen bleiben öffentlich. Kopieren Sie die vollständig ausgegebene URL einschließlich des Tokens, weil Sie bei jeder folgenden Methode diese URL öffnen.

Das zweite Gate: die /api-Vertrauensgrenze

Pakete an Port 3080 zu senden, löst nur die Hälfte des Problems. DSH führt eine zweite Prüfung durch. Sie verursacht den verwirrenden Fehler, bei dem die Seite geladen wird, das Layout erscheint und anschließend nichts funktioniert.

Das @deepseek-ai/dsh-client-connection-Plugin enthält eine Einstellung trustedHosts. In der README steht die Regel: Der Header Host muss eine Loopback-Adresse, die eigene Bind-Adresse des Listeners an einem beliebigen Port oder einen Eintrag trustedHosts enthalten. Wenn der Browser einen Header Origin sendet, muss dieser dieselbe Authority angeben. Die Vertrauensgrenze wird bei jeder Anfrage vor der Authentifizierung geprüft. Sie weist jede /api-Anfrage zurück, die diese Prüfung nicht besteht. Der Browser meldet die Zurückweisung wie folgt:

transport failure for /api/host.describe: HTTP 403

Jeder Proxy vor DSH muss daher den Namen angeben, den der Browser verwendet. Die CLI akzeptiert --trusted-host <authority>. Die Option kann mehrfach angegeben werden:

dsh web --trusted-host dsh.example.com

Die Vertrauensgrenze vergleicht Authorities, also Host plus Port, und normalisiert Standardports anhand des Schemas des Listeners. Ein Eintrag ohne Port wie dsh.example.com gilt für diesen Namen an jedem Port und deckt daher auch dsh.example.com:8443 ab. Ein Eintrag mit Port wie dsh.example.com:8443 gilt nur für genau diesen Host und Port. Für Loopback ist kein Eintrag erforderlich. Daher werden sowohl localhost:3080 als auch 127.0.0.1:3080 akzeptiert. Ein nicht erklärbarer 403 entsteht fast immer durch einen Unterschied zwischen dem Namen in der Adressleiste und den Namen in der Liste der vertrauenswürdigen Einträge. Ein 401 ist ein anderes Problem: Die Vertrauensgrenze hat die Anfrage zugelassen, aber der Browser besitzt für diese Authority kein gültiges Sitzungs-Cookie.

Die Vertrauensgrenze prüft den Origin. Sie übernimmt nicht die Authentifizierung. Ein Browser darf einen Host-Header nicht selbst setzen. Dadurch verhindert die Prüfung, dass eine Seite auf einer anderen Website Ihren Agent steuert. Jeder Client, der kein Browser ist, kann diesen Header frei schreiben. Behandeln Sie trustedHosts als Kompatibilitätseinstellung für Proxys und als Schutz gegen Browser-Anfragen, niemals als Authentifizierung oder als Einschränkung der Clients, die den Port erreichen dürfen.

Option 1: ein lokales SSH-Forwarding

Verwenden Sie diese Option zuerst, weil sie auf dem Server nichts verändert.

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

-L öffnet einen Listener auf Ihrem Laptop und leitet jede Verbindung an 127.0.0.1:3080 weiter, wie der Hostname auf dem VPS aufgelöst wird. -N bedeutet „keinen Remote-Befehl ausführen“. Die Sitzung transportiert daher nur das Forwarding. Die lokale Seite als 127.0.0.1:3080 statt als einfaches 3080 zu schreiben, ist beabsichtigt: Dadurch wird der Listener auf dem Laptop an Loopback gebunden. Eine Einstellung GatewayPorts in Ihrer SSH-Clientkonfiguration kann den Agenten dadurch nicht unbemerkt im Netzwerk veröffentlichen, mit dem Sie gerade verbunden sind.

Öffnen Sie nun die von DSH ausgegebene Start-URL einschließlich Token im Browser Ihres Laptops. Da das Forwarding auf 127.0.0.1:3080 lauscht, funktioniert das ausgegebene http://127.0.0.1:3080/?token=... unverändert. Das einfache http://localhost:3080 reicht in einer neuen Browsersitzung nicht aus: Ohne Cookie antwortet DSH mit 401. Nach dem ersten Aufruf wird die Authentifizierung durch das Cookie übernommen. Das Cookie gilt jedoch nur für den Host. Verwenden Sie daher weiterhin den Namen, den Sie zuerst geöffnet haben. Ein für 127.0.0.1 gesetztes Cookie wird nicht an localhost gesendet. Der Header Host gibt eine Loopback-Authority an. Die /api-Prüfung wird daher ohne Konfiguration bestanden. Die aktuelle DSH-Implementierung für UUIDs verwendet crypto.getRandomValues(). Sie ist daher beim Start nicht mehr auf das ausschließlich für sichere Kontexte vorgesehene crypto.randomUUID() angewiesen.

Fügen Sie -f hinzu, damit ssh nach erfolgreicher Authentifizierung selbst in den Hintergrund wechselt:

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

Der ehrliche Kompromiss: Es lauscht nichts Neues an einer öffentlichen Adresse, und es werden keine Firewall-Regeln geändert. Dadurch ist dies die kleinstmögliche Erhöhung der Angriffsfläche. Ihre gesamte Zugriffskontrolle besteht aus Ihrer SSH-Konfiguration. Daher ist SSH nur mit Schlüssel und deaktivierter Kennwortanmeldung eine Voraussetzung und kein optionales Extra. Der Nachteil ist, dass der Tunnel an eine einzelne Clientsitzung gebunden ist. Er endet, sobald der Laptop in den Energiesparmodus wechselt. Sie müssen ihn manuell neu starten. Auf einem Smartphone steht er Ihnen nicht zur Verfügung.

Option 2: Tailscale serve auf dem VPS

Tailscale erstellt ein privates Netzwerk zwischen Ihren eigenen Geräten. Wenn Sie Tailscale auf dem VPS installieren, erhält diese Maschine eine über Tailscale erreichbare 100.x.y.z-Adresse. Ihre Zugriffsrichtlinien legen fest, welche Geräte eine Verbindung herstellen dürfen. Wenn Sie die Maschine freigeben, gilt dieser Zugriff auch für die Geräte eines externen Benutzers.

Der Beitritt zu diesem Netzwerk reicht nicht aus. Genau hier treten häufig Probleme auf. DSH lauscht nicht auf der 100.x.y.z-Adresse, weil es auf Loopback lauscht. Ein Browser, der auf http://100.x.y.z:3080 zeigt, erhält die Fehlermeldung „Verbindung abgelehnt“, weil an diese Adresse kein Socket gebunden ist. --host akzeptiert diese konkrete Adresse zwar, aber eine Bindung außerhalb von Loopback stellt unverschlüsseltes HTTP bereit, sofern Sie TLS nicht konfigurieren. DSH warnt beim Start vor einer HTTP-Bindung außerhalb von Loopback. Der hier verwendete Loopback-Listener löst diese Warnung nicht aus. Die aktuelle UUID-Implementierung funktioniert ohne sicheren Kontext. Unverschlüsseltes HTTP legt das Start-Token und das Cookie auf diesem HTTP-Abschnitt trotzdem offen.

tailscale serve verbindet diese beiden Komponenten. Es läuft auf dem VPS, nimmt Datenverkehr aus Ihrem privaten Netzwerk an und leitet ihn an eine lokale Adresse weiter:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
sudo tailscale serve --bg --https=443 localhost:3080
tailscale serve status

tailscale serve status gibt die URL im Format https://<machine>.<tailnet>.ts.net/ aus. Starten Sie DSH mit diesem Namen als vertrauenswürdigem Namen. Andernfalls gibt /api wie oben beschrieben den Statuscode 403 zurück:

dsh web --public-url https://your-vps.your-tailnet.ts.net/ --trusted-host your-vps.your-tailnet.ts.net

--public-url setzt die ausgegebene und geöffnete Start-URL, DSH_WEB_URL, sowie die Web-GUI-URL im Laufzeitkontext des Agents. Dadurch wird die Start-URL unter dem Tailnet-Namen ausgegeben und auf Ihrem Telefon direkt geöffnet. Allein dadurch wird noch nichts zugelassen. Deshalb ist --trusted-host weiterhin erforderlich. Die ausgegebene URL enthält ein gültiges Zugangstoken. Fügen Sie sie daher nur auf Ihren eigenen Geräten ein.

Tailscale beendet die TLS-Verbindung mit einem für diesen Namen ausgestellten Zertifikat. Dadurch werden das Start-Token und das Sitzungscookie zwischen Ihrem Browser und dem VPS geschützt. Der Dienst ist nicht im öffentlichen Internet erreichbar: serve akzeptiert Tailscale-Datenverkehr, einschließlich des über die Maschinenfreigabe gewährten Zugriffs.

Verwenden Sie hier nicht tailscale funnel. Dieser Befehl gehört zur gleichen Befehlsfamilie, ist aber auf das öffentliche Internet ausgerichtet. Damit würden Sie einen Agenten mit Shell-Zugriff auf einem Hostnamen bereitstellen, den jeder auflösen kann. Lesen Sie wie serve den Datenverkehr in Ihrem Tailnet hält, während funnel ihn veröffentlicht, bevor Sie einen der beiden Befehle eingeben. Die auf ein Telefon zugeschnittene Variante dieser vollständigen Konfiguration finden Sie unter einen selbst gehosteten Agenten vom Telefon aus erreichen.

Der Nachteil ist eine zusätzliche Abhängigkeit. Jedes Gerät, das die Benutzeroberfläche benötigt, muss Tailscale verwenden und Zugriff auf den VPS haben, entweder über Ihr Tailnet oder über die Maschinenfreigabe. Außerdem verwaltet ein von Ihnen nicht betriebener Koordinationsserver die Netzwerkmitgliedschaft. Wenn das nicht akzeptabel ist, verwendet ein selbst gehosteter Headscale-Kontrollserver dasselbe Protokoll auf Hardware, die Sie selbst besitzen.

Option 3: ein authentifizierter TLS-Reverse-Proxy

Verwenden Sie diese Option, wenn der Browser keinem privaten Netzwerk beitreten kann, etwa bei einem Rechner, den Sie nicht administrieren. Sie veröffentlichen jetzt einen Hostnamen im Internet. Deshalb muss die Authentifizierung tatsächlich wirksam sein und vom Proxy kommen. Das Start-Token von DSH ist ein einzelnes Bearer-Credential in einer URL, das von allen Personen geteilt wird, die es besitzen. Es zählt daher nicht als diese zusätzliche Schutzebene.

TLS steht für Transport Layer Security, die Verschlüsselung hinter https://. Richten Sie nginx auf den Loopback-Port und schalten Sie ein Passwort davor. Der Block map gehört in den Kontext http. Legen Sie dafür eine eigene Datei unter /etc/nginx/conf.d/ an:

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

Dann die Site selbst:

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 Host              $host;
        proxy_set_header Upgrade           $http_upgrade;
        proxy_set_header Connection        $connection_upgrade;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cookie_flags ~ secure;
        proxy_read_timeout 3600s;
        proxy_buffering    off;
    }
}

Erstellen Sie die Passwortdatei, testen Sie die Konfiguration und laden Sie sie 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 und test is successful ausgeben. Gibt der Befehl stattdessen einen Fehler aus, verwendet nginx weiterhin die alte Konfiguration. Dadurch ist noch nichts kaputt. Starten Sie DSH anschließend mit dem öffentlichen Namen als vertrauenswürdigem Host, weil proxy_set_header Host $host dsh.example.com weiterleitet und die Zugriffssperre die Anfrage sonst ablehnt. --public-url sorgt dafür, dass die ausgegebene Start-URL diesen Namen verwendet. Sie können sie dadurch direkt öffnen:

dsh web --public-url https://dsh.example.com/ --trusted-host dsh.example.com

Drei Direktiven sind dabei entscheidend. Die Header Upgrade und Connection ermöglichen der Benutzeroberfläche, ihre WebSocket-Verbindung herzustellen. Ohne diese Header schlägt das Upgrade fehl. proxy_read_timeout 3600s erhöht das zulässige Intervall zwischen Lesevorgängen vom Upstream vom Standardwert 60 Sekunden auf eine Stunde. Es begrenzt nicht die Gesamtdauer der Agent-Ausführung. proxy_cookie_flags ~ secure kennzeichnet das Session-Cookie Secure von DSH auf der HTTPS-Verbindung als sicher. Der öffentliche Deployment-Leitfaden von DSH verlangt diese Einstellung für den Proxy, weil ein Backend über normales HTTP das Cookie sonst ohne diese Kennzeichnung ausstellt. DSH kann mit --tls-cert und --tls-key auch selbst HTTPS bereitstellen. Es ruft jedoch keine Zertifikate ab und erneuert sie nicht. Außerdem bietet es keine Passwortauthentifizierung. Daher ersetzt es den Proxy in diesem Szenario nicht. Die Begründung für die übrigen Einstellungen finden Sie unter eine nginx-Reverse-Proxy-Konfiguration, Direktive für Direktive erklärt. Die Auswahl des Proxys selbst wird unter nginx im Vergleich mit Caddy und Traefik erläutert.

Beachten Sie genau, welchen Schutz Basic Auth bietet. Sie verhindert automatisierte Scanner, die zufällig erreichbare Dienste prüfen, und ist deutlich besser als ein offener Port. Gleichzeitig handelt es sich nur um ein gemeinsames Passwort vor einer Shell. Es gibt keinen zweiten Faktor und keine Möglichkeit, den Zugriff einer einzelnen Person zu widerrufen, während alle denselben Login verwenden. Jede Person, die das Passwort und eine Start-URL oder ein Session-Cookie kennt, kann Befehle als der Benutzer ausführen, unter dem DSH läuft. Wenn mehrere Personen Zugriff benötigen, schalten Sie stattdessen einen echten Identity-Proxy davor. Lesen Sie außerdem die Sicherheitsregeln für den Betrieb eines Coding-Agenten auf einem VPS, bevor Sie den Zugriff weiter öffnen.

Was geschieht, wenn Sie an 0.0.0.0 binden und den Port öffnen

Der naheliegende Ansatz besteht darin, die Bind-Adresse zu ändern und die Firewall zu öffnen. DSH blockiert den Wildcard-Teil. --host lehnt 0.0.0.0 ab, und das @deepseek-ai/dsh-host-webserver-Plugin verwirft die nicht angegebene Adresse bei jedem Schreibweisen, sobald es seine Konfiguration lädt, einschließlich 0.0.0.0, :: und der IPv4-zugeordneten Formen. Was host akzeptiert, ist ein konkretes IPv4- oder IPv6-Adressliteral. Ihre öffentliche IP-Adresse anzugeben, ist daher eine Einstellung, die DSH übernimmt. Es gibt Community-Plugins, die den Eintrag für den Webserver ersetzen und damit die Wildcard-Ablehnung umgehen. Sie werden mit Warnungen ausgeliefert, und diese Warnungen sind berechtigt. Die gleiche Plugin-Schicht ist in der entgegengesetzten Richtung wesentlich nützlicher: Ausgabenlimits und Berechtigungsregeln für Werkzeuge schränken ein, was der Agent tun darf, statt den Bereich zu erweitern, auf dem er Verbindungen annimmt.

Das erhalten Sie tatsächlich mit einer öffentlichen Bind-Adresse ohne TLS. Port 3080 antwortet über unverschlüsseltes HTTP an Ihrer öffentlichen IP-Adresse. DSH gibt beim Start zwar eine Warnung aus, wenn eine Bind-Adresse außerhalb des Loopback-Bereichs unverschlüsseltes HTTP bereitstellt. Eine Warnung ist aber alles, was geschieht: Der Listener wird trotzdem geöffnet. Es gibt keine Anmeldeseite. Das Start-Token ist die einzige Sperre. Es wird innerhalb der URL unverschlüsselt über das Internet übertragen. Das Sitzungscookie wird anschließend ebenfalls unverschlüsselt übertragen. Die /api-Schranke prüft einen Host-Header, den jeder Client außerhalb eines Browsers selbst setzt. Außerdem lässt sie die Bind-Adresse unabhängig vom Port zu. Daher ändert die Angabe Ihrer Adresse in trustedHosts nichts für einen Angreifer, der curl besitzt. In der eigenen Bereitstellungsanleitung von DSH steht, dass weder die beworbene URL noch die Schranke den Listening-Port selbst schützt. Hinter diesem Port läuft ein Agent, der Shell-Befehle mit Ihrem Benutzerkonto ausführt. Dazu kommen die Zugangsdaten unter $DSH_HOME. Dort speichert DSH Profile und API-Schlüssel. Ein abgehörtes Token oder Cookie ermöglicht die Remotecodeausführung auf Ihrem Server. Die Kosten Ihres Providers fallen ebenfalls an. Scanner durchsuchen kontinuierlich den gesamten Adressraum. Eine nicht veröffentlichte IP-Adresse ist daher keine Schutzmaßnahme. Jedes Geheimnis, das der Agent lesen kann wird zusammen mit der Shell übertragen.

Jede der oben genannten Methoden existiert, damit Sie dies niemals tun müssen. Die SSH-Weiterleitung ist die richtige Standardeinstellung für eine Person auf einem Laptop. Wechseln Sie zu tailscale serve, wenn ein Telefon beteiligt ist oder Sie ein echtes Zertifikat benötigen. Behalten Sie den öffentlichen Reverse Proxy für den Fall bei, dass ein Browser, den Sie nicht verwalten, auf die Benutzeroberfläche zugreifen muss und davor eine echte Authentifizierung erforderlich ist.

FAQ

Warum wird http://127.0.0.1:3080 auf meinem Laptop nicht geöffnet?

Weil 127.0.0.1 „die Maschine bezeichnet, die diese Adresse liest“. DSH gibt die Adresse auf dem VPS aus, wo sie korrekt ist. Ihr Laptop liest dieselbe Zeichenfolge und verwendet seine eigene Loopback-Schnittstelle, auf der kein Prozess lauscht. Prüfen Sie die Serverseite auf dem VPS mit ss -ltnp | grep 3080. Eine Zeile mit 127.0.0.1:3080 bedeutet, dass DSH absichtlich auf die Loopback-Schnittstelle gebunden ist. Sie benötigen einen Tunnel oder einen Proxy, keine andere Bind-Adresse. Verwenden Sie anschließend die vollständige Start-URL mit ihrem Token.

Kann ich dsh web mit --host 0.0.0.0 ausführen?

Nein. Die am 4 November 2026 geprüfte CLI-Referenz des Repositorys besagt, dass --host eine konkrete lokale Adresse und keinen Wildcard-Wert enthalten muss und dass --host 0.0.0.0 mit einem Verwendungsfehler beendet wird. Das Webserver-Plugin lehnt dieselbe Adresse beim Laden seiner Konfiguration ab. Eine konkrete Adresse wie Ihre öffentliche IP wird akzeptiert. Ohne TLS wird darüber jedoch unverschlüsseltes HTTP bereitgestellt. DSH weist beim Start darauf hin. Dadurch wird das Start-Token, das eine Shell schützt, unverschlüsselt über das Netzwerk übertragen. Community-Plugins umgehen die Prüfung auf Wildcard-Werte. Wenn Sie ein solches Plugin verwenden, sind Sie selbst für die Firewall und die Transportsicherheit verantwortlich.

Warum liefern alle /api-Aufrufe hinter meinem Reverse Proxy HTTP 403 zurück?

Die Vertrauensgrenze /api lehnt jede Anfrage ab, deren Header Host weder eine Loopback-Adresse noch die Bind-Adresse des Listeners enthält und auch nicht in trustedHosts aufgeführt ist. Hinter einem Proxy enthält dieser Header Ihren öffentlichen Namen. Daher lehnt die Vertrauensgrenze die Anfrage ab, und der Browser protokolliert transport failure for /api/host.describe: HTTP 403. Starten Sie DSH mit --trusted-host <your name> und verwenden Sie darin denselben Namen wie in der Adresszeile. Ein Eintrag ohne Port entspricht diesem Namen an jedem Port. Ein Eintrag mit Port muss dagegen exakt mit Host und Port übereinstimmen. Wenn die Aufrufe stattdessen 401 zurückgeben, wurde die Vertrauensgrenze passiert. Dem Browser fehlt dann eine gültige Sitzung für diese Authority. Öffnen Sie die ausgegebene Start-URL mit ihrem Token.

Warum wird die DSH-Oberfläche über unverschlüsseltes HTTP geladen, startet aber nie vollständig?

Die aktuelle UUID-Implementierung von DSH verwendet crypto.getRandomValues(). Das funktioniert außerhalb sicherer Kontexte. Der frühere crypto.randomUUID()-Startfehler erklärt dieses Symptom daher nicht mehr. Prüfen Sie die fehlgeschlagenen Anfragen des Browsers: 403 weist auf die Host-/Origin-Vertrauensgrenze hin, 401 auf fehlende oder ungültige Anmeldedaten. Öffnen Sie die vollständige Start-URL mit ihrem Token und prüfen Sie --trusted-host anhand der im Browser sichtbaren Authority. Verwenden Sie für den Remotezugriff weiterhin HTTPS oder eine SSH-Weiterleitung. Unverschlüsseltes HTTP legt das Start-Token und das Sitzungscookie auf dieser Strecke weiterhin offen.

Welche Methode sollte ein einzelner Entwickler verwenden?

Die lokale SSH-Weiterleitung. Sie fügt dem Server nichts hinzu, ändert keine Firewall-Regel und verwendet den SSH-Schlüssel weiter, dem Sie bereits vertrauen. Führen Sie ssh -f -N -L 127.0.0.1:3080:127.0.0.1:3080 you@your-vps aus. Öffnen Sie anschließend die von DSH ausgegebene Start-URL http://127.0.0.1:3080/?token=... mit unverändertem Token. Wechseln Sie zu tailscale serve, sobald Sie die Oberfläche auf einem Telefon verwenden möchten oder der Zugriff auch dann bestehen soll, wenn der Laptop in den Ruhezustand wechselt.

War dieser Artikel hilfreich?