En resumen: utiliza el flujo actual de Docker Compose de Homarr en lugar de la plantilla de BigBear de 2023
La antigua publicación sobre CasaOS resultaba útil cuando BigBearCasaOS incluía Homarr para la instalación con un solo clic. Homarr ha cambiado considerablemente. Su flujo actual de autoalojamiento utiliza Compose y conserva el estado en /appdata, requiere una SECRET_ENCRYPTION_KEYy opcionalmente puede montar el socket de Docker para las integraciones con contenedores.
Comienza con una definición de Compose persistente
services:
homarr:
image: ghcr.io/homarr-labs/homarr:latest
restart: unless-stopped
ports:
- "7575:7575"
volumes:
- /DATA/AppData/homarr:/appdata
- /var/run/docker.sock:/var/run/docker.sock
environment:
- SECRET_ENCRYPTION_KEY=REPLACE_WITH_64_HEX_CHARSLa instalación de Homarr con Docker actual recomienda Compose y documenta /appdata.
Genera la clave de cifrado antes del primer inicio
openssl rand -hex 32Homarr utiliza este secreto para proteger los datos confidenciales de las integraciones. Mantenlo fuera de las exportaciones públicas de Compose. La generación segura de números aleatorios de OpenSSL explica el comando.
Monta el socket de Docker solo si es necesario
El socket de Docker proporciona un control potente sobre el host. Si Homarr solo necesita enlaces, marcadores y widgets externos, omítelo. Añádelo únicamente para las integraciones compatibles con Docker que utilices de forma intencionada.
Usa la API OpenAPI de ZimaOS para los datos de ZimaOS
Para el almacenamiento o el estado del sistema, utiliza la API OpenAPI de ZimaOS publicada en lugar de analizar el HTML del panel. Los requisitos de las aplicaciones de ZimaOS abarcan la planificación de recursos.
Mantén Homarr en la red interna hasta que la autenticación esté lista
Un panel puede exponer IP internas, puertos y el estado de la infraestructura. No lo publiques directamente sin autenticación ni HTTPS. El proxy HTTPS de ZimaOS proporciona la capa de acceso público.
Actualiza Homarr como contenedor
docker compose down
docker compose pull
docker compose up -dPersistente /appdata sobrevive a la recreación. Por eso el volumen es más importante que conservar el contenedor antiguo.
No pongas la configuración de Homarr únicamente dentro del contenedor
Si /appdata no está asignado a un almacenamiento persistente del host, volver a crear el contenedor puede borrar la configuración. Haz una copia de seguridad de la carpeta de Homarr en el host. La copia de seguridad de ZimaOS proporciona la capa de recuperación.
Usa Homarr como puerta de entrada, no como forma de eludir la administración
Homarr puede centralizar enlaces y mostrar estados de solo lectura, pero cada aplicación subyacente sigue teniendo su propia autenticación. No insertes credenciales de administrador en widgets públicos para obtener acceso con un clic.
Crea el panel por capas en lugar de conectarlo todo desde el primer día
Empieza con enlaces sencillos a ZimaOS, Plex, Home Assistant y otros servicios. Cuando el panel sea estable, añade una integración cada vez. Así será evidente qué integración provocó un bucle de inicio de sesión, una carga lenta de la página o un problema de permisos. Un panel con veinte integraciones de API puede parecer una sola aplicación averiada aunque solo un backend esté agotando el tiempo de espera.
Usa nombres de host internos o IP estables de la LAN
Las instrucciones actuales de Homarr para contenedores recomiendan un nombre de host o una IP directa que los clientes de tu red puedan resolver. Si utilizas un proxy inverso, mantén constante el nombre de host público y asegúrate de que las solicitudes de WebSocket/API utilicen el mismo origen. Evita codificar las IP temporales de Docker, ya que pueden cambiar cuando se vuelven a crear los contenedores.
Haz copias de seguridad de algo más que del diseño
Tu panel puede contener credenciales de integraciones cifradas, cuentas de usuario, iconos y metadatos de servicios. Conserva todo el directorio persistente /appdata al mismo tiempo que la clave de cifrado. Prueba a restaurar una copia en un contenedor de Homarr desechable antes de confiar en ella.
Ten cuidado con las actualizaciones automáticas de contenedores
A menudo, el panel es el primer lugar donde notas si el resto del laboratorio doméstico funciona correctamente. Si Homarr se actualiza automáticamente y falla al mismo tiempo que otro servicio, el diagnóstico se vuelve más difícil. Fija una versión conocida y estable o actualiza manualmente cuando la disponibilidad sea importante; después, avanza a una versión posterior tras realizar pruebas.
Registra la etiqueta exacta de la imagen de Homarr después de cada actualización correcta para que sea fácil volver atrás.
Preguntas frecuentes
¿Sigue siendo necesario BigBearCasaOS para Homarr?
No. Homarr publica su propio procedimiento actual de instalación de Docker y Compose.
¿Qué es SECRET_ENCRYPTION_KEY?
Es un secreto persistente que Homarr utiliza para proteger los datos confidenciales de las integraciones.
¿Necesito el socket de Docker?
Solo para integraciones compatibles con Docker o controles de contenedores.
¿Puede Homarr mostrar los datos del sistema de ZimaOS?
Posiblemente mediante integraciones personalizadas usando la OpenAPI de ZimaOS.
¿Cómo actualizo Homarr de forma segura?
Conserva /appdata, descarga la imagen más reciente, vuelve a crear el servicio y verifica el panel antes de eliminar las imágenes antiguas.
