SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor · Atualizado 2026-11-06

Como executar o dsh sem terminal num VPS com systemd

Configure o dsh como serviço systemd no VPS, com utilizador dedicado, versão fixa, Restart, logs no journalctl e túnel SSH para a interface.

Executar dsh sem terminal num VPS

Executar dsh sem terminal num VPS requer um ficheiro de unidade do systemd e um utilizador dedicado para ser o proprietário do serviço. dsh é o iniciador de linha de comandos do DeepSeek Harness, o runtime de agentes da DeepSeek, publicado sob a licença MIT em developer preview em agosto de 2026. Um harness é o programa que envolve o modelo, e não o próprio modelo. Por isso, o que está a colocar sob o systemd é o ciclo, as ferramentas e as permissões, não a inferência da DeepSeek. O quickstart indica que deve introduzir npx @deepseek-ai/dsh web, o que está correto, mas o processo também termina assim que fechar a sessão SSH (secure shell).

Um ficheiro de unidade resolve quatro problemas ao mesmo tempo. O serviço volta a iniciar depois de um reboot. A saída é enviada para o journal, em vez de desaparecer do terminal. O serviço é executado por uma conta que não é root. E a versão executada é a versão que escolheu. Isto é especialmente importante neste caso, porque o projeto upstream avisa em letras maiúsculas:

O DeepSeek Harness está atualmente em developer preview e está a evoluir rapidamente. HAVERÁ ALTERAÇÕES INCOMPATÍVEIS.

Este guia pressupõe que o dsh já funciona quando o executa manualmente. Se isso não acontecer, comece por instalar o DeepSeek Harness num VPS e retome o procedimento quando npx @deepseek-ai/dsh web servir uma página.

Node primeiro, porque os avisos do npm não são suficientes

node -v

O pacote do próprio Ubuntu 24.04 é o Node 18 (18.19.1 em agosto de 2026), que é antigo para um pacote publicado este ano. O próprio npm verifica as versões do Node: a documentação informa que o campo engines de um pacote "só produz avisos", a menos que engine-strict seja ativado. Os manifestos @deepseek-ai/dsh publicados não têm nenhum campo engines (verificado em 27 de outubro de 2026 para 0.1.0-rc.7, 0.2.1-rc.2 e 0.2.1-rc.4), embora o repositório declare um. O npm também verifica os requisitos de engine das dependências. A versão 0.2.1-rc.2 fixada declara commander: ^15.0.0, e o Commander 15 requer o Node >=22.12.0. Por isso, instalá-lo no Node 18 do Ubuntu produz um aviso EBADENGINE com as configurações normais do npm. Por padrão, esse aviso não interrompe a instalação. Verifique o Node antes de encontrar uma falha em tempo de execução.

A versão mínima exigida pelo repositório também mudou. O código-fonte 0.2.1-rc.2 aceita ^22.19.0 || >=24.0.0, mas o pacote CLI no branch master agora declara >=24.9.0, requisito que o Node 22 não atende. Instale o Node 24 a partir do NodeSource. Essa é uma linha de suporte de longo prazo (LTS), em manutenção desde 20 de outubro de 2026, e as versões atuais atendem aos dois intervalos. O Node 26 tornou-se LTS em 28 de outubro de 2026, segundo o calendário de lançamentos do 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 -v

node -v agora deve exibir uma versão v24, 24.9.0 ou mais recente. A linha less existe porque enviar um script remoto diretamente para bash executa código que você não leu.

Confirme se ele é executado antes de escrever uma unidade

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

Deixe esse processo em execução. Em uma segunda sessão SSH:

curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/

Qualquer código de status HTTP significa que o perfil web está escutando no loopback, que é onde ele faz o bind por padrão. Espere um 401 e considere isso uma aprovação: a interface autentica os navegadores com um token de inicialização na URL exibida, que troca por um cookie de sessão assinado, e uma requisição que não contenha nenhum dos dois recebe um 401. 000 junto com curl: (7) Failed to connect to 127.0.0.1 port 3080 significa que ele não está escutando, e o primeiro terminal informa o motivo. Interrompa a execução manual com Ctrl+C antes de prosseguir: uma unidade que tenta fazer bind em uma porta já ocupada por outro processo falha com Error: listen EADDRINUSE: address already in use 127.0.0.1:3080.

0.1.0-rc.7 era a versão publicada em 18 August 2026 e é anterior à autenticação do navegador usada neste guia: o README de Connection informa que a barreira é uma política de acessibilidade e que "o Web carrier não fornece uma camada de autenticação". Em 11 October 2026, a tag latest apontava para 0.2.0-rc.2. Em 27 October 2026, latest apontava para 0.2.1-rc.2 e next para 0.2.1-rc.4, portanto os comandos aqui fixam 0.2.1-rc.2. Em 4 November 2026, a listagem de versões do npm mostra latest e next em 0.2.1-rc.5; os comandos aqui mantêm a versão fixada existente. Verifique o que está atual com npm view @deepseek-ai/dsh version e fixe a versão que decidir executar.

Instale globalmente a versão que fixou

npx é a ferramenta errada dentro de um ficheiro de unidade. Sem uma versão ou uma instalação local correspondente, resolve a versão do pacote quando o processo arranca. Assim, um reinício daqui a três meses pode iniciar uma compilação diferente de um agente em fase de pré-visualização, sem qualquer alteração da sua parte. Os pacotes em falta ou os dados da cache também exigem acesso ao registo do npm. Um registo lento pode atrasar ou impedir o arranque. O npm também suporta execução com cache e offline. Instale uma vez, com uma versão registada:

sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dsh

command -v dsh mostra /usr/bin/dsh quando o npm veio do NodeSource e /usr/local/bin/dsh quando veio do pacote do próprio Ubuntu. Use no ficheiro de unidade o caminho que o comando mostrou. npm ls -g mostra a versão exata. Essa é a informação de que precisará daqui a seis semanas, quando o comportamento mudar e já não se lembrar do que instalou. Se a instalação falhar, se command -v dsh não mostrar nada depois ou se a versão devolvida não for a que pediu, resolva as falhas habituais de instalação e versão do dsh antes de escrever o ficheiro de unidade.

Uma conta que pertence ao serviço e a mais nada

O agente executa comandos de shell. Essa é a sua função. Executá-lo como root transforma cada chamada de ferramenta numa chamada com privilégios de root. Por isso, atribua-lhe uma conta própria sem shell de 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 torna-se DSH_HOME, o diretório onde o dsh mantém os perfis. Um perfil é uma pilha nomeada de pacotes de plugins com a sua própria camada de patches, e os perfis web e headless são criados a partir dos templates fornecidos na primeira vez que são iniciados. Tudo o que adicionar posteriormente a essa pilha será executado por este utilizador, com o acesso do próprio agente aos ficheiros e à shell. Por isso, verificar um plugin antes de o instalar faz parte da mesma tarefa que criar a conta. O primeiro arranque grava ficheiros e pode obter pacotes. Faça-o manualmente, para poder acompanhá-lo.

sudo -u dsh env HOME=/var/lib/dsh DSH_HOME=/var/lib/dsh/harness /usr/bin/dsh --profile web

Defina HOME explicitamente, em vez de confiar no que sudo faz com esse valor, porque a forma como sudo preserva ou reescreve HOME depende de definições que incluem env_reset, env_keep e always_set_home em /etc/sudoers. Se definir o valor incorretamente, a primeira execução tenta usar o seu diretório pessoal para caches e estado. Isso causa erros de permissões ou coloca o estado num local que o serviço não utilizará posteriormente. Pare-o com Ctrl+C assim que a verificação curl apresentar um código de estado.

O arquivo da unidade

Escreva /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.target

ExecStart= usa o caminho absoluto obtido com command -v dsh. O systemd procura uma lista fixa de caminhos quando recebe apenas o nome de um comando, mas essa lista não é o PATH da sua shell. Por isso, um caminho absoluto elimina essa ambiguidade.

WorkingDirectory= é o diretório usado para resolver caminhos relativos. Também é o diretório inicial de uma chamada de ferramenta que executa ls sem argumentos. Aponte-o para o workspace disponibilizado ao agente. Se o diretório não existir ou o utilizador do serviço não puder aceder a ele, a unidade falhará com status=200/CHDIR antes mesmo de o dsh ser executado.

ProtectHome=true oculta /home e /root do processo. Isso é seguro neste caso porque tudo o que o serviço utiliza fica em /var/lib/dsh. Aponte o workspace para um caminho dentro de /home, e o agente informará que o diretório não existe. Isso pode ser confuso até que se lembre desta linha. ProtectSystem=full torna /usr, /boot e /etc somente de leitura, e o serviço nunca precisa escrever neles.

É tentador ir além, mas isso normalmente está errado. ProtectSystem=strict torna todo o sistema de ficheiros somente de leitura, exceto os pseudo-sistemas de ficheiros do kernel e, com PrivateTmp=true, /tmp e /var/tmp nesta unidade, faz com que as escritas no workspace falhem com EROFS: read-only file system. Se quiser esse nível de isolamento, adicione ReadWritePaths=/var/lib/dsh na mesma edição.

Qual Type= deve ser usado aqui

Type=exec, porque dsh permanece em primeiro plano e nunca faz fork. A vantagem em relação ao padrão é obter uma mensagem de erro real. Com Type=simple, o systemd considera o arranque bem-sucedido assim que o processo faz fork, antes de saber se o binário sequer existe. Assim, systemctl start dsh termina sem erro, e a falha aparece apenas no journal. Com Type=exec, o systemd espera que execve() seja concluído com sucesso. Portanto, um erro de digitação em ExecStart= faz falhar o comando que acabou de executar, e o erro fica visível nesse ponto.

As duas respostas erradas ficam bloqueadas. Type=forking faz o systemd esperar que um processo pai termine, mas o dsh nunca termina. Por isso, o arranque fica bloqueado até TimeoutStartSec expirar, o que ocorre após 90 segundos por padrão, e depois comunica Job for dsh.service failed because a timeout was exceeded.. Type=notify espera uma mensagem READY=1 através de sd_notify. Um processo Node que nunca envia essa mensagem fica bloqueado da mesma forma. A comparação completa dos tipos de serviço do systemd aborda os restantes casos, incluindo quando vale a pena configurar notify.

Regras de reinício que falham de forma explícita

Restart=on-failure reinicia após uma saída diferente de zero ou um sinal não limpo e deixa a unidade parada depois de uma saída limpa; o systemd trata SIGHUP, SIGINT, SIGTERM e SIGPIPE como sinais limpos para este tipo de serviço. Esse é o comportamento pretendido para uma compilação de pré-visualização. Se o dsh sair com o código 0 por ter lido uma configuração que não aceitou, a unidade para e permanece parada, e systemctl status dsh mostra inactive (dead), onde pode consultar o motivo. Restart=always transforma o mesmo evento num ciclo de reinícios que parece saudável à distância.

O limite de frequência é a parte que muitas pessoas omitem. Os valores predefinidos do systemd são cinco arranques em dez segundos e, com RestartSec=5s, nunca chega a cinco arranques numa janela de dez segundos. Assim, uma unidade que falha ao arrancar reinicia indefinidamente e apenas o journal regista o problema. StartLimitIntervalSec=300 com StartLimitBurst=5 permite cinco arranques em cinco minutos e, depois, recusa outro arranque durante esse intervalo. O systemd desiste e coloca a unidade no estado failed, registando Start request repeated too quickly.. Limpe esse estado com sudo systemctl reset-failed dsh depois de corrigir a causa. As duas definições pertencem a [Unit], não a [Service]; as opções não reconhecidas geram avisos nos logs em vez de serem ignoradas silenciosamente.

Inicie-o e verifique-o

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

O enable --now executa duas tarefas. O enable é o que restaura o serviço após um reboot, e o --now inicia-o nesta inicialização. Um systemctl start simples é perdido após o próximo reboot, e atualizações de kernel exigem reboots.

O systemctl status dsh deve exibir Active: active (running), um Main PID e uma linha Memory:. Em seguida, confirme onde ele está escutando:

sudo ss -lntp | grep 3080

Você deseja o 127.0.0.1:3080. Se visualizar qualquer outro endereço, uma flag --host moveu o listener para a rede à qual esse endereço pertence, servindo HTTP simples a menos que o TLS esteja configurado. O nome do processo nessa saída é node, não dsh, pois o binário dsh é um script Node, então o pgrep -x dsh não encontra nada. Use o systemctl show -p MainPID dsh em vez disso.

Depois, reinicie uma vez. Um serviço que nunca sobreviveu a um reboot ainda não é um serviço.

sudo reboot

Reconecte-se e execute o systemctl is-active dsh. Ele imprime active.

Lendo os logs com journalctl

Tudo o que o dsh escreve em stdout e stderr fica registado no journal com o nome da unidade.

journalctl -u dsh -f
journalctl -u dsh -n 200 --no-pager
journalctl -u dsh --since "10 min ago" -p err

-f acompanha as linhas novas, -n mostra as últimas N linhas e -p err filtra por prioridade. SyslogIdentifier=dsh na unidade faz com que essas linhas sejam marcadas como dsh em vez de node. Isto é importante na primeira vez que consultar a saída do journal sem filtrar por unidade.

Verifique se o journal sobrevive a reinícios antes de precisar dele:

journalctl -u dsh -b -1

Se isso imprimir Specifying boot ID or boot offset has no effect, no persistent journal was found, o journal está em /run e é eliminado em cada reinício. Com Storage=auto, crie o diretório e reinicie o daemon. Se Storage=volatile estiver configurado, altere-o primeiro para persistent:

sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journald

Execute sudo journalctl --flush para mudar para armazenamento persistente e gravar no disco os logs do boot atual.

Aceda à UI através de um túnel SSH, não de uma porta pública

O dsh disponibiliza a UI (interface de utilizador) web na 127.0.0.1:3080 por predefinição. O loopback é a predefinição, mas não a única escolha: a --host aceita um endereço IPv4 ou IPv6 concreto de uma interface local, e qualquer endereço que não seja o loopback serve a rede à qual pertence via HTTP simples, com um aviso no arranque, a menos que também passe a --tls-cert e a --tls-key. O que o dsh recusa é um wildcard. Se pedir a --host 0.0.0.0, o erro começa desta forma:

webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:

O erro continua dizendo que "vincular todas as interfaces exporia a execução remota de código à rede" e instrui a "vincular um endereço IPv4 ou IPv6 concreto de uma interface local". Um valor que não seja um IP literal, como um hostname, falha com a is not a concrete IPv4 or IPv6 address literal.

Mantenha a predefinição. A API (interface de programação de aplicações) web controla o agente, e o agente executa comandos de shell. O dsh coloca autenticação à frente dessa API: verificações de Host e Origin, além de um token de lançamento no URL impresso que a UI troca por um cookie de sessão assinado. Em HTTP simples, contudo, esse token atravessa a rede em texto simples, e a própria documentação do upstream diz que a verificação de Host não protege a porta de escuta em si. Se precisar da UI num hostname real, o guia de implementações públicas da DeepSeek cobre um reverse proxy com --public-url e --trusted-host, ou TLS nativo com --tls-cert e --tls-key. Vale a pena ler o que a linha 127.0.0.1:3080 na saída de arranque realmente significa antes de tentar movê-la. Para uma máquina que apenas você utiliza, encaminhe a porta a partir da sua própria máquina:

ssh -N -L 3080:127.0.0.1:3080 you@203.0.113.10

A -L 3080:127.0.0.1:3080 abre a porta 3080 no seu portátil e envia tudo o que chega lá para a 127.0.0.1:3080, conforme resolvido no VPS. A -N significa não executar nenhum comando remoto, para que a sessão apenas mantenha o túnel aberto. Deixe-o a correr, encontre o URL que o dsh imprimiu no arranque com a journalctl -u dsh -n 100 --no-pager e abra-o no seu browser. Esse URL contém o token de lançamento. Se abrir a http://127.0.0.1:3080/ pura num browser que não iniciou sessão, receberá um 401. O token pertence ao processo em execução, mas o cookie de sessão que ele compra sobrevive ao processo: o cookie é assinado com um segredo que o dsh mantém na $DSH_HOME/.credentials.yaml e dura 30 dias por predefinição, pelo que um browser que já tenha iniciado sessão pode abrir o URL puro novamente, mesmo após um reinício. Precisa de um URL novo do journal apenas para um novo browser, ou quando esse cookie expirar. Trate o URL como uma credencial: o upstream diz para partilhá-lo apenas com utilizadores pretendidos, e qualquer pessoa que consiga ler o journal do sistema consegue lê-lo. Assim que entrar, é aí que introduz a chave da API da DeepSeek, em Settings e depois Models, e onde escolhe o diretório de trabalho. Aponte o workspace para a /var/lib/dsh/workspace, o diretório que o utilizador do serviço possui, ou as ferramentas de ficheiros do agente falharão com a EACCES: permission denied.

Se a porta 3080 estiver ocupada no seu portátil, o ssh avisa:

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

Escolha uma porta local diferente com a ssh -N -L 3081:127.0.0.1:3080 you@203.0.113.10, depois abra o URL impresso com a 3080 alterada para a 3081. Guarde a digitação na ~/.ssh/config na sua própria máquina:

Host dsh-vps
  HostName 203.0.113.10
  User you
  LocalForward 3080 127.0.0.1:3080

Depois disso, a ssh -N dsh-vps é o comando completo. Este túnel é agora a única porta de entrada para o seu agente, pelo que o daemon SSH é o que o protege: apenas chaves, sem autenticação por palavra-passe, e o resto de reforçar o SSH no seu VPS aplica-se com mais força do que o habitual. Se esse VPS crescer para uma pequena rede privada própria, com uma base de dados ou uma máquina de staging atrás dele, anunciar esses endereços à sua tailnet com um subnet router poupa-lhe um encaminhamento por serviço, embora com o dsh na sua predefinição de loopback, a UI em si continue a chegar através de um túnel.

A chave não pertence ao ficheiro de unidade. Os valores da Environment= são impressos pela systemctl show dsh -p Environment, que qualquer utilizador na máquina pode executar. Se um plugin que instalar precisar de uma chave no ambiente, coloque-a na /etc/dsh.env com permissões 600, propriedade do root, e referencie-a com a EnvironmentFile=/etc/dsh.env. O systemd lê esse ficheiro como root no momento da execução, e a systemctl show não imprime o seu conteúdo. Que ficheiro no disco cada definição ocupa, e o que sai da sua máquina quando aponta o dsh para um endpoint local do Ollama em vez da API da DeepSeek, é o assunto de configurar as chaves, modelos e endpoints do dsh.

Quanto custa executar

A inferência ocorre na API da DeepSeek, não no seu VPS. O seu servidor consome recursos com o processo Node, a interface que serve e cada comando que o agente decide executar. Os dois primeiros custos são estáveis e baixos. O terceiro não tem qualquer limite definido neste ficheiro de unidade.

Meça o valor mínimo no seu próprio servidor, em vez de confiar num valor obtido noutro sistema:

systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2

MemoryCurrent é expresso em bytes. Monitorize-o enquanto o agente está a trabalhar, não quando está ocioso.

As chamadas de ferramentas são processos descendentes do serviço. Por isso, ficam no mesmo grupo de controlo e contam para os mesmos limites. Um agente que execute npm install ou uma suite de testes na área de trabalho pode usar muito mais memória do que o próprio harness. Num VPS com 1 GB, é nesse ponto que surgem as falhas: o kernel escolhe um processo e termina-o, e journalctl -k | grep -i "out of memory" mostra a linha Out of memory: Killed process, que identifica o processo escolhido. Muitas vezes, esse processo não é o que causou o problema.

A solução é definir deliberadamente um limite. MemoryMax= e CPUQuota= na secção [Service] mantêm o impacto dentro da unidade. Assim, uma compilação descontrolada é terminada, em vez de bloquear todo o servidor. Limitar a memória e a CPU com systemd explica os valores e o comportamento em caso de falha. O disco também cresce, devido ao histórico das sessões em DSH_HOME e ao que o agente grava na área de trabalho. Por isso, inclua du -sh /var/lib/dsh na ferramenta que já utiliza para monitorizar o disco.

Se pretende um agente interativo ao qual possa ligar-se e do qual possa desligar-se, um serviço não é o formato adequado. Executar um agente numa sessão tmux persistente é uma opção mais adequada. Execute o dsh como unidade quando quiser que esteja sempre ativo e acessível através de um túnel.

Modos de falha e as mensagens que você verá

status=203/EXEC. O systemd não conseguiu executar o ficheiro e regista Failed to locate executable /usr/local/bin/dsh: No such file or directory. O caminho em ExecStart= não corresponde ao que command -v dsh imprimiu. Esta é a falha que Type=exec reporta no momento systemctl start em vez de ocultar.

status=217/USER. O systemd falhou ao determinar ou alterar as credenciais de utilizador de User= e Group=, ou ao configurar o user namespacing. Para esta unidade, a causa habitual é uma conta que não existe. Confirme com id dsh.

status=200/CHDIR. WorkingDirectory= está em falta, ou o utilizador do serviço não consegue aceder ao diretório. sudo -u dsh ls /var/lib/dsh/workspace reproduz isso diretamente.

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080. Algo já ocupa a porta, normalmente a execução npx deixada aberta noutro terminal. sudo ss -lntp | grep 3080 identifica o processo.

EACCES: permission denied seguido de um caminho. A propriedade sob /var/lib/dsh está incorreta, normalmente porque uma primeira execução ocorreu como root ou com o HOME errado. sudo chown -R dsh:dsh /var/lib/dsh corrige isso.

Start request repeated too quickly. A unidade atingiu o limite de taxa de arranque e desistiu. O erro real encontra-se nas linhas acima. Execute sudo systemctl reset-failed dsh antes de tentar novamente.

A unidade está active (running) mas o browser não mostra nada. Execute a verificação no VPS: se curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ imprimir um código de estado, o listener responde no VPS, portanto verifique o reencaminhamento de porta a seguir. Esse código não prova que tudo foi carregado: o upstream indica que falhas em plugins opcionais não suprimem o estado de prontidão, por isso leia journalctl -u dsh -n 200 --no-pager para erros de plugins também. Um 401 no browser significa que não existe um cookie de sessão válido e o URL não continha um token de lançamento válido, seja porque abriu o URL base ou porque o token é anterior ao último reinício. Abra o URL que o processo atual imprimiu.

Atualizando intencionalmente

Fixar uma versão significa que uma atualização é algo que você faz, não algo que acontece com você. Leia as notas de lançamento primeiro, pois o próprio aviso do desenvolvedor sobre mudanças que quebram a compatibilidade é o motivo principal para a fixação. Faça backup do diretório de estado e, em seguida, troque a versão:

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-pager

Reverter é o mesmo processo npm install -g com a versão antiga, além de restaurar aquele arquivo tar, o que só funciona se você o tiver criado. Um runtime de agente em estágio de pré-visualização é exatamente o tipo de software onde uma atualização reescreve um formato de configuração enquanto você o utiliza.

FAQ

Por que o dsh para quando fecho a sessão SSH?

Porque npx @deepseek-ai/dsh web é um processo em primeiro plano pertencente à sua sessão de login. Por isso, é encerrado quando a sessão termina. Uma unidade systemd pertence ao sistema init, por isso continua em execução depois de desligar e volta a iniciar após um reboot. sudo systemctl enable --now dsh é o par de passos que fornece ambos: enable para o reboot e --now para este boot.

Devo usar Type=simple ou Type=exec para o dsh?

Type=exec. O dsh é executado em primeiro plano e nunca cria um processo filho, portanto ambos funcionam. No entanto, Type=exec faz o systemd esperar que execve() seja concluído com sucesso antes de considerar o arranque bem-sucedido. Um caminho incorreto em ExecStart= falha então systemctl start com status=203/EXEC à sua frente. Com Type=simple, o mesmo erro devolve sucesso e fica oculto no journal. Type=forking e Type=notify estão ambos errados neste caso e ficam bloqueados até TimeoutStartSec expirar, após 90 segundos por predefinição.

Como abro a interface web do dsh a partir do meu portátil?

Encaminhe a porta através de SSH: ssh -N -L 3080:127.0.0.1:3080 you@your-vps. Em seguida, abra no navegador o URL apresentado pelo dsh no arranque. Pode encontrá-lo com journalctl -u dsh. Esse URL contém o token de arranque. Um navegador que ainda não tenha iniciado sessão recebe um erro 401 sem esse token. Depois de iniciar sessão, o cookie da sessão dura 30 dias por predefinição e mantém-se após um reinício do serviço. Mantenha o serviço na predefinição de loopback. O dsh rejeita um wildcard como --host 0.0.0.0 por ser um endereço não especificado. Embora aceite um endereço local concreto, uma ligação a um endereço que não seja de loopback fornece HTTP simples se não configurar TLS. Nesse caso, o token de arranque de um agente que executa comandos shell através da rede é enviado em texto claro.

Posso executar o dsh como root para simplificar as permissões?

Não. O harness existe para executar comandos e escrever ficheiros. Portanto, todas as permissões do serviço também ficam disponíveis para o agente. Crie uma conta de sistema com useradd --system --shell /usr/sbin/nologin dsh, atribua-lhe a propriedade de /var/lib/dsh e adicione NoNewPrivileges=true à unidade. Se depois encontrar EACCES: permission denied, a causa habitual é uma execução anterior como root que deixou ficheiros pertencentes a root. sudo chown -R dsh:dsh /var/lib/dsh corrige o problema.

Que versão do dsh devo fixar na unidade?

Use a versão indicada por npm view @deepseek-ai/dsh version quando configurar o serviço. Instale-a com npm install -g @deepseek-ai/dsh@<that version> e registe-a num local que possa consultar. 0.1.0-rc.7 era a versão atual em 18 August 2026, 0.2.0-rc.2 em 11 October 2026 e 0.2.1-rc.2 em 27 October 2026, com next já em 0.2.1-rc.4. Em 4 November 2026, latest e next apontam ambos para 0.2.1-rc.5. Builds tão antigas como 0.1.0-rc.7 não têm autenticação no navegador. Por isso, não fixe uma dessas versões para o perfil web. O importante não é o número. O problema é que npx sem uma versão resolve o pacote no momento do arranque. Assim, um reinício não supervisionado pode mudar silenciosamente para uma build com um formato de configuração diferente.

Este artigo foi útil?