Apagados no limpios

An unclean shutdown happens when Unraid detects that the array was not properly stopped before the system powered off. This situation can trigger an automatic parity check during the next boot to ensure data integrity.

Recommendations para prevenir apagados no limpios

Tomar algunas medidas proactivas puede ayudarte a evitar o identificar apagados no limpios:

• Usa un SAI: Mantén tu servidor conectado a un Sistema de Alimentación Ininterrumpida (SAI) y configúralo para iniciar un apagado controlado cuando la energía de la batería sea baja.
• Intentar un apagado ordenado: Si su servidor no responde, presione brevemente el botón de encendido para activar un apagado seguro. No mantenga el botón presionado, ya que esto forzará un apagado duro y provocará un apagado no limpio.
• Habilitar registro persistente: Vaya a Ajustes → Servidor de Syslog para activar el registro que persiste después de un reinicio. Consulte Registros persistentes (servidor Syslog) para más detalles.
• Adjuntar diagnósticos para obtener soporte: Si ocurre un apagado no limpio, Unraid intentará guardar diagnósticos en /log/diagnostics.zip en su dispositivo flash. Adjunte este archivo a las publicaciones del foro cuando busque ayuda.

UPS mejores prácticas de configuración

Un SAI bien configurado es tu mejor defensa contra apagados no limpios causados por pérdida de energía.

• Conecta el SAI vía USB a tu servidor Unraid.
• Habilitar el soporte de SAI en Configuración → Configuración de SAI.
• Configurar tiempos de espera de apagado: Configure el SAI para que desencadene un apagado controlado antes de que la batería se agote. Ajuste los umbrales de "Tiempo restante de la batería" o "Nivel de carga de la batería" para proporcionar tiempo suficiente para que Unraid detenga el array y se apague de forma segura.
• Prueba tu configuración: Simula una pérdida de energía para asegurarte de que el SAI y Unraid respondan correctamente.

Examina el plugin NUT para una mayor compatibilidad con modelos más avanzados de SAI o hardware no compatible.

Eventos que causan apagados no limpios

Comprender los principales desencadenantes de apagados no limpios le ayuda a prevenirlos. Explore las pestañas a continuación para obtener detalles sobre cada escenario.

Pérdida inesperada de energía

Las interrupciones de energía son una de las principales razones de apagados no limpios. Protege tu sistema con un SAI (Sistema de Alimentación Ininterrumpida) configurado correctamente que pueda apagar automáticamente Unraid antes de que se agote la batería.

nota

Unraid admite la mayoría de las unidades SAI utilizando el protocolo apcupsd Protocol (APC y CyberPower suelen ser compatibles). Si tu SAI no es compatible, considera utilizar el plugin Network UPS Tools (NUT) de las Aplicaciones de la Comunidad.

Fallo de unidad flash

El estado de array se guarda en tu dispositivo USB. Si la unidad flash se vuelve inaccesible o entra en un estado de solo lectura, Unraid no puede actualizar el estado de apagado, incluso si el array se detiene correctamente. Esto resulta en un apagado incorrecto que se detecta en el próximo arranque.

Abrir sesiones de terminal

Unraid espera que todas las sesiones abiertas de terminal o SSH se cierren durante el apagado. Si estas sesiones permanecen activas y el temporizador de apagado expira, se produce un apagado forzado.

consejo

El plugin Dynamix Stop Shell puede cerrar automáticamente sesiones de bash o SSH persistentes, ayudando a asegurar un apagado sin problemas. Sin embargo, tenga cuidado si hay operaciones de escritura en curso en el array.

---

Configuración de tiempos de apagado

Configurar correctamente los tiempos de espera de apagado es esencial para asegurar que su servidor Unraid pueda detener efectivamente todos los servicios, previniendo apagados no limpios, especialmente durante pérdidas de energía o mantenimiento. Cada componente de su sistema - VMs, contenedores de Docker, y el array general - tiene su propia configuración de tiempo de espera que puede ajustarse.

Configuraciones recomendadas de tiempo de espera

Configuración	Defecto	Mínimo recomendado	Dónde configurar
%%Tiempo de espera para apagar VMs	vm%%	60s	300s (5 min)
Tiempo de espera para detener contenedor Docker	10s	30–60s	Ajustes → Docker (Avanzado)
Tiempo de espera general de apagado	90s	3 × tiempo de espera de VM + tiempo de espera de Docker + 15–30s	Configuración → Configuración de Disco → Tiempo de espera para apagado

Tiempo de espera para máquinas virtuales

Haga clic para expandir/colapsar

Unraid primero apaga todas las máquinas virtuales configuradas (VMs) antes de detener los contenedores de Docker o el array. El Tiempo de Espera de Apagado de VM determina cuánto tiempo espera Unraid para que cada VM se apague de manera ordenada.

Dónde configurarlo

• Configuración → Gestor de VM → Apagado de VM (activar vista Avanzada)

Considerar

• Las VMs de Windows pueden tardar más en apagarse, especialmente si hay actualizaciones pendientes o la VM está en modo de suspensión/hibernación.
• Si el tiempo de espera es muy corto, las VMs se detendrán a la fuerza, arriesgando pérdida o corrupción de datos.

Mejores prácticas

Establezca el tiempo de espera en al menos 300 segundos (5 minutos) para Windows VMs. Programe las actualizaciones para que se ejecuten al iniciar, no al apagar, para evitar retrasos.

Tiempo de espera para contenedores Docker

Haga clic para expandir/colapsar

Después de las VMs, Unraid detiene todos los contenedores de Docker en ejecución. El Tiempo de Espera para Detener Contenedores Docker controla cuánto tiempo espera Unraid para que cada contenedor salga limpiamente.

Dónde configurarlo

• Configuración → Docker (activar vista Avanzada)

Considerar

• Los contenedores se detienen en paralelo.
• Los contenedores complejos, o aquellos con grandes bases de datos, pueden necesitar más de los 10 segundos predeterminados para apagarse con seguridad.
• Si el temporizador expira, los contenedores se detienen forzosamente.

Mejores prácticas

Aumenta el tiempo de espera a 30–60 segundos si ejecutas contenedores Docker que requieren más tiempo de apagado.

Temporizador general de apagado

Haga clic para expandir/colapsar

El tiempo total de espera de apagado es el tiempo máximo que Unraid permite para todos los procesos de apagado - VMs, Docker y operaciones de disco - antes de forzar un apagado.

Dónde configurarlo

• Configuración → Configuración de Disco → Tiempo de espera para apagado

Cómo calcular

Suma tus tiempos de espera para VM y Docker, luego añade 15–30 segundos para el desmontaje de disco y otros procesos.

• Ejemplo: 3 × ***Tiempo de espera para Apagado de VM*** + ***Tiempo de espera para detener Docker*** + 15–30 segundos

Mejores prácticas

Establece este temporizador lo suficientemente alto para cubrir tu escenario de apagado más lento, especialmente si tienes muchas unidades o un gran array.

Vida útil de la batería del SAI

Haga clic para expandir/colapsar

Tu SAI debe proporcionar suficiente tiempo de funcionamiento para permitir que todos los temporizadores de apagado expiren antes de que el servidor pierda energía.

Dónde configurarlo

• Configuración → Configuración de SAI (ver Tiempo de ejecución restante con todos los discos activados)

Considerar

• El SAI debería activar un apagado lo suficientemente temprano para permitir que toda la secuencia de apagado se complete.
• Si la batería se agota antes de que el apagado se complete, existe el riesgo de un apagado no limpio y posible pérdida de datos.

Mejores prácticas

Prueba tu SAI simulando un corte de energía y confirma que Unraid se apague limpiamente con tiempo de sobra.