SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor

Como acessar seu agente Hermes pelo celular

Veja 3 formas de acessar o dashboard Hermes no celular: Tailscale sem portas públicas, HTTPS com autenticação ou SSH, e revogue o acesso se perder o aparelho.

As três formas de aceder ao seu agente Hermes a partir do telemóvel

Para aceder ao seu agente Hermes a partir do telemóvel, utiliza o respetivo dashboard web. A decisão principal é o que fica à frente desse dashboard. A primeira opção é uma rede mesh privada, na qual o dashboard escuta apenas num endereço Tailscale e nenhuma porta fica exposta à Internet. A segunda opção é um endpoint público atrás de um reverse proxy com TLS (transport layer security) e um login. Nesse caso, esse login é a única proteção de um terminal com acesso ao servidor. A terceira opção é SSH (secure shell) a partir de uma aplicação de terminal. É a opção que exige menos configuração e concede mais acesso.

Este guia começa onde termina a execução de um agente Hermes no seu próprio VPS. O agente está instalado, responde na linha de comandos e agora pretende tê-lo disponível no telemóvel.

Os comandos abaixo têm como referência a tag v2026.8.3, publicada em 3 August 2026 e identificada como v0.20.0 nas notas de release. O Hermes lança versões com frequência, por isso fixe a máquina numa tag em vez de seguir main. O instalador aceita um commit:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/v2026.8.3/scripts/install.sh | bash -s -- --commit 3c27eb6234bf
hermes --version

Utilize o instalador dessa tag para efetuar esta fixação. O instalador atual espera o sistema de dependências PM mais recente. hermes --version mostra o que está efetivamente instalado. Compare esse resultado com a tag antes de confiar em qualquer flag desta página.

O que o repositório fornece e o que não fornece

Não existe uma aplicação para iOS ou Android no repositório Hermes. O cliente nativo é hermes desktop (alias hermes gui), uma aplicação Electron para macOS, Windows e Linux. Pode ligar-se a um agente remoto em vez de usar um agente local: nas Settings, em Gateway, defina o URL remoto como http://<server-address>:9119 ou exporte HERMES_DESKTOP_REMOTE_URL=http://<server-address>:9119 antes de o iniciar. Isto resolve o acesso a partir de um segundo portátil. Não resolve o acesso a partir de um telemóvel.

A interface usada a partir de um telemóvel é hermes dashboard, a interface no browser. Permite gerir a configuração, as sessões, os cron jobs, as skills, os logs e as plataformas de messaging, e inclui um terminal: o servidor inicia hermes --tui atrás de um PTY (pseudo-terminal) e transmite o output para a página. Num ecrã estreito, o seletor de sessões transforma-se num painel lateral sobreposto, pelo que o layout continua utilizável num telemóvel.

As releases mais recentes também disponibilizam o workspace Desktop num browser através de hermes webapp. É uma superfície de gateway separada, com a sua própria porta e definições de URL público; as instruções abaixo abrangem o dashboard.

Por predefinição, o dashboard escuta em 127.0.0.1:9119 e abre um separador do browser no próprio servidor, o que não é útil num VPS (virtual private server) sem interface gráfica. Inicie-o sem abrir o browser e consulte o socket:

hermes dashboard --no-open
ss -lntp | grep 9119

Um listener em 127.0.0.1:9119 só pode ser acedido a partir do servidor. Um listener em 0.0.0.0:9119 pode ser acedido a partir de todas as redes às quais a máquina está ligada, incluindo a rede pública. Essa única linha determina o nível de exposição, por isso consulte-a em vez de o assumir.

Opção 1: uma rede mesh privada com Tailscale

Escolha esta opção, a menos que tenha um motivo para não o fazer. O Tailscale é uma VPN mesh (rede privada virtual) baseada no WireGuard. Cada dispositivo que regista recebe um endereço estável e liga-se diretamente aos restantes ou através de um relay encriptado. O telemóvel entra na mesma mesh, pelo que o dashboard nunca precisa de uma porta pública.

No servidor:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale ip -4

Instale a aplicação Tailscale no telemóvel e inicie sessão com a mesma conta. tailscale status no servidor lista então o telemóvel pelo nome. Agora associe o dashboard ao endereço que tailscale ip -4 apresentou:

hermes dashboard --host 100.101.102.103 --port 9119 --no-open

Associar ao endereço da mesh, em vez de a 0.0.0.0, faz com que o socket aceite apenas ligações dirigidas a esse IP da mesh. Um port scan ao seu endereço IP público não encontra nada na porta 9119, porque não existe nenhum processo a escutar nesse endereço. No entanto, isto não associa o socket à interface Tailscale. A documentação do kernel Linux é clara: os endereços IP pertencem ao host completo, não a interfaces específicas. Um pacote dirigido a 100.101.102.103 que chegue pela interface pública, enviado por uma máquina na mesma rede do fornecedor, ainda pode alcançar o dashboard. Para impor também a interface, mantenha o ufw com a política deny predefinida para o tráfego de entrada e permita a porta apenas na mesh com sudo ufw allow in on tailscale0 to any port 9119 proto tcp. Confirme novamente o listener com ss -lntp | grep 9119.

O endereço de bind também determina a autenticação, e esta é a parte que muitas pessoas ignoram. Em v2026.8.3, um dashboard associado a 127.0.0.1 não tem login, mesmo quando public_url está configurado. Em qualquer outro endereço, a autenticação é obrigatória e, sem um provider configurado, o servidor recusa iniciar. O projeto chama a isto falhar de forma segura. Execute-o interativamente pela primeira vez. Nesse momento, será proposta a configuração de um nome de utilizador e de uma palavra-passe, guardados como dashboard.basic_auth em ~/.hermes/config.yaml. Também pode configurar o mesmo provider através de ~/.hermes/.env, que é o método usado pelo exemplo funcional do próprio projeto:

HERMES_DASHBOARD_BASIC_AUTH_USERNAME=you
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD_HASH=scrypt$16384$8$1$...
HERMES_DASHBOARD_BASIC_AUTH_SECRET=a-long-random-string

Gere esse segredo com openssl rand -base64 32, o comando usado na documentação do dashboard do projeto. O comentário da configuração pede 32 ou mais bytes aleatórios, em base64 ou hexadecimal. Depois, não o altere. O segredo assina os tokens de sessão do provider de palavras-passe, pelo que alterá-lo termina a sessão de todos os dispositivos que usam esse provider. O mesmo ficheiro contém as chaves da API do seu modelo. Proteja-o com chmod 600 ~/.hermes/.env.

Teste a autenticação a partir de outra máquina na mesh antes de confiar nela:

curl -s http://100.101.102.103:9119/api/status | jq '.auth_required, .auth_providers'

true seguido de ["basic"] significa que a autenticação está ativa e que o provider de palavras-passe é o componente que responde. A documentação do próprio projeto é clara sobre esse provider: destina-se a uma rede confiável ou a uma VPN e não é adequado para um dashboard exposto à Internet pública. Numa mesh, essa é exatamente a situação em que se encontra.

Para usar HTTPS dentro da tailnet, a configuração Tailscale Serve abaixo requer uma versão mais recente com suporte de public_url nas verificações Host e WebSocket Origin. Não funciona na versão fixada em v2026.8.3: um bind em loopback aceita apenas nomes Host de loopback, independentemente de public_url. Nessa versão, mantenha o IP direto da mesh apresentado acima. Depois de atualizar e verificar essas validações, o Serve encaminha para o endereço de loopback abaixo. Para esta configuração, inicie o dashboard em 127.0.0.1, em vez de o associar ao endereço da mesh, e execute:

sudo tailscale serve --bg localhost:9119
sudo tailscale serve status

A documentação atual do dashboard Hermes indica depois que deve usar a origem HTTPS apresentada por tailscale serve status como URL pública:

dashboard:
  public_url: "https://vps.tail1234.ts.net"

Sem essa linha, o dashboard rejeita o nome MagicDNS no cabeçalho Host. Como o nome não é um host de loopback, a autenticação continua ativa, mesmo quando o backend escuta em loopback. O Tailscale termina o TLS com um certificado emitido para o nome MagicDNS da máquina. Assim, o browser deixa de mostrar avisos e o cookie de sessão recebe a flag Secure. Ative MagicDNS e HTTPS Certificates na página DNS da consola de administração do Tailscale. Leia também o aviso apresentado nessa página: os nomes das máquinas e o nome DNS da sua tailnet são publicados no registo público de transparência de certificados, que qualquer pessoa pode consultar.

O custo real desta opção é o servidor de coordenação. O tráfego entre o telemóvel e o VPS é encriptado de ponta a ponta, inclusive quando passa por um relay Tailscale DERP. No entanto, a conta que decide quais dispositivos pertencem à mesh não está no seu hardware. Se isso for importante, execute o plano de controlo por sua conta com Headscale, o servidor de controlo Tailscale self-hosted, e indique-o aos clientes usando tailscale up --login-server https://headscale.example.com. Se preferir abandonar a mesh e configurar os peers manualmente, a comparação entre WireGuard simples e Tailscale explica o que perde.

Opção 2: um endpoint HTTPS público e a armadilha nele

Às vezes, uma mesh não está disponível. Um telefone de trabalho pode não permitir a instalação de um cliente VPN. Nesse caso, o dashboard fica atrás de um reverse proxy. Esta configuração HTTPS em loopback também requer o suporte mais recente a nomes de host públicos descrito acima; public_url não funciona em v2026.8.3. Mantenha o dashboard em loopback e deixe o Caddy gerir o certificado:

hermes.example.com {
  reverse_proxy 127.0.0.1:9119
}

O Caddy obtém e renova o certificado automaticamente, e o seu reverse_proxy encaminha upgrades de WebSocket sem diretivas adicionais. O terminal incorporado do dashboard precisa desse comportamento. No nginx, é necessário adicionar manualmente os cabeçalhos Upgrade e Connection. Emitir um certificado Let's Encrypt com Certbot no nginx explica a parte TLS desse processo. Indique ao Hermes o seu nome público para que os callbacks de login apontem para o host correto:

dashboard:
  public_url: "https://hermes.example.com"

Agora, a armadilha. O controlo de autenticação baseia-se no endereço de bind, não no endereço de origem do pedido. As versões atuais também ativam esse controlo quando dashboard.public_url (ou HERMES_DASHBOARD_PUBLIC_URL) define um host que não é loopback, mesmo que o backend esteja em loopback. Assim, a configuração acima ativa o controlo e o dashboard recusa iniciar até que um provider seja configurado. Deixe public_url sem valor para manter o controlo desativado, mas o proxy, por si só, não determina quem pode entrar. O dashboard também verifica o cabeçalho Host. Nesta configuração em loopback, as versões atuais aceitam nomes de loopback e o host declarado por public_url, e respondem com 400 a qualquer outro valor. O v2026.8.3 fixado aceita aqui apenas nomes de loopback e nunca verifica public_url. O Caddy encaminha o Host do navegador sem alterações. Por isso, o bloco acima sem public_url é rejeitado, não servido. O risco está num proxy que reescreve Host para o endereço do backend. Por predefinição, o nginx faz exatamente isso: envia o destino proxy_pass, a menos que defina manualmente proxy_set_header Host. Esse pedido passa a verificação e chega a um dashboard sem login. O WebSocket do terminal acrescenta uma verificação de Origin. Na versão fixada, um cabeçalho Origin HTTP ou HTTPS, quando presente, tem de apontar para o host associado ao bind. Isso impede o acesso por um navegador no seu hostname público, mas um script que não envie Origin passa por essa verificação. Independentemente do que configurou, confirme o que publicou efetivamente:

curl -s https://hermes.example.com/api/status | jq '.auth_required'

Se isso imprimir false, a Internet está a uma URL de distância de um terminal no seu servidor. Não é necessária qualquer exploração e nada nos logs indicará o problema. Se o pedido falhar com 400, a verificação Host recusou-o. Numa versão com suporte a nomes de host públicos, corrija o problema definindo public_url e um provider de login. Não reescreva cabeçalhos para contornar a verificação. Em v2026.8.3, use a rota direta pelo IP da mesh ou faça primeiro o upgrade. Existem duas correções para um dashboard aberto, e deve aplicar pelo menos uma delas. Pode colocar a autenticação no proxy, usando Authentik como provider de single sign-on autogerido à frente dele através de forward auth, ou configurar o provider OIDC (OpenID Connect) do próprio dashboard:

HERMES_DASHBOARD_OIDC_ISSUER=https://auth.example.com/application/o/hermes/
HERMES_DASHBOARD_OIDC_CLIENT_ID=hermes-dashboard
HERMES_DASHBOARD_OIDC_SCOPES="openid profile email"

Mesmo configurada corretamente, esta opção tem um limite que não pode reduzir. Uma página de login pública é acessível e atacável por qualquer pessoa, e atrás dela existe um shell no seu VPS. Um nome de utilizador e uma palavra-passe oferecem pouca proteção nesse cenário. Por isso, a documentação recomenda OAuth ou OIDC para binds públicos. Limite a taxa de tentativas de login, mantenha o ufw fechado para tudo, exceto as portas do proxy e SSH e consulte o access log regularmente.

Opção 3: SSH e mosh a partir de um terminal móvel

A opção que exige menos trabalho: instale uma aplicação de terminal no telemóvel, carregue uma chave SSH nessa aplicação e use a própria interface de texto do agente.

ssh you@vps.example.com
tmux new -A -s phone
hermes --tui

tmux new -A -s phone liga-se a uma sessão chamada phone ou cria-a se não existir. Assim, o agente continua a executar quando a ligação cai e, na próxima vez, regressa ao mesmo ponto. O padrão é o mesmo usado para controlar o Claude Code a partir de um telemóvel.

O SSH simples através de uma rede móvel é incómodo, porque a ligação cai sempre que o telemóvel muda de endereço ou entra em suspensão. O mosh resolve esse problema. Funciona através de UDP (user datagram protocol) e sincroniza o estado do terminal em vez de um fluxo de bytes. Por isso, a sessão sobrevive à passagem de wifi para a rede celular:

sudo apt install -y mosh
sudo ufw allow 60000:61000/udp

No telemóvel, execute mosh you@vps.example.com. O mosh inicia mosh-server através da sessão SSH existente e depois transfere a sessão para uma porta UDP entre 60000 e 61000. É por isso que deve abrir esse intervalo. Cada sessão precisa apenas da sua própria porta. Assim, num servidor com poucas sessões simultâneas, pode abrir um intervalo menor, como 60000 a 60010.

O custo de segurança é simples. Uma sessão SSH é uma shell, e uma shell pode fazer tudo o que essa conta tiver permissão para fazer. Os pedidos de aprovação do agente tornam-se então a última barreira entre um telemóvel desbloqueado roubado e os seus ficheiros. Para isto, use uma conta dedicada que não seja root, apenas com chave, e siga as instruções para reforçar a segurança do SSH num VPS antes de colocar uma chave num dispositivo que transporta consigo.

O que falha numa rede móvel

Quatro coisas, e nenhuma delas é um erro que possa ser eliminado com configuração.

O dashboard termina a sessão enquanto não está a olhar. O tempo depende do fornecedor de autenticação. O fornecedor de nome de utilizador e palavra-passe emite um token de acesso válido durante 12 horas por predefinição, definido por session_ttl_seconds em dashboard.basic_auth, mas esse valor controla apenas a frequência com que o dashboard é atualizado em segundo plano, não a duração da sessão autenticada. Cada atualização emite um novo token de atualização válido durante 30 dias, pelo que um início de sessão com palavra-passe permanece válido até passarem 30 dias sem atualização. Um reinício do backend também termina a sessão se não estiver configurado um segredo de assinatura estável através de HERMES_DASHBOARD_BASIC_AUTH_SECRET ou dashboard.basic_auth.secret, porque o Hermes gera uma nova chave de assinatura sempre que arranca. O fornecedor OAuth do Nous Portal emite tokens de acesso com um TTL (tempo de vida) de 15 minutos e renova-os em segundo plano com um token de atualização que roda a cada utilização, pelo que um token de acesso expirado, por si só, não o envia de volta para /login. O que provoca isso é a perda da sessão de atualização. Nas releases anteriores à v0.21.3 (tag v2026.9.14, publicada em 14 September 2026), um telefone que regressasse do segundo plano podia enviar vários pedidos ao mesmo tempo, reutilizar o token de atualização acabado de rodar, ativar a deteção de reutilização do fornecedor e revogar toda a sessão. Ao regressar, encontrava o ecrã de início de sessão e tudo o que estivesse a escrever tinha desaparecido. A v0.21.3 faz com que esses pedidos partilhem uma única atualização. Do lado do Nous Portal, uma sessão de atualização passa agora a prolongar a sua janela de 30 dias sempre que roda, embora 30 dias de inatividade continuem a terminá-la. Se permanecer na versão v2026.8.3 fixada no início desta página, espere algum início de sessão forçado ocasional. Nada está avariado. Inicie novamente a sessão.

O terminal incorporado não sobrevive por predefinição a um separador em segundo plano. A ligação de terminal documentada do dashboard inicia a TUI (interface de utilizador de texto) atrás de uma PTY e termina-a corretamente quando o separador fecha. Ao reabrir, inicia uma nova. Os browsers móveis descartam separadores em segundo plano para libertar memória, pelo que mudar para outra aplicação durante tempo suficiente termina esse terminal. O histórico da conversa está seguro, porque as sessões são armazenadas no servidor e hermes sessions list continua a mostrá-las. O servidor fixado também suporta uma ligação keep-alive opcional que utiliza um token de anexação e mantém uma PTY separada durante 30 minutos. Se precisar de uma sessão que sobreviva, use tmux através de SSH.

As ligações inativas terminam silenciosamente. Os operadores móveis terminam ligações TCP inativas para libertar entradas nas tabelas NAT (tradução de endereços de rede), e o telefone deixa de processar a rede quase completamente quando o ecrã se desliga. Um WebSocket que esteve silencioso durante algum tempo normalmente já terminou quando desbloqueia o telefone, e a página só volta a ligar-se depois de tocar nela. É por isso que mosh funciona melhor do que SSH num telefone: não tinha uma ligação para perder.

Nenhuma notificação é enviada. Nem o dashboard nem uma sessão SSH conseguem ativar o telefone. Não existe uma aplicação Hermes no dispositivo, pelo que não há caminho para o serviço de notificações push da plataforma. Uma execução longa de um agente termina, e só fica a saber disso da próxima vez que consultar o telefone.

As notificações chegam através do gateway de mensagens

A solução para o último caso é o gateway, que oferece uma forma completamente diferente de chegar ao agente. hermes gateway liga o agente a plataformas de mensagens, incluindo Telegram, Discord, Slack, WhatsApp, Signal e email. Assim, pode falar com o agente numa aplicação que já tem um canal de push no telemóvel, já trata da entrega em segundo plano e já lida com interrupções da rede.

hermes gateway setup
hermes gateway install
hermes gateway status

hermes gateway install regista o gateway como um serviço systemd, para que este volte a arrancar depois de um reboot. A etapa do gateway do instalador pode executar esse passo por si, mas nada no instalador cria uma unidade para hermes dashboard. Por isso, o dashboard não volta a ficar disponível automaticamente depois de um reinício. Crie uma unidade para cada componente de que dependa. O artigo criar serviços e timers systemd num VPS explica como criar o próprio ficheiro.

Um trabalho agendado também pode enviar um resultado da mesma forma, sem envolver uma conversa:

hermes send -t telegram -s "Backup report" -f /home/you/report.txt

A autorização segue aqui o princípio de negar por defeito. Sem uma allowlist ou um emparelhamento aprovado, e com GATEWAY_ALLOW_ALL_USERS não definido, todos os utilizadores são recusados. Esse é o ponto de partida correto. Indique em ~/.hermes/.env as contas que pretende autorizar:

TELEGRAM_ALLOWED_USERS=123456789
GATEWAY_ALLOWED_USERS=123456789

Também pode usar um emparelhamento baseado em código em vez de colar IDs numéricos. Esta é a predefinição nas plataformas de DM ao estilo de chat. Pode defini-la explicitamente com unauthorized_dm_behavior: pair em ~/.hermes/config.yaml. Quando uma conta desconhecida envia uma mensagem ao agente, recebe um código com oito caracteres. Nada mais acontece até aprovar o emparelhamento:

hermes pairing list
hermes pairing approve telegram ABC12DEF
hermes pairing revoke telegram 123456789

Os códigos expiram após uma hora. Um utilizador pode pedir um código a cada dez minutos. Cinco tentativas falhadas bloqueiam essa conta.

Limitar o impacto de um telefone roubado

Um telefone que consegue aceder ao seu agente consegue executar comandos no seu servidor, e os telefones perdem-se. Decida agora o que a pessoa que o tem na mão pode fazer.

Mantenha as aprovações ativadas. approvals.mode tem smart por predefinição, o que pede a um modelo auxiliar para avaliar o risco e aprova automaticamente apenas os comandos de baixo risco. Defini-lo como off equivale a executar tudo com --yolo, e HERMES_YOLO_MODE=1 faz o mesmo através do ambiente. Não transporte um telefone que comunique com um agente nesse estado. Defina approvals.cron_mode: deny para que os trabalhos agendados não possam aprovar-se a si próprios enquanto dorme.

approvals:
  mode: smart
  cron_mode: deny

Reduza o ambiente que o agente pode afetar. terminal.backend: docker executa os comandos dentro de um contentor que remove todas as capacidades Linux, exceto uma lista curta, define no-new-privileges e limita o número de processos, fazendo do contentor o limite de segurança em vez do prompt. terminal.cwd fixa o diretório de trabalho. HERMES_WRITE_SAFE_ROOT restringe write_file e patch aos diretórios que indicar, e uma escrita fora desses diretórios é bloqueada sem possibilidade de substituição por aprovação.

export HERMES_WRITE_SAFE_ROOT=/home/you/projects:/home/you/.hermes

O Hermes já bloqueia escritas em ~/.ssh, ~/.aws, ~/.kube e /etc/sudoers, bem como nos seus próprios repositórios de segredos, como ~/.hermes/.env. Os ficheiros .env do projeto noutras localizações do disco não podem ser lidos, mas continuam a poder ser escritos. Também rejeita uma lista rígida de comandos destrutivos, independentemente das definições de aprovação. Considere isto um limite mínimo, não o seu plano de segurança. Execute o agente como um utilizador normal, nunca como root. O mesmo raciocínio aplica-se a qualquer agente de programação deixado em execução sem supervisão, e executar o Claude Code com segurança num VPS explica isto com mais detalhe.

Em seguida, documente os passos de revogação antes de precisar deles. Remover o dispositivo na consola de administração do Tailscale corta imediatamente o acesso à rede mesh. Alterar HERMES_DASHBOARD_BASIC_AUTH_SECRET e reiniciar invalida todas as sessões dos painéis dos fornecedores de palavras-passe em todos os dispositivos, porque esse valor assina os tokens de sessão do fornecedor. Eliminar a chave pública do telefone de ~/.ssh/authorized_keys bloqueia novos logins SSH com essa chave; termine separadamente as sessões SSH e mosh existentes. hermes pairing revoke telegram <user-id> remove uma conta de mensagens. Se o dispositivo tivesse acesso a algo capaz de ler as suas chaves do fornecedor, revogue-as com hermes auth logout <provider> e emita novas chaves no fornecedor.

Verifique o resultado em vez de assumir que funcionou. Estes comandos devem ser executados no seu próprio sistema, e o que imprimem depende da sua configuração:

tailscale status
hermes pairing list
hermes logs gateway -n 100
hermes status --deep

Os logs ficam em ~/.hermes/logs/. Leia-os depois de um incidente e consulte-os ocasionalmente quando não tiver ocorrido nenhum incidente.

FAQ

Existe uma aplicação móvel oficial do Hermes para iOS ou Android?

Não. O repositório do Hermes inclui uma interface de linha de comandos, um dashboard web e um cliente desktop Electron para macOS, Windows e Linux. Não existe uma versão própria para iOS ou Android. Num telemóvel, utilize o dashboard web num navegador, um cliente SSH ou uma plataforma de mensagens ligada através de hermes gateway. Também existem clientes móveis de terceiros. Estes são código de terceiros que armazena credenciais do seu agente, por isso leia o código-fonte antes de instalar um.

Porque é que o dashboard do Hermes termina a minha sessão no telemóvel?

Depende do fornecedor de autenticação. O fornecedor OAuth do Nous Portal emite tokens de acesso com um TTL de 15 minutos e renova-os em segundo plano com um token de atualização rotativo. Por isso, a expiração isolada de um token de acesso não o envia para /login. Nas versões anteriores à v0.21.3 (tag v2026.9.14), um telemóvel que regressasse do segundo plano podia enviar vários pedidos em simultâneo, reutilizar o token de atualização acabado de rodar e revogar a sessão completa. Isso obriga efetivamente a iniciar sessão novamente. A v0.21.3 corrige este problema, mas uma sessão de atualização que permaneça inativa durante 30 dias também expira. Por predefinição, o fornecedor de nome de utilizador e palavra-passe utiliza um token de acesso de 12 horas, definido por session_ttl_seconds. Isto controla apenas a frequência com que o dashboard é atualizado em segundo plano. A sessão é renovada através de um token de atualização de 30 dias, que é emitido novamente a cada atualização. Por isso, uma sessão iniciada com palavra-passe não termina ao fim de 12 horas. Com esse fornecedor, defina HERMES_DASHBOARD_BASIC_AUTH_SECRET com um valor aleatório estável. Sem um segredo estável nessa variável ou em dashboard.basic_auth.secret, o Hermes gera uma nova chave de assinatura sempre que arranca. Cada reinício termina a sua sessão.

Posso disponibilizar o dashboard do Hermes publicamente na Internet com segurança?

Apenas se tiver verificado pessoalmente a autenticação. O mecanismo de autenticação é ativado com base no endereço de ligação e, nas versões atuais, também quando dashboard.public_url especifica um host que não seja de loopback. Por isso, um dashboard ligado a 127.0.0.1 atrás de um reverse proxy, sem um URL público definido, nunca pede autenticação. Na revisão v2026.8.3, definir public_url não ativa o mecanismo de autenticação de loopback nem permite um hostname público através das verificações de Host e de WebSocket Origin. Utilize a rota direta pelo IP da mesh ou atualize para uma versão com suporte para hostnames públicos antes de seguir a configuração do proxy HTTPS. A verificação Host rejeita um proxy que encaminhe o seu hostname público, mas não um proxy que reescreva Host para o endereço do backend, como o nginx faz por predefinição. Execute curl -s https://your-host/api/status | jq '.auth_required' e leia o resultado. Utilize OAuth ou OIDC em vez de nome de utilizador e palavra-passe, porque a documentação do projeto indica que o fornecedor de palavra-passe se destina a redes fidedignas e VPNs. Uma mesh privada evita completamente esta questão e, por isso, é a predefinição recomendada.

Preciso de uma conta Tailscale ou posso alojar o plano de controlo por conta própria?

Pode alojá-lo por conta própria. O Headscale é uma implementação aberta do servidor de coordenação do Tailscale, e os clientes oficiais do Tailscale ligam-se a ele através de tailscale up --login-server https://headscale.example.com. Assim, passa a controlar a lista de dispositivos autorizados a entrar na mesh. O custo é ter de executar e criar cópias de segurança desse servidor. Enquanto estiver indisponível, não poderá inscrever nem voltar a autenticar um dispositivo.

Como recebo uma notificação no telemóvel quando o agente termina um trabalho?

Utilize o gateway de mensagens. O dashboard e o SSH não conseguem ativar um telemóvel, porque não existe uma aplicação Hermes no dispositivo para receber notificações push. Ligue o agente ao Telegram, Signal, Discord ou a outra plataforma suportada através de hermes gateway setup. Depois, deixe a própria aplicação dessa plataforma entregar a notificação. Um cron job também pode enviar uma única mensagem através de hermes send -t telegram -s "Job done" -f /path/to/report.txt. Essa operação entrega a mensagem sem chamar o modelo.

Este artigo foi útil?