gists/smartmontools

smartmontools Docker镜像文档

镜像概述和主要用途

smartmontools Docker镜像是基于Alpine Linux构建的轻量级容器，集成了s Martmontools工具集（包含smartctl和smartd），用于通过S.M.A.R.T.（自我监控、分析与报告技术）协议监控存储设备（如硬盘、SSD）的健康状态。该镜像旨在提供便捷的跨环境部署方案，支持实时收集设备S.M.A.R.T.数据、分析运行状态及触发故障预警。

核心功能和特性

• S.M.A.R.T.监控能力：集成smartctl（命令行工具）和smartd（后台守护进程），支持查询设备S.M.A.R.T.属性、执行自检（短/长/ conveyance）及分析健康状态。
• 轻量级基础：基于Alpine Linux，镜像体积小（约数MB级），资源占用低，适合边缘设备及资源受限环境。
• 自定义配置：支持通过挂载外部配置文件（如smartd.conf）定义监控规则、告警触发条件及通知方式。
• 告警集成：可选集成邮件告警功能（通过ssmtp配置），支持故障状态实时通知。
• 后台运行：默认以smartd守护进程模式运行，持续监控设备状态并记录日志。

使用场景和适用范围

• 服务器存储监控：适用于物理服务器、云服务器的本地磁盘健康监控。
• NAS系统：个人或企业级NAS（网络附加存储）设备的硬盘状态管理。
• 数据中心环境：大规模存储集群中硬盘故障预警，降低数据丢失风险。
• 边缘计算设备：嵌入式系统、边缘服务器的存储设备健康管理。

使用方法和配置说明

基本运行（docker run）

通过docker run命令快速启动容器，默认配置下运行smartd守护进程：

bash
docker run \
  -d \
  --privileged \  # 必要：允许容器访问宿主机存储设备（如/dev/sda）
  --name smartmontools \  # 指定容器名称
  gists/smartmontools  # 镜像名称

参数说明：

• -d：后台运行容器；
• --privileged：赋予容器特权模式，需访问宿主机设备文件（如/dev下的磁盘设备）；
• --name：自定义容器名称，便于管理。

自定义配置（docker-compose）

通过docker-compose实现持久化配置和服务自启动，支持挂载自定义监控规则及告警配置文件：

yaml
version: '3'
services:
  smartmontools:
    image: gists/smartmontools
    privileged: true  # 同docker run，需特权模式访问设备
    volumes:
      - ./smartd.conf:/etc/smartd.conf  # 挂载自定义smartd监控配置
      - ./ssmtp.conf:/etc/ssmtp/ssmtp.conf  # 邮件发送配置（ssmtp主配置）
      - ./revaliases:/etc/ssmtp/revaliases  # 邮件别名配置（可选）
    restart: always  # 容器退出时自动重启，确保服务持续运行

部署步骤：

1. 本地创建配置文件（smartd.conf、ssmtp.conf、revaliases）；
2. 编写docker-compose.yml并指定上述文件挂载路径；
3. 执行docker-compose up -d启动服务。

配置文件说明

smartd.conf（核心监控配置）

路径：容器内/etc/smartd.conf，用于定义smartd守护进程的监控规则，格式为：

ini
# 语法：<设备路径> <监控选项> <告警动作>
/dev/sda -a -m admin@example.com  # 监控/dev/sda，启用所有属性检查，告警邮件发送至admin@example.com
/dev/sdb -s (S/../../6/03) -W 4,50,55  # 每周六3点执行短自检，温度超过55°C告警（警告阈值50°C）

详细配置项参考smartd.conf官方文档。

ssmtp配置（邮件告警）

若需通过邮件发送告警，需挂载ssmtp.conf（SMTP客户端配置）和revaliases（邮件别名）：

• ssmtp.conf（示例，使用SMTP服务器发送邮件）：

  ini
  root=admin@example.com  # 发件人邮箱
  mailhub=smtp.example.com:587  # SMTP服务器地址:端口
  AuthUser=user@example.com  # SMTP认证用户名
  AuthPass=password  # SMTP认证密码
  UseSTARTTLS=YES  # 启用TLS加密
  

• revaliases（定义本地用户与外部***映射）：

  ini
  root:admin@example.com:smtp.example.com:587  # 将root用户的邮件转发至admin@example.com
  

注意事项

1. 特权模式风险：--privileged允许容器访问宿主机所有设备，建议仅在可信环境使用，或通过--device=/dev/sda:/dev/sda等参数限制仅挂载需监控的设备。
2. 宿主机设备访问：容器需能识别宿主机存储设备，部分系统需额外挂载/dev目录（如-v /dev:/dev），但需注意权限冲突。
3. 配置文件权限：挂载的外部配置文件需确保容器内用户（通常为root）有读取权限，建议设置文件权限为644。
4. 日志查看：通过docker logs smartmontools查看smartd运行日志，排查配置或设备访问问题。

!版本信息 !镜像信息