mdhiggins/smartmontools Docker 镜像 - 轩辕镜像

smartmontools Docker镜像文档

镜像概述

基于Debian系统的Docker容器，集成smarttools（硬盘SMART检测工具）、mailutils（邮件处理工具）和ssmtp（邮件传输客户端），核心功能为每日自动执行硬盘SMART健康状态检查，并通过配置的邮件服务将检查报告发送至指定***。

核心功能和特性

• SMART检测能力：集成smarttools工具集，支持对硬盘进行全面的SMART（自我监控、分析与报告技术）状态检测，包括硬盘温度、坏道、使用寿命等关键指标。
• 邮件通知功能：通过mailutils和ssmtp实现邮件发送能力，可将每日SMART检查结果自动发送至指定***，便于及时掌握硬盘健康状态。
• 自动化执行：默认配置每日定期执行检查任务，无需手动触发，实现无人值守的硬盘监控。
• 轻量稳定：基于Debian系统构建，镜像体积轻量，运行稳定，适合长期后台部署。

使用场景和适用范围

• 服务器环境：适用于物理服务器、云服务器等需要7×24小时运行的场景，通过定期SMART检查提前预警硬盘潜在故障，降低数据丢失风险。
• 个人工作站/存储设备：用于个人电脑、NAS存储等设备，通过邮件报告实时了解硬盘健康状态，及时备份重要数据。
• 企业级存储监控：可作为中小型企业存储系统的辅助监控工具，低成本实现硬盘状态可视化管理。

使用方法和配置说明

前置要求

• 已安装Docker或Docker Compose环境。
• 目标硬盘支持SMART功能（大多数现代SATA/SAS硬盘均支持）。
• 需配置有效的邮件服务信息（通过ssmtp配置文件定义SMTP服务器、端口、认证信息等）。

关键配置参数

环境变量

卷挂载

部署示例

Docker Compose配置

yaml
  smartmontools:
    image: mdhiggins/smartmontools
    privileged: true  # 需特权模式以访问宿主机硬盘设备
    environment:
      - MAIL=${MAIL}  # 接收报告的***地址，建议通过环境变量传入
    volumes:
      - /opt/appdata/smartmontools/smartd.conf:/etc/smartd.conf  # 挂载自定义smartd配置
      - /opt/appdata/smartmontools/ssmtp:/etc/ssmtp  # 挂载ssmtp邮件配置
    restart: always  # 容器退出后自动重启，确保持续运行

Docker Run命令示例

bash
docker run -d \
  --name smartmontools \
  --privileged \
  -e MAIL="***" \  # 替换为实际接收***
  -v /opt/appdata/smartmontools/smartd.conf:/etc/smartd.conf \
  -v /opt/appdata/smartmontools/ssmtp:/etc/ssmtp \
  --restart always \
  mdhiggins/smartmontools

配置文件说明

smartd.conf配置示例

/opt/appdata/smartmontools/smartd.conf文件用于定义SMART检查规则，基础配置示例：

conf
# 对所有支持SMART的硬盘执行检查，每日凌晨2点运行
/dev/sd[a-z] -a -s (S/../.././02) -m ${MAIL} -M test

• -a：启用所有默认检查项。
• -s (S/../.././02)：设置检查时间为每周日凌晨2点（可根据需求调整）。
• -m：指定接收报告的***（与环境变量MAIL一致）。
• -M test：首次启动时发送测试邮件，验证配置是否生效。

ssmtp配置示例

/opt/appdata/smartmontools/ssmtp/ssmtp.conf文件需配置SMTP服务器信息，示例（以Gmail为例）：

conf
root=***
mailhub=smtp.gmail.com:587
rewriteDomain=gmail.com
AuthUser=***
AuthPass=your-app-password  # 需使用Gmail应用专用密码（开启2FA时）
FromLineOverride=YES
UseSTARTTLS=YES

注意事项

• 特权模式：容器必须以--privileged模式运行，否则无法访问宿主机硬盘设备的SMART接口。
• 邮件配置验证：首次部署后建议检查邮件是否正常发送，可通过查看容器日志（docker logs smartmontools）排查配置问题。
• 硬盘兼容性：部分RAID控制器或虚拟环境中的硬盘可能无法直接访问SMART信息，需确保宿主机能正常识别目标硬盘的SMART数据。