Saltar al contenido
ES EN
Tema: automático

Laboratorio · Almacenamiento

Vigila la salud de los discos de tu NAS con Scrutiny en Docker Compose

Despliega Scrutiny v0.10.0 con Docker Compose: panel S.M.A.R.T., recolector, avisos por Shoutrrr, copia de la configuración y limpieza total.

Laboratorio · Almacenamiento

40 min nivel medio configuración validada

Arquitectura del laboratorioComponentes: Navegador, Scrutiny omnibus, Recolector + smartctl, InfluxDB, Discos del NAS, Servicio de avisos.HTTPS.M.A.R.T.APIseries temporalesURL ShoutrrrNavegador: paso 3Navegadorpanel en 127.0.0.1:8080Recolector + smartctl: paso 2Recolector + smart…dentro del contenedorScrutiny omnibus: paso 3Scrutiny omnibuscontenedor :8080, v0.10…Discos del NAS: paso 1Discos del NAS/dev/sda, /dev/sdbInfluxDB: paso 3InfluxDBintegrado en el contene…Servicio de avisos: paso 2Servicio de avisosShoutrrr (ntfy, Telegra…
  1. Navegador · paso 3 panel en 127.0.0.1:8080
  2. Scrutiny omnibus · paso 3 contenedor :8080, v0.10.0
  3. Recolector + smartctl · paso 2 dentro del contenedor
  4. InfluxDB · paso 3 integrado en el contenedor
  5. Discos del NAS · paso 1 /dev/sda, /dev/sdb
  6. Servicio de avisos · paso 2 Shoutrrr (ntfy, Telegram…)

Qué vas a montar y por qué

Un RAID o unos snapshots te protegen cuando un disco ya ha fallado; S.M.A.R.T. sirve para enterarte de que va a fallar. El problema es que smartd no guarda histórico, no distingue entre atributos críticos e informativos y no tiene interfaz web. Scrutiny resuelve eso con un panel que recoge los datos de smartctl, los guarda como serie temporal y los compara con tasas de fallo reales.

En este laboratorio montarás la imagen omnibus (panel web, recolector e InfluxDB en un solo contenedor) con Docker Compose y versión fijada, ajustarás el recolector, configurarás avisos por Shoutrrr, harás copia de la configuración y sabrás cómo retirar todo. Fijamos la versión v0.10.0, la última publicada en las notas de versión, porque es la que documenta las claves globales de notify que usaremos. Son instrucciones para seguir en tu propia máquina Linux; adapta los dispositivos /dev/sdX a tus discos.

Laboratorio: Vigila la salud de los discos de tu NAS con Scrutiny en Docker Compose

Requisitos

SistemaLinux (Debian 12 / Ubuntu 24.04) con discos SATA/SAS accesibles
Docker Engine28.5.2
Docker Compose5.7.1
Scrutiny (imagen omnibus, incluye smartctl)v0.10.0
curl8.21.0
RAM2 GB
Disco5 GB

Paso a paso

  1. Identifica tus discos y prepara los directorios

    Scrutiny detecta discos con smartctl --scan, pero el contenedor solo puede leerlos si le pasas cada dispositivo con --device (en Compose, la clave devices). Por eso primero necesitas saber qué dispositivos tiene tu máquina. Si usas RAID por controladora, pasa también los dispositivos que muestre smartctl --scan en tu host.

    Crea además las carpetas donde persistirán la configuración y la base InfluxDB. Sin volúmenes, perderías el histórico al recrear el contenedor.

    lsblk -d -o NAME,SIZE,MODEL
    mkdir -p ~/scrutiny/config ~/scrutiny/influxdb
    cd ~/scrutiny

    Salida esperada (ilustrativa: el formato exacto puede variar)

    NAME   SIZE MODEL
    sda    3.6T WDC WD40EFRX-68N
    sdb    3.6T WDC WD40EFRX-68N
  2. Escribe la configuración del recolector y de los avisos

    Escribe los archivos de configuración antes de levantar el contenedor, así el servicio los lee desde el primer arranque. El directorio por defecto de ambos es /opt/scrutiny/config, que con nuestro volumen es ~/scrutiny/config.

    En collector.yaml decides qué discos vigilar (allow_listed_devices; si lo omites, se recogen todos los detectados) y puedes forzar tipo o ignorar discos con la clave devices. Los umbrales de alerta no los inventas tú: Scrutiny combina los valores del fabricante con tasas de fallo reales y destaca en el panel los atributos críticos.

    En scrutiny.yaml, notify.urls acepta URLs de Shoutrrr. Con on_missed_upload recibes un aviso si un disco deja de reportar, con upload_period fijas cada cuánto esperas datos (0s lo estima a partir de las últimas subidas) y con on_smartctl_error te avisa si smartctl falla. Estas claves globales aparecen en la línea v0.10.0, por eso fijamos esa versión. Cambia CHANGE_ME_NTFY_TOPIC por un tema difícil de adivinar de tu servicio ntfy (o usa otra URL de Shoutrrr); no publiques esa URL, porque equivale a una credencial.

    Fichero config/collector.yaml

    version: 1
    
    host:
      id: 'nas-casa'
    
    allow_listed_devices:
      - /dev/sda
      - /dev/sdb
    
    log:
      level: INFO

    Fichero config/scrutiny.yaml

    version: 1
    
    web:
      listen:
        port: 8080
        host: 0.0.0.0
      database:
        location: /opt/scrutiny/config/scrutiny.db
      src:
        frontend:
          path: /opt/scrutiny/web
    
    log:
      level: INFO
    
    notify:
      on_missed_upload: true
      upload_period: 0s
      on_smartctl_error: true
      urls:
        - ntfy://ntfy.sh/CHANGE_ME_NTFY_TOPIC

    Sustituye cada valor CHANGE_ME_… por uno tuyo antes de arrancar: no dejes contraseñas ni claves de ejemplo.

  3. Escribe el Compose con la versión fijada y arranca

    El proyecto avisa de que usar etiquetas latest- puede actualizar la imagen sin avisarte, y publica etiquetas semver como v0.10.0-omnibus. Fijamos esa. El panel (8080) se publica solo en 127.0.0.1: si quieres abrirlo a tu red, pon un proxy inverso con autenticación delante. No publicamos el 8086 de InfluxDB porque nada fuera del contenedor lo necesita.

    /run/udev en solo lectura da al recolector los metadatos de los dispositivos y SYS_RAWIO permite a smartctl consultar los datos S.M.A.R.T. Ajusta la lista de devices a tus discos. Si tuvieras discos NVMe, la documentación pide además SYS_ADMIN y pasar su dispositivo (el que te muestre smartctl --scan); añádelos también a allow_listed_devices.

    Después de docker compose up -d, la recogida de datos ocurre sola; revisa los registros para confirmar que arranca sin errores.

    Fichero compose.yaml

    services:
      scrutiny:
        image: ghcr.io/analogj/scrutiny:v0.10.0-omnibus
        container_name: scrutiny
        restart: unless-stopped
        ports:
          - "127.0.0.1:8080:8080"
        cap_add:
          - SYS_RAWIO
        volumes:
          - ./config:/opt/scrutiny/config
          - ./influxdb:/opt/scrutiny/influxdb
          - /run/udev:/run/udev:ro
        devices:
          - "/dev/sda"
          - "/dev/sdb"
    docker compose up -d
    docker compose ps
    docker compose logs --tail 30 scrutiny

    Salida esperada (ilustrativa: el formato exacto puede variar)

    NAME       IMAGE                                     COMMAND   SERVICE    CREATED          STATUS          PORTS
    scrutiny   ghcr.io/analogj/scrutiny:v0.10.0-omnibus  "/init"   scrutiny   10 seconds ago   Up 9 seconds    127.0.0.1:8080->8080/tcp
  4. Abre el panel y revisa los discos

    Abre http://127.0.0.1:8080 en el navegador. Si el NAS no tiene pantalla, haz un túnel SSH al puerto 8080 en lugar de exponerlo. Los discos aparecen tras la primera recogida del recolector; si tras unos minutos el panel sigue vacío, mira el apartado de problemas.

    Si editas collector.yaml o scrutiny.yaml más adelante, docker compose restart scrutiny es suficiente para que el contenedor relea esos archivos; un cambio en compose.yaml (dispositivos, puertos, etiqueta) requiere docker compose up -d de nuevo.

    docker compose restart scrutiny
    docker compose logs --tail 30 scrutiny
  5. Copia la configuración

    Lo que no puedes regenerar es la configuración y el histórico. Con nuestros volúmenes todo vive en ~/scrutiny/config (incluye scrutiny.yaml, collector.yaml y la base scrutiny.db) y en ~/scrutiny/influxdb (series temporales). Para una copia coherente, detén el servicio unos segundos, empaqueta y vuelve a arrancar.

    Los archivos de datos los crea el contenedor y pueden pertenecer a root, por eso el tar va con sudo. Guarda el archivo resultante en otro disco o máquina, no en el que vigilas, y recuerda que scrutiny.yaml contiene la URL con tu tema de avisos.

    docker compose stop scrutiny
    sudo tar -czf ~/scrutiny-backup-$(date +%F).tar.gz -C ~ scrutiny/config scrutiny/influxdb
    docker compose start scrutiny

Comprueba que funciona

  1. El contenedor está en marcha y el panel responde

    Comprueba el estado con Compose y pide solo el código HTTP del panel; debe devolver 200.

    docker compose ps
    curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080

    Salida esperada (ilustrativa: el formato exacto puede variar)

    200
  2. Los discos aparecen con datos

    En el panel debes ver cada disco con su estado y temperatura. Si falta alguno, revisa los registros del contenedor.

    docker compose logs --tail 30 scrutiny
Si algo falla

El panel sale vacío, sin discos.

Lee los registros con docker compose logs scrutiny. Normalmente falta el devices del disco en el Compose o SYS_RAWIO en cap_add. Comprueba la lista con smartctl --scan en el host y pasa todos los dispositivos que muestre.

Un disco aparece con datos incompletos o no se detecta (RAID, adaptadores USB).

La detección automática puede fallar con algunas controladoras. Fuerza el tipo en collector.yaml con la clave devices y type, por ejemplo sat, y reinicia el servicio.

Los discos NVMe no aparecen.

Según la documentación, con NVMe hay que añadir además la capacidad SYS_ADMIN. Pasa en devices el dispositivo NVMe que te muestre smartctl --scan y añádelo a allow_listed_devices.

No llegan las notificaciones.

Revisa que la URL de notify.urls sea válida para Shoutrrr y que, si el usuario o la contraseña tienen caracteres especiales, estén codificados como URL. Reinicia el servicio tras editar el archivo y mira docker compose logs.

Endurece la instalación

No expongas el panel sin autenticación

El Compose publica 8080 solo en 127.0.0.1. Si necesitas acceso remoto, usa un túnel SSH o un proxy inverso con autenticación; no abras este puerto a internet.

Mantén los privilegios mínimos

Pasa solo los dispositivos que quieras vigilar y añade SYS_ADMIN únicamente si tienes NVMe. Evita el modo privilegiado.

Protege la configuración y fija versiones

La URL de avisos equivale a una credencial: no la subas a repositorios y limita quién puede leer ~/scrutiny, por ejemplo con permisos restrictivos en el directorio padre, de modo que el contenedor siga accediendo a sus volúmenes. Tras cualquier cambio de permisos, reinicia y verifica que el panel sigue respondiendo. Actualiza la etiqueta de la imagen de forma deliberada, leyendo las notas de versión, en lugar de usar latest.

chmod go-rwx ~/scrutiny
docker compose restart scrutiny
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080
Limpieza: deshacer el laboratorio

Elimina el laboratorio

Conserva antes el archivo de copia si quieres poder recuperar el histórico. Detén y borra el contenedor y su red. Si ya no quieres los datos, borra los directorios (esto elimina la base y las series temporales de forma irreversible, y puede requerir sudo si pertenecen a root) y la imagen descargada.

docker compose down
sudo rm -rf ~/scrutiny/config ~/scrutiny/influxdb
docker image rm ghcr.io/analogj/scrutiny:v0.10.0-omnibus

Qué está verificado

  • Sintaxis de config/collector.yaml (parser YAML)
  • Sintaxis de config/scrutiny.yaml (parser YAML)
  • Sintaxis de compose.yaml (parser YAML y estructura de Compose)
  • Sintaxis de 8 bloque(s) de comandos (bash -n en un contenedor aislado, sin ejecutarlos)
  • Versiones (5), opciones (1) y claves de configuración (27) contrastadas con 20 páginas de documentación oficial
  • Arranque real del laboratorio: no ejecutado

Comprobaciones automáticas del 16 de noviembre de 2026. Lo marcado con «·» no se ha ejecutado: revísalo en tu entorno.

Fuentes

Artículo generado mediante AI.larebelion

Kernel

· Dirección de tecnología · España

«Un disco que avisa antes de morir vale más que el mejor RAID que descubres roto el día que lo necesitas.»

Comentarios (0)

Todavía no hay comentarios. Puedes ser el primero.

Escribe un comentario