Cómo simular cortes de luz en homelabs con SAI USB

Por qué proteger tu homelab contra cortes de energía repentinos

Cualquier persona que mantenga un servidor casero o un homelab sabe que la inestabilidad de la red eléctrica es una pesadilla para la integridad de los datos. Cuando la electricidad se corta de manera abrupta, los sistemas de archivos modernos como Ext4 o ZFS sufren escrituras interrumpidas, lo que suele resultar en archivos corruptos y horas de recuperación manual. Para evitar este estrés, la combinación clásica implica utilizar una fuente de alimentación ininterrumpida (SAI o UPS) conectada mediante cable USB y el software NUT (Network UPS Tools), que monitorea la salud de la batería en tiempo real.

En la práctica, NUT actúa como un vigilante silencioso que se ejecuta en segundo plano en tu sistema Linux. Se comunica directamente con el microcontrolador del SAI a través del puerto USB, traduciendo señales eléctricas en métricas comprensibles sobre carga actual, tiempo restante y voltaje de batería. Cuando ocurre un apagón, la compañía eléctrica deja de alimentar el equipo, haciendo que el inversor del SAI entre en acción. Es en ese exacto momento cuando la automatización interviene para evitar que tus servidores mueran de forma abrupta.

La gran ventaja de automatizar este proceso es que no necesitas estar presente físicamente para apagar tus equipos de forma correcta. Antes de alcanzar este nivel de automatización, garantizar que tus componentes físicos estén sanos es fundamental, tal como explicamos al detallar cómo calcular disipación térmica y flujo de aire en servidores para evitar sobrecalentamientos durante el estrés operativo. NUT advierte a los demonios locales y en red que la energía principal ha caído y el tiempo se agota rápidamente.

Instalando y configurando Network UPS Tools en Linux

El primer paso para poner en marcha este mecanismo es instalar los paquetes de NUT en tu distribución Linux, como Debian, Ubuntu o distribuciones derivadas. En la terminal, el proceso inicial requiere únicamente la instalación de los paquetes básicos del servidor y el controlador de comunicación USB. En la práctica, esto significa que el sistema operativo ganará la capacidad de consultar el hardware del SAI periódicamente para saber exactamente cuánta carga queda en el acumulador de energía.

sudo apt update && sudo apt install nut -y

Con los paquetes instalados, necesitamos editar los archivos de configuración principales ubicados en el directorio /etc/nut. El archivo ups.conf define qué controlador usar y qué puerto monitorear. Para la inmensa mayoría de los SAIs interactivos modernos con interfaz USB, el controlador predeterminado recomendado es usbhid-ups. Simplemente abre el archivo de configuración con tu editor de texto favorito y agrega un bloque simple identificando tu dispositivo de energía.

[misai]
driver = usbhid-ups
port = auto
desc = "SAI del Homelab"

Tras guardar el archivo, el siguiente paso es habilitar el modo autónomo o maestro en el archivo nut.conf. El modo maestro es ideal cuando tienes un solo servidor principal conectado físicamente al SAI y deseas que administre los comandos de apagado. Para validar si la conexión USB se estableció con éxito y si el demonio puede leer los datos de la batería, podemos utilizar comandos de consulta nativos del propio ecosistema NUT.

upsc misai@localhost

Simulando cortes de energía y probando el comportamiento del sistema

Muchos administradores configuran el software y cruzan los dedos esperando que todo funcione perfectamente el día que ocurra un apagón real. Esta es una postura sumamente arriesgada, ya que errores de sintaxis o permisos incorrectos en archivos pueden impedir que el comando de apagado se ejecute. El mejor enfoque en la ingeniería de sistemas es simular el escenario de fallo de forma controlada, asegurando que la rutina de apagado responda exactamente como se espera sin poner en riesgo los datos.

En la práctica, la manera más segura de probar sin descargar por completo la batería física de tu SAI es utilizando las funciones de simulación del propio NUT o desconectando temporalmente el cable de alimentación del enchufe de pared. Al retirar el cable, el SAI asume la carga inmediatamente y el comando upsc comienza a mostrar el estado indicando OB, que significa "On Battery" (en batería). Monitorear la estabilidad de la red durante las pruebas también recuerda la importancia de verificar la integridad física de otros componentes, como cuando analizamos cómo probar transistores bipolares en corto con multímetro para aislar fallas en fuentes de banco.

Para configurar la acción automática de apagado, el archivo upsd.users define quién puede enviar comandos, mientras que upsmon.conf gestiona las órdenes finales. Cuando la batería alcanza el nivel crítico definido en la configuración, el demonio upsmon ejecuta el comando de apagado del sistema operativo. Es vital probar este flujo simulando el evento de batería baja a través de parámetros manuales de prueba para verificar que todos los servicios dependientes, contenedores y bases de datos vuelquen la memoria al disco antes del corte total de energía.

Automatizando scripts personalizados de apagado seguro

Apagar el sistema operativo de forma estándar puede no ser suficiente si ejecutas homelabs complejos con decenas de contenedores Docker, máquinas virtuales y bases de datos relacionales pesadas. En tales escenarios, un apagado bruto del sistema puede dejar archivos de bloqueo en bases de datos o corromper volúmenes persistentes. La solución ideal consiste en crear scripts personalizados activados por NUT momentos antes de que el sistema lance el comando final de apagado del host.

El script de notificación y cierre ordenado debe detener primero los servicios críticos, asegurando que las conexiones activas se cierren y las transacciones pendientes se escriban en disco. Podemos configurar el archivo upssched.conf para esperar unos minutos tras el corte de energía —al fin y al cabo, muchos apagones duran solo unos segundos y no justifican apagar todo el parque de servidores. Si la energía no regresa dentro del límite estipulado, el script entra en acción.

#!/bin/bash
echo "¡Energía crítica! Deteniendo contenedores Docker..."
docker stop $(docker ps -a -q)
sync
echo "Sistema listo para apagado seguro."
sudo shutdown -h now

Integrar rutinas de parada controlada garantiza que tus discos duros dejen de girar y los cabezales de lectura regresen a la posición de reposo, eliminando daños mecánicos y lógicos. Para quienes gestionan infraestructuras densas, monitorear cuellos de botella de hardware también ayuda a comprender el comportamiento térmico y de carga antes de los apagones, complementando prácticas como aprender cómo depurar cuellos de botella de memoria RAM con perf en Linux para optimizar los recursos del sistema.

Consideraciones finales sobre resiliencia energética en el homelab

Construir un entorno resiliente en casa requiere atención a los detalles, desde la elección correcta de cables hasta la automatización inteligente de software como NUT. Simular cortes de energía y validar scripts de apagado transforma una infraestructura frágil en un sistema robusto capaz de protegerse ante las incertidumbres de la red eléctrica pública. La inversión de tiempo en la configuración inicial se recompensa ampliamente la primera vez que ocurre un apagón prolongado y tus servidores se apagan de manera totalmente limpia y autónoma.

Al adoptar estas prácticas, garantizas que tus datos permanezcan íntegros, tus discos protegidos y tus servicios listos para operar tan pronto como se restablezca la energía de la red comercial. Documentar tus scripts de automatización y realizar pruebas periódicas cada pocos meses asegura que las actualizaciones del sistema operativo o de NUT no rompan la cadena de comunicación con tu SAI USB.