caddy-wol

Este plugin de Caddy extiende la funcionalidad del servidor web extendiendo su capacidad de gestión de dispositivos remotos mediante paquetes Wake-on-LAN (WOL). La implementación se realiza a través de un handler HTTP minimalista que envía el paquete mágico correspondiente y luego delega la respuesta al siguiente handler, manteniendo la integridad de la solicitud original. El plugin está escrito en Go y se integra directamente con Caddy mediante su sistema de plugins nativo, sin necesidad de contenedores Docker ni orquestación externa.

La arquitectura del plugin sigue el patrón de error handling integrado de Caddy, permitiendo configurar el orden de ejecución mediante directivas globales como `order wake_on_lan before respond`. Esto garantiza que el paquete WOL se envíe antes de intentar la conexión al destino remoto, optimizando la experiencia del usuario final. El sistema incluye un mecanismo interno de throttling que limita los envíos a una vez cada 10 minutos por host remoto, evitando saturación innecesaria de red y respetando las características de los dispositivos objetivo.

Los casos de uso principales incluyen activar NAS para servicios multimedia como Jellyfin, servidores de juegos o estaciones de trabajo remotos que operan en modo bajo consumo. La configuración se realiza mediante directivas Caddy estándar sin dependencias externas complejas, manteniendo una curva de aprendizaje baja y compatibilidad con despliegues tradicionales.