dsh web: por que aparece http://127.0.0.1:3080
Veja por que o dsh mostra http://127.0.0.1:3080, como acessar a Web UI com tunel SSH e por que expor a porta 3080 publicamente e inseguro.
O que dsh web: http://127.0.0.1:3080 significa
Quando inicia o perfil Web do DeepSeek Harness numa VPS, é apresentada uma linha semelhante a esta e, em seguida, o processo fica à espera:
dsh web: http://127.0.0.1:3080/?token=...127.0.0.1 é o endereço de loopback. É o endereço que uma máquina utiliza para comunicar consigo própria. Um socket associado a 127.0.0.1 aceita ligações de processos nessa mesma máquina, e de nenhum outro local. Por isso, essa linha indica duas coisas ao mesmo tempo: onde a Web UI está a escutar e quem pode aceder-lhe. Apenas a máquina onde dsh está em execução. A parte ?token= no fim é uma credencial aleatória nova que o processo gera sempre que arranca. Mais abaixo explicamos este ponto.
É por isso que o URL não faz nada quando o cola no navegador do seu portátil. O 127.0.0.1 do portátil é o próprio portátil. O harness está a escutar no 127.0.0.1 da VPS, que é outra máquina com outra pilha de loopback. Não há nada avariado. É necessário transportar a ligação entre as duas máquinas.
O README oficial indica claramente o comportamento predefinido: "O comando inicia a Web UI em http://127.0.0.1:3080 por predefinição e abre-a no navegador predefinido numa execução local." Numa sessão SSH não existe um navegador para abrir, por isso o URL é apresentado para utilização manual. O endereço de bind vem do plugin de host do servidor web, @deepseek-ai/dsh-host-webserver. Na versão 0.2.0-rc.2, que este guia fixa, a chave host está documentada como "Host de escuta; os dois valores suportados são loopback e todas as interfaces". O valor predefinido é loopback, a menos que o altere. Se o conceito de portas for novo para si, como funcionam as portas no Linux explica o modelo de endereço e porta em que isto se baseia.
Por que a interface Web fica ligada apenas a localhost
dsh é um harness de agente, ou seja, o programa que envolve o modelo: controla o ciclo de execução, as chamadas de ferramentas e as permissões com que essas chamadas são executadas. O separador do navegador é uma superfície de controlo para um processo que executa comandos de shell, lê e grava ficheiros no diretório de trabalho que escolheu e consome a sua chave da API do modelo. Qualquer pessoa que consiga carregar essa página pode fazer tudo isso como o utilizador que executa dsh. A rede também não é a única forma de obter esse acesso: um plugin que instale é executado dentro do mesmo processo, com as mesmas permissões. Por isso, avaliar um plugin dsh antes de o instalar exige o mesmo cuidado que decidir em que endereço o servidor fica à escuta.
Por isso, a porta 3080 não é um painel apenas de leitura. Carregar essa página permite executar comandos no servidor.
Abra o URL apresentado e irá diretamente para a lista de sessões. Não existe ecrã de início de sessão nem contas de utilizador. O que protege a página é o token no final do URL: a página raiz troca-o por um cookie de sessão assinado e redireciona para um endereço limpo. Depois disso, todas as chamadas RPC e todos os fluxos WebSocket feitos pela interface sem um cookie válido recebem 401 Unauthorized. No entanto, nem tudo o que está nessa porta é protegido. A documentação do plugin Connection indica que os recursos estáticos continuam públicos. O próprio servidor Web não tem autenticação global nem política de origem. Por isso, cada plugin que possui uma rota aplica as suas próprias regras. Nessas rotas protegidas, o plugin Connection também responde 403 quando o cabeçalho Host não é um endereço de loopback nem um host que tenha autorizado explicitamente. Em loopback, isso é uma segunda camada sensata atrás do controlo de acesso real: o sistema operativo permite a passagem apenas a processos locais. Isso não é motivo para publicar a porta. O token fica no histórico de saída do terminal e em qualquer log que tenha capturado o texto apresentado no arranque. O guia de reverse proxy do próprio projeto indica que nem a verificação de Host nem o URL anunciado protegem a porta em que o servidor fica à escuta. A documentação do servidor Web avisa que associar o servidor a um endereço que não seja de loopback "continua a expor rotas não protegidas e recursos estáticos a essa rede". Além disso, em 0.2.0-rc.2 o plugin do servidor Web não tem TLS próprio. Os scanners automatizados analisam continuamente portas incomuns. Por isso, considere uma porta 3080 publicada como já descoberta.
Não abra a porta 3080 na firewall e não definahostdo servidor Web como0.0.0.0nem como o seu IP público num VPS público. Essa combinação deixa a execução de comandos no seu servidor a uma URL divulgada de distância de qualquer pessoa que se ligue.
As versões atuais já o orientam nesse sentido: a própria flag --host da aplicação Web recusa associar o servidor a todas as interfaces. No entanto, em 0.2.0-rc.2, a chave de configuração host do plugin do servidor Web ainda aceita 0.0.0.0, pelo que uma alteração na configuração ainda pode expô-lo. A documentação do servidor Web no branch predefinido do projeto e na versão 0.2.1-rc.5, para a qual a tag latest do npm aponta atualmente, vai mais longe: rejeita um endereço não especificado durante o carregamento e adiciona uma definição opcional tls. Continua a aceitar qualquer endereço concreto de uma interface local. Por isso, apontar host para o IP público do seu VPS expõe a interface da mesma forma.
O mesmo raciocínio aplica-se a qualquer runtime de agente que coloque num servidor. Por isso, executar um agente de programação em segurança num VPS começa pela mesma regra: a porta de controlo do agente permanece privada e algo em que confia encaminha-o até ela.
Como abro a interface Web do dsh a partir do meu portátil?
Existem três formas corretas, e todas mantêm o harness associado à interface loopback.
- Um túnel SSH. Nada de novo fica à escuta na interface pública, e já dispõe das credenciais. É esta a opção a utilizar.
- Uma rede overlay privada, para que a interface seja acessível a partir dos seus próprios dispositivos e permaneça invisível para todos os outros.
- Um reverse proxy que termina o TLS (transport layer security) e exige uma palavra-passe antes de encaminhar qualquer pedido.
A diferença entre estas opções é o mecanismo que transporta o browser até à interface loopback. Nenhuma deve envolver a remoção do harness da interface loopback.
Aceder através de um túnel SSH
Execute isto no seu portátil, não no VPS:
ssh -N -L 3080:127.0.0.1:3080 you@your-vpsDeixe-o em execução e abra no navegador local o URL completo dsh apresentado, http://127.0.0.1:3080/?token=... com o token incluído. A Web UI é carregada, troca o token por um cookie de sessão e remove o token da barra de endereços. O navegador envia 127.0.0.1:3080 como Host, que é loopback, por isso o túnel passa a verificação do Host sem configuração adicional.
O argumento -L contém três campos separados por dois-pontos. O primeiro é a porta a abrir no portátil. O segundo e o terceiro são o endereço e a porta para os quais cada ligação deve ser encaminhada. O detalhe importante é o seguinte: 127.0.0.1 no campo do meio é resolvido pelo servidor SSH no VPS, depois de o tráfego já ter chegado ao VPS. Refere-se ao loopback do VPS, não ao do seu portátil. Esse é precisamente o endereço apresentado por dsh, razão pela qual o túnel funciona quando uma ligação direta do navegador não funciona.
-N informa o SSH para não executar um comando remoto. Assim, obtém um encaminhador sem shell. Para um túnel em segundo plano que falhe de forma explícita, em vez de falhar silenciosamente:
ssh -N -f -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -L 3080:127.0.0.1:3080 you@your-vps-f coloca-o em segundo plano depois da autenticação. ExitOnForwardFailure=yes é mais importante do que parece: sem essa opção, o SSH liga-se com sucesso mesmo quando o encaminhamento não pôde ser configurado. Assim, obtém uma sessão funcional e um túnel inativo sem qualquer aviso. ServerAliveInterval=30 envia uma mensagem de keepalive a cada 30 segundos, para que um túnel inativo sobreviva aos timeouts de NAT (network address translation) nos routers de cafés e hotéis.
O que deve ver
No VPS, confirme o que está efetivamente à escuta:
ss -ltnp | grep 3080Um resultado correto indica o endereço de loopback:
LISTEN 0 511 127.0.0.1:3080 0.0.0.0:* users:(("node",pid=1042,fd=21))Se a coluna do endereço local indicar 0.0.0.0:3080, a Web UI está disponível em todas as interfaces, incluindo a interface pública. O IP público do VPS nessa coluna significa a mesma exposição. Pare o serviço e corrija o bind antes de fazer qualquer outra coisa. Se ss apresentar o socket mas deixar o campo users: vazio, execute-o com sudo, porque, caso contrário, o nome do processo de um socket pertencente a outro utilizador fica oculto.
Quando o túnel não inicia
O SSH apresenta esta mensagem e termina:
bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080Isto diz respeito ao seu portátil, não ao servidor. Algo local já está a utilizar a porta 3080, muitas vezes um túnel anterior que ficou esquecido. Escolha outra porta local livre:
ssh -N -L 3081:127.0.0.1:3080 you@your-vpsApenas o primeiro campo mudou. Agora, navegue para http://127.0.0.1:3081/?token=..., com o mesmo token, enquanto o harness continua à escuta na porta 3080. Os dois números não têm de coincidir. O cookie de sessão está associado ao host e à porta presentes na barra de endereços. Por isso, uma nova porta local requer novamente o URL com o token.
Se o túnel iniciar, mas o navegador indicar uma ligação recusada ou uma resposta vazia, o tráfego atravessou o VPS e não encontrou nada na outra extremidade. Ou dsh terminou, ou ficou associado a uma porta diferente. Verifique com ss -ltnp | grep 3080 no servidor. Se a página responder com 401 Unauthorized, o túnel está correto e o navegador simplesmente não tem um cookie válido para esse endereço: abra novamente o URL apresentado, com o token incluído. Depois de um reinício, obtenha o URL da nova saída, porque cada processo gera um token novo.
Há ainda outro problema frequente. Um npx @deepseek-ai/dsh web em primeiro plano termina quando a shell é fechada, por isso o harness para assim que termina a sessão. Inicie-o dentro de tmux ou através de um serviço de utilizador do systemd. É o mesmo problema resolvido em manter um agente de programação em execução num VPS. Com o systemd, a linha dsh web:, incluindo o token, fica registada no log do serviço. Leia-a a partir daí. Enquanto trabalha no SSH, vale a pena reforçar a segurança do SSH no seu VPS primeiro, porque o túnel faz do seu login SSH a única porta de acesso ao agente.
Aceder através de uma rede overlay privada
Uma rede overlay atribui ao seu VPS e ao seu portátil endereços numa rede privada à qual apenas os seus dispositivos aderem. Tailscale é a opção habitual, e o comando serve adapta-se exatamente a este caso: tailscaled é executado no VPS e liga-se ao próprio localhost:3080, mantendo assim o harness na interface de loopback.
tailscale serve --bg localhost:3080
tailscale serve statusA interface fica acessível através do nome da sua máquina dentro da sua tailnet, usando HTTPS, sem nenhuma porta aberta na interface pública. Para isso, é necessário ativar certificados HTTPS para a sua tailnet; caso contrário, serve não terá nenhum certificado para apresentar. Como o navegador passa a enviar esse nome da tailnet no cabeçalho Host, inicie o harness com esse nome na lista de nomes confiáveis. Caso contrário, as chamadas à API recebem 403. Uma entrada sem porta corresponde a qualquer porta:
npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host your-vps.your-tailnet.ts.netEm seguida, abra https://your-vps.your-tailnet.ts.net/?token=... e transfira o token da linha apresentada. Para o desativar, repita o comando com off:
tailscale serve --https=443 offUse serve, nunca funnel. O Funnel publica o mesmo destino na Internet pública. Isso coloca um runtime de agente numa porta aberta, protegido apenas por um token incluído no URL. Os dois comandos parecem quase iguais, mas têm efeitos opostos. Por isso, leia a diferença entre Tailscale Serve e Funnel antes de executar qualquer um deles. Tailscale como rede privada explica a própria configuração.
Aceda através de um reverse proxy que valida uma palavra-passe
Esta é a opção que publica efetivamente uma porta na Internet. A autenticação é a única barreira entre um desconhecido e a execução de comandos no seu servidor. Escolha-a quando várias pessoas precisarem da interface e um túnel individual para cada pessoa não for prático.
O harness permanece em 127.0.0.1:3080. O nginx é executado no mesmo sistema, por isso pode aceder ao loopback, e escuta na porta 443 com um certificado e um ficheiro de palavras-passe.
server {
listen 443 ssl;
server_name dsh.example.com;
ssl_certificate /etc/letsencrypt/live/dsh.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/dsh.example.com/privkey.pem;
auth_basic "dsh";
auth_basic_user_file /etc/nginx/dsh.htpasswd;
location / {
proxy_pass http://127.0.0.1:3080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_read_timeout 3600s;
proxy_buffering off;
}
}Crie o ficheiro de palavras-passe e recarregue a configuração:
sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/dsh.htpasswd you
sudo nginx -t && sudo systemctl reload nginxnginx -t deve apresentar syntax is ok seguido de test is successful. Um recarregamento com um ficheiro inválido falha e mantém a configuração em execução. Por isso, leia o erro em vez de reiniciar sem verificar.
Três dessas linhas do proxy são necessárias. Os cabeçalhos Upgrade e Connection permitem concluir o handshake WebSocket. Sem eles, a página é carregada, mas nunca é atualizada. proxy_read_timeout 3600s aumenta o timeout de inatividade do nginx de 60 segundos para uma hora. Não limita a duração total de uma execução do agente. A versão fixada 0.2.0-rc.2 já envia pings WebSocket a cada dois segundos por predefinição, mantendo essa ligação ativa durante uma etapa longa do agente. proxy_buffering off desativa o buffering das respostas HTTP encaminhadas pelo proxy. Não controla os frames WebSocket. Uma configuração de reverse proxy do nginx, linha a linha explica o restante, e escolher entre nginx, Caddy e Traefik explica como fazer o mesmo com certificados automáticos.
O harness também precisa de conhecer o proxy. proxy_set_header Host $host encaminha o nome apresentado ao navegador sem alterações. É isso que o guia de proxy do projeto exige. Por isso, inicie dsh com esse nome como confiável. Caso contrário, responde 403:
npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host dsh.example.comCada pessoa abre https://dsh.example.com/?token=... uma vez, usando o token da linha dsh web:. Depois disso, o navegador mantém o cookie de sessão. O backend define esse cookie sem o atributo Secure, e o guia de proxy pede que o proxy o adicione quando usa HTTPS. No nginx 1.19.3 ou mais recente, proxy_cookie_flags ~ secure; no bloco location faz isso.
Mantenha a porta 3080 fechada na firewall, independentemente do proxy escolhido. O único caminho de entrada deve ser o proxy autenticado. Princípios básicos da firewall ufw explica as regras. A autenticação básica sobre TLS é apenas um nível mínimo de proteção, não um modelo de segurança completo. Quem tiver essa palavra-passe e o URL com o token terá acesso a uma shell no seu servidor. Prefira o túnel quando possível.
Como altero a porta em que a interface Web do dsh fica à escuta?
--port pertence à aplicação Web, não ao launcher. A documentação da CLI mostra diretamente o exemplo:
dsh --profile web --port 8080dsh web é um alias de --profile web, portanto dsh web --port 8080 é o mesmo comando. O launcher interpreta apenas os seus próprios flags e encaminha tudo o que vem depois para o perfil iniciado. Por isso, os flags do launcher aparecem primeiro, e o primeiro token que o launcher não reconhece inicia os argumentos da aplicação. Coloque --port depois do perfil, nunca antes dele.
Leia o URL apresentado pelo comando em vez de o assumir, porque essa linha indica o endereço em que o servidor efetivamente ficou à escuta, juntamente com o token de que precisa. Depois, atualize o último campo do túnel para corresponder:
ssh -N -L 3080:127.0.0.1:8080 you@your-vpsPara uma alteração permanente, a porta fica na configuração do perfil, e não na linha de comandos. Os perfis web e headless são inicializados automaticamente na primeira utilização a partir dos modelos fornecidos, em ~/.dsh. Essa mesma diretoria contém as definições da chave da API e do endpoint do modelo. Por isso, configurar chaves, modelos e endpoints do dsh é a leitura complementar se já estiver a editar estes ficheiros. Para ver o que está efetivamente em vigor depois de todas as camadas serem combinadas:
dsh --dump-configO endereço de escuta vem de duas chaves do plugin do servidor Web, host e port. Na versão 0.2.0-rc.2, as outras chaves apenas ajustam a compressão das respostas. A versão 0.2.1-rc.2 e o branch predefinido adicionam uma chave tls opcional. Definir port como 0 pede ao sistema operativo uma porta livre, conforme documentado: "zero requests an OS-assigned port". Isto garante que nunca ocorre um conflito. No entanto, é inadequado para um túnel, porque o número muda a cada reinício.
Por que o dsh falha com "address already in use"?
Isso acontece porque outro processo já detém esse endereço e essa porta. Por isso, o kernel recusa o segundo bind. O Node informa o erro desta forma:
Error: listen EADDRINUSE: address already in use 127.0.0.1:3080Identifique o processo que detém o endereço antes de alterar qualquer coisa:
sudo ss -ltnp | grep 3080O campo users:(("node",pid=1042,fd=21)) identifica o processo e o respetivo PID. Normalmente, trata-se de uma instância anterior do dsh que pensava ter parado, muitas vezes ainda em execução numa janela tmux desanexada. Pare essa instância com kill 1042 ou inicie a nova instância noutra porta. Tenha em atenção que 127.0.0.1:3080 e 0.0.0.0:3080 também entram em conflito, porque associar o serviço a todas as interfaces já inclui a interface de loopback.
Fixe a versão, porque esta é uma versão de pré-visualização para programadores
O README é direto: o DeepSeek Harness está em pré-visualização para programadores e evolui rapidamente, e haverá alterações incompatíveis. Se esse ritmo é o motivo da sua hesitação, como o dsh se compara com o Claude Code e o Omnigent compara-o com dois harnesses em pontos diferentes da mesma evolução.
Um npx @deepseek-ai/dsh web sem versão especificada não identifica nenhuma versão, portanto não controla qual build é iniciado. A documentação do npm indica que um nome de pacote sem um especificador "será correspondido à versão que existir no projeto local", e que um pacote ausente do projeto é instalado numa pasta da cache do npm. O build iniciado depende do que essa máquina tiver, por isso um reinício pode iniciar um CLI diferente daquele que testou, com flags diferentes. Fixe a versão para que um reinício não seja uma atualização:
npx @deepseek-ai/dsh@0.2.0-rc.2 webEm novembro de 2026 (verificado em 2026-11-01), a tag latest do npm aponta para 0.2.1-rc.5, lançada no GitHub em 2026-10-30. O GitHub regista 0.2.1-rc.4 como lançada em 2026-10-28 às 02:49 UTC, aproximadamente quatro dias e onze horas depois de 0.2.1-rc.3, em 2026-10-23 às 15:26 UTC. Assim, numa máquina sem uma cópia local, um npx @deepseek-ai/dsh simples obtém agora uma release candidate 0.2.1, e não o build fixado neste guia. O 0.2.0-rc.2 fixado foi lançado no GitHub em 2026-09-29. O build 0.1.0-rc.7 fixado neste guia em agosto está agora várias versões de pré-visualização atrasado, abrangendo o restante da linha 0.1 e entrando na 0.2. Verifique o que um npx simples obteria antes de o aceitar:
npm view @deepseek-ai/dsh versionnpm view @deepseek-ai/dsh dist-tags lista todas as tags de uma só vez. É assim que distingue uma release candidate de uma versão alpha antes de a fixar.
Se a versão fixada recusar a instalação, ou se npx continuar a iniciar o build antigo depois de fixar um novo, os erros de instalação e de versão que isto provoca explica como limpar a cache do npx e verificar qual npm o seu Node inclui.
As flags mudam entre o launcher e a aplicação Web ao longo das versões de pré-visualização. Se --port deixar de funcionar como este guia descreve, peça à aplicação a sua própria lista de flags em vez de tentar adivinhar:
dsh --profile web --helpPara a instalação, a configuração da workspace e a chave do modelo, consulte instalar o DeepSeek Harness numa VPS. Para um guia mais curto apenas sobre a etapa de acesso, aceder à Web UI do dsh numa VPS explica o túnel sem a parte do raciocínio.
FAQ
Por que não consigo abrir http://127.0.0.1:3080 no navegador do meu laptop?
Porque 127.0.0.1 significa a máquina onde está a escrever. A interface Web do DeepSeek Harness está associada ao endereço de loopback do VPS. Por isso, apenas processos no VPS conseguem ligar-se a ela. O seu laptop tem o seu próprio loopback separado, e não há nada a escutar na porta 3080 nesse equipamento. Encaminhe a porta através de SSH com ssh -N -L 3080:127.0.0.1:3080 you@your-vps e, localmente, carregue o URL completo apresentado, http://127.0.0.1:3080/?token=.... O campo intermédio do argumento -L é resolvido no servidor. É isso que faz com que aponte para o harness. Se omitir o token, obterá 401 Unauthorized até o navegador manter um cookie de sessão.
É seguro associar a interface Web do dsh a 0.0.0.0 num VPS público?
Não. A interface Web é a superfície de controlo de um agente que executa comandos shell e edita ficheiros com o utilizador que executa dsh. Não tem contas de utilizador nem ecrã de início de sessão. A única credencial é o token incluído no URL apresentado. Os recursos estáticos são servidos sem esse token, e a documentação do próprio projeto indica que a porta de escuta não tem proteção. Associar a interface a todas as interfaces num IP público deixa a execução de comandos no seu servidor à distância de um URL divulgado para qualquer pessoa que consiga chegar à porta 3080. Associá-la diretamente ao IP público apresenta o mesmo risco. Mantenha a associação em 127.0.0.1, mantenha a porta 3080 fechada na firewall e use um túnel SSH, uma rede overlay privada ou um reverse proxy que exija uma palavra-passe.
Como mantenho a interface Web do dsh em execução depois de fechar a sessão SSH?
Um npx @deepseek-ai/dsh web em primeiro plano é um processo filho da sua shell de início de sessão. Por isso, é terminado quando essa shell sai. Inicie-o dentro de uma sessão tmux e desanexe-a com Ctrl-b d, ou execute-o como um serviço de utilizador do systemd com o lingering ativado. O túnel e o harness são independentes. Pode terminar e recriar o túnel SSH as vezes que quiser sem afetar o harness em execução, desde que o próprio harness tenha um processo-pai que permaneça ativo depois do fim da sua sessão.
Por que a interface Web do dsh bloqueia a meio de uma execução longa do agente atrás do nginx?
Verifique a ligação WebSocket e o log de erros do nginx. O valor predefinido de proxy_read_timeout no nginx é de 60 segundos entre leituras, mas a versão fixada 0.2.0-rc.2 envia pings WebSocket a cada dois segundos por predefinição. Por isso, uma etapa longa do agente, por si só, não ativa esse timeout. proxy_read_timeout 3600s; aumenta para uma hora o período permitido de inatividade. proxy_buffering off; desativa o buffering das respostas HTTP, não dos frames WebSocket. Passe os cabeçalhos Upgrade e Connection com proxy_http_version 1.1; para que o handshake WebSocket seja concluído. Sem esses cabeçalhos, a página carrega, mas nunca recebe atualizações.