Entra en casa desde fuera
Accede a tus aplicaciones y a tu red doméstica cuando estás fuera, como si siguieras conectado a tu Wi-Fi.
Tu casa, contigo
Tu propia VPN para entrar en casa desde cualquier sitio
HEIMDALL convierte una Raspberry Pi o un PC con Linux en una puerta segura para tus móviles, ordenadores y dispositivos.
Sin complicaciones
Empieza en 5 minutos
Cuatro pasos en tu Raspberry Pi (64 bits) o PC Linux. El instalador comprueba todo antes y te dice cómo arreglar lo que falte.
Descarga y comprueba
No cambia nada: revisa Docker, la arquitectura y que los puertos de la VPN y del panel estén libres.
git clone https://github.com/BertMarti/HEIMDALL.git cd HEIMDALL && ./install.sh --comprobarInstala
Tres preguntas con respuesta por defecto: contraseña (Enter genera una segura que verás una sola vez), tu dirección pública o DuckDNS y el puerto.
./install.shAbre un puerto en el router
Redirige UDP 51820 hacia la IP de la máquina (ejemplo:
192.168.1.50). Solo ese: el panel se queda dentro de casa.Crea un cliente y escanea el QR
En el panel, «Nuevo cliente». En el móvil, la app WireGuard → «+» → escanear QR. Pruébalo con datos, sin Wi-Fi.
La idea sencilla
¿Qué es HEIMDALL?
Una VPN es como un túnel privado entre tu dispositivo y tu casa. HEIMDALL lo construye con WireGuard y lo administra desde un panel web.
Más tranquilidad en Wi-Fi pública
Usa tu conexión de casa al navegar desde una red pública, con el túnel WireGuard activo.
Bloqueo de anuncios fuera
Si tienes SHIELD-DNS instalado, tus dispositivos conectados también pueden llevarse ese bloqueo a todas partes.
Panel y QR, sin líos
Crea dispositivos desde el panel, escanea un QR en el móvil o descarga un archivo .conf. Es gratis, autoalojado y con licencia MIT.
El viaje de tus datos
Cómo funciona
Solo necesitas abrir en el router el puerto de WireGuard. El panel se queda dentro de casa.
Móvil en 4Gtu dispositivo
Internettúnel cifrado
Tu routerUDP 51820
HEIMDALLWireGuard
Tu red de casa
SHIELD-DNSopcional · sin anuncios
Sin magia negra
Instalar, paso a paso
Sigue el orden. Los valores son ejemplos: 192.168.1.50 es la máquina de HEIMDALL y 192.168.1.1 el router.
01
Comprueba los requisitos
Raspberry Pi 4/5 de 64 bits o PC/mini-PC con Debian, Ubuntu u otra distribución Linux. Necesitas una IP fija en casa, acceso al router y una IP pública sin CG-NAT. Docker Compose v2 se instala si falta. Tras clonar, ./install.sh --comprobar lo revisa todo sin cambiar nada.
02
Prepara la máquina
sudo apt update && sudo apt install -y git openssl curl¿Quieres SHIELD-DNS? Instálalo antes para que HEIMDALL lo use como DNS automáticamente.
03
Clona e instala
mkdir -p ~/homelab && cd ~/homelab
git clone https://github.com/BertMarti/HEIMDALL.git
cd HEIMDALL
./install.sh04
Abre el panel en casa
Visita https://192.168.1.50:51843. Acepta el aviso del certificado propio. La contraseña está en:
grep WG_ADMIN_PASSWORD ~/homelab/HEIMDALL/.env05
Abre solo el puerto necesario
En el router crea un reenvío UDP 51820 → 192.168.1.50:51820. No abras nunca el panel TCP 51843 a Internet.
¿Quieres todo el ecosistema? El instalador de ARIA prepara las aplicaciones en el orden correcto.
curl -fsSL https://raw.githubusercontent.com/BertMarti/ARIA/main/instalar-todo.sh | bash
El día a día
Usar HEIMDALL
Una vez instalado, añadir un dispositivo es cuestión de un minuto.
Móvil o tablet con QR
- Instala WireGuard desde App Store o Google Play.
- En HEIMDALL, crea un cliente nuevo y pulsa el icono QR.
- En WireGuard, toca + y escanea el código.
- Activa el túnel.
Si pierdes un móvil, desactívalo o bórralo en el panel cuanto antes.
Ordenador
Instala WireGuard, descarga su archivo .conf desde el panel e impórtalo como túnel.
Android TV
Las teles con Android TV o Google TV pueden instalar WireGuard e importar el QR o el archivo .conf.
IP que cambia
Usa DuckDNS gratis con un nombre como micasa.duckdns.org para que tu dirección siga apuntando a casa.
Todo en un mismo lugar
HEIMDALL con ARIA
ARIA es el asistente y panel central de la casa. Cuando se integra con HEIMDALL, te ahorra entrar al panel para las tareas habituales.
¿Qué añade ARIA?
- Mosaico en Inicio y tarjeta HEIMDALL en el Centro de control.
- Chat y Telegram con
/vpny/nuevovpn. - Añadir dispositivos con QR o
.conf, activar, desactivar y eliminar con confirmación. - Avisos si HEIMDALL cae, accesos temporales y aviso de ubicación nueva.
- Resumen diario e informe semanal del uso.
ARIA
Asistente de IA y panel central de la casa.
SHIELD-DNS
Pi-hole + Unbound para bloquear anuncios.
HEIMDALL
Tu VPN WireGuard para entrar desde fuera.
Cuando algo no encaja
Preguntas frecuentes
Desde fuera de casa no conecta
Comprueba el reenvío UDP 51820 hacia 192.168.1.50 y prueba con el móvil usando datos, no Wi-Fi. Mira si aparece un último handshake.
¿Tengo CG-NAT?
Compara la IP WAN del router con la que muestra un servicio de consulta de IP pública. Si no coinciden, o empieza por 100.64. hasta 100.127., pide una IP pública a tu operador. DuckDNS no lo soluciona.
Conecta pero no navega
Revisa el DNS de la VPN. Si usas SHIELD-DNS, comprueba que está en marcha con docker ps.
Dejó de funcionar tras unos días
Probablemente cambió tu IP pública. Configura DNS dinámico con DuckDNS.
Olvidé la contraseña del panel
Si nunca la cambiaste desde el panel, consulta grep WG_ADMIN_PASSWORD .env. Si la cambiaste, el valor de .env no se actualiza solo.
¿Funciona en Windows?
No. HEIMDALL necesita una máquina Linux; WireGuard dentro de WSL2 o Docker Desktop no recibe conexiones de fuera de forma fiable.
¿Es gratis?
Sí. HEIMDALL es autoalojado y tiene licencia MIT. Tú pones la máquina y la conexión de casa.
¿Cómo hago copias de seguridad?
Ejecuta ./backup.sh. Guarda la copia fuera de la máquina y en un sitio seguro: contiene las claves privadas del servidor y de los dispositivos.
