UpSnap | Wake on LAN | Docker
UpSnap: Gestión de Wake-on-LAN desde web en Docker
Enciende, apaga y gestiona tus dispositivos de red desde un navegador. Descubrimiento automático, permisos por usuario, escaneo de red y control remoto de máquinas.
¿Qué es UpSnap?
UpSnap es una
aplicación web para Wake-on-LAN (WOL) escrita en SvelteKit, Go y PocketBase. Permite encender computadoras y dispositivos de red remotamente usando Magic Packets, apagar máquinas via SSH o comandos personalizados, y gestionar todo desde una interfaz web limpia y moderna.
A diferencia de herramientas WOL tradicionales de línea de comandos o aplicaciones móviles limitadas, UpSnap ofrece una solución completa con gestión de usuarios, permisos granulares, descubrimiento automático de dispositivos en tu red, programación de encendidos, y más. Todo autohospedado en Docker con almacenamiento PocketBase.
Perfecto para: Apagar laboratorios de ordenadores, encender máquinas home-lab, gestionar servidores domésticos, crear automatizaciones para equipos en tu red local sin necesidad de herramientas comerciales costosas.
Características principales
Wake-on-LAN
Enciende máquinas en tu red local enviando Magic Packets a su dirección MAC.
Apagado remoto
Apaga dispositivos via SSH, comandos personalizados o scripts shell.
Descubrimiento automático
Escanea tu red con nmap para encontrar y añadir dispositivos automáticamente.
Control de usuarios
Permisos granulares: admins y usuarios normales con acceso por dispositivo.
Gestión de dispositivos
Añade, edita, elimina dispositivos con notas, nombres personalizados y metadatos.
Ping y estado
Verifica si un dispositivo está encendido o apagado con ping en tiempo real.
Cron y programación
Programa encendidos/apagados automáticos a horas específicas.
Interfaz responsive
Funciona en desktop, tablet y móvil para acceso desde cualquier lugar.
Base de datos integrada
PocketBase integrado, sin necesidad de base de datos externa.
Multiidioma
Interfaz disponible en múltiples idiomas incluyendo español.
API REST
API completa para automatizar y integrar con otras herramientas.
Open Source
100% código abierto bajo licencia MIT. Completamente gratuito para siempre.
Instalación rápida
Opción 1: Docker Run (lo más simple)
docker run --network=host \
-v upsnap-data:/app/data \
ghcr.io/seriousm4x/upsnap:5
Accede a http://localhost:8090 y crea tu cuenta de administrador en el primer acceso.
Importante: --network=host es necesario para que WOL funcione correctamente (envío de Magic Packets).
Opción 2: Docker Compose (recomendado)
Paso 1: Crear docker-compose.yml
services:
upsnap:
image: ghcr.io/seriousm4x/upsnap:5
container_name: upsnap
network_mode: host
volumes:
- upsnap-data:/app/data
restart: unless-stopped
volumes:
upsnap-data:
Paso 2: Iniciar UpSnap
docker compose up -d
Paso 3: Acceder a la aplicación
Abre http://localhost:8090 en tu navegador.
Docker Compose con todas las opciones
services:
upsnap:
image: ghcr.io/seriousm4x/upsnap:5
container_name: upsnap
network_mode: host
volumes:
- upsnap-data:/app/data
environment:
- UPSNAP_HTTP_LISTEN=0.0.0.0:8090
- TZ=Europe/Madrid
restart: unless-stopped
volumes:
upsnap-data:
Configuración inicial
Crear cuenta de administrador
- Accede a
http://localhost:8090 en tu navegador
- Completa el formulario de registro (primera cuenta es automáticamente admin)
- Inicia sesión
Descubrir dispositivos en la red
- Ve a Settings → Network Scan
- Introduce tu rango de red (ej:
192.168.1.0/24)
- Haz clic en Scan
- Espera a que termine el escaneo (puede tomar 1-5 minutos)
- Selecciona los dispositivos que quieras añadir
- Haz clic en Add Selected
Nota: El escaneo requiere nmap. Si no está disponible, añade dispositivos manualmente con su dirección MAC.
Añadir dispositivo manual
- Ve a Devices
- Haz clic en Add Device
- Completa los campos:
- Name: Nombre visible (ej: "Gaming PC")
- MAC Address: Dirección MAC del dispositivo
- IP Address: IP del dispositivo (para ping, opcional)
- Broadcast Address: Dirección de broadcast de la red
- Haz clic en Save
Configurar apagado remoto (SSH)
Para apagar máquinas remotamente, UpSnap puede usar SSH con claves.
Generar clave SSH en el contenedor
docker exec upsnap ssh-keygen -t rsa -N "" -f /app/data/upsnap-key
Configurar en UpSnap
- Ve a Settings → SSH Config
- Pega la clave privada generada
- Para cada dispositivo, ve a Device Details → Shutdown Config
- Configura el comando de apagado (ej:
shutdown -h now en Linux)
- Prueba la conexión
Comando de apagado por SO
- Linux:
shutdown -h now o poweroff
- Windows (Powershell):
Stop-Computer -Force
- macOS:
shutdown -h now
Gestión de permisos de usuarios
UpSnap permite control granular de quién puede hacer qué:
Niveles de acceso
- Admin: Control total. Puede crear usuarios, modificar dispositivos, cambiar configuración
- User: Acceso limitado a dispositivos específicos según permisos asignados
Permisos por dispositivo
Para cada dispositivo, admins pueden asignar a usuarios específicos:
- View: Ver el dispositivo en la lista
- Edit: Editar nombre, IP, MAC y configuración del dispositivo
- Wake: Encender el dispositivo (WOL)
- Shutdown: Apagar el dispositivo
Crear usuario y asignar permisos
- Ve a Settings → Users
- Haz clic en Add User
- Introduce email y contraseña
- Haz clic en el usuario para editar permisos por dispositivo
- Marca/desmarca los permisos según necesites
- Guarda los cambios
Configurar reverse proxy (Caddy)
upsnap.tudominio.com {
reverse_proxy localhost:8090
}
Con ruta personalizada (Nginx)
location /upsnap/ {
proxy_pass http://localhost:8090/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
También actualiza el variable de entorno en docker-compose:
- UPSNAP_BASE_URL=/upsnap/
Consideraciones de seguridad
Advertencia importante: El comando de apagado se ejecuta como shell. Si alguien obtiene acceso no autorizado y puede abusar de esta ruta API, tendría acceso a un shell en tu red local (posiblemente como root si corres Docker como root).
Recomendaciones de seguridad
- No expongas a Internet: UpSnap está diseñado para usar en red local. Si necesitas acceso remoto, usa VPN (Wireguard, OpenVPN)
- Usa reverse proxy con autenticación: Añade autenticación extra con Authelia o similar si accedes desde fuera de tu red
- Contraseñas fuertes: Usa contraseñas complejas para todas las cuentas
- Limita permisos: Asigna solo los permisos necesarios a cada usuario
- Actualiza regularmente: Mantén UpSnap y Docker actualizados
Gestión y mantenimiento
Ver logs
docker compose logs -f upsnap
Reiniciar UpSnap
docker compose restart upsnap
Detener UpSnap
docker compose down
Actualizar a la última versión
docker compose pull
docker compose up -d
Acceder al shell del contenedor
docker compose exec upsnap sh
Backup de datos
docker run --rm \
-v upsnap-data:/data \
-v $(pwd):/backup \
alpine tar czf /backup/upsnap-backup-$(date +%Y%m%d).tar.gz -C /data .
Casos de uso
- Laboratorio escolar: Encender y apagar múltiples ordenadores simultáneamente
- Home lab: Gestionar servidores y máquinas virtuales desde una interfaz centralizada
- Empresa pequeña: Control de estaciones de trabajo sin necesidad de software costoso
- Gaming: Encender/apagar ordenadores gaming desde cualquier dispositivo
- Automatización: Integración con automatización del hogar para control de energía
- Data center pequeño: Gestión de múltiples servidores sin hardware especializado
- Ahorro de energía: Apagar ordenadores automáticamente fuera de horario de trabajo
Sígueme en mis redes sociales
Comentarios
Publicar un comentario