SSD Nodes Learn Hosting plans →
Gidsen Matt ConnorDoor Matt Connor

DeepSeek Harness veilig installeren op een Linux VPS

Installeer DeepSeek Harness op uw VPS met een vaste npm versie. Leer hoe u poort 3080 via een SSH tunnel beveiligt en voorkom dat uw agent toegankelijk is voor buitenstaanders.

Wat de DeepSeek Harness is

De DeepSeek Harness (dsh) is een Node.js-agentruntime die u op een VPS (virtual private server) kunt draaien. De veilige manier om deze uit te voeren is door deze te binden aan 127.0.0.1, waarbij uw browser via een SSH (secure shell)-tunnel verbinding maakt. De software biedt een web-UI (user interface) op poort 3080 in plaats van in een terminal te draaien. In de 0.1.0-rc.6-release die in deze handleiding wordt gebruikt, vraagt de webserver niet om een eigen wachtwoord. Een opengezette poort 3080 geeft iedereen die deze vindt toegang tot een agent die uw bestanden leest en opdrachten uitvoert als uw Linux-gebruiker. Nieuwere releases, van 0.2.0-rc.2 tot en met 0.2.2-rc.2 van 11 november 2026, de nieuwste release die GitHub op 12 november 2026 vermeldt, tonen bij het opstarten een URL met een vers token voor dat proces en wisselen dit in voor een sessiecookie. Ze luisteren echter standaard nog steeds op loopback en weigeren nog steeds om aan alle interfaces te binden.

DeepSeek publiceert de software onder de MIT-licentie als het npm-pakket @deepseek-ai/dsh. Het project omschrijft zichzelf als een developer preview en geeft aan dat er wijzigingen te verwachten zijn die de compatibiliteit verbreken. De hieronder vastgelegde versie is de release van augustus 2026. Op 12 november 2026 wijst de latest-tag van npm naar 0.2.2-rc.1. GitHub vermeldt de nieuwere prerelease 0.2.2-rc.2, getagd als dsh-v0.2.2-rc.2 en uitgebracht op 11 november 2026. Controleer de repository voordat u de software kopieert naar een server die van belang is.

Eén concept vormt de kern van het ontwerp: alles is een plugin. De modeladapter, het toolregister, het sessielogboek, de sandbox, de scheduler en de agent-loop zelf zijn plugins die in één gedeelde context worden geladen; elk onderdeel kan worden vervangen. Er is geen bevoorrechte kern die enkel door plugins wordt uitgebreid. Dat is wat de harness het proberen waard maakt, maar het is ook waar het werkelijke risico schuilt. Of deze afweging de juiste is, hangt af van waar u het mee vergelijkt, en hoe het zich verhoudt tot Claude Code en Omnigent plaatst het 'alles-is-een-plugin'-ontwerp naast twee andere oplossingen wat betreft modelkoppeling, licenties en de systeemeisen die elk van deze tools aan een VPS stelt.

Een harness is geen model

Het harness voert de agent-loop uit. Het redeneren vindt elders in een model plaats, dus niets werkt totdat u een API (application programming interface) key of het adres van een door u zelf gehost model-endpoint opgeeft. Alles in dit bericht betreft de configuratie van het harness en niet het gedrag van het model. Het is verstandig om de grens tussen beide helder te hebben voordat u een middag besteedt aan het debuggen van de vraag aan welke kant een probleem is ontstaan.

U configureert dit in de UI onder Settings en vervolgens Models. DeepSeek heeft een eigen kaart en in huidige releases opent de knop "Add model provider" daaronder twee modi. "Third-party model provider" omvat de providers waarvoor het harness een catalogus meelevert, zoals OpenAI en Anthropic, waarbij u een key plakt en de catalogus het endpoint en de modellijst levert. "Custom model API" is de interessante optie: deze vereist een provider-ID in kleine letters, een weergavenaam, een base URL, een API-protocol, een credential en ten minste één model. De protocolkiezer biedt OpenAI Chat Completions, OpenAI Responses, Anthropic Messages en Gemini API, zodat u een gateway of lokale server kunt configureren die een van deze protocollen spreekt; endpoints met verschillen in request-format vereisen compatibiliteitsinstellingen. Custom providers kunnen ook het OpenAI-compatibele GET /models endpoint bevragen om de modellijst voor u in te vullen.

Zo wijst u het harness naar een model op dezelfde VPS. Ollama stelt een OpenAI-compatibele API beschikbaar op http://127.0.0.1:11434/v1/, en het veld voor de API key accepteert elke string, volgens conventie ollama, omdat de OpenAI-stijl client een waarde vereist en Ollama deze negeert. De eigen documentatie van Ollama beschrijft ook ollama launch dsh, dat @deepseek-ai/dsh installeert indien dit ontbreekt en het start tegen een Ollama-model. Controleer dus welke versie het installeert voordat u vertrouwt op de onderstaande pin. Of een model dat klein genoeg is voor uw VPS goed genoeg is om een agent aan te sturen, is de lastigere vraag, en het verschil tussen Ollama en vLLM als lokale modelserver bepaalt hoeveel van uw RAM het antwoord kost.

Keys die in de UI worden ingevoerd, zijn write-only. Het harness slaat ze op in $DSH_HOME/.credentials.yaml, en de instellingen bewaren alleen een credential-referentie, die huidige releases wegschrijven naar het patch-bestand van het actieve profiel, $DSH_HOME/profiles/<profile>/cordis.patch.yml (het profiel is web voor dsh web). $DSH_HOME is standaard ~/.dsh. Behandel het credentials-bestand als een wachtwoordbestand, want dat is het: iedereen die het leest, kan uw API-budget verbruiken. Als u die bestanden liever direct bewerkt in plaats van door de Settings te klikken, laat de walkthrough van dsh config-bestanden, keys en model-endpoints zien wat elke key doet en wat er in elke modus vanaf uw machine wordt verzonden.

Vereisten voor de installatie

  • een VPS met Ubuntu 24.04 of een andere actuele Linux-distributie, met SSH-toegang
  • Node.js 24.9 of nieuwer, omdat de main-branch van het project en 0.2.2-alpha.2 nu >=24.9.0 vereisen en de CI-tests Node 24 uitvoeren met een compatibiliteitscontrole op Node 24.9 en Node 26, zonder job voor Node 22; getagde releases via 0.2.1-rc.4 vermeldden voorheen Node 22.19 als acceptabel, maar dat is niet langer de ondergrens waar het project tegen bouwt
  • een normaal gebruikersaccount, niet root, omdat de agent shell-commando's uitvoert als de gebruiker die het proces heeft gestart
  • pnpm in de PATH als u van plan bent plugins te installeren, aangezien het plugin-commando dit aanroept via de shell
  • poort 3080 gesloten op uw firewall en op de afzonderlijke netwerkfirewall van uw provider

Het nodejs-pakket van Ubuntu 24.04 is ouder dan wat de harness nodig heeft, dus installeer op die release Node via NodeSource of nvm in plaats van apt install nodejs te gebruiken. De officiële repository van Ubuntu 26.10 bevat Node 24.19.0, wat voldoet aan het minimum van Node 24.9. Als de VPS vers is, is SSH beveiligen voor alle andere stappen tien minuten werk, omdat de tunnel waar u op gaat vertrouwen slechts zo veilig is als de SSH-server erachter.

De DeepSeek Harness installeren op een VPS, vastgezet op één versie

node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 web

npx downloadt het pakket en voert het dsh-binary uit. web is een alias voor --profile web, dat de browserapplicatie opstart; het proces toont vervolgens het adres waarop het luistert. De standaardwaarde is http://127.0.0.1:3080. Deze getallen zijn een bindende beslissing en geen cosmetische standaardinstelling. waarom dsh een loopback-adres toont beschrijft waar de harness wel en niet op reageert voordat u dit vanaf uw laptop probeert te benaderen.

Zet de versie vast. npx @deepseek-ai/dsh web lost op naar waar de latest-tag op dat moment naar wijst, tenzij het project waaruit u het uitvoert al een kopie heeft geïnstalleerd; in dat geval gebruikt npx stilzwijgend die kopie. Hoe dan ook, u kiest de versie niet zelf, en het project heeft al diverse release candidates uitgebracht en geeft aan dat er ingrijpende wijzigingen aankomen. 0.1.0-rc.6 is de versie van augustus 2026 die hier wordt vastgezet. Op 12 november 2026 wijst latest naar 0.2.2-rc.1, een release die een getokeniseerde opstart-URL toont; GitHub vermeldt de nieuwere prerelease 0.2.2-rc.2, dus overstappen naar een andere versie is precies het soort upgrade dat u bewust moet uitvoeren na het lezen van de repository. Een vastgezette versie betekent dat de server die u vandaag inricht, volgende maand hetzelfde gedrag vertoont, waardoor een upgrade een bewuste beslissing wordt in plaats van een toevallige ontdekking. Wanneer een vastgezet commando toch de verkeerde build start of weigert te installeren, behandelt de gebruikelijke dsh installatie- en versie-fouten het legen van de npx-cache en het controleren welke npm uw Node-bundels gebruikt.

Voor dagelijks gebruik installeert u het één keer in plaats van het bij elke start opnieuw op te lossen.

npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --help

De tweede regel is het uitvoeren waard, omdat de launcher en de web-app afzonderlijke sets vlaggen gebruiken. dsh --help toont de eigen opties van de launcher. dsh --profile web --help toont de vlaggen die de webapplicatie accepteert; hier bevinden zich --port, --host en de herhaalbare --trusted-host.

Bevestig nu waarop het luistert.

ss -tlnp | grep 3080

De kolom voor het lokale adres moet 127.0.0.1:3080 weergeven. Als hier 0.0.0.0:3080 staat, luistert de UI op alle interfaces. In dat geval staan alleen uw firewalls tussen de applicatie en het internet, en dient u het proces te stoppen voordat u verdergaat.

Waarom u poort 3080 nooit openbaar mag maken

De webserver in 0.1.0-rc.6 bevat geen authenticatielaag. De configuratie stelt een listen host en een listen port in, en dat is het volledige aanvalsoppervlak. Toegangscontrole voor implementaties die niet via localhost verlopen, is een afzonderlijke trusted-host instelling; dit is geen inlogscherm.

Nieuwere releases voegen dit wel toe. Vanaf 0.2.0-rc.2 print het opstartproces een URL die een vers token voor dat proces bevat; de browser die deze opent, ontvangt een ondertekend sessie-cookie en wordt omgeleid naar hetzelfde adres zonder het token. Een Host/Origin-filter voor de /api-routes accepteert alleen localhost, het eigen bind-adres van de listener en de autoriteiten die u opgeeft met --trusted-host. Dat is een echt inloggegeven, maar de documentatie van het project waarschuwt dat de geprinte URL een inloggegeven is dat u alleen met beoogde gebruikers moet delen, en dat platte HTTP dit zonder versleuteling verstuurt. Sinds 0.2.1-alpha.2 kan de web-app ook aan één concreet lokaal adres binden en zelf HTTPS aanbieden met --tls-cert en --tls-key. Dat lost het probleem van platte tekst op, maar niet de blootstelling. Het maakt een open poort lastiger te misbruiken. Het maakt het nog steeds geen poort die u openbaar moet maken.

Kijk nu naar wat er achter die poort draait. De agent bewerkt bestanden in de workspace en voert shell-commando's uit, en uw provider-inloggegevens staan op de schijf ernaast. Op de vastgezette release is een open poort 3080 dus een remote shell met een chat-interface, die draait onder de gebruiker die het proces startte, met uw API-sleutel gekoppeld. Niemand heeft een exploit nodig voor die situatie. Ze hebben alleen het poortnummer nodig. Op een release met het opstart-token hebben ze ook het token nodig, dat iedereen die uw terminal, uw service-logs of uw onversleutelde verkeer kan inzien, al in handen heeft.

De CLI (command line interface) bevestigt dit. Sinds 0.1.0-rc.6 ondersteunt deze opzettelijk geen --host 0.0.0.0 en sluit af met een gebruiks-foutmelding in plaats van op te starten, en de nieuwere 0.2.2-alpha.2 weigert dit nog steeds bij het opstarten. Die weigering is een functionaliteit, dus zoek niet naar een patch die dit verwijdert.

Twee andere implementaties zijn redelijk als een tunnel niet voor u werkt. Plaats de machine op een privaat overlay-netwerk zodat deze een adres heeft waar alleen uw eigen apparaten naartoe kunnen routeren; dit is wat een zelfgehoste Headscale control server u biedt. Of plaats er een reverse proxy voor die het verzoek authenticeert voordat het poort 3080 bereikt, bijvoorbeeld een Authentik single sign-on server die forward auth uitvoert. Een reverse proxy zonder authenticatie ervoor is geen beveiligingsmaatregel. Het is slechts een langere URL.

Toegang tot de web-UI via een SSH-tunnel

Voer dit uit op uw laptop, niet op de server.

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

-L opent poort 3080 op uw laptop en stuurt al het verkeer dat hiermee verbinding maakt door via de versleutelde SSH-sessie. Het 127.0.0.1:3080-gedeelte wordt op de server opgelost, waardoor de verbinding bij de harness aankomt vanaf loopback, precies alsof u achter de machine zelf zit. -N geeft aan dat er geen externe shell moet worden gestart, omdat u enkel de doorsturing wilt gebruiken.

Open vervolgens http://127.0.0.1:3080 in uw lokale browser. Bij een release met het opstarttoken opent u in plaats daarvan de volledige opstart-URL die de server heeft weergegeven, inclusief het token; wanneer de harness via SSH wordt gestart, wordt de opstartregel nog steeds getoond, maar wordt er niet geprobeerd een browser voor u te openen. Als poort 3080 al in gebruik is op uw laptop, wijzigt u het getal aan de linkerzijde: ssh -N -L 3180:127.0.0.1:3080 you@your-server, en navigeert u vervolgens naar http://127.0.0.1:3180, waarbij u de poort in een URL met token op dezelfde wijze aanpast. Het getal aan de linkerzijde is lokaal en het getal aan de rechterzijde hoort bij de server, dus alleen het linkergetal wordt gewijzigd.

Sla dit op in ~/.ssh/config zodat u het niet telkens hoeft in te typen.

Host dsh
  HostName 203.0.113.10
  User deploy
  IdentityFile ~/.ssh/id_ed25519
  LocalForward 3080 127.0.0.1:3080

Daarna start ssh -N dsh de tunnel. Als een browser meldt dat de verbinding is geweigerd, betekent dit meestal dat de tunnel actief is, maar dat er aan de andere kant niets luistert, omdat SSH de poort doorstuurt ongeacht of de harness draait. Controleer de server met het bovenstaande ss-commando.

De harness actief houden na het uitloggen

Een npx commando wordt beëindigd zodra uw shell sluit. Een systemd user service blijft actief en herstart de harness na een crash of reboot. De unit is hier bewust minimaal gehouden; als u wilt dat de harness onder een eigen, beveiligd account draait, met een vastgelegde versie in de unit en doorzoekbare logs, dan beschrijft de headless systemd setup voor dsh dit volledig.

loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dsh

enable-linger is van belang omdat user services normaal gesproken stoppen wanneer uw laatste sessie eindigt; zonder deze instelling stopt de harness zodra u de tunnel sluit. Gebruik het absolute pad dat door command -v dsh wordt getoond en plaats dit in de unit, aangezien systemd niet zoekt in het PATH dat uw login-shell opbouwt.

[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.target

WorkingDirectory is niet louter cosmetisch. Het dsh proces gebruikt de map van waaruit het wordt aangeroepen als standaardlocatie voor het bestandssysteem. Een service die op de verkeerde plek wordt gestart, wijst de agent dus naar de verkeerde map. Die map is echter slechts een standaardinstelling: een nieuwe Web UI heeft geen geselecteerde workspace totdat u er een toevoegt onder Choose workspace. De handleiding van het project instrueert u om de map toe te voegen waarin u dsh heeft gestart. De handleiding bevat geen versiemarkering en dezelfde tekst staat ook in 0.1.0-rc.7, dus verwacht dit ook bij de vastgelegde release. Stel de directory van de unit in op het project en selecteer vervolgens die workspace in de UI.

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

Een unit die niet wil starten, heeft bijna altijd een onjuist ExecStart pad of een Node versie die door het binary wordt geweigerd; journalctl --user -u dsh -n 50 geeft aan welke dit is. Bij een release met een launch token verschijnt in de journal ook de URL voor de token-gebaseerde opstart, en bij elke herstart wordt een nieuwe URL gegenereerd. Hetzelfde patroon is van toepassing op het actief houden van elke coding agent op een VPS, en de foutmodi zijn identiek.

Wat een plugin mag doen

Een plugin is een module die services, getypeerde events en omkeerbare effecten toevoegt aan een gedeelde context. De extensiepunten zijn de onderdelen die nauwkeurige bestudering vereisen:

  • registreer een modelprovider op ctx.llm
  • voeg modelgerichte tools toe op ctx.tools
  • lever de shell-backend achter ctx.shell
  • lever bestandssysteemtoegang of beleid achter ctx.fs
  • registreer menselijke commando's op ctx.commands
  • voer achtergrondtaken uit via ctx.jobs
  • omsluit gestarte processen met een ctx.sandbox-backend
  • onderschep verzoeken en tool-aanroepen via de agent/*- en tools/*-events
  • breid de duurzame sessiestatus uit
  • stuur de UI aan via ctx.agents

Lees deze lijst zoals een aanvaller dat zou doen. Een plugin kan de bestandssysteemlaag en de shell-laag leveren, en kan zich tussen elke tool-aanroep nestelen die het model doet. Er staat geen toestemmingsdialoogvenster tussen een plugin en deze koppelingen, omdat een plugin gewone Node-code is die in hetzelfde proces wordt geladen als al het andere. Het installeren van een plugin is het uitvoeren van code van een onbekende met de rechten van uw agent, en de rechten van uw agent zijn de rechten van uw Unix-gebruiker.

Dit is dezelfde vertrouwensbeslissing die u neemt bij het koppelen van een MCP-server aan een agent op een VPS, waarbij MCP staat voor het model context protocol. Dit is ook de reden waarom het veilig draaien van een coding agent op een VPS begint bij het account waaronder deze draait in plaats van bij het model, en waarom npm supply chain-aanvallen zo hard aankomen op servers: de installatiestap is het moment van de inbreuk, en er verschijnt geen enkele waarschuwing.

Herkomst van plugins

Plugins bevinden zich in profielen. Een profiel is een benoemde samenstelling die wordt opgeslagen onder $DSH_HOME, met ~/.dsh als standaardlocatie. Elke profielmap bevat de out-of-tree plugins die daarin worden geïnstalleerd. De CLI beheert deze door uw argumenten direct door te sturen naar pnpm, waarbij de profielmap als werkmap wordt gebruikt.

dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-ui

Omdat de argumenten ongewijzigd bij pnpm aankomen, gedragen add, remove, update en why zich zoals in elk pnpm-project. Een plugin kan een npm-pakket of een GitHub-referentie zijn. pnpm moet eerst aanwezig zijn op de PATH. Op Node 24 plaatst corepack enable pnpm deze daar. Node 25 distribueert Corepack niet langer; installeer het daarom op Node 25 en nieuwer met npm install -g pnpm.

Ontdekking verloopt via een GitHub-topic. Plugin-auteurs voegen het dsh-plugin-topic toe aan hun repository; door dit topic te doorzoeken, vindt u welke plugins beschikbaar zijn. Een topic is een label dat een auteur aan zijn eigen repository toekent. Niemand controleert of ondertekent dit, en de topic-pagina sorteert op sterren, wat populariteit meet in plaats van veiligheid.

Huidige releases bevatten ook een experimentele bundel voor Custom plugin indexes. Schakel deze in onder Plugins; via een Discover-tabblad kunt u een index toevoegen. Dit is een JSON-bestand dat wordt opgehaald van een door u opgegeven URL. De harness levert zelf geen index mee. Het controleert het bestandsformaat, maar niet de titels, auteurs of bronnen die een marktplaats claimt. Iedereen op het netwerkpad kan een index die via onbeveiligde http: wordt aangeboden, herschrijven. Een marktplaats is een catalogus die door iemand anders is geschreven, geen beoordeling.

Vier gewoontes houden dit beheerbaar. Lees de broncode voordat u installeert, aangezien de meeste plugins klein genoeg zijn om in tien minuten te lezen. Pin de exacte versie of commit in plaats van een branch te volgen. Draai de harness onder een gebruiker die geen andere rechten heeft, op een VPS die u zonder problemen opnieuw zou installeren. Geef de agent een eigen API-sleutel met een eigen bestedingslimiet, gescheiden van de sleutel die uw productieservices gebruiken. Als u een plugin wilt doorgronden en wilt weten welke bestanden risico's met zich meebrengen, doorloopt de walkthrough voor het controleren van een dsh plugin het manifest, het entry point en de extensiepunten die een plugin registreert.

Als u liever ontwerpen vergelijkt voordat u een keuze maakt, beantwoordt de Omnigent multi-agent harness hetzelfde probleem met een andere structuur. De afwegingen worden duidelijk zodra plugins in gebruik zijn. Als u uiteindelijk twee of drie van deze harnesses op dezelfde machine behoudt in plaats van één winnaar te kiezen, bespaart het plaatsen van elke harness achter één self-hosted API u een tunnel per poort. Dit gaat ten koste van één extra service die vanaf de eerste dag aan localhost moet worden gebonden en van een echt wachtwoord moet worden voorzien.

Wat gaat er als eerste kapot

Node is te oud. De main-branch van het project en 0.2.2-alpha.2 vereisen Node 24.9 of nieuwer. De CI test Node 24 plus een compatibiliteitscontrole op Node 24.9 en Node 26; er wordt niets getest op Node 22. Oudere getagde releases via 0.2.1-rc.4 vermeldden Node 22.19 als acceptabel, maar het project bouwt hier niet langer op. Een oudere runtime faalt bij het opstarten omdat de code syntaxis en API's gebruikt die niet aanwezig zijn. Voer node --version uit voordat u iets anders doet.

Poort 3080 is al in gebruik. Een tweede harness, een verouderd proces of een niet-gerelateerde applicatie gebruikt ook 3080. Zoek dit proces met ss -tlnp | grep 3080 en stop het, of start de harness elders met dsh web --port 3180. --port hoort bij de web-app, dus dit komt na web.

De browser kan geen verbinding maken via de tunnel. Bevestig dat u naar 127.0.0.1 bent genavigeerd en niet naar het publieke adres van de server, aangezien de geforwarde poort alleen op uw laptop bestaat. Controleer vervolgens of de harness op de server luistert, aangezien SSH de forward opzet ongeacht of er aan de andere kant antwoord komt.

dsh plugin faalt onmiddellijk. Het commando is een wrapper rond pnpm, dus een ontbrekend pnpm-binary stopt het proces voordat er enig plugin-werk begint. Op Node 25 en nieuwer is dit de standaardstatus, omdat Corepack niet langer wordt meegeleverd met Node.

De agent kan uw project niet zien. Een nieuwe Web UI heeft geen geselecteerde workspace totdat u er een toevoegt; de session composer blijft onbeschikbaar totdat u dit doet. Het proces gebruikt de directory waarin het is gestart alleen als standaardbestandslocatie. Een unit waarvan de WorkingDirectory uw home-directory is, wijst de agent dus naar uw home-directory. Kies de workspace in de UI, of corrigeer de unit en herlaad deze.

FAQ

Is het veilig om de DeepSeek Harness web-UI bloot te stellen op poort 3080?

Nee. In de vastgezette 0.1.0-rc.6 heeft de webserver geen eigen inlogprocedure. De agent erachter bewerkt bestanden en voert shell-commando's uit als de gebruiker die het proces heeft gestart, terwijl uw API-sleutel van de provider op dezelfde schijf staat. Vanaf 0.2.0-rc.2, inclusief 0.2.2-rc.1, de npm latest release op 12 november 2026, en de nieuwere 0.2.2-rc.2 prerelease, bevat de geprinte opstart-URL een opstarttoken dat de browser inruilt voor een sessiecookie. Die URL is echter een inloggegeven dat via onversleuteld HTTP wordt verzonden, dus het advies blijft ongewijzigd. Laat de listener op 127.0.0.1 staan en benader deze via een SSH-tunnel. Een privaat overlay-netwerk of een reverse proxy die elk verzoek authenticeert voordat het de poort bereikt, werkt ook. Sinds versie 0.1.0-rc.6 weigert de CLI --host 0.0.0.0 en sluit af met een gebruiks-foutmelding, en 0.2.2-alpha.2 wijst dit eveneens af; dit geeft aan hoe de auteurs over dit idee denken.

Heb ik een DeepSeek API-sleutel nodig, of kan ik een lokaal model gebruiken?

Beide werken, omdat de harness een runtime is en geen model. Onder Settings en vervolgens Models kunt u een sleutel plakken in de DeepSeek-kaart of een catalogusprovider, of kiezen voor "Add model provider" en vervolgens "Custom model API". Geef daar een basis-URL op die OpenAI Chat Completions, OpenAI Responses, Anthropic Messages of de Gemini API ondersteunt. Een lokale Ollama-server antwoordt op http://127.0.0.1:11434/v1/ en accepteert elke willekeurige string in het veld voor de API-sleutel. Sleutels worden opgeslagen in $DSH_HOME/.credentials.yaml, wat standaard ~/.dsh/.credentials.yaml is.

Wat krijgt een DeepSeek Harness-plugin precies aan rechten?

De rechten van het account dat de harness uitvoert. Een plugin is Node-code die in hetzelfde proces wordt geladen. De extensiepunten omvatten de shell-backend, de bestandssysteemlaag, het tool-register en de events die elke tool-aanroep omhullen. Niets isoleert een plugin van die onderdelen, tenzij de plugin zelf in een sandbox draait. Lees de broncode voordat u iets installeert en voer de harness uit als een gebruiker die geen toegang heeft tot gegevens die u belangrijk vindt.

Welke versie moet ik installeren en blijft deze werken?

Installeer een exacte versie, bijvoorbeeld npx @deepseek-ai/dsh@0.1.0-rc.6 web. Dat is de hier vastgezette versie van augustus 2026. Op 12 november 2026 wijst de npm latest tag naar 0.2.2-rc.1; GitHub vermeldt de nieuwere prerelease 0.2.2-rc.2, uitgebracht op 11 november, en de huidige CLI vereist Node 24.9 of nieuwer. Het project noemt zichzelf een developer preview en geeft aan dat er wijzigingen verwacht worden die de compatibiliteit verbreken. Een niet-vastgezet commando kan zich daarom van de ene op de andere dag anders gedragen. Controleer de repository voordat u upgradet en houd er rekening mee dat configuratiesleutels en plugin-interfaces kunnen wijzigen zolang de versie met 0 begint.

Was dit artikel nuttig?