Cómo ejecutar Hermes Agent en un servidor doméstico sin perder datos

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Respuesta rápida

Para ejecutar Hermes Agent en un servidor doméstico sin perder datos, no dependas del sistema de archivos interno del contenedor como única ubicación para la configuración, las habilidades, los registros, los archivos generados o los ajustes de la puerta de enlace. Planifica primero una carpeta persistente del host o un volumen de Docker, móntalo en la ruta del contenedor que realmente usa la aplicación, comprueba la propiedad de los archivos y verifica que los datos sigan existiendo después de reiniciar o reconfigurar. Este artículo se centra en el problema habitual de que un contenedor no encuentre una carpeta debido a problemas de montaje de volúmenes, permisos o asignación de rutas.

El flujo de trabajo más seguro para principiantes es:

  1. Identifica qué datos de Hermes Agent deben conservarse.
  2. Elige una carpeta dedicada del host o un volumen gestionado por Docker.
  3. Asigna ese almacenamiento a la ruta correcta del contenedor.
  4. Confirma que el usuario de la aplicación pueda escribir en ella.
  5. Haz una copia de seguridad de la configuración importante antes de las actualizaciones o reconstrucciones.
  6. Reinicia y verifica que la configuración, los registros, los archivos generados y los ajustes de la puerta de enlace sigan presentes.

Que un contenedor esté en ejecución no significa automáticamente que tus datos estén seguros. Los datos solo están seguros cuando se almacenan en una ubicación persistente, el usuario correcto tiene permiso para escribir en ella, se hacen copias de seguridad cuando hace falta y se comprueba que sigan disponibles después del reinicio.

Por qué pueden desaparecer los datos de Hermes Agent en una configuración con contenedores

Las aplicaciones en contenedores suelen ser fáciles de iniciar y de sustituir. Esto resulta útil para las actualizaciones, las pruebas y la recuperación, pero también significa que todo lo que se almacene únicamente en la capa desechable del contenedor puede perderse al eliminar, volver a crear o reconstruir el contenedor.

En un agente de IA autoalojado, esto puede afectar a más que la configuración básica. Según cómo uses el agente, quizá te interesen la configuración del modelo, las habilidades, los archivos generados, los registros, la configuración de la puerta de enlace de mensajería y otros datos de la aplicación.

Reinicios de contenedores frente a datos persistentes de la aplicación

Reiniciar un contenedor normalmente no siempre elimina los datos. Si los datos están almacenados en un volumen persistente o en una carpeta del host asignada correctamente, deberían seguir disponibles después del reinicio.

El riesgo aparece cuando los archivos importantes solo están en la capa de escritura del contenedor. Esa capa no es lo mismo que una ubicación de datos persistente planificada. Si vuelves a crear el contenedor sin conservar o volver a montar la ruta correcta, la aplicación puede iniciarse desde cero o no encontrar sus archivos anteriores.

Por qué eliminar o volver a crear un contenedor puede borrar el estado no guardado

Eliminar o volver a crear un contenedor no es lo mismo que reiniciarlo. Un contenedor creado de nuevo puede usar un sistema de archivos interno nuevo, nuevas variables de entorno o una asignación de montaje distinta.

Si la configuración, las habilidades, los registros o los archivos generados por Hermes Agent nunca se guardaron en una carpeta del host persistente o en un volumen, es posible que no se transfieran al nuevo contenedor. Por eso pueden ser ciertas tanto «la aplicación funcionaba ayer» como «la aplicación se restableció después de la actualización».

La práctica segura es tratar la sustitución de un contenedor como un evento que pone en riesgo los datos, a menos que hayas confirmado dónde se almacenan los datos de la aplicación.

Por qué es necesario planificar primero las rutas del host y del contenedor

Una ruta del host es donde se encuentran los datos en el servidor doméstico. Una ruta del contenedor es donde la aplicación ve esos datos desde dentro del contenedor. Un montaje de volumen o de enlace conecta esos dos entornos.

Si la ruta del host es correcta, pero está montada en una ruta incorrecta del contenedor, es posible que la aplicación actúe como si la carpeta no existiera. Si la ruta del contenedor es correcta, pero la ruta del host es temporal, la aplicación puede escribir datos en un lugar distinto al previsto.

Planifica la asignación antes de ejecutar la aplicación, no después de perder los datos.

¿Qué datos debes proteger antes de ejecutar Hermes Agent?

Antes de modificar un contenedor, actualizar una imagen o reconfigurar una pasarela, enumera los datos que sería difícil recrear. No todos los archivos necesitan el mismo nivel de protección, pero debes saber cuáles son críticos.

Una regla útil es proteger todo aquello que almacene identidad, acceso, configuración, flujos de trabajo aprendidos o resultados que no puedas regenerar fácilmente.

Configuración del agente y ajustes del proveedor del modelo

La configuración del modelo suele incluir la selección del proveedor, los valores del endpoint, los nombres de los modelos, las opciones relacionadas con el contexto y el acceso a la API. Si se pierden estos ajustes, es posible que el agente se inicie, pero no responda correctamente.

Guarda la configuración del modelo en una ruta persistente de datos de la aplicación, no en una sesión de shell temporal. Si la configuración se proporciona mediante variables de entorno, conserva una copia segura del archivo compose, el archivo env o las notas de implementación.

Protege también cualquier opción de configuración que determine cómo usa el agente las herramientas de terminal o las pasarelas de mensajería.

Memoria de la aplicación, sesiones, habilidades y estado de ejecución

Los datos de Hermes Agent pueden incluir más de un archivo de configuración. La estructura de datos de las habilidades de Hermes explica que las habilidades se encuentran en ~/.hermes/skills/, que es la fuente principal de verdad para las habilidades incluidas, instaladas desde el hub y creadas por el agente. También describe estados relacionados, como los manifiestos incluidos, los paquetes de habilidades, la configuración de tap del hub, las escrituras de habilidades pendientes y los ajustes de configuración.

Esto importa porque las habilidades creadas por el agente pueden convertirse en memoria procedimental reutilizable. Si se monta la ruta equivocada, puedes perder no solo la configuración, sino también los flujos de trabajo que el agente aprendió o las habilidades que instalaste.

Trata las habilidades, los paquetes, las escrituras pendientes y el estado relacionado con el perfil como datos persistentes del agente.

Descargas, archivos generados, registros y resultados de herramientas

Los archivos generados pueden pasar fácilmente desapercibidos. Durante el uso normal, un agente puede crear planes, scripts, informes, capturas de pantalla, registros o archivos descargados.

Estos archivos pueden guardarse en el espacio de trabajo activo, el directorio de trabajo del backend, el directorio de inicio de la aplicación o una ruta de salida montada. Si esa ubicación está solo dentro del contenedor, los archivos pueden desaparecer cuando se elimine el contenedor.

Para un uso práctico, decide dónde deberían aparecer los archivos generados en el servidor host y comprueba que el contenedor los escriba allí.

Claves de API, tokens de bots y variables de entorno

Los secretos no son datos ordinarios de la aplicación. Las claves de API, los tokens de bots, las contraseñas del panel y las variables de entorno necesitan persistencia y protección.

No guardes secretos en carpetas aleatorias de archivos generados ni en directorios compartidos de acceso amplio. Guárdalos en una ruta de configuración controlada y con acceso limitado.

Una buena configuración para gestionar secretos debería responder a lo siguiente:

  • dónde se guarda el secreto;
  • qué usuario puede leerlo;
  • si está incluida en las copias de seguridad;
  • si la copia de seguridad está cifrada o protegida por controles de acceso;
  • cómo rotar el secreto si queda expuesto.

Rutas del host y del contenedor, y montajes de volúmenes

Este es el concepto clave detrás de la mayoría de los problemas de «el contenedor no encuentra la carpeta» y «los datos desaparecieron después de reiniciar». Un contenedor solo puede ver lo que existe dentro de su propio sistema de archivos o lo que se ha montado en él.

Usa El mapa de supervivencia de los datos del agente para organizar la configuración antes de solucionar problemas.

Módulo del marco de trabajo Pregunta clave Qué te ayuda a decidir Enfoque de configuración y resolución de problemas
Inventario de datos ¿Qué datos deben sobrevivir al reinicio o la recreación del contenedor? Qué configuraciones, habilidades, registros, descargas, tokens y archivos generados necesitan protección Evita tratar los datos importantes del agente como estado desechable
Ruta de persistencia ¿Dónde deberían guardarse los datos persistentes en el host? Si se debe usar una carpeta dedicada del host, un volumen de Docker o un montaje bind Evita que los datos se restablezcan al recrear el contenedor
Asignación de montajes ¿La ruta del host está correctamente asignada a la ruta del contenedor? Si la aplicación realmente puede ver la carpeta deseada Ayuda a diagnosticar errores de carpeta no encontrada y ruta de destino incorrecta
Límites de permisos ¿Qué usuario es propietario de los datos montados y qué usuario escribe en ellos? Si los archivos pertenecen al usuario del host, al usuario del contenedor, al usuario de la aplicación o a root Ayuda a resolver errores de permiso denegado sin que todo quede bajo la propiedad de root
Límites de la copia de seguridad ¿De qué hay que hacer una copia de seguridad antes de actualizar o reconfigurar? Qué datos son esenciales y cuáles son temporales Evita perder la configuración, las habilidades, las sesiones, los tokens y los ajustes de la puerta de enlace
Validación del reinicio ¿Los datos siguen existiendo después de reiniciar o actualizar? Si la configuración es realmente persistente Convierte «funciona» en una comprobación de seguridad repetible

Qué almacena el servidor host

El servidor host almacena las carpetas reales, los discos y las ubicaciones de almacenamiento gestionadas por Docker. Si usas un montaje bind, eliges una carpeta específica del host. Si usas un volumen de Docker con nombre, Docker elige y gestiona la ubicación de almacenamiento.

Esta distinción importa porque la visibilidad desde el host afecta a las copias de seguridad y a la migración. Una carpeta montada mediante un enlace bind puede ser más fácil de localizar y copiar para principiantes. Un volumen con nombre puede ser más ordenado para los datos de aplicaciones gestionados por Docker, pero aun así necesitas saber cómo inspeccionarlo o hacer una copia de seguridad.

Elige el tipo de almacenamiento según necesites carpetas del host legibles para las personas, persistencia de aplicaciones gestionada por Docker o una ruta de copia de seguridad controlada.

Qué puede ver el contenedor

El contenedor ve su propio sistema de archivos interno y todas las rutas montadas. No ve automáticamente todas las carpetas de tu servidor doméstico.

La guía paso a paso de bind mounts de Docker muestra cómo puede aparecer un directorio del host dentro de un contenedor en una ruta de destino y cómo los cambios en los archivos pueden reflejarse entre el host y el contenedor cuando el montaje es correcto.

Esa es la idea central: a la aplicación no le importa dónde exista un archivo en el host, a menos que esté montado en la ruta que utiliza la aplicación.

Cómo los montajes de volúmenes mantienen la persistencia de los datos de la aplicación

Un montaje persistente proporciona a la aplicación un lugar estable donde escribir datos que dure más que un único contenedor. Para los datos de la aplicación, suele marcar la diferencia entre «a salvo de reinicios» y «solo durante la vida útil del contenedor».

El montaje debe coincidir con la ruta de datos que espera la aplicación. Si la aplicación escribe en una carpeta interna y montas una carpeta distinta, los datos podrían seguir guardándose en almacenamiento desechable.

Una buena configuración persistente debe definir:

  • la carpeta del host o el volumen con nombre;
  • la ruta de destino en el contenedor;
  • si el montaje es de lectura y escritura o de solo lectura;
  • qué datos de la aplicación van ahí;
  • cómo se respaldará la ruta.

Por qué una asignación de ruta incorrecta provoca errores de carpeta inexistente

Una asignación de ruta incorrecta suele parecer un problema de carpeta inexistente. La carpeta puede existir en el host, pero el contenedor no puede verla. O el contenedor puede tener una carpeta en la ruta esperada, pero no estar conectada con la carpeta del host que querías usar.

Entre los síntomas más comunes están:

  • la aplicación indica que una carpeta no existe;
  • los archivos generados aparecen dentro del contenedor, pero no en el host;
  • los registros desaparecen al reconstruir el contenedor;
  • la configuración se restablece después de una actualización;
  • editas una carpeta del host, pero la aplicación sigue usando la configuración anterior;
  • los scripts de copia de seguridad se ejecutan, pero no incluyen los datos reales de la aplicación.

Cuando esto ocurra, comprueba juntos la ruta del host y la del contenedor. No inspecciones solo una de ellas.

Cómo ejecutar Hermes Agent sin perder datos

El objetivo no es solo iniciar Hermes Agent. También es asegurarse de que los datos que te importan sobrevivan a los reinicios, las actualizaciones, las reconstrucciones y los cambios de configuración.

Paso 1: Elige una carpeta dedicada para los datos del host

Elige una carpeta para los datos del host antes de ejecutar o reconstruir el contenedor. Debe ser fácil de identificar, de respaldar y no estar mezclada con archivos personales no relacionados.

Una carpeta dedicada reduce el riesgo porque puedes ver qué pertenece a la aplicación. También evita montar todo tu directorio personal u otras carpetas sensibles en el contenedor.

Una carpeta práctica para los datos del host debería:

  • sean específicos de la aplicación;
  • estén fuera de las rutas de descarga desechables;
  • se incluyan en tu plan de copias de seguridad;
  • no se compartan ampliamente con servicios no relacionados;
  • solo puedan escribir en ellos los usuarios o servicios que necesiten acceso.

Paso 2: Monta la carpeta de datos en el contenedor

Monta la carpeta de datos del host en la ruta del contenedor que espera la aplicación. En este punto es donde se producen o se evitan muchos problemas de pérdida de datos.

En un montaje de enlace, tú eliges la ruta del host y la ruta de destino es donde aparece dentro del contenedor. En un volumen con nombre, Docker administra la ubicación en el host.

No des por hecho que la aplicación utilizará automáticamente una carpeta montada. Confirma que la ruta de destino del montaje coincide con la ruta de datos real de la aplicación.

Paso 3: Confirma que el contenedor utiliza la ruta de datos prevista para la aplicación

Después de montar la carpeta, comprueba la ruta desde dentro del contenedor. Puede que una carpeta exista en el host y, aun así, la aplicación no la vea si no está montada correctamente.

La validación más sencilla consiste en crear o localizar un archivo de prueba inocuo en un lado y confirmar que aparece en el otro. Luego, verifica que la aplicación escriba la configuración, los registros o los archivos generados reales en la misma ruta persistente.

Este paso es especialmente importante antes de actualizar o migrar.

Paso 4: Comprueba la propiedad de los archivos y los permisos de escritura

Aunque el montaje sea correcto, puede fallar si la aplicación no puede escribir en él. Los errores de permisos suelen producirse cuando los archivos los crea root, pero luego la aplicación se ejecuta con otro usuario.

Comprueba la propiedad antes de cambiar los permisos de forma generalizada. Lo correcto suele ser permitir que el usuario previsto de la aplicación lea y escriba en la carpeta específica de datos de la aplicación, no dar a todos los procesos control total sobre directorios amplios del host.

Si ves «permiso denegado», identifica lo siguiente:

  1. la ruta montada en el host;
  2. la ruta de destino en el contenedor;
  3. el usuario que ejecuta la aplicación;
  4. el propietario del archivo;
  5. si el montaje es de solo lectura;
  6. si la ruta de copia de seguridad o exportación también permite escritura.

Paso 5: Mantén los secretos y los archivos de configuración fuera de las rutas desechables

Los secretos y los archivos de configuración no deben estar únicamente en carpetas temporales, directorios de salida de archivos generados o historiales de shell improvisados. Si usas variables de entorno, guarda el archivo de implementación o el archivo de entorno en una ubicación persistente y controlada.

Evita mezclar secretos con registros o archivos generados. Es posible que se compartan los registros para solucionar problemas, mientras que los secretos nunca deben compartirse a la ligera.

Si haces copias de seguridad de secretos, protege la copia. Una copia de seguridad que expone claves de API o tokens de bot crea otro tipo de riesgo.

Paso 6: Reinicia el contenedor y verifica que los datos sigan ahí

Después de la configuración, reinicia el contenedor y comprueba si los datos importantes siguen ahí. Esta es la prueba más práctica de persistencia.

No te quedes en «el contenedor se inicia». Confirma lo siguiente:

  • la configuración del modelo siga existiendo;
  • las habilidades o el estado de la aplicación sigan siendo visibles;
  • los registros sigan guardándose en la ubicación prevista;
  • los archivos generados aparezcan en el host;
  • la configuración de la puerta de enlace o del bot siga funcionando;
  • se puedan localizar los archivos de copia de seguridad.

Una configuración que supera la validación tras reiniciar es mucho más segura que una que solo se validó durante la instalación inicial.

Permisos, copias de seguridad y límites de seguridad

La seguridad de los datos depende de tres límites: quién puede escribir, qué se incluye en las copias de seguridad y a qué puede acceder el agente. Estos límites son especialmente importantes para los agentes autoalojados, porque pueden crear archivos, modificar flujos de trabajo o interactuar con herramientas.

Por qué importan los permisos del usuario del contenedor

Los permisos del usuario del contenedor determinan si la aplicación puede leer y escribir sus datos. Si la aplicación se ejecuta con un usuario, pero la carpeta montada pertenece a otro, es posible que fallen las operaciones de escritura.

Por eso, ejecutar un comando de configuración como root puede causar problemas más adelante. La cuenta root puede crear archivos correctamente, pero el usuario habitual de la aplicación quizá no pueda modificarlos.

Corrige los permisos en el nivel de la carpeta de datos de la aplicación. Evita cambios generales en los permisos que expongan archivos del host que no estén relacionados.

Por qué debes evitar ejecutar todo como root

La cuenta root puede eludir muchas restricciones, pero eso no la convierte en una opción predeterminada segura. Ejecutar todo como root puede crear archivos cuya propiedad sea de root, ocultar problemas de permisos y darle a la aplicación más acceso del que necesita.

En la mayoría de los flujos de trabajo de aplicaciones autoalojadas, la cuenta root debe usarse solo para tareas administrativas específicas. Siempre que sea posible, la configuración rutinaria de la aplicación debe ejecutarse con el usuario previsto de la aplicación o del contenedor.

Un enfoque más seguro es el del mínimo privilegio: dale a la aplicación acceso de escritura solo a las carpetas que necesita.

Cuándo usar montajes de solo lectura o carpetas limitadas

Usa montajes de solo lectura cuando el agente necesite inspeccionar archivos, pero no deba modificarlos. Usa carpetas con acceso de escritura limitado cuando el agente necesite crear archivos, pero no deba acceder a directorios personales o del sistema más amplios.

Esto resulta especialmente útil si quieres que el agente genere informes, planes o scripts sin darle acceso de escritura a todos los archivos del servidor.

Un diseño con acceso a carpetas limitadas reduce el impacto de los errores. También facilita las copias de seguridad, porque sabes qué carpeta contiene el estado de la aplicación y cuál contiene los archivos generados.

Cómo hacer copias de seguridad de los datos del agente antes de actualizar o reconfigurar

Haz copias de seguridad de los datos importantes de la aplicación antes de cambiar las imágenes de contenedor, las rutas de montaje, la configuración de la puerta de enlace o los perfiles. Una copia de seguridad solo es útil si sabes qué incluye y cómo restaurarla.

El debate sobre permisos en copias de seguridad de volúmenes de la comunidad de Docker muestra un patrón de fallo común para los usuarios: puede que una ruta exista, pero las operaciones de copia de seguridad o escritura aún pueden fallar por restricciones de permisos, propiedad, etiquetado o relacionadas con el montaje.

Tómalo como un recordatorio para probar las copias de seguridad, no solo crearlas. Un plan de copias de seguridad debe incluir tanto su creación como la verificación de la restauración.

Problemas comunes y cómo solucionarlos

Cuando faltan los datos de Hermes Agent, no reinstales la aplicación de inmediato. Primero identifica qué capa falló: inventario de datos, ruta de persistencia, mapeo de montajes, límite de permisos, límite de copias de seguridad o validación tras el reinicio.

El contenedor no encuentra una carpeta montada

Esto suele significar que la ruta existe en una capa, pero no en la otra. Es posible que la carpeta del host no esté montada, que la ruta de destino del contenedor sea incorrecta o que la aplicación esté buscando en otra ubicación.

Comprueba lo siguiente en este orden:

  1. Confirma que la carpeta exista en el host.
  2. Confirma que el contenedor tenga el montaje.
  3. Confirma la ruta de destino dentro del contenedor.
  4. Confirma que la aplicación esté configurada para usar esa ruta de destino.
  5. Confirma que el usuario de la aplicación pueda leer la carpeta.
  6. Confirma que el montaje se haya vuelto a crear tras cambiar la configuración de Compose o de ejecución.

No intentes solucionarlo creando carpetas aleatorias dentro del contenedor. Eso podría hacer que el error desaparezca temporalmente, pero los datos seguirían en un almacenamiento desechable.

Los datos de la aplicación se restablecen tras reiniciar

Si los datos se restablecen tras reiniciar, es posible que la aplicación esté escribiendo en el sistema de archivos interno del contenedor en vez de en la ruta persistente. También puede estar usando otro perfil, una variable de entorno distinta o un directorio de datos diferente del previsto.

Comprueba si la ruta de datos es la misma antes y después del reinicio. Luego, comprueba si la carpeta está respaldada por un montaje o solo por la capa del contenedor.

Si se volvió a crear la aplicación, confirma que el nuevo contenedor tenga montado el mismo volumen o montaje de enlace.

Errores de permiso denegado en el directorio de datos

«Permiso denegado» significa que la aplicación puede ver la ruta, pero no realizar la acción necesaria. El problema puede deberse al propietario, a la configuración de solo lectura del montaje, a las etiquetas del sistema de archivos o a una discrepancia entre el usuario del host y el del contenedor.

Empieza con la comprobación más sencilla: ¿puede el usuario de la aplicación crear un archivo de prueba inocuo en el directorio de datos? Si no, revisa el propietario y los permisos de esa ruta concreta.

No intentes resolverlo dando acceso de escritura general a todo el directorio del host. Corrige la ruta de datos de la aplicación y el usuario asignado a ella.

Los archivos generados solo se guardan dentro del contenedor

Si los archivos generados desaparecen después de volver a crear el contenedor, probablemente se guardaron dentro del contenedor en lugar de una ruta del host montada. Esto suele ocurrir cuando el directorio de trabajo o el directorio de salida de la aplicación no están vinculados.

Decide dónde deben guardarse los archivos generados. Luego, monta esa carpeta de salida o configura la aplicación para que escriba en una ubicación persistente existente.

Después de cambiar la ruta, genera un archivo de prueba inocuo y confirma que aparece en el host.

Los ajustes del bot o de la puerta de enlace desaparecen tras reconfigurarlos

Los ajustes de la puerta de enlace pueden desaparecer si la configuración se guarda en una ruta no persistente o si, tras reiniciar, la aplicación se ejecuta con otro perfil. También puede ocurrir si una variable de entorno cambia en un lugar, pero el contenedor en ejecución usa otro valor.

Comprueba que la configuración de la puerta de enlace, la referencia al token del bot, la lista de permitidos y los ajustes del panel estén guardados en la ubicación persistente prevista. Luego, reinicia la puerta de enlace y confirma que los ajustes sigan activos.

Si el bot funciona antes de reiniciar, pero no después, céntrate en la persistencia y la configuración del entorno antes de cambiar el token.

Cómo comprobar si los datos de Hermes Agent están seguros

Una configuración segura debe superar las comprobaciones de reinicio, escritura, copia de seguridad y acceso. Estas comprobaciones no tienen que ser complicadas, pero deben repetirse después de cambios importantes.

La configuración se conserva después de reiniciar

Cambia una opción sin importancia, reinicia el contenedor y comprueba que el cambio se mantenga. Así confirmarás que la aplicación escribe en el almacenamiento persistente.

Si la configuración desaparece, no sigas añadiendo más opciones. Primero corrige la ruta de los datos.

Los registros y los archivos generados aparecen en la carpeta esperada del host

Los registros y los archivos generados deben aparecer en la ubicación esperada del host. Si solo aparecen dentro del contenedor, podrían perderse al reconstruirlo.

Comprueba ambos lados del montaje. El host y el contenedor deben coincidir en cuanto a los archivos importantes.

El agente puede escribir en los datos de la aplicación sin errores de permisos

El agente debe poder escribir en la carpeta de datos de la aplicación como el usuario previsto. Una prueba de escritura satisfactoria es más útil que simplemente confirmar que la carpeta existe.

Después de reiniciar, busca errores de permisos en los registros. Algunos problemas de permisos solo aparecen cuando el agente intenta actualizar la configuración, escribir una habilidad, guardar un archivo generado o actualizar el estado de la pasarela.

Los archivos de copia de seguridad se pueden localizar y restaurar

Una copia de seguridad no está completa hasta que puedas encontrarla y restaurarla en una ubicación de prueba. Como mínimo, confirma que contiene los datos que querías proteger.

En configuraciones importantes, restaura la copia de seguridad en una carpeta independiente o en una instancia de prueba antes de confiar en ella. Así evitarás descubrir problemas de restauración solo después de perder datos.

El acceso al panel o a la mensajería sigue funcionando después de reiniciar

Después de reiniciar, verifica que el acceso al panel o a la mensajería siga funcionando. Así confirmarás que los datos persistentes, las credenciales, la configuración de la pasarela y el acceso a la red siguen funcionando correctamente.

Si el panel funciona, pero la mensajería falla, comprueba la configuración de la pasarela y el acceso al token. Si la mensajería funciona, pero los archivos generados desaparecen, comprueba la ruta de salida y los montajes.

Cómo funciona en un entorno real de servidor doméstico

En una configuración real de servidor doméstico, se aplica la misma lógica de seguridad de los datos aunque el sistema ofrezca un panel intuitivo. Aun así, debes saber qué datos deben conservarse, dónde se almacenan, cómo accede el contenedor a ellos, qué usuario puede escribirlos y cómo verificarlos después de reiniciar.

Por ejemplo, el flujo de configuración de ZimaOS Hermes Agent muestra un proceso específico para el dispositivo que incluye configurar el proveedor de modelos, configurar la pasarela de Telegram, acceder al contenedor de Hermes, activar el entorno de la aplicación, comprobar el panel web y resolver problemas de permisos o de respuesta del bot.

Para quienes ejecutan aplicaciones Docker, flujos de trabajo de agentes y servicios locales en un equipo compacto que funciona siempre, el servidor doméstico ZimaBoard 2 es un ejemplo pertinente del tipo de entorno de servidor doméstico ligero en el que conviene planificar conjuntamente las carpetas persistentes, las rutas de los contenedores, los permisos y la ampliación del almacenamiento. No es la única configuración posible, pero encaja con el tipo de flujo de trabajo de aplicaciones autoalojadas que se aborda en esta guía.

La lección general puede aplicarse a cualquier caso: antes de confiar trabajo importante a un agente en contenedor, asegúrate de que sus datos esenciales persistan más allá del contenedor que esté en ejecución en ese momento.

Preguntas frecuentes

¿Por qué desaparecieron mis datos de Hermes Agent después de reiniciar el contenedor?

Un simple reinicio no debería eliminar los datos persistentes, pero puede parecer que la aplicación se ha restablecido si escribía en una ruta no persistente del contenedor. También es posible que falten datos si se recreó el contenedor sin el mismo volumen o montaje de enlace. Comprueba la ruta del host, la ruta del contenedor y la ruta real de los datos de la aplicación antes de cambiar más ajustes.

¿Cuál es la diferencia entre un volumen de Docker y un montaje de enlace?

Docker administra un volumen de Docker, mientras que un montaje de enlace asocia una carpeta del host que elijas con el contenedor. Un volumen suele ser una opción ordenada para los datos administrados por la aplicación, mientras que un montaje de enlace es más fácil de localizar directamente en el host. La mejor opción depende de si prefieres que Docker administre el almacenamiento o tener una carpeta visible en el host para hacer copias de seguridad e inspeccionarla.

¿Dónde debería guardar los datos de Hermes Agent en un servidor doméstico?

Usa una carpeta persistente dedicada o un volumen de Docker en lugar de una ruta temporal del contenedor. La ubicación debe ser fácil de respaldar, limitarse a las necesidades de la aplicación y no mezclarse con archivos confidenciales sin relación. Lo más importante es que la ruta del contenedor que espera la aplicación esté realmente asociada a ese almacenamiento persistente.

¿Por qué el contenedor dice que una carpeta no existe?

Es posible que la carpeta exista en el host, pero no dentro del contenedor. Esto suele significar que no se creó el montaje, que la ruta de origen o la ruta de destino es incorrecta, o que la aplicación está buscando en otra ruta del contenedor. Comprueba tanto el lado del host como el del contenedor en lugar de crear una carpeta nueva sin más.

¿Debería ejecutar Hermes Agent como root para evitar errores de permisos?

Ejecutarlo como root puede ocultar el error inmediato, pero puede crear archivos cuyo propietario sea root y aumentar el riesgo. Una opción más segura es permitir que el usuario previsto de la aplicación lea y escriba únicamente en la ruta de datos necesaria. Usa root solo para acciones administrativas o de reparación específicas cuando entiendas el cambio.

¿Con qué frecuencia debería hacer una copia de seguridad de los datos de Hermes Agent?

Haz una copia de seguridad antes de las actualizaciones, las reconstrucciones de contenedores, los cambios de rutas, la reconfiguración de la puerta de enlace o la migración a otro servidor. Si lo usas activamente, programa copias de seguridad regulares según la frecuencia con la que cambien las habilidades, la configuración, los archivos generados o las sesiones. Una copia de seguridad no es fiable hasta que hayas confirmado que puedes encontrar y restaurar los archivos.

Soporte y consejos

Más para leer

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.