aristanetworks/smartctl

docker-library: smartctl 镜像文档

镜像概述

本镜像为Docker Hub发布的官方镜像，内置smartctl工具。smartctl是一款用于查询和控制存储设备SMART（自我监控、分析与报告技术）系统的命令行工具，可帮助用户监控硬盘、SSD等存储设备的健康状态、预测潜在故障风险。

核心功能与特性

• SMART信息查询：支持读取存储设备的SMART属性（如温度、坏扇区计数、寿命余量等）
• 设备健康状态评估：自动分析SMART数据，提供设备健康状态报告（正常/警告/故障）
• 自检功能：支持启动设备的短自检、长自检及 conveyance自检，评估硬件稳定性
• 跨平台兼容：适配各类存储接口（SATA、NVMe、SCSI等）及主流操作系统架构
• 轻量级设计：基于最小化基础镜像，镜像体积小，资源占用低

使用场景与适用范围

• 服务器存储监控：系统管理员定期检查服务器硬盘健康状态
• 个人设备维护：家庭用户监控PC或NAS存储设备的寿命与故障风险
• 自动化运维：集成到监控系统（如Prometheus、Zabbix）中，实现存储健康状态的持续监控
• 故障排查：存储设备异常时，快速获取SMART数据辅助诊断问题

使用方法与配置说明

前置条件

• 宿主机需支持SMART功能（大多数现代存储设备默认启用）
• 运行容器时需提供设备访问权限（通常通过--privileged或--device参数）

基础命令格式

bash
docker run --rm --privileged -v /dev:/dev smartctl [smartctl命令参数]

常用操作示例

1. 查看设备SMART信息

查询指定设备（如/dev/sda）的详细SMART信息：

bash
docker run --rm --privileged -v /dev:/dev smartctl -a /dev/sda

2. 检查设备健康状态

快速评估设备健康状态：

bash
docker run --rm --privileged -v /dev:/dev smartctl -H /dev/sda

3. 启动短自检

启动设备短自检（通常耗时2-5分钟）：

bash
docker run --rm --privileged -v /dev:/dev smartctl -t short /dev/sda

4. 查看自检结果

检查已完成的自检结果：

bash
docker run --rm --privileged -v /dev:/dev smartctl -l selftest /dev/sda

参数说明

smartctl支持丰富的命令参数，常用参数包括：

• -a：显示设备所有SMART信息
• -H：仅显示健康状态摘要
• -t <test-type>：执行自检（short/long/conveyance）
• -l selftest：显示自检日志
• -i：显示设备基本信息（型号、序列号等）

Docker部署示例

定期检查脚本（Bash）

创建定时任务脚本check_disk_health.sh，定期检查所有存储设备：

bash
#!/bin/bash
DEVICES=$(ls /dev/sd[a-z] /dev/nvme[0-9]n[0-9] 2>/dev/null)
for device in $DEVICES; do
  echo "=== Checking $device ==="
  docker run --rm --privileged -v /dev:/dev smartctl -H $device
  docker run --rm --privileged -v /dev:/dev smartctl -a $device | grep -i temperature
done

docker-compose配置（用于持续监控）

yaml
version: '3'
services:
  smartctl-monitor:
    image: smartctl
    privileged: true
    volumes:
      - /dev:/dev
      - ./smart-logs:/var/log/smartctl
    command: >
      sh -c "while true; do
        date >> /var/log/smartctl/health.log;
        smartctl -H /dev/sda >> /var/log/smartctl/health.log;
        sleep 86400;
      done"

注意事项

• 部分设备（如USB外接硬盘）可能不支持SMART功能，执行命令前需确认设备支持性
• 运行--privileged模式会授予容器较高权限，生产环境建议使用--device参数精确控制设备访问权限（如--device /dev/sda:/dev/sda）
• NVMe设备需使用nvme-cli工具获取更详细信息，本镜像仅包含smartctl基础功能