DeepSeek Harness privat auf einem VPS betreiben
Installieren Sie den DeepSeek Harness auf einem Linux-VPS, pinnen Sie die npm-Version, prüfen Sie Plugin-Rechte und öffnen Sie die Port-3080-Oberfläche per SSH-Tunnel.
Was das DeepSeek Harness ist
Das DeepSeek Harness (dsh) ist eine Node.js-Agent-Laufzeitumgebung, die Sie auf einem VPS (virtual private server) ausführen können. Die sichere Betriebsart bindet sie an 127.0.0.1. Ihr Browser erreicht sie dann über einen SSH-(secure shell)-Tunnel. Die Anwendung stellt eine Weboberfläche (user interface) auf Port 3080 bereit, statt in einem Terminal zu laufen. In der 0.1.0-rc.6-Version, auf die diese Anleitung festgelegt ist, fordert der Webserver kein eigenes Passwort an. Ein veröffentlichter Port 3080 stellt daher jedem, der ihn findet, einen Agenten zur Verfügung, der Ihre Dateien liest und Befehle als Ihr Linux-Benutzer ausführt. Neuere Versionen von 0.2.0-rc.2 bis 0.2.2-rc.2 vom 11 November 2026, der neuesten von GitHub am 12 November 2026 aufgeführten Version, geben beim Start eine URL mit einem neuen Token für diesen Prozess aus und tauschen ihn gegen ein Session-Cookie aus. Sie lauschen jedoch weiterhin standardmäßig auf Loopback und verweigern weiterhin die Bindung an alle Schnittstellen.
DeepSeek veröffentlicht die Software unter der MIT-Lizenz als npm-Paket @deepseek-ai/dsh. Das Projekt bezeichnet sich selbst als Entwicklervorschau und weist darauf hin, dass inkompatible Änderungen zu erwarten sind. Die unten festgelegte Version ist die Version vom August 2026. Am 12 November 2026 verweist der npm-Tag latest auf 0.2.2-rc.1. GitHub führt außerdem die neuere Prerelease 0.2.2-rc.2, die mit dsh-v0.2.2-rc.2 getaggt und am 11 November 2026 veröffentlicht wurde. Prüfen Sie das Repository, bevor Sie Teile davon auf ein wichtiges System kopieren.
Ein Grundgedanke zieht sich durch das gesamte Design: Alles ist ein Plugin. Der Modelladapter, die Tool-Registry, das Sitzungsprotokoll, die Sandbox, der Scheduler und auch die Agentenschleife selbst sind Plugins, die in einen gemeinsamen Kontext geladen werden. Jedes dieser Plugins kann ersetzt werden. Es gibt keinen privilegierten Kern, den Plugins lediglich erweitern. Das macht das Harness interessant für Tests. Genau darin liegt jedoch auch das einzige echte Risiko. Ob dieser Kompromiss für Sie sinnvoll ist, hängt davon ab, womit Sie das System vergleichen. Wie es im Vergleich zu Claude Code und Omnigent abschneidet stellt das Design, bei dem alles ein Plugin ist, zwei anderen Ansätzen gegenüber: der Bindung an ein Modell, der Lizenz und dem Ressourcenbedarf auf einem VPS.
Ein Harness ist kein Modell
Der Harness führt die Agent-Schleife aus. Die Schlussfolgerungen entstehen an anderer Stelle in einem Modell. Daher funktioniert nichts, bis Sie entweder einen API (Application Programming Interface)-Key oder die Adresse eines Modell-Endpunkts angeben, den Sie selbst hosten. Alles in diesem Beitrag betrifft die Harness-Konfiguration und nicht das Modellverhalten. Die Trennlinie zwischen beiden sollten Sie kennen, bevor Sie einen Nachmittag damit verbringen, zu ermitteln, auf welcher Seite ein Problem entstanden ist.
Sie konfigurieren das in der UI unter Settings und anschließend unter Models. DeepSeek verfügt über eine eigene Karte. In aktuellen Releases öffnet die Schaltfläche "Add model provider" darunter zwei Modi. "Third-party model provider" umfasst die Anbieter, für die der Harness einen Katalog bereitstellt, etwa OpenAI und Anthropic. Dort fügen Sie einen Key ein, und der Katalog liefert den Endpunkt sowie die Modellliste. "Custom model API" ist die interessante Option. Sie erwartet eine Provider-ID in Kleinbuchstaben, einen Anzeigenamen, eine Basis-URL, ein API-Protokoll, eine Zugangsdatenreferenz und mindestens ein Modell. Der Protokollauswahldialog bietet OpenAI Chat Completions, OpenAI Responses, Anthropic Messages und Gemini API. Sie können daher ein Gateway oder einen lokalen Server konfigurieren, der eines dieser Protokolle unterstützt. Für Endpunkte mit abweichenden Anfrageformaten sind Kompatibilitätseinstellungen erforderlich. Benutzerdefinierte Provider können außerdem den OpenAI-kompatiblen GET /models-Endpunkt abfragen, um die Modellliste automatisch auszufüllen.
So richten Sie den Harness auf ein Modell auf demselben VPS aus. Ollama stellt unter http://127.0.0.1:11434/v1/ eine OpenAI-kompatible API bereit. Das API-Key-Feld akzeptiert nach Konvention jede Zeichenfolge, ollama, weil der OpenAI-kompatible Client einen Wert verlangt und Ollama ihn ignoriert. Die Ollama-Dokumentation beschreibt außerdem ollama launch dsh. Dieser Befehl installiert @deepseek-ai/dsh, falls es fehlt, und startet es mit einem Ollama-Modell. Prüfen Sie daher, welche Version installiert wird, bevor Sie sich auf den folgenden Pin verlassen. Ob ein Modell, das klein genug für Ihren VPS ist, einen Agent ausreichend gut steuern kann, ist die schwierigere Frage. Der Unterschied zwischen Ollama und vLLM als lokalem Modellserver bestimmt, wie viel RAM diese Entscheidung kostet.
In der UI eingegebene Keys können nur geschrieben, nicht ausgelesen werden. Der Harness speichert sie in $DSH_HOME/.credentials.yaml. Die Einstellungen enthalten nur eine Zugangsdatenreferenz, die aktuelle Releases in die Patch-Datei des aktiven Profils schreiben: $DSH_HOME/profiles/<profile>/cordis.patch.yml (das Profil ist web für dsh web). $DSH_HOME ist standardmäßig auf ~/.dsh gesetzt. Behandeln Sie die Zugangsdaten-Datei wie eine Passwortdatei, denn sie ist eine: Jeder, der sie lesen kann, kann Ihr API-Budget verwenden. Wenn Sie diese Dateien direkt bearbeiten möchten, anstatt durch Settings zu klicken, zeigt die Anleitung zu dsh-Konfigurationsdateien, Keys und Modellendpunkten, welche Funktion jeder Key hat und welche Daten Ihren Rechner in den einzelnen Modi verlassen.
Voraussetzungen vor der Installation
- ein VPS mit Ubuntu 24.04 oder einem anderen aktuellen Linux-System sowie SSH-Zugriff
- Node.js 24.9 oder neuer, weil der Haupt-Branch des Projekts und
0.2.2-alpha.2jetzt>=24.9.0deklarieren und die CI Node 24 mit einer Kompatibilitätsprüfung unter Node 24.9 und Node 26 testet; einen Job für Node 22 gibt es nicht. Getaggte Releases bis0.2.1-rc.4führten Node 22.19 noch als zulässige Version auf, aber diese Version ist nicht mehr die Untergrenze, gegen die das Projekt gebaut wird - ein normales Benutzerkonto, nicht
root, weil der Agent Shell-Befehle unter dem Benutzerkonto ausführt, das den Prozess gestartet hat pnpmim PATH, wenn Sie Plugins installieren möchten, da der Plugin-Befehl dieses Programm über eine Shell aufruft- Port 3080 in Ihrer Firewall und in der separaten Netzwerk-Firewall Ihres Providers geschlossen
Das Ubuntu-24.04-Paket nodejs ist älter als für den Harness erforderlich. Installieren Sie Node in dieser Version daher über NodeSource oder nvm, statt apt install nodejs zu verwenden. Das offizielle Repository von Ubuntu 26.10 führt Node 24.19.0, was die Mindestversion Node 24.9 übertrifft. Wenn der VPS neu eingerichtet ist, sollten Sie SSH zuerst härten. Das dauert zehn Minuten. Der Tunnel, auf den Sie gleich angewiesen sind, ist nur so sicher wie der dahinterliegende SSH-Server.
DeepSeek Harness versionsgebunden auf einem VPS installieren
node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 webnpx lädt das Paket herunter und startet dessen dsh-Binärdatei. web ist ein Alias für --profile web. Damit wird die Browseranwendung gestartet, und der Prozess gibt die Adresse aus, auf der er Verbindungen entgegennimmt. Der Standardwert ist http://127.0.0.1:3080. Diese Zahlen sind eine verbindliche Festlegung und kein rein kosmetischer Standardwert. Warum dsh eine Loopback-Adresse ausgibt erklärt, auf welche Anfragen das Harness antwortet und auf welche nicht, bevor Sie vom Laptop aus danach suchen.
Legen Sie die Version fest. npx @deepseek-ai/dsh web verwendet die Version, auf die der Tag latest zum Zeitpunkt der Ausführung zeigt. Wenn das Projekt, aus dem Sie den Befehl ausführen, bereits eine Kopie installiert hat, verwendet npx stattdessen still diese Kopie. In beiden Fällen wählen Sie die Version nicht selbst. Außerdem hat das Projekt bereits mehrere Release-Kandidaten veröffentlicht und kündigt inkompatible Änderungen an. 0.1.0-rc.6 ist die hier festgelegte Version vom August 2026. Am 12. November 2026 zeigt latest auf 0.2.2-rc.1. Diese Version gibt beim Start eine URL mit Token aus. GitHub führt den neueren Prerelease 0.2.2-rc.2 auf. Wenn Sie zu einer anderen Version wechseln, sollten Sie das daher bewusst tun und zuvor das Repository prüfen. Bei einer festgelegten Version verhält sich der eingerichtete Server heute auch im nächsten Monat gleich. Ein Upgrade wird dadurch zu einer bewussten Entscheidung und nicht zu einer Änderung, die Sie erst nachträglich bemerken. Wenn ein Befehl mit festgelegter Version trotzdem den falschen Build startet oder die Installation vollständig verweigert, beschreibt Die üblichen Installations- und Versionsfehler von dsh, wie Sie den npx-Cache leeren und prüfen, welches npm mit Ihrem Node gebündelt ist.
Für den täglichen Betrieb installieren Sie das Paket einmal, statt es bei jedem Start erneut aufzulösen.
npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --helpDie zweite Zeile sollten Sie ausführen, da der Launcher und die Webanwendung unterschiedliche Optionssätze verwenden. dsh --help zeigt die Optionen des Launchers. dsh --profile web --help zeigt die von der Webanwendung unterstützten Flags. Dort finden Sie --port, --host und das wiederholbare --trusted-host.
Prüfen Sie jetzt, auf welcher Adresse der Prozess Verbindungen entgegennimmt.
ss -tlnp | grep 3080In der Spalte für die lokale Adresse sollte 127.0.0.1:3080 stehen. Wenn dort 0.0.0.0:3080 steht, nimmt die Benutzeroberfläche Verbindungen auf allen Interfaces entgegen. Dann schützen nur Ihre Firewalls sie noch vor dem Internet. Beenden Sie den Prozess, bevor Sie etwas anderes tun.
Warum Sie Port 3080 niemals veröffentlichen dürfen
Der Webserver in 0.1.0-rc.6 verfügt über keine Authentifizierungsschicht. Seine Konfiguration legt einen Listen-Host und einen Listen-Port fest. Das ist die gesamte Angriffsfläche. Die Zugriffskontrolle für Deployments außerhalb des Loopback-Bereichs erfolgt über eine separate Trusted-Host-Einstellung. Das ist keine Anmeldeseite.
Neuere Releases fügen eine solche Funktion hinzu. Ab 0.2.0-rc.2 gibt die Anwendung beim Start eine URL aus, die ein für diesen Prozess neu erzeugtes Token enthält. Der Browser, der diese URL öffnet, erhält ein signiertes Session-Cookie und wird anschließend zur gleichen Adresse ohne Token weitergeleitet. Eine Host/Origin-Sperre vor /api akzeptiert nur Loopback, die eigene Bind-Adresse des Listeners und die mit --trusted-host angegebenen Authorities. Das ist ein echtes Zugangstoken. Die Dokumentation des Projekts weist jedoch darauf hin, dass die ausgegebene URL nur für die vorgesehenen Benutzer bestimmt ist und dass unverschlüsseltes HTTP sie ohne Verschlüsselung überträgt. Seit 0.2.1-alpha.2 kann die Webanwendung außerdem an eine konkrete lokale Adresse gebunden werden und HTTPS mit --tls-cert und --tls-key selbst bereitstellen. Das behebt das Problem der unverschlüsselten Übertragung, nicht aber das Problem der Erreichbarkeit. Dadurch wird ein veröffentlichter Port schwieriger missbrauchbar. Er wird dadurch nicht zu etwas, das Sie veröffentlichen sollten.
Betrachten Sie nun auch, was hinter diesem Port läuft. Der Agent bearbeitet Dateien im Workspace und führt Shell-Befehle aus. Die Zugangsdaten Ihres Providers liegen daneben auf der Festplatte. Bei dem festgelegten Release ist ein offener Port 3080 daher eine Remote-Shell mit Chat-Oberfläche. Sie läuft unter dem Benutzerkonto, das sie gestartet hat, und verwendet Ihren API-Key. Dafür benötigt niemand einen Exploit. Die Portnummer reicht aus. Bei einem Release mit Starttoken wird zusätzlich das Token benötigt. Dieses besitzt jedoch bereits jeder, der Ihr Terminal, Ihre Service-Logs oder Ihren unverschlüsselten Netzwerkverkehr lesen kann.
Die CLI (command line interface) bestätigt diese Einschätzung. Seit 0.1.0-rc.6 unterstützt sie --host 0.0.0.0 absichtlich nicht und wird mit einem Usage-Fehler beendet, statt zu starten. Auch das neuere 0.2.2-alpha.2 weist diese Option beim Start weiterhin zurück. Diese Ablehnung ist eine Sicherheitsfunktion. Suchen Sie daher nicht nach einem Patch, der sie entfernt.
Zwei andere Deployments sind sinnvoll, wenn ein Tunnel nicht geeignet ist. Platzieren Sie den Rechner in einem privaten Overlay-Netzwerk. Dann besitzt er nur eine Adresse, die ausschließlich Ihre eigenen Geräte erreichen können. Genau das bietet ein selbst gehosteter Headscale-Steuerungsserver. Oder schalten Sie einen Reverse Proxy davor, der die Anfrage authentifiziert, bevor sie Port 3080 erreicht, beispielsweise ein Authentik-Server für Single Sign-On mit Forward Auth. Ein Reverse Proxy ohne Authentifizierung davor ist keine Sicherheitsmaßnahme. Er ist nur eine längere URL.
Zugriff auf das Web-UI über einen SSH-Tunnel
Führen Sie diesen Befehl auf Ihrem Laptop aus, nicht auf dem Server.
ssh -N -L 3080:127.0.0.1:3080 you@your-server-L öffnet Port 3080 auf Ihrem Laptop und leitet alle Verbindungen durch die verschlüsselte SSH-Sitzung weiter. Der Teil 127.0.0.1:3080 wird auf dem Server aufgelöst, sodass die Verbindung vom Loopback-Interface aus am Harness ankommt, exakt so, als säßen Sie direkt vor der Maschine. -N weist SSH an, keine Remote-Shell zu starten, da Sie ausschließlich die Weiterleitung benötigen.
Öffnen Sie anschließend http://127.0.0.1:3080 in Ihrem lokalen Browser. Bei einem Release mit Launch-Token öffnen Sie stattdessen die vollständige Startup-URL, die der Server ausgegeben hat, inklusive Token; wenn der Harness über SSH gestartet wurde, gibt er die Startup-Zeile weiterhin aus, versucht jedoch nicht, einen Browser für Sie zu öffnen. Falls Port 3080 auf Ihrem Laptop bereits belegt ist, ändern Sie die linke Zahl: ssh -N -L 3180:127.0.0.1:3080 you@your-server, und navigieren Sie dann zu http://127.0.0.1:3180, wobei Sie den Port in einer URL mit Token auf die gleiche Weise anpassen. Die Zahl auf der linken Seite ist lokal, die Zahl auf der rechten Seite gehört zum Server; daher wird nur die linke Zahl geändert.
Speichern Sie dies in ~/.ssh/config, um die Eingabe zu vereinfachen.
Host dsh
HostName 203.0.113.10
User deploy
IdentityFile ~/.ssh/id_ed25519
LocalForward 3080 127.0.0.1:3080Danach startet ssh -N dsh den Tunnel. Wenn ein Browser meldet, dass die Verbindung verweigert wurde, bedeutet dies meist, dass der Tunnel zwar aktiv ist, aber auf der Gegenseite kein Dienst lauscht, da SSH den Port unabhängig davon weiterleitet, ob der Harness läuft oder nicht. Überprüfen Sie den Server mit dem oben genannten Befehl ss.
Nach der Abmeldung weiterlaufendes Harness
Ein npx-Befehl wird zusammen mit Ihrer Shell beendet. Ein systemd-Benutzerdienst läuft weiter und startet das Harness nach einem Absturz oder Reboot erneut. Die Unit ist hier bewusst minimal gehalten. Wenn das Harness unter einem eigenen, eingeschränkten Konto laufen soll, die Version in der Unit festgelegt werden soll und durchsuchbare Logs benötigt werden, beschreibt die vollständige headless-systemd-Einrichtung für dsh dieses Vorgehen ausführlich.
loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dshenable-linger ist erforderlich, weil Benutzerdienste normalerweise beendet werden, sobald Ihre letzte Sitzung endet. Ohne diese Einstellung wird das Harness beendet, sobald Sie den Tunnel schließen. Übernehmen Sie den absoluten Pfad, den command -v dsh ausgibt, in die Unit. systemd durchsucht nicht den PATH, den Ihre Login-Shell erstellt.
[Unit]
Description=DeepSeek Harness web UI
After=network-online.target
[Service]
Type=simple
WorkingDirectory=%h/projects/site
ExecStart=/usr/local/bin/dsh web
Restart=on-failure
RestartSec=5
[Install]
WantedBy=default.targetWorkingDirectory ist nicht nur Kosmetik. Der dsh-Prozess verwendet sein Startverzeichnis als standardmäßigen Dateisystempfad. Wenn der Dienst im falschen Verzeichnis gestartet wird, verweist der Agent auf den falschen Ordner. Dieses Verzeichnis ist jedoch nur ein Standardwert: In einer neuen Web UI ist kein Workspace ausgewählt, bis Sie unter Choose workspace einen hinzufügen. Die Projektanleitung fordert Sie auf, das Verzeichnis hinzuzufügen, in dem Sie dsh gestartet haben. Die Anleitung enthält keinen Versionsmarker. Dieselbe Formulierung steht bereits in 0.1.0-rc.7. Daher ist sie auch in der angepinnten Version zu erwarten. Legen Sie das Projekt als Verzeichnis der Unit fest. Wählen Sie anschließend diesen Workspace in der UI aus.
systemctl --user daemon-reload
systemctl --user enable --now dsh
systemctl --user status dshEine Unit, die den Start verweigert, verwendet fast immer einen falschen ExecStart-Pfad oder eine Node-Version, die die Binärdatei ablehnt. journalctl --user -u dsh -n 50 nennt die jeweilige Ursache. Bei einer Version mit Launch-Token steht die tokenisierte Start-URL ebenfalls im Journal. Bei jedem Neustart wird eine neue URL ausgegeben. Dasselbe Vorgehen gilt für das dauerhafte Ausführen eines beliebigen Coding-Agenten auf einem VPS. Die Fehlerursachen sind identisch.
Was ein Plugin tun darf
Ein Plugin ist ein Modul, das Dienste, typisierte Ereignisse und umkehrbare Effekte zu einem gemeinsamen Kontext beiträgt. Die Erweiterungspunkte sollten Sie besonders genau prüfen:
- einen Model-Provider auf
ctx.llmregistrieren - modellseitig nutzbare Tools auf
ctx.toolshinzufügen - das Shell-Backend hinter
ctx.shellbereitstellen - Dateisystemzugriff oder Richtlinien hinter
ctx.fsbereitstellen - menschliche Befehle auf
ctx.commandsregistrieren - Hintergrundarbeiten über
ctx.jobsausführen - gestartete Prozesse mit einem
ctx.sandbox-Backend kapseln - Anfragen und Tool-Aufrufe über die Ereignisse
agent/*undtools/*abfangen - den dauerhaft gespeicherten Sitzungsstatus erweitern
- die Benutzeroberfläche über
ctx.agentssteuern
Lesen Sie diese Liste aus der Sicht eines Angreifers. Ein Plugin kann die Dateisystem- und die Shell-Schicht bereitstellen. Außerdem kann es sich in jeden Tool-Aufruf einschalten, den das Modell ausführt. Zwischen einem Plugin und diesen Schnittstellen steht kein Berechtigungsdialog, weil ein Plugin gewöhnlicher Node-Code ist, der im selben Prozess wie alle anderen Komponenten geladen wird. Ein Plugin zu installieren bedeutet, den Code eines Fremden mit den Berechtigungen Ihres Agents auszuführen. Die Berechtigungen Ihres Agents entsprechen den Berechtigungen Ihres Unix-Benutzers.
Dies ist dieselbe Vertrauensentscheidung wie beim Einbinden eines MCP-Servers in einen Agent auf einem VPS, wobei MCP für Model Context Protocol steht. Deshalb beginnt auch das sichere Ausführen eines Coding-Agents auf einem VPS mit dem Konto, unter dem der Agent läuft, und nicht mit dem Modell. Ebenso erklärt dies, warum npm-Supply-Chain-Angriffe auf Server besonders schwerwiegend sind: Der Installationsschritt stellt bereits die Kompromittierung dar, und es erscheint keine Rückfrage.
Aus welchen Quellen Plugins stammen
Plugins befinden sich in Profilen. Ein Profil ist eine benannte Zusammenstellung unter $DSH_HOME, standardmäßig ~/.dsh. In jedem Profilverzeichnis liegen die installierten Plugins außerhalb des Hauptbaums. Die CLI verwaltet sie, indem sie Ihre Argumente direkt an pnpm weitergibt und das Profilverzeichnis als Arbeitsverzeichnis verwendet.
dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-uiDa die Argumente unverändert an pnpm gelangen, verhalten sich add, remove, update und why wie in jedem pnpm-Projekt. Ein Plugin kann ein npm-Paket oder eine GitHub-Referenz sein. pnpm muss sich zunächst im PATH befinden. Unter Node 24 fügt corepack enable pnpm es dort ein. Node 25 wird nicht mehr mit Corepack ausgeliefert. Installieren Sie es unter Node 25 und neuer stattdessen mit npm install -g pnpm.
Die Suche erfolgt über ein GitHub-Topic. Plugin-Autoren fügen ihrem Repository das Topic dsh-plugin hinzu. Über dieses Topic finden Sie vorhandene Plugins. Ein Topic ist eine Bezeichnung, die ein Autor auf sein eigenes Repository anwendet. Niemand prüft oder signiert es. Die Topic-Seite sortiert nach Sternen. Diese messen die Popularität, nicht die Sicherheit.
Aktuelle Releases enthalten außerdem ein experimentelles Bundle mit benutzerdefinierten Plugin-Indizes. Aktivieren Sie es unter Plugins. Im Tab Discover können Sie dann einen Index hinzufügen. Dabei handelt es sich um eine JSON-Datei, die von einer von Ihnen angegebenen URL abgerufen wird. Das Harness liefert keinen eigenen Index mit. Es prüft das Format der Datei, nicht jedoch die von einem Markt angegebenen Titel, Autoren oder Quellen. Jeder, der den Netzwerkpfad kontrolliert, kann einen über unverschlüsseltes http: bereitgestellten Index ändern. Ein Markt ist ein von jemand anderem erstellter Katalog und keine Prüfung.
Vier Gewohnheiten halten den Aufwand überschaubar. Lesen Sie vor der Installation den Quellcode. Die meisten Plugins sind klein genug, um sie in zehn Minuten zu lesen. Fixieren Sie die exakte Version oder den Commit, statt einem Branch zu folgen. Führen Sie das Harness unter einem Benutzer aus, dem keine anderen Ressourcen gehören, und auf einem VPS, den Sie bei Bedarf neu aufsetzen würden. Geben Sie dem Agenten einen eigenen API-Schlüssel mit einem eigenen Ausgabenlimit. Trennen Sie ihn von dem Schlüssel Ihrer Produktivdienste. Wenn Sie ein Plugin prüfen und wissen möchten, welche Dateien das Risiko enthalten, behandelt die Anleitung zur Prüfung eines dsh-Plugins das Manifest, den Einstiegspunkt und die Erweiterungspunkte, die ein Plugin registriert.
Wenn Sie zunächst verschiedene Designs vergleichen möchten, beantwortet das Omnigent-Multi-Agent-Harness dasselbe Problem mit einer anderen Struktur. Die Unterschiede werden deutlich, sobald Plugins beteiligt sind. Wenn Sie schließlich zwei oder drei davon auf demselben System behalten, statt einen Gewinner auszuwählen, erspart Ihnen alle Harnesses hinter einer selbst gehosteten API zu betreiben einen Tunnel pro Port. Dafür muss ein weiterer Dienst an loopback gebunden und am ersten Tag mit einem echten Passwort geschützt werden.
Was zuerst ausfällt
Node ist zu alt. Der Haupt-Branch des Projekts und 0.2.2-alpha.2 erfordern Node 24.9 oder neuer. Die CI testet Node 24 sowie die Kompatibilität mit Node 24.9 und Node 26, aber nichts mit Node 22. Ältere getaggte Releases bis einschließlich 0.2.1-rc.4 führten Node 22.19 als zulässig auf. Das Projekt wird jedoch nicht mehr dafür gebaut. Eine ältere Runtime schlägt beim Start fehl, weil der Code Syntax und APIs verwendet, die sie nicht unterstützt. Führen Sie zuerst node --version aus.
Port 3080 ist bereits belegt. Möglicherweise verwendet ihn ein zweiter Harness, ein veralteter Prozess oder eine andere Anwendung. Ermitteln Sie den Prozess mit ss -tlnp | grep 3080. Stoppen Sie ihn oder starten Sie den Harness mit dsh web --port 3180 an einem anderen Port. --port gehört zur Webanwendung und folgt daher auf web.
Der Browser kann über den Tunnel keine Verbindung herstellen. Vergewissern Sie sich, dass Sie 127.0.0.1 und nicht die öffentliche Adresse des Servers aufgerufen haben. Der weitergeleitete Port existiert nur auf Ihrem Laptop. Prüfen Sie anschließend, ob der Harness auf dem Server lauscht. SSH richtet die Weiterleitung unabhängig davon ein, ob am entfernten Ende ein Dienst antwortet.
dsh plugin schlägt sofort fehl. Der Befehl ist ein Wrapper für pnpm. Fehlt die Binärdatei pnpm, wird der Befehl beendet, bevor die Plugin-Verarbeitung beginnt. In Node 25 und neuer ist das der Standardzustand, weil Corepack nicht mehr mit Node ausgeliefert wird.
Der Agent kann Ihr Projekt nicht sehen. Eine neue Web-UI hat zunächst keinen ausgewählten Workspace. Erst nachdem Sie einen Workspace hinzugefügt haben, ist der Sitzungs-Composer verfügbar. Der Prozess verwendet das Verzeichnis, in dem er gestartet wurde, nur als standardmäßigen Speicherort im Dateisystem. Wenn daher WorkingDirectory einer Unit auf Ihr Home-Verzeichnis zeigt, verweist der Agent auf Ihr Home-Verzeichnis. Wählen Sie den Workspace in der UI aus oder korrigieren Sie die Unit und laden Sie sie neu.
FAQ
Ist es sicher, die Weboberfläche von DeepSeek Harness an Port 3080 zu veröffentlichen?
Nein. In der festgelegten 0.1.0-rc.6 verfügt der Webserver über keine eigene Anmeldung. Der dahinter laufende Agent bearbeitet Dateien und führt Shell-Befehle mit dem Konto aus, das den Prozess gestartet hat. Ihr Provider-API-Schlüssel liegt auf derselben Festplatte. Ab 0.2.0-rc.2, einschließlich 0.2.2-rc.1, der npm-Version latest vom 12. November 2026 und der neueren 0.2.2-rc.2-Vorabversion enthält die ausgegebene Start-URL ein Starttoken. Der Browser tauscht es gegen ein Sitzungscookie aus. Diese URL ist jedoch eine Zugangsinformation, die unverschlüsseltes HTTP unverschlüsselt überträgt. Daher ändert sich die Empfehlung nicht. Lassen Sie den Listener auf 127.0.0.1 gebunden und greifen Sie über einen SSH-Tunnel darauf zu. Auch ein privates Overlay-Netzwerk oder ein Reverse Proxy, der jede Anfrage authentifiziert, bevor sie den Port erreicht, ist geeignet. Seit Version 0.1.0-rc.6 verweigert die CLI --host 0.0.0.0 und beendet sich mit einem Usage-Fehler. 0.2.2-alpha.2 lehnt die Option ebenfalls weiterhin ab. Das zeigt, wie die Autoren diese Vorgehensweise beurteilen.
Benötige ich einen DeepSeek-API-Schlüssel, oder kann ich ein lokales Modell verwenden?
Beides ist möglich, weil Harness eine Laufzeitumgebung und kein Modell ist. Unter Settings und anschließend Models können Sie im DeepSeek-Eintrag oder bei einem Kataloganbieter einen Schlüssel einfügen. Alternativ können Sie Add model provider und anschließend Custom model API auswählen und eine Base-URL angeben, die OpenAI Chat Completions, OpenAI Responses, Anthropic Messages oder Gemini API unterstützt. Ein lokaler Ollama-Server antwortet unter http://127.0.0.1:11434/v1/ und akzeptiert im Feld für den API-Schlüssel jede Zeichenfolge. Die Schlüssel werden in $DSH_HOME/.credentials.yaml gespeichert. Standardmäßig ist dies ~/.dsh/.credentials.yaml.
Was erhält ein DeepSeek-Harness-Plugin durch die Installation tatsächlich?
Die Berechtigungen des Kontos, unter dem Harness ausgeführt wird. Ein Plugin besteht aus Node-Code, der in denselben Prozess geladen wird. Zu den Erweiterungspunkten gehören das Shell-Backend, die Dateisystemschicht, die Tool-Registry und die Ereignisse, die jeden Tool-Aufruf umschließen. Nichts kapselt ein Plugin von diesen Schnittstellen, sofern das Plugin nicht selbst eine Sandbox bereitstellt. Lesen Sie den Quellcode, bevor Sie ein Plugin installieren. Führen Sie Harness unter einem Benutzer aus, der keine schützenswerten Daten besitzt.
Welche Version sollte ich installieren, und wird sie weiterhin funktionieren?
Installieren Sie eine exakte Version, zum Beispiel npx @deepseek-ai/dsh@0.1.0-rc.6 web. Dies ist die hier festgelegte Version vom August 2026. Am 12. November 2026 verweist der npm-Tag latest auf 0.2.2-rc.1. GitHub führt die neuere Vorabversion 0.2.2-rc.2, die am 11. November veröffentlicht wurde. Die aktuelle CLI benötigt Node 24.9 oder neuer. Das Projekt bezeichnet sich selbst als Entwicklervorschau und weist darauf hin, dass inkompatible Änderungen zu erwarten sind. Ein nicht festgelegter Befehl kann sich daher von einem Tag auf den nächsten anders verhalten. Prüfen Sie das Repository vor einem Upgrade. Rechnen Sie damit, dass sich Konfigurationsschlüssel und Plugin-Schnittstellen ändern, solange die Version noch mit 0 beginnt.