Acceder a tu agente Hermes desde el teléfono
Conecta el panel de Hermes en tu VPS desde el móvil mediante Tailscale, HTTPS público o SSH, y revoca el acceso si pierdes el teléfono.
Las tres formas de acceder a tu agente Hermes desde el teléfono
Para acceder a tu agente Hermes desde el teléfono, usa su panel web. La decisión importante es qué componente se coloca delante de ese panel. La primera opción es una red de malla privada. El panel escucha sólo en una dirección de Tailscale y ningún puerto queda expuesto a Internet. La segunda opción es un endpoint público detrás de un reverse proxy con TLS (seguridad de la capa de transporte) y un inicio de sesión. En este caso, ese inicio de sesión es la única protección de un terminal con acceso al servidor. La tercera opción es SSH (shell seguro) desde una aplicación de terminal. Requiere menos configuración y proporciona más acceso.
Esta guía comienza donde termina ejecutar un agente Hermes en tu propio VPS. El agente está instalado y responde en la línea de comandos. Ahora quieres acceder a él desde el teléfono.
Los comandos siguientes están escritos para el tag v2026.8.3, publicado el 3 de agosto de 2026 y etiquetado como v0.20.0 en las notas de la versión. Hermes publica versiones con frecuencia, así que fija la máquina a un tag en lugar de seguir main. El instalador acepta un commit:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/v2026.8.3/scripts/install.sh | bash -s -- --commit 3c27eb6234bf
hermes --versionUsa el instalador de ese tag para fijar esta versión. El instalador actual espera el sistema de dependencias PM más reciente. hermes --version muestra lo que está instalado realmente. Compáralo con el tag antes de confiar en cualquier flag de esta página.
Qué incluye el repositorio y qué no
No hay ninguna aplicación para iOS o Android en el repositorio de Hermes. El cliente nativo es hermes desktop (alias hermes gui), una aplicación de Electron para macOS, Windows y Linux. Puede conectarse a un agente remoto en lugar de uno local: establezca la URL remota en http://<server-address>:9119 en Settings, dentro de Gateway, o exporte HERMES_DESKTOP_REMOTE_URL=http://<server-address>:9119 antes de iniciarlo. Esto resuelve el caso de un segundo portátil. No sirve para un teléfono.
La interfaz que se usa desde un teléfono es hermes dashboard, la interfaz del navegador. Permite administrar la configuración, las sesiones, las tareas de cron, las skills, los registros y las plataformas de mensajería, e integra un terminal: el servidor inicia hermes --tui detrás de un PTY (terminal pseudo-TTY) y transmite la salida a la página. En una pantalla estrecha, el selector de sesiones se pliega en un panel superpuesto, por lo que la interfaz sigue siendo utilizable desde un teléfono.
Las versiones más recientes también ofrecen el espacio de trabajo Desktop en un navegador mediante hermes webapp. Es una interfaz de gateway independiente, con su propio puerto y configuración de URL pública; las instrucciones siguientes cubren el dashboard.
De forma predeterminada, el dashboard escucha en 127.0.0.1:9119 y abre una pestaña del navegador en el propio servidor, lo que no sirve en un VPS (servidor privado virtual) sin interfaz gráfica. Inícielo sin abrir el navegador y consulte el socket:
hermes dashboard --no-open
ss -lntp | grep 9119Un listener en 127.0.0.1:9119 sólo es accesible desde el servidor. Un listener en 0.0.0.0:9119 es accesible desde todas las redes a las que está conectado el equipo, incluida la red pública. Esa única línea determina el nivel de exposición, así que debe consultarla en lugar de asumirlo.
Opción 1: una red privada con Tailscale
Elija esta opción salvo que tenga un motivo para no hacerlo. Tailscale es una VPN en malla (red privada virtual) basada en WireGuard. Cada dispositivo que registre recibe una dirección estable y se conecta directamente con los demás o mediante un relay cifrado. El teléfono se une a la misma malla, por lo que el dashboard no necesita ningún puerto público.
En el servidor:
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale ip -4Instale la aplicación Tailscale en el teléfono e inicie sesión con la misma cuenta. tailscale status en el servidor muestra entonces el teléfono por su nombre. Ahora vincule el dashboard a la dirección que mostró tailscale ip -4:
hermes dashboard --host 100.101.102.103 --port 9119 --no-openVincularse a la dirección de la malla, en lugar de a 0.0.0.0, significa que el socket sólo acepta conexiones dirigidas a esa IP de la malla. Un escaneo de puertos de su dirección IP pública no encuentra nada en 9119, porque ningún proceso escucha en esa dirección. Sin embargo, esto no vincula el socket a la interfaz de Tailscale. La documentación del kernel de Linux lo explica claramente: las direcciones IP pertenecen al host completo, no a interfaces concretas. Un paquete dirigido a 100.101.102.103 que llegue por la interfaz pública, enviado por una máquina de la misma red del proveedor, todavía puede llegar al dashboard. Para imponer también la interfaz, mantenga ufw con su política predeterminada de denegar el tráfico entrante y permita el puerto sólo en la malla con sudo ufw allow in on tailscale0 to any port 9119 proto tcp. Vuelva a confirmar el proceso en escucha con ss -lntp | grep 9119.
La dirección de vinculación también determina la autenticación, y este es el aspecto que suele pasarse por alto. En v2026.8.3, un dashboard vinculado a 127.0.0.1 no tiene inicio de sesión aunque public_url esté configurado. En cualquier otra dirección, la puerta de autenticación es obligatoria y, si no hay ningún proveedor configurado, el servidor se niega a iniciar. El proyecto denomina a esto fallo seguro. Ejecútelo de forma interactiva la primera vez y ofrecerá configurar en ese momento un nombre de usuario y una contraseña, guardados como dashboard.basic_auth en ~/.hermes/config.yaml. También puede configurar el mismo proveedor mediante ~/.hermes/.env, que es el método del ejemplo práctico del propio proyecto:
HERMES_DASHBOARD_BASIC_AUTH_USERNAME=you
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD_HASH=scrypt$16384$8$1$...
HERMES_DASHBOARD_BASIC_AUTH_SECRET=a-long-random-stringGenere ese secreto con openssl rand -base64 32, el comando que utiliza la documentación del dashboard del proyecto (el comentario de configuración solicita 32 bytes aleatorios o más, en base64 o hexadecimal), y después no lo modifique. El secreto firma los tokens de sesión del proveedor de contraseñas, por lo que cambiarlo cierra la sesión de todos los dispositivos que usan ese proveedor. El mismo archivo contiene las claves de API de su modelo, así que protéjalo con chmod 600 ~/.hermes/.env.
Compruebe la puerta desde otra máquina de la malla antes de confiar en ella:
curl -s http://100.101.102.103:9119/api/status | jq '.auth_required, .auth_providers'true seguido de ["basic"] significa que la puerta está activa y que el proveedor de contraseñas es quien responde. La documentación del propio proyecto es clara sobre ese proveedor: está pensado para una red de confianza o una VPN, y no es adecuado para un dashboard expuesto a Internet pública. En una malla, esa es exactamente la situación.
Para usar HTTPS dentro de la tailnet, la configuración de Tailscale Serve que aparece a continuación requiere una versión más reciente con compatibilidad con public_url en sus comprobaciones de Host y WebSocket Origin. No funciona con el pin v2026.8.3: una vinculación a loopback sólo acepta nombres de Host de loopback, independientemente de public_url. Mantenga la IP directa de la malla indicada arriba con ese pin. Después de actualizar y verificar esas comprobaciones, Serve actúa como proxy hacia la dirección de loopback aquí, por lo que en esta configuración debe iniciar el dashboard en 127.0.0.1 en lugar de en la dirección de la malla y, a continuación:
sudo tailscale serve --bg localhost:9119
sudo tailscale serve statusLa documentación actual del dashboard de Hermes indica que debe usar como URL pública el origen HTTPS que muestra tailscale serve status:
dashboard:
public_url: "https://vps.tail1234.ts.net"Sin esa línea, el dashboard rechaza el nombre de MagicDNS en la cabecera Host. Como el nombre no es un host de loopback, también mantiene activa la puerta de autenticación aunque el backend escuche en loopback. Tailscale termina TLS con un certificado emitido para el nombre MagicDNS de la máquina, por lo que el navegador deja de mostrar advertencias y la cookie de sesión recibe el indicador Secure. Active primero MagicDNS y HTTPS Certificates en la página DNS de la consola de administración de Tailscale y lea allí el aviso: los nombres de sus máquinas y el nombre DNS de su tailnet se publican en el registro público de transparencia de certificados, que cualquiera puede consultar.
El coste real es el servidor de coordinación. El tráfico entre el teléfono y su VPS está cifrado de extremo a extremo, incluso cuando pasa por un relay DERP de Tailscale, pero la cuenta que decide qué dispositivos pertenecen a la malla no reside en su hardware. Si esto es importante, ejecute el plano de control usted mismo con Headscale, el servidor de control de Tailscale autoalojado y dirija los clientes hacia él mediante tailscale up --login-server https://headscale.example.com. Si prefiere abandonar la malla y configurar los pares manualmente, la comparación entre WireGuard sin intermediarios y Tailscale explica qué funciones pierde.
Opción 2: un endpoint HTTPS público y la trampa que contiene
A veces no hay una malla disponible. Es posible que un teléfono de trabajo no permita instalar un cliente VPN. En ese caso, el dashboard se coloca detrás de un reverse proxy. Esta configuración HTTPS en loopback también requiere la compatibilidad con nombres de host públicos descrita anteriormente; public_url no hace que funcione en v2026.8.3. Mantenga el dashboard en loopback y deje que Caddy gestione el certificado:
hermes.example.com {
reverse_proxy 127.0.0.1:9119
}Caddy obtiene y renueva el certificado por su cuenta. Su reverse_proxy permite pasar las actualizaciones de WebSocket sin directivas adicionales, algo que necesita el terminal integrado del dashboard. En nginx debe añadir manualmente las cabeceras Upgrade y Connection. Emitir un certificado de Let's Encrypt con Certbot en nginx explica la parte TLS de ese proceso. Indique a Hermes su nombre público para que las devoluciones de autenticación apunten al host correcto:
dashboard:
public_url: "https://hermes.example.com"Ahora viene la trampa. La puerta de autenticación se basa en la dirección de escucha, no en la dirección desde la que llega la petición. Las versiones actuales también activan la puerta cuando dashboard.public_url (o HERMES_DASHBOARD_PUBLIC_URL) especifica un host que no es loopback, incluso si el backend está en loopback. Por tanto, la configuración anterior activa la puerta y el dashboard se niega a iniciar hasta que se configure un proveedor. Deje public_url sin definir para mantener desactivada la puerta, pero el proxy por sí solo no decide quién puede acceder. El dashboard también comprueba la cabecera Host. En esta configuración con loopback, las versiones actuales aceptan los nombres de loopback y el host que declara public_url, y responden con un 400 a cualquier otro valor. El v2026.8.3 fijado sólo acepta nombres de loopback aquí y nunca comprueba public_url. Caddy reenvía sin cambios el Host del navegador, por lo que el bloque anterior sin public_url se rechaza y no se sirve. El peligro aparece cuando un proxy reescribe Host con la dirección del backend. nginx hace exactamente eso de forma predeterminada: envía el destino proxy_pass, salvo que configure proxy_set_header Host manualmente. Esa petición supera la comprobación y llega a un dashboard sin autenticación. El WebSocket del terminal añade una comprobación de Origin. En la versión fijada, una cabecera Origin HTTP o HTTPS, cuando está presente, debe apuntar al host enlazado. Esto bloquea un navegador que use el nombre de host público, pero un script que no envíe ningún Origin supera la comprobación. Sea cual sea su configuración, compruebe qué ha publicado realmente:
curl -s https://hermes.example.com/api/status | jq '.auth_required'Si muestra false, Internet está a una URL de distancia de un terminal en su servidor. No interviene ningún exploit y nada lo indicará en los logs. Si la petición falla con un 400, la comprobación de Host la rechazó. En una versión compatible con nombres de host públicos, corríjalo configurando public_url y un proveedor de inicio de sesión, no reescribiendo cabeceras para eludir la comprobación. En v2026.8.3, use la ruta directa mediante la IP de la malla o actualice primero. Hay dos formas de corregir un dashboard abierto y debe aplicar al menos una. Puede colocar la autenticación en el proxy mediante Authentik como proveedor de inicio de sesión único autoalojado, situado delante mediante forward auth, o configurar el proveedor OIDC (OpenID Connect) propio del 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"Incluso correctamente configurada, esta opción tiene un límite que no puede reducir. Una página de inicio de sesión pública es accesible y atacable por cualquiera, y detrás de ella hay un shell en su VPS. Un nombre de usuario y una contraseña ofrecen una protección limitada en ese contexto. Por eso la documentación recomienda OAuth u OIDC para las vinculaciones públicas. Aplique límites de tasa al inicio de sesión, mantenga ufw cerrado para todo excepto los puertos del proxy y SSH y revise el access log de vez en cuando.
Opción 3: SSH y mosh desde un terminal móvil
La opción que requiere menos trabajo: instale una aplicación de terminal en el teléfono, cargue una clave SSH y use la interfaz de texto del propio agente.
ssh you@vps.example.com
tmux new -A -s phone
hermes --tuitmux new -A -s phone se conecta a una sesión llamada phone o la crea si no existe. Así, el agente sigue ejecutándose cuando se interrumpe la conexión y la próxima vez vuelve al mismo punto. El patrón es el mismo que se usa para controlar Claude Code desde un teléfono.
SSH sin más sobre una red móvil resulta incómodo porque la conexión se interrumpe cada vez que el teléfono cambia de dirección o entra en suspensión. Mosh resuelve este problema. Funciona sobre UDP (user datagram protocol) y sincroniza el estado del terminal en lugar de un flujo de bytes. Por eso, la sesión sobrevive al cambio de wifi a la red móvil:
sudo apt install -y mosh
sudo ufw allow 60000:61000/udpDesde el teléfono, ejecute mosh you@vps.example.com. Mosh inicia mosh-server mediante la conexión SSH existente y después traslada la sesión a un puerto UDP entre 60000 y 61000. Por eso debe abrirse ese rango. Cada sesión sólo necesita su propio puerto. En un servidor con pocas sesiones simultáneas, puede abrir un rango menor, como 60000 a 60010.
El coste de seguridad es directo. Una sesión SSH es un shell, y un shell puede hacer todo lo que pueda hacer esa cuenta. Las solicitudes de aprobación del agente se convierten entonces en la última barrera entre un teléfono desbloqueado robado y sus archivos. Use para esto una cuenta dedicada que no sea root y sólo con clave. Antes de copiar una clave en un dispositivo que lleva consigo, siga cómo reforzar SSH en un VPS.
Qué falla en una red móvil
Hay cuatro problemas, y ninguno se puede resolver cambiando una configuración.
El panel cierra la sesión mientras no lo está mirando. El tiempo depende del proveedor de inicio de sesión. El proveedor de nombre de usuario y contraseña emite un token de acceso que dura 12 horas de forma predeterminada. Lo establece session_ttl_seconds en dashboard.basic_auth, pero ese valor sólo controla cada cuánto se actualiza el panel en segundo plano, no cuánto tiempo permanece iniciada la sesión. Cada actualización genera un nuevo token de actualización válido durante 30 días. Por tanto, el inicio de sesión con contraseña dura hasta que transcurren 30 días sin una actualización. Un reinicio del backend también termina la sesión si no se configura un secreto de firma estable mediante HERMES_DASHBOARD_BASIC_AUTH_SECRET o dashboard.basic_auth.secret, porque Hermes genera una nueva clave de firma cada vez que se inicia. El proveedor OAuth de Nous Portal emite tokens de acceso con un TTL (tiempo de vida) de 15 minutos y los renueva en segundo plano con un token de actualización que rota en cada uso. Por eso, que caduque el token de acceso no le devuelve por sí solo a /login. Lo que sí lo hace es perder la sesión de actualización. En las releases anteriores a v0.21.3 (tag v2026.9.14, publicada el 14 de septiembre de 2026), un teléfono que volvía del segundo plano podía enviar varias peticiones a la vez, reutilizar el token de actualización recién rotado, activar la detección de reutilización del proveedor y revocar toda la sesión. Al volver, aparecía la pantalla de inicio de sesión y se perdía lo que estuviera escribiendo. v0.21.3 hace que esas peticiones compartan una sola actualización. Además, en Nous Portal, la sesión de actualización amplía ahora su ventana de 30 días cada vez que rota, aunque 30 días de inactividad siguen terminándola. Si mantiene el pin v2026.8.3 indicado al principio de esta página, espere algún inicio de sesión forzado ocasional. No hay ningún fallo. Vuelva a iniciar sesión.
El terminal integrado no sobrevive de forma predeterminada a una pestaña en segundo plano. La conexión de terminal documentada del panel inicia la TUI (interfaz de usuario de texto) detrás de una PTY y la finaliza correctamente cuando se cierra la pestaña. Al volver a abrirla, inicia una nueva. Los navegadores móviles descartan las pestañas en segundo plano para recuperar memoria. Por eso, cambiar a otra aplicación durante el tiempo suficiente termina ese terminal. El historial del chat está a salvo porque las sesiones se almacenan en el servidor y hermes sessions list todavía las muestra. El servidor fijado también admite una conexión keep-alive opcional mediante un token de adjunto, que conserva una PTY separada durante 30 minutos. Si necesita una sesión que sobreviva, use tmux sobre SSH.
Las conexiones inactivas se interrumpen sin avisar. Los operadores móviles eliminan las conexiones TCP inactivas para recuperar entradas de sus tablas NAT (traducción de direcciones de red), y el teléfono deja de atender casi por completo la red cuando se apaga la pantalla. Cuando desbloquea el teléfono, un WebSocket que ha permanecido silencioso durante un tiempo normalmente ya está desconectado. La página sólo vuelve a conectarse después de que interactúe con ella. Por eso mosh funciona mejor que SSH en un teléfono: nunca tuvo una conexión que perder.
No se envía ninguna notificación. Ni el panel ni una sesión SSH pueden activar el teléfono. No hay ninguna aplicación de Hermes en el dispositivo, por lo que no existe una ruta hasta el servicio de notificaciones push de la plataforma. Una ejecución larga del agente termina y usted se entera la próxima vez que mira el teléfono.
Las notificaciones llegan a través del gateway de mensajería
La solución para este último problema es el gateway, que ofrece otra forma de acceder al agente. hermes gateway conecta el agente con plataformas de mensajería como Telegram, Discord, Slack, WhatsApp, Signal y el correo electrónico. Así puede comunicarse con el agente desde una aplicación que ya tiene un canal de notificaciones push en el teléfono, gestiona la entrega en segundo plano y tolera las interrupciones de red.
hermes gateway setup
hermes gateway install
hermes gateway statushermes gateway install registra el gateway como un servicio de systemd, por lo que vuelve a iniciarse después de un reinicio. La fase del gateway del instalador puede ejecutar ese paso, pero el instalador no crea ninguna unidad para hermes dashboard. Por tanto, el dashboard no volverá a iniciarse por sí solo después de un reinicio. Cree una unidad para cada componente del que dependa. Escribir servicios y temporizadores de systemd en un VPS explica cómo crear el archivo.
Un trabajo programado también puede enviar un resultado de la misma forma, sin que haya ninguna conversación:
hermes send -t telegram -s "Backup report" -f /home/you/report.txtLa autorización aplica una política de denegación predeterminada. Si no existe una allowlist ni una vinculación aprobada y GATEWAY_ALLOW_ALL_USERS no está definido, se rechaza a todos los usuarios. Ese es el punto de partida correcto. Indique las cuentas que quiere permitir en ~/.hermes/.env:
TELEGRAM_ALLOWED_USERS=123456789
GATEWAY_ALLOWED_USERS=123456789También puede usar una vinculación mediante código en lugar de pegar identificadores numéricos. Es el método predeterminado para las plataformas de mensajería directa de tipo chat, y puede activarlo explícitamente con unauthorized_dm_behavior: pair en ~/.hermes/config.yaml. Una cuenta desconocida que envía un mensaje al agente recibe un código de ocho caracteres. No ocurre nada más hasta que lo aprueba:
hermes pairing list
hermes pairing approve telegram ABC12DEF
hermes pairing revoke telegram 123456789Los códigos caducan después de una hora. Un usuario puede solicitar uno cada diez minutos. Cinco intentos fallidos bloquean esa cuenta.
Limitar el alcance de un teléfono robado
Un teléfono que puede acceder a tu agente puede ejecutar comandos en tu servidor, y los teléfonos se pierden. Decide ahora qué puede hacer la persona que lo tenga.
Mantén activadas las aprobaciones. approvals.mode tiene smart de forma predeterminada, lo que pide a un modelo auxiliar que evalúe el riesgo y apruebe automáticamente sólo los comandos de bajo riesgo. Establecerlo en off equivale a ejecutar todo con --yolo, y HERMES_YOLO_MODE=1 lo hace mediante el entorno. No lleves un teléfono que se comunique con un agente en ese estado. Establece approvals.cron_mode: deny para que los trabajos programados no puedan aprobarse a sí mismos mientras duermes.
approvals:
mode: smart
cron_mode: denyReduce el entorno en el que el agente puede causar daños. terminal.backend: docker ejecuta los comandos dentro de un contenedor que elimina todas las capacidades de Linux salvo una lista breve, establece no-new-privileges y limita el número de procesos, de modo que el contenedor se convierte en el límite de seguridad en lugar de una instrucción. terminal.cwd fija el directorio de trabajo. HERMES_WRITE_SAFE_ROOT restringe write_file y patch a los directorios que especifiques, y cualquier escritura fuera de ellos se bloquea sin que ninguna aprobación pueda anularla.
export HERMES_WRITE_SAFE_ROOT=/home/you/projects:/home/you/.hermesHermes ya bloquea las escrituras en ~/.ssh, ~/.aws, ~/.kube y /etc/sudoers, así como en sus propios almacenes de secretos, como ~/.hermes/.env. Los archivos .env del proyecto situados en otras rutas del disco no se pueden leer, pero siguen siendo modificables. También rechaza una lista estricta de comandos destructivos, independientemente de la configuración de aprobaciones. Considéralo un nivel mínimo de protección, no tu plan de seguridad. Ejecuta el agente como un usuario normal, nunca como root. El mismo razonamiento se aplica a cualquier agente de programación que dejes ejecutándose sin supervisión, y ejecutar Claude Code de forma segura en un VPS lo explica con más detalle.
Después, documenta los pasos de revocación antes de necesitarlos. Eliminar el dispositivo desde la consola de administración de Tailscale corta de inmediato el acceso a la malla. Cambiar HERMES_DASHBOARD_BASIC_AUTH_SECRET y reiniciar invalida todas las sesiones de los paneles del proveedor basadas en contraseña en todos los dispositivos, porque ese valor firma los tokens de sesión del proveedor. Eliminar la clave pública del teléfono de ~/.ssh/authorized_keys bloquea los nuevos inicios de sesión SSH con esa clave; las sesiones SSH y mosh existentes deben terminarse por separado. hermes pairing revoke telegram <user-id> elimina una cuenta de mensajería. Si el dispositivo tenía acceso a algo que pudiera leer las claves de tu proveedor, revócalas con hermes auth logout <provider> y emite otras nuevas en el proveedor.
Comprueba el resultado en lugar de darlo por supuesto. Estos comandos deben ejecutarse en tu propio equipo, y su salida depende de tu configuración:
tailscale status
hermes pairing list
hermes logs gateway -n 100
hermes status --deepLos registros se encuentran en ~/.hermes/logs/. Léelos después de un incidente y también ocasionalmente cuando no haya ocurrido ninguno.
FAQ
¿Existe una aplicación móvil oficial de Hermes para iOS o Android?
No. El repositorio de Hermes incluye una interfaz de línea de comandos, un panel web y un cliente de escritorio basado en Electron para macOS, Windows y Linux. No existe una compilación oficial para iOS o Android. Desde un teléfono puede usar el panel web en un navegador, un cliente SSH o una plataforma de mensajería conectada mediante hermes gateway. También existen clientes móviles de terceros. Son código de terceros que almacena las credenciales de su agente, así que revise el código fuente antes de instalar uno.
¿Por qué el panel de Hermes cierra mi sesión en el teléfono?
Depende del proveedor de inicio de sesión. El proveedor OAuth de Nous Portal emite tokens de acceso con una TTL de 15 minutos y los renueva en segundo plano mediante un token de actualización rotatorio. Por tanto, un token de acceso caducado por sí solo no le redirige a /login. En las versiones anteriores a v0.21.3 (etiqueta v2026.9.14), un teléfono que volvía del segundo plano podía enviar varias solicitudes a la vez, reutilizar el token de actualización recién rotado y revocar toda la sesión. Eso sí obliga a iniciar sesión de nuevo. v0.21.3 corrige este problema, pero una sesión de actualización inactiva durante 30 días también caduca. El proveedor de nombre de usuario y contraseña usa de forma predeterminada un token de acceso de 12 horas, definido por session_ttl_seconds. Este valor sólo controla la frecuencia con la que el panel se actualiza en segundo plano. La renovación se realiza mediante un token de actualización de 30 días que se vuelve a emitir en cada actualización, por lo que un inicio de sesión con contraseña no termina después de 12 horas. Con ese proveedor, establezca HERMES_DASHBOARD_BASIC_AUTH_SECRET en un valor aleatorio estable. Sin un secreto estable en esa variable o en dashboard.basic_auth.secret, Hermes genera una nueva clave de firma cada vez que se inicia y cada reinicio cierra la sesión.
¿Puedo publicar el panel de Hermes en Internet de forma segura?
Sólo si ha verificado personalmente la autenticación. El mecanismo de autenticación se activa según la dirección de enlace y, en las versiones actuales, también cuando dashboard.public_url especifica un host que no es de bucle invertido. Por tanto, un panel enlazado a 127.0.0.1 detrás de un proxy inverso, sin una URL pública configurada, nunca solicita un inicio de sesión. En la versión v2026.8.3, establecer public_url no activa el mecanismo de autenticación de bucle invertido ni permite un nombre de host público mediante sus comprobaciones de Host y del origen de WebSocket. Use la ruta mediante la IP directa de la malla o actualice a una versión que admita nombres de host públicos antes de seguir la configuración del proxy HTTPS. Su comprobación Host rechaza un proxy que reenvía su nombre de host público, pero no uno que reescribe Host con la dirección del backend, como hace nginx de forma predeterminada. Ejecute curl -s https://your-host/api/status | jq '.auth_required' y revise la respuesta. Use OAuth u OIDC en lugar de un nombre de usuario y una contraseña, porque la documentación del proyecto indica que el proveedor de contraseñas está destinado a redes de confianza y VPN. Una malla privada evita por completo esta cuestión, por lo que es la opción predeterminada recomendada.
¿Necesito una cuenta de Tailscale o puedo alojar yo mismo el plano de control?
Puede alojarlo usted mismo. Headscale es una implementación abierta del servidor de coordinación de Tailscale, y los clientes oficiales de Tailscale se conectan a él mediante tailscale up --login-server https://headscale.example.com. De este modo, usted controla la lista de dispositivos autorizados a entrar en la malla. El coste es que debe ejecutar y respaldar ese servidor. Mientras esté inactivo, no podrá inscribir ni volver a autenticar un dispositivo.
¿Cómo recibo una notificación en el teléfono cuando el agente termina un trabajo?
Use la pasarela de mensajería. El panel y SSH no pueden activar un teléfono, porque no existe una aplicación de Hermes en el dispositivo que reciba notificaciones push. Conecte el agente a Telegram, Signal, Discord u otra plataforma compatible mediante hermes gateway setup y deje que la aplicación de esa plataforma entregue la notificación. Un trabajo de cron también puede enviar un único mensaje mediante hermes send -t telegram -s "Job done" -f /path/to/report.txt. Se entrega sin llamar al modelo.