Esegui dsh su VPS con systemd senza terminale
Configura dsh come servizio systemd su un VPS: utente dedicato, versione bloccata, riavvio automatico, log con journalctl e tunnel SSH per la UI.
Esegui dsh senza terminale su un VPS
Eseguire dsh senza terminale su un VPS richiede un solo file di unità systemd e un utente dedicato che ne sia il proprietario. dsh è il launcher a riga di comando per DeepSeek Harness, il runtime per agenti di DeepSeek, pubblicato con licenza MIT in developer preview nell'agosto 2026. Un harness è il programma che circonda il modello, non il modello stesso. Pertanto, ciò che esegui tramite systemd sono il ciclo di esecuzione, gli strumenti e le autorizzazioni, non l'inferenza di DeepSeek. La guida introduttiva indica di digitare npx @deepseek-ai/dsh web, ed è corretto. Tuttavia, il processo termina non appena chiudi la sessione SSH (secure shell).
Un file di unità risolve quattro aspetti contemporaneamente. Il servizio viene riavviato dopo un reboot. Il suo output viene scritto nel journal invece di scorrere oltre il terminale. Il servizio viene eseguito con un account diverso da root. Inoltre, viene eseguita la versione scelta, un aspetto ancora più importante in questo caso perché il progetto upstream lo dichiara esplicitamente:
DeepSeek Harness è attualmente in developer preview e viene aggiornato rapidamente. CI SARANNO MODIFICHE CHE ROMPERANNO LA COMPATIBILITÀ.
Questa guida presuppone che dsh funzioni già quando lo avvii manualmente. In caso contrario, inizia da installare DeepSeek Harness su un VPS e torna qui quando npx @deepseek-ai/dsh web serve una pagina.
Prima Node, perché gli avvisi di npm non bastano
node -vIl pacchetto fornito da Ubuntu 24.04 contiene Node 18 (18.19.1 ad agosto 2026), una versione datata per un pacchetto pubblicato quest’anno. npm controlla effettivamente le versioni di Node: la documentazione indica che il campo engines di un pacchetto "produce soltanto avvisi" se non si abilita engine-strict. I manifest @deepseek-ai/dsh pubblicati non contengono affatto il campo engines (verifica effettuata il 27 ottobre 2026 per 0.1.0-rc.7, 0.2.1-rc.2 e 0.2.1-rc.4), anche se il repository ne dichiara uno; tuttavia npm controlla anche i requisiti del motore delle dipendenze. La release 0.2.1-rc.2 fissata dichiara commander: ^15.0.0 e Commander 15 richiede Node >=22.12.0, quindi l’installazione con il Node 18 di Ubuntu produce un avviso EBADENGINE con le impostazioni normali di npm. Per impostazione predefinita, l’avviso non interrompe l’installazione. Controlla quindi Node prima di arrivare a un errore in fase di esecuzione.
Anche la versione minima richiesta dal repository è cambiata. Il codice sorgente 0.2.1-rc.2 accetta ^22.19.0 || >=24.0.0, ma il pacchetto CLI sul branch master ora dichiara >=24.9.0, requisito non soddisfatto da Node 22. Installa Node 24 da NodeSource. È una linea long term support (LTS), in manutenzione dal 20 ottobre 2026, e le build attuali soddisfano entrambi gli intervalli. Node 26 è diventato LTS il 28 ottobre 2026, secondo il calendario delle release di Node.js.
curl -fsSL https://deb.nodesource.com/setup_24.x -o /tmp/nodesource_setup.sh
less /tmp/nodesource_setup.sh
sudo -E bash /tmp/nodesource_setup.sh
sudo apt install -y nodejs
node -vnode -v dovrebbe ora stampare una versione v24, 24.9.0 o successiva. La riga less è presente perché passare direttamente uno script remoto a bash esegue codice che non hai letto.
Verificare il funzionamento prima di scrivere una unit
npx @deepseek-ai/dsh@0.2.1-rc.2 webLascia il processo in esecuzione. Da una seconda sessione SSH:
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/Qualsiasi codice di stato HTTP indica che il profilo Web è in ascolto sull’interfaccia di loopback, che è quella usata per impostazione predefinita. È previsto un 401, che va considerato un risultato positivo: l’interfaccia autentica i browser con un token di avvio incluso nell’URL stampato, lo scambia con un cookie di sessione firmato e una richiesta priva di entrambi restituisce 401. La presenza di 000 insieme a curl: (7) Failed to connect to 127.0.0.1 port 3080 indica invece che il servizio non è in ascolto e che il primo terminale sta mostrando la causa. Arresta l’esecuzione manuale con Ctrl+C prima di proseguire: una unit che tenta di usare una porta già occupata da un altro processo termina con Error: listen EADDRINUSE: address already in use 127.0.0.1:3080.
0.1.0-rc.7 era la versione pubblicata il 18 agosto 2026 e precede l’autenticazione del browser richiesta da questa guida: il README Connection specifica che il fence è una policy di raggiungibilità e che "il Web carrier non fornisce alcun livello di autenticazione". L’11 ottobre 2026 il tag latest puntava a 0.2.0-rc.2. Il 27 ottobre 2026 latest puntava a 0.2.1-rc.2 e next a 0.2.1-rc.4, quindi i comandi riportati qui fissano 0.2.1-rc.2. Il 4 novembre 2026, l’elenco delle versioni di npm mostra sia latest sia next alla versione 0.2.1-rc.5; i comandi qui mantengono il pin esistente. Controlla la versione corrente con npm view @deepseek-ai/dsh version, quindi fissa quella che decidi di eseguire.
Installa globalmente la versione fissata
npx è lo strumento sbagliato all'interno di un file di unità. Senza una versione o un'installazione locale corrispondente, risolve la versione del pacchetto quando il processo viene avviato. Di conseguenza, un riavvio tra tre mesi può avviare una build diversa di un agent in fase di anteprima, senza alcuna modifica da parte tua. Anche i pacchetti mancanti o i dati nella cache richiedono il registry npm. Un registry lento può quindi ritardare o impedire l'avvio. npm supporta anche l'esecuzione dalla cache e in modalità offline. Esegui l'installazione una sola volta, usando una versione annotata:
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dshcommand -v dsh stampa /usr/bin/dsh quando npm proviene da NodeSource e /usr/local/bin/dsh quando proviene dal pacchetto fornito direttamente da Ubuntu. Nel file di unità usa il percorso stampato effettivamente dal comando. npm ls -g stampa la versione esatta. È il dato che ti servirà tra sei settimane, quando il comportamento cambia e non ricordi quale versione hai installato. Se l'installazione non riesce, se command -v dsh non stampa nulla in seguito oppure se la versione restituita non corrisponde a quella richiesta, consulta i consueti problemi di installazione e versione di dsh prima di scrivere il file di unità.
Un utente proprietario del servizio e di nient’altro
L’agente esegue comandi shell. Questo è il suo compito. Eseguirlo come root fa sì che ogni chiamata agli strumenti venga eseguita come root; assegnagli quindi un account dedicato senza shell di login.
sudo useradd --system --create-home --home-dir /var/lib/dsh --shell /usr/sbin/nologin dsh
sudo install -d -o dsh -g dsh -m 750 /var/lib/dsh/harness /var/lib/dsh/workspace
id dsh/var/lib/dsh/harness diventa DSH_HOME, la directory in cui dsh conserva i profili. Un profilo è uno stack denominato di bundle di plugin con un proprio livello di patch, mentre i profili web e headless vengono creati automaticamente a partire dai template forniti al primo avvio. Qualsiasi elemento aggiunto successivamente a quello stack verrà eseguito da questo utente con l’accesso ai file e alla shell dell’agente; per questo verificare un plugin prima di installarlo rientra nella stessa attività della creazione dell’account. Il primo avvio scrive file e potrebbe scaricare bundle, quindi eseguilo manualmente, in modo da poterlo monitorare.
sudo -u dsh env HOME=/var/lib/dsh DSH_HOME=/var/lib/dsh/harness /usr/bin/dsh --profile webImposta HOME in modo esplicito invece di affidarti a ciò che sudo fa con questa variabile, perché il comportamento di sudo, che può conservare o riscrivere HOME, dipende da impostazioni come env_reset, env_keep e always_set_home in /etc/sudoers. Se la imposti in modo errato, la prima esecuzione tenta di usare la home directory dell’utente per cache e stato, causando errori di autorizzazione o collocando lo stato in un percorso che il servizio non utilizzerà in seguito. Interrompilo con Ctrl+C quando il controllo curl stampa un codice di stato.
Il file dell’unità
Scrivi /etc/systemd/system/dsh.service:
[Unit]
Description=DeepSeek Harness (dsh) web profile
Documentation=https://github.com/deepseek-ai/deepseek-harness
After=network-online.target
Wants=network-online.target
StartLimitIntervalSec=300
StartLimitBurst=5
[Service]
Type=exec
User=dsh
Group=dsh
WorkingDirectory=/var/lib/dsh/workspace
Environment=HOME=/var/lib/dsh
Environment=DSH_HOME=/var/lib/dsh/harness
ExecStart=/usr/bin/dsh --profile web
Restart=on-failure
RestartSec=5s
TimeoutStopSec=30s
SyslogIdentifier=dsh
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=full
ProtectHome=true
[Install]
WantedBy=multi-user.targetExecStart= usa il percorso assoluto ottenuto da command -v dsh. systemd cerca un elenco di percorsi predefinito per i nomi semplici dei comandi, ma questo elenco non corrisponde a PATH della shell. Un percorso assoluto elimina quindi ogni ambiguità.
WorkingDirectory= è la directory da cui vengono risolti i percorsi relativi. È anche la directory iniziale di una chiamata allo strumento che esegue ls senza argomenti. Impostala sulla directory di lavoro che fornisci all’agente. Se la directory non esiste o l’utente del servizio non può accedervi, l’unità termina con status=200/CHDIR prima ancora dell’avvio di dsh.
ProtectHome=true nasconde /home e /root al processo. In questo caso è sicuro, perché tutto ciò che il servizio usa si trova sotto /var/lib/dsh. Imposta la directory di lavoro su un percorso sotto /home e l’agente segnalerà che la directory non esiste. Il motivo può risultare poco chiaro finché non si considera questa riga. ProtectSystem=full rende /usr, /boot e /etc di sola lettura, operazione che il servizio non deve eseguire in scrittura.
Applicare ulteriori restrizioni può sembrare utile, ma in genere è una scelta errata. ProtectSystem=strict rende di sola lettura l’intero filesystem, ad eccezione dei pseudo-filesystem del kernel e, con PrivateTmp=true, /tmp e /var/tmp di questa unità, quindi le scritture nella directory di lavoro terminano con EROFS: read-only file system. Se vuoi applicare questo livello di isolamento, aggiungi ReadWritePaths=/var/lib/dsh nella stessa modifica.
A quale Type= appartiene questa configurazione
Type=exec, perché dsh resta in primo piano e non esegue il fork. Il vantaggio rispetto all’impostazione predefinita è un messaggio di errore reale. Con Type=simple, systemd considera l’avvio riuscito non appena il processo ha eseguito il fork, prima di sapere se il binario esiste. Di conseguenza, systemctl start dsh termina senza errori e il problema compare soltanto nel journal. Con Type=exec, systemd attende che execve() abbia esito positivo. Un errore di battitura in ExecStart= fa quindi fallire il comando appena immesso e l’errore è visibile direttamente.
Le due risposte errate causano entrambe un blocco. Type=forking indica a systemd di attendere l’uscita di un processo padre. dsh non termina, quindi l’avvio resta bloccato finché non scade TimeoutStartSec (90 secondi per impostazione predefinita), dopodiché segnala Job for dsh.service failed because a timeout was exceeded.. Type=notify attende un messaggio READY=1 tramite sd_notify. Un processo Node che non ne invia alcuno si blocca nello stesso modo. Il confronto completo dei tipi di servizio systemd illustra gli altri casi, incluso quando vale la pena configurare notify.
Regole di riavvio che segnalano chiaramente gli errori
Restart=on-failure riavvia il servizio in caso di uscita diversa da zero o di arresto anomalo causato da un segnale, ma lascia l'unità ferma dopo un'uscita corretta; systemd considera SIGHUP, SIGINT, SIGTERM e SIGPIPE segnali di arresto corretto per questo tipo di servizio. Questo è il comportamento previsto per una build di anteprima. Se dsh termina con codice 0 perché ha letto una configurazione non valida, l'unità si arresta e rimane ferma, mentre systemctl status dsh mostra inactive (dead), dove è possibile verificare l'evento. Restart=always trasforma lo stesso evento in un ciclo di riavvio che, visto dall'esterno, sembra indicare che il servizio funzioni correttamente.
Il limite di frequenza è l'impostazione che spesso viene omessa. I valori predefiniti di systemd consentono cinque avvii nell'arco di dieci secondi; con RestartSec=5s non si raggiungono mai cinque avvii in una finestra di dieci secondi. Di conseguenza, un'unità che si arresta durante l'avvio viene riavviata senza fine e soltanto il journal registra il problema. StartLimitIntervalSec=300 con StartLimitBurst=5 consente cinque avvii in cinque minuti, quindi rifiuta gli avvii successivi durante lo stesso intervallo. systemd rinuncia e porta l'unità nello stato failed, registrando Start request repeated too quickly.. Dopo aver corretto la causa, cancellare questo stato con sudo systemctl reset-failed dsh. Entrambe le impostazioni appartengono a [Unit], non a [Service]; le opzioni non riconosciute generano messaggi di avviso nei log invece di essere ignorate senza segnalazioni.
Avvialo, quindi verifica il risultato
sudo systemctl daemon-reload
sudo systemctl enable --now dsh
systemctl status dshenable --now svolge due funzioni. enable riavvia il servizio dopo un reboot, mentre --now lo avvia nel boot corrente. Un semplice systemctl start non persiste dopo il reboot successivo, e gli aggiornamenti del kernel richiedono i reboot.
systemctl status dsh dovrebbe mostrare Active: active (running), una riga Main PID e una riga Memory:. Verifica quindi su quale indirizzo è in ascolto:
sudo ss -lntp | grep 3080Deve comparire 127.0.0.1:3080. Se compare un altro indirizzo, un flag --host ha spostato il listener sulla rete a cui appartiene quell'indirizzo. In assenza di TLS, il servizio espone HTTP in chiaro. Nell'output il nome del processo è node, non dsh, perché il binario dsh è uno script Node. Di conseguenza, pgrep -x dsh non trova nulla. Usa invece systemctl show -p MainPID dsh.
Esegui quindi un reboot. Un servizio che non ha mai superato un reboot non è ancora realmente operativo.
sudo rebootRiconnettiti ed esegui systemctl is-active dsh. Verrà visualizzato active.
Lettura dei log con journalctl
Tutto ciò che dsh scrive su stdout e stderr finisce nel journal con il nome dell'unità.
journalctl -u dsh -f
journalctl -u dsh -n 200 --no-pager
journalctl -u dsh --since "10 min ago" -p err-f segue le nuove righe, -n mostra le ultime N righe e -p err filtra per priorità. SyslogIdentifier=dsh nell'unità fa sì che queste righe siano contrassegnate con dsh invece di node. Questo è importante la prima volta che si legge l'output del journal senza filtrarlo per unità.
Verificare prima che il journal sopravviva ai riavvii:
journalctl -u dsh -b -1Se il comando restituisce Specifying boot ID or boot offset has no effect, no persistent journal was found, il journal si trova in /run e viene eliminato a ogni riavvio. Con Storage=auto, creare la directory e riavviare il demone. Se è configurato Storage=volatile, modificarlo prima impostandolo su persistent:
sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journaldEseguire sudo journalctl --flush per passare all'archiviazione persistente e scrivere su disco i log del boot corrente.
Raggiungere l'interfaccia tramite un tunnel SSH, non tramite una porta pubblica
dsh espone l'interfaccia web su 127.0.0.1:3080 per impostazione predefinita. Il loopback è l'impostazione predefinita, ma non l'unica: --host accetta un indirizzo IPv4 o IPv6 concreto di un'interfaccia locale e qualsiasi indirizzo diverso dal loopback rende il servizio disponibile alla rete a cui appartiene tramite HTTP in chiaro, con un avviso all'avvio, a meno che non si passino anche --tls-cert e --tls-key. dsh rifiuta invece un wildcard. Richiedendo --host 0.0.0.0, l'errore inizia così:
webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:Il messaggio prosegue spiegando che «il binding su ogni interfaccia esporrebbe l'esecuzione di codice da remoto alla rete» e indica di «eseguire il bind su un singolo indirizzo IPv4 o IPv6 concreto di un'interfaccia locale». Un valore che non è affatto un literal IP, ad esempio un hostname, restituisce invece is not a concrete IPv4 or IPv6 address literal.
Mantieni comunque l'impostazione predefinita. L'API web guida l'agent e l'agent esegue comandi shell. dsh protegge questa API con l'autenticazione: controlli su Host e Origin, oltre a un launch token incluso nell'URL stampato, che l'interfaccia scambia con un cookie di sessione firmato. Tuttavia, tramite HTTP in chiaro, quel token attraversa la rete in chiaro e la documentazione upstream precisa che il controllo Host non protegge la porta in ascolto. Se ti serve l'interfaccia su un hostname reale, la guida pubblica di DeepSeek per i deployment descrive un reverse proxy con --public-url e --trusted-host, oppure TLS nativo con --tls-cert e --tls-key. Vale la pena leggere Che cosa significa realmente la riga 127.0.0.1:3080 nell'output di avvio prima di provare a spostarla. Per un server che usi solo tu, inoltra invece la porta dal tuo computer:
ssh -N -L 3080:127.0.0.1:3080 you@203.0.113.10-L 3080:127.0.0.1:3080 apre la porta 3080 sul laptop e invia tutto ciò che arriva lì a 127.0.0.1:3080, risolto sul VPS. -N significa non eseguire alcun comando remoto, quindi la sessione mantiene aperto soltanto il tunnel. Lascialo in esecuzione, individua con journalctl -u dsh -n 100 --no-pager l'URL stampato da dsh all'avvio e aprilo nel browser. L'URL contiene il launch token. Aprendo il semplice http://127.0.0.1:3080/ in un browser che non ha effettuato l'accesso, si riceve un 401. Il token appartiene al processo in esecuzione, ma il cookie di sessione che consente di ottenere dura più a lungo: il cookie è firmato con un secret che dsh conserva in $DSH_HOME/.credentials.yaml e dura 30 giorni per impostazione predefinita. Di conseguenza, un browser che ha già effettuato l'accesso può aprire di nuovo l'URL semplice, anche dopo un riavvio. Serve un nuovo URL dal journal solo per un nuovo browser o dopo la scadenza del cookie. Tratta l'URL come una credenziale: upstream indica di condividerlo solo con gli utenti previsti e chiunque possa leggere il system journal può leggerlo. Una volta effettuato l'accesso, è qui che inserisci la chiave API di DeepSeek, in Settings e poi Models, e dove scegli la directory di workspace. Imposta il workspace su /var/lib/dsh/workspace, la directory di cui è proprietario l'utente del servizio, altrimenti gli strumenti per i file dell'agent restituiscono EACCES: permission denied.
Se la porta 3080 è già occupata sul laptop, ssh lo segnala:
bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080Scegli una porta locale diversa con ssh -N -L 3081:127.0.0.1:3080 you@203.0.113.10, quindi apri l'URL stampato modificando 3080 in 3081. Salva il comando in ~/.ssh/config sul tuo computer:
Host dsh-vps
HostName 203.0.113.10
User you
LocalForward 3080 127.0.0.1:3080Dopodiché ssh -N dsh-vps è l'intero comando. Questo tunnel è ora l'unico accesso al tuo agent, quindi a proteggerlo è il demone SSH: solo chiavi, nessuna autenticazione tramite password, e il resto di mettere in sicurezza SSH sul VPS si applica con particolare rigore. Se il VPS diventa una piccola rete privata autonoma, con un database o un server di staging dietro di esso, pubblicizzare quegli indirizzi alla tua tailnet con un subnet router evita un inoltro per ogni servizio, anche se con dsh sul loopback predefinito l'interfaccia continua a essere raggiungibile tramite un tunnel.
La chiave non deve essere inserita nel file dell'unità. I valori Environment= vengono stampati da systemctl show dsh -p Environment, che qualsiasi utente del server può eseguire. Se un plugin installato richiede una chiave nell'ambiente, inseriscila in /etc/dsh.env con permessi 600 e proprietario root, quindi referenziala con EnvironmentFile=/etc/dsh.env. systemd legge quel file come root al momento di exec e systemctl show non ne stampa il contenuto. Il file su disco in cui viene effettivamente salvata ciascuna impostazione e ciò che lascia il server quando si configura dsh per usare un endpoint Ollama locale invece dell'API di DeepSeek sono argomenti trattati in configurare chiavi, modelli ed endpoint di dsh.
Costi di esecuzione
L'inferenza viene eseguita tramite l'API di DeepSeek, non sul tuo VPS. Il server esegue il processo Node, l'interfaccia che pubblica e ogni comando che l'agente decide di eseguire. I primi due consumi sono costanti e contenuti. Il terzo non è limitato da alcuna impostazione in questo file di unità.
Misura il valore minimo sul tuo server invece di fidarti di un dato rilevato su un altro sistema:
systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2MemoryCurrent è espresso in byte. Monitoralo mentre l'agente è al lavoro, non quando è inattivo.
Le chiamate agli strumenti sono processi figli del servizio. Pertanto vengono inserite nello stesso gruppo di controllo e sono soggette agli stessi limiti. Un agente che esegue npm install o una suite di test nella directory di lavoro può utilizzare molta più memoria del processo di orchestrazione. Su un VPS da 1 GB è in questo punto che possono verificarsi i problemi: il kernel seleziona un processo e lo termina, mentre journalctl -k | grep -i "out of memory" mostra la riga Out of memory: Killed process che identifica il processo scelto. Spesso non si tratta del processo che ha causato il problema.
La soluzione consiste nell'impostare deliberatamente un limite. MemoryMax= e CPUQuota= nella sezione [Service] mantengono l'impatto all'interno dell'unità. In questo modo una compilazione fuori controllo viene terminata invece di bloccare l'intero server. Limitare memoria e CPU con systemd descrive i valori da usare e il comportamento in caso di errore. Anche l'utilizzo del disco aumenta, a causa della cronologia delle sessioni in DSH_HOME e dei file che l'agente scrive nella directory di lavoro. Pertanto aggiungi du -sh /var/lib/dsh allo strumento che già utilizzi per monitorare lo spazio su disco.
Se vuoi un agente interattivo a cui collegarti e da cui scollegarti, un servizio non è la soluzione adatta. In questo caso è preferibile eseguire un agente in una sessione tmux persistente. Esegui dsh come unità quando vuoi che sia sempre attivo e raggiungibile tramite un tunnel.
Modalità di errore e stringhe visualizzate
status=203/EXEC. systemd non ha potuto eseguire il file e i log Failed to locate executable /usr/local/bin/dsh: No such file or directory. Il percorso in ExecStart= non corrisponde a quello stampato da command -v dsh. Questo è l'errore che Type=exec segnala al momento systemctl start, invece di nasconderlo.
status=217/USER. systemd non ha potuto determinare o modificare le credenziali dell'utente da User= e Group=, oppure configurare lo user namespacing. Per questa unit, la causa abituale è un account inesistente. Verifica con id dsh.
status=200/CHDIR. WorkingDirectory= manca oppure l'utente del servizio non può accedervi. sudo -u dsh ls /var/lib/dsh/workspace riproduce direttamente il problema.
Error: listen EADDRINUSE: address already in use 127.0.0.1:3080. La porta è già utilizzata da un altro processo, di solito perché l'esecuzione di npx è rimasta aperta in un altro terminale. sudo ss -lntp | grep 3080 identifica il processo.
EACCES: permission denied seguito da un percorso. La proprietà degli elementi sotto /var/lib/dsh è errata, normalmente perché una prima esecuzione è avvenuta come root o con un HOME errato. sudo chown -R dsh:dsh /var/lib/dsh risolve il problema.
Start request repeated too quickly. L'unit ha raggiunto il limite della frequenza di avvio e ha interrotto i tentativi. L'errore reale si trova nelle righe precedenti. Esegui sudo systemctl reset-failed dsh prima di riprovare.
L'unit è active (running) ma il browser non mostra nulla. Esegui il controllo sul VPS: se curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ stampa un codice di stato, il listener risponde sul VPS, quindi controlla poi il port forwarding. Quel codice non dimostra che sia stato caricato tutto: l'upstream indica che gli errori dei plugin opzionali non impediscono lo stato ready, quindi leggi anche journalctl -u dsh -n 200 --no-pager per verificare gli errori dei plugin. Un 401 nel browser indica che non è disponibile un cookie di sessione valido e che l'URL non contiene un launch token valido, perché hai aperto l'URL di base oppure perché il token risale a prima dell'ultimo riavvio. Apri l'URL stampato dal processo corrente.
Aggiornare intenzionalmente
Il pinning significa che un aggiornamento è un'operazione controllata, non un evento imprevisto. Leggere prima le note di rilascio, perché l'avviso del progetto upstream sulle modifiche che rompono la compatibilità è il motivo stesso del pinning. Eseguire il backup della directory di stato, quindi sostituire la versione:
sudo systemctl stop dsh
sudo tar czf /root/dsh-home-$(date +%F).tgz -C /var/lib/dsh harness
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
sudo systemctl start dsh
journalctl -u dsh -n 50 --no-pagerIl rollback segue la stessa npm install -g con la versione precedente e richiede inoltre il ripristino di quel tarball; funziona soltanto se il tarball è stato creato. Un runtime agent in fase di anteprima è proprio il tipo di software in cui un aggiornamento può riscrivere il formato di configurazione senza preavviso.
FAQ
Perché dsh si arresta quando chiudo la sessione SSH?
Perché npx @deepseek-ai/dsh web è un processo in primo piano appartenente alla sessione di accesso, quindi viene terminato quando la sessione finisce. Un'unità systemd appartiene invece al sistema init. Per questo continua a funzionare dopo la disconnessione e viene riavviata dopo un reboot. sudo systemctl enable --now dsh è la coppia di passaggi che offre entrambe le cose: enable per il reboot e --now per questo avvio.
Devo usare Type=simple o Type=exec per dsh?
Type=exec. dsh viene eseguito in primo piano e non crea processi fork, quindi entrambe le opzioni funzionano. Tuttavia, Type=exec fa attendere systemd che execve() abbia esito positivo prima di considerare riuscito l'avvio. Un percorso errato in ExecStart= fa quindi fallire systemctl start, mostrando status=203/EXEC direttamente nel terminale. Con Type=simple lo stesso errore restituisce invece un esito positivo e rimane nascosto nel journal. Type=forking e Type=notify sono entrambi errati in questo caso e restano in attesa fino alla scadenza di TimeoutStartSec, che per impostazione predefinita è di 90 secondi.
Come apro l'interfaccia web di dsh dal laptop?
Inoltra la porta tramite SSH: ssh -N -L 3080:127.0.0.1:3080 you@your-vps, quindi apri nel browser l'URL stampato da dsh all'avvio. Puoi recuperarlo con journalctl -u dsh. L'URL contiene il token di avvio. Un browser che non ha effettuato l'accesso riceve un errore 401 se ne è privo. Dopo l'accesso, il cookie di sessione dura 30 giorni per impostazione predefinita e rimane valido dopo il riavvio del servizio. Lascia il servizio sull'impostazione predefinita di loopback. dsh rifiuta un wildcard come --host 0.0.0.0 perché rappresenta un indirizzo non specificato. Anche se accetta un singolo indirizzo locale concreto, un bind su un indirizzo non di loopback espone HTTP in chiaro se non configuri TLS. In questo modo il token di avvio di un agent che esegue comandi shell sulla rete viene trasmesso in chiaro.
Posso eseguire dsh come root per semplificare la gestione dei permessi?
No. L'harness serve a eseguire comandi e scrivere file. Di conseguenza, i privilegi del servizio sono anche i privilegi dell'agent. Crea un account di sistema con useradd --system --shell /usr/sbin/nologin dsh, assegnagli la proprietà di /var/lib/dsh e aggiungi NoNewPrivileges=true all'unità. Se in seguito ricevi EACCES: permission denied, la causa abituale è un'esecuzione precedente come root che ha lasciato file di proprietà di root. sudo chown -R dsh:dsh /var/lib/dsh li rimuove.
Quale versione di dsh devo fissare nell'unità?
Quella indicata da npm view @deepseek-ai/dsh version quando configuri il servizio, installata con npm install -g @deepseek-ai/dsh@<that version> e registrata in un punto che potrai individuare. 0.1.0-rc.7 era la versione corrente il 18 agosto 2026, 0.2.0-rc.2 l'11 ottobre 2026 e 0.2.1-rc.2 il 27 ottobre 2026; in quest'ultima data next era già alla versione 0.2.1-rc.4. Il 4 novembre 2026, sia latest sia next puntano a 0.2.1-rc.5. Le build vecchie fino a 0.1.0-rc.7 non dispongono dell'autenticazione del browser. Non fissarne quindi una per il profilo web. Il punto non è il numero della versione. È il fatto che npx senza una versione risolve il pacchetto al momento dell'avvio. Un riavvio non presidiato può quindi spostarti silenziosamente su una build con un formato di configurazione diverso.