Heimdall: Panel de aplicaciones y lanzador para servidores caseros
Heimdall: Panel de aplicaciones y lanzador para servidores caseros
Organiza y accede a tus servicios autohospedados desde una interfaz centralizada y personalizable
Vídeo tutorial en YouTube
Mira el vídeo completo sobre cómo instalar y usar Heimdall: Panel de aplicaciones y lanzador para servidores caseros en el canal GENBYTE:
¿Qué es Heimdall: Panel de aplicaciones y lanzador para servidores caseros?
Heimdall es un panel de aplicaciones y lanzador desarrollado por LinuxServer.io que permite centralizar el acceso a servicios autohospedados en una única interfaz web. Está diseñado para entornos HTPC y servidores caseros, ofreciendo una página de inicio personalizable donde agregar enlaces a aplicaciones como Plex, Sonarr, Radarr, NZBGet, Sabnzbd, Emby y muchas más. El proyecto está escrito en PHP sobre el framework Laravel y utiliza una base de datos SQLite por defecto, con soporte para MySQL y PostgreSQL.
Características principales
Panel de aplicaciones centralizado
Agrupa enlaces a servicios como Plex, Sonarr, Radarr, NZBGet, Sabnzbd, Emby, CouchPotato, Muximux, Organizr y otros en una sola página de inicio.
Personalización de la interfaz
Permite agregar, editar y organizar aplicaciones con iconos personalizados, colores y disposición en cuadrícula.
Búsqueda integrada
Incluye funcionalidad de búsqueda para localizar rápidamente aplicaciones dentro del panel.
Respaldo y restauración
Ofrece opciones para exportar e importar la configuración del dashboard, facilitando migraciones y copias de seguridad.
Soporte multiidioma
Configurable mediante la variable APP_LOCALE en el archivo de entorno, con inglés como idioma predeterminado.
Autenticación y roles opcionales
Incluye soporte para autenticación basada en encabezados HTTP (AUTH_ROLES_ENABLE) y definición de roles de administrador.
Requisitos del sistema
- Servidor web con PHP 8.1 o superior (requerido por Laravel 10.x)
- Extensiones PHP: OpenSSL, PDO, Mbstring, Tokenizer, XML, Ctype, JSON, BCMath, Fileinfo
- Base de datos: SQLite (por defecto), MySQL/MariaDB o PostgreSQL
- Composer para gestión de dependencias PHP
- Node.js y npm para compilar assets frontend (Vite, Bootstrap, Sass)
- Git para clonar el repositorio
Instalación con Docker Compose
Clonar el repositorio
Descarga el código fuente desde GitHub y accede al directorio del proyecto.
Instalar dependencias PHP
Utiliza Composer para instalar las dependencias del backend Laravel.
Instalar y compilar assets frontend
Instala dependencias de Node.js y compila los assets para producción con Vite.
Configurar variables de entorno
Copia el archivo de ejemplo y ajusta los valores según tu entorno (APP_URL, base de datos, etc.).
Ejecutar migraciones de base de datos
Crea las tablas necesarias en la base de datos configurada (SQLite por defecto).
Servir la aplicación
Inicia el servidor de desarrollo de Laravel o configura un servidor web (Nginx/Apache) apuntando al directorio public/.
Acceder al proyecto
Acceso web
Una vez iniciado el servidor, accede a la interfaz mediante el navegador en la URL configurada en APP_URL (por defecto http://localhost:8000 si usas php artisan serve).
Primer uso
Al acceder por primera vez, se presenta el panel vacío. Utiliza la interfaz de administración para agregar aplicaciones, configurar iconos y personalizar el diseño.
Casos de uso
- Página de inicio personalizada para servidores caseros y HTPC
- Lanzador unificado para suites de medios (Plex, Emby, Jellyfin) y automatización (Sonarr, Radarr, Lidarr)
- Panel de acceso rápido a clientes de descarga (NZBGet, Sabnzbd, qBittorrent, Transmission)
- Dashboard para administradores de sistemas que gestionan múltiples servicios web internos
- Página de aterrizaje para redes locales con enlaces a servicios internos y externos
Configuración avanzada
Configuración de base de datos externa
Modifica .env para usar MySQL o PostgreSQL en lugar de SQLite. Descomenta y completa las variables DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME y DB_PASSWORD.
Habilitar autenticación por encabezados (Reverse Proxy)
Configura AUTH_ROLES_ENABLE=true y define el encabezado que contendrá los grupos del usuario (ej. remote-groups). Requiere un proxy inverso que gestione la autenticación (Authelia, Authentik, Nginx con auth_request).
Permitir peticiones a direcciones internas
Si necesitas que Heimdall realice consultas a URLs internas (iconos, healthchecks) desde el servidor, activa ALLOW_INTERNAL_REQUESTS=true. Por defecto está desactivado por seguridad (SSRF).
Endurecimiento de seguridad (CVE-2025-50578)
Define TRUSTED_PROXIES con los rangos CIDR de tus proxies inversos y TRUSTED_HOSTS con el nombre de host público para prevenir inyección de cabecera Host y redirecciones abiertas.
Gestión y mantenimiento
Actualizar la aplicación
Obtén los últimos cambios del repositorio, actualiza dependencias y ejecuta migraciones.
Limpiar cachés de Laravel
Limpia cachés de configuración, rutas y vistas tras cambios en .env o código.
Respaldar la base de datos SQLite
Copia el archivo de base de datos (por defecto database/app.sqlite) a una ubicación segura.
Exportar configuración del panel
Utiliza la función de respaldo integrada en la interfaz de administración para exportar un archivo JSON con todas las aplicaciones, iconos y ajustes.
Stack técnico
- PHP 8.1+
- Laravel 10.x
- SQLite / MySQL / PostgreSQL
- Vite
- Bootstrap 3 (bootstrap-sass)
- jQuery
- Select2
- SortableJS
- Huebee
- Sass
- ESLint
- Prettier
Referencias oficiales
- Repositorio oficial en GitHub: https://github.com/linuxserver/Heimdall
- Licencia MIT: https://github.com/linuxserver/Heimdall/blob/2.x/LICENSE
- Documentación de LinuxServer.io (imagen Docker): https://docs.linuxserver.io/images/docker-heimdall
Comentarios
Publicar un comentario