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
Pulsa una pieza para ver su paso.
- Navegador · paso 3 panel en 127.0.0.1:8080
- Scrutiny omnibus · paso 3 contenedor :8080, v0.10.0
- Recolector + smartctl · paso 2 dentro del contenedor
- InfluxDB · paso 3 integrado en el contenedor
- Discos del NAS · paso 1 /dev/sda, /dev/sdb
- 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.

Requisitos
Paso a paso
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 clavedevices). Por eso primero necesitas saber qué dispositivos tiene tu máquina. Si usas RAID por controladora, pasa también los dispositivos que muestresmartctl --scanen 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 ~/scrutinySalida esperada (ilustrativa: el formato exacto puede variar)
NAME SIZE MODEL sda 3.6T WDC WD40EFRX-68N sdb 3.6T WDC WD40EFRX-68NEscribe 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.yamldecides qué discos vigilar (allow_listed_devices; si lo omites, se recogen todos los detectados) y puedes forzar tipo o ignorar discos con la clavedevices. 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.urlsacepta URLs de Shoutrrr. Conon_missed_uploadrecibes un aviso si un disco deja de reportar, conupload_periodfijas cada cuánto esperas datos (0slo estima a partir de las últimas subidas) y conon_smartctl_errorte avisa sismartctlfalla. Estas claves globales aparecen en la línea v0.10.0, por eso fijamos esa versión. CambiaCHANGE_ME_NTFY_TOPICpor 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.yamlversion: 1 host: id: 'nas-casa' allow_listed_devices: - /dev/sda - /dev/sdb log: level: INFOFichero
config/scrutiny.yamlversion: 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_TOPICSustituye cada valor CHANGE_ME_… por uno tuyo antes de arrancar: no dejes contraseñas ni claves de ejemplo.
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 comov0.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/udeven solo lectura da al recolector los metadatos de los dispositivos ySYS_RAWIOpermite asmartctlconsultar los datos S.M.A.R.T. Ajusta la lista dedevicesa tus discos. Si tuvieras discos NVMe, la documentación pide ademásSYS_ADMINy pasar su dispositivo (el que te muestresmartctl --scan); añádelos también aallow_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.yamlservices: 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 scrutinySalida 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/tcpAbre el panel y revisa los discos
Abre
http://127.0.0.1:8080en 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.yamloscrutiny.yamlmás adelante,docker compose restart scrutinyes suficiente para que el contenedor relea esos archivos; un cambio encompose.yaml(dispositivos, puertos, etiqueta) requieredocker compose up -dde nuevo.docker compose restart scrutiny docker compose logs --tail 30 scrutinyCopia 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(incluyescrutiny.yaml,collector.yamly la basescrutiny.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
tarva consudo. Guarda el archivo resultante en otro disco o máquina, no en el que vigilas, y recuerda quescrutiny.yamlcontiene 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
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:8080Salida esperada (ilustrativa: el formato exacto puede variar)
200Los 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:8080Limpieza: 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-omnibusQué 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
- AnalogJ/scrutiny: README e instalación con Docker github.com
- Notas de versión de Scrutiny github.com
- example.scrutiny.yaml: notificaciones y base de datos github.com
- example.collector.yaml: configuración del recolector github.com
- docker compose down docs.docker.com
¿Te ha funcionado este laboratorio?
Puntúalo de 1 a 5 estrellas. Un voto por persona; puedes cambiarlo cuando quieras.
Artículo generado mediante AI.larebelion



Comentarios (0)
Todavía no hay comentarios. Puedes ser el primero.
Escribe un comentario