hd-idle命令行参数完全指南：从-a到-l的实用配置示例

【免费下载链接】hd-idleHard Disk Idle Spin-Down Utility项目地址: https://gitcode.com/gh_mirrors/hd/hd-idle

hd-idle是一款轻量级的硬盘空闲自动休眠工具，通过智能监控硬盘活动状态，帮助用户减少不必要的能源消耗并延长硬盘使用寿命。本文将详细解析hd-idle的所有命令行参数，提供从基础到高级的配置示例，让你轻松掌握硬盘休眠管理技巧。

核心参数解析与基础配置

-a：指定目标硬盘设备

功能：为特定硬盘设备应用配置参数
语法：-a <device_name>
示例：

hd-idle -a sda -i 300

此命令为sda硬盘设置300秒（5分钟）的空闲休眠时间。设备名称需与/dev目录下的硬盘设备名一致，如sda、sdb等。代码实现详见main.go中的设备配置逻辑。

-i：设置默认空闲时间

功能：定义硬盘进入休眠状态的默认空闲时间（秒）
语法：-i <seconds>
默认值：600秒（10分钟）
示例：

hd-idle -i 1800 # 所有硬盘默认30分钟后休眠 hd-idle -a sda -i 600 -a sdb -i 300 # 为不同硬盘设置不同时间

当结合-a参数使用时，-i仅对紧接其后的硬盘生效。参数解析逻辑见main.go。

高级功能配置

-c：选择命令类型

功能：指定硬盘休眠命令类型
语法：-c <command_type>
可选值：scsi（默认）、ata
示例：

hd-idle -a sda -c ata -i 300

SCSI命令适用于大多数现代硬盘，ATA命令则针对传统IDE硬盘。命令类型选择逻辑在main.go中实现。

-p：设置电源管理模式

功能：指定硬盘休眠的电源条件等级（0-15）
语法：-p <level>
默认值：0（最低功耗）
示例：

hd-idle -a sda -p 2 -i 600

不同硬盘厂商对电源等级的定义可能不同，建议参考硬盘手册设置。参数验证代码见main.go。

-l：配置日志文件

功能：指定活动日志的存储路径
语法：-l <file_path>
示例：

hd-idle -l /var/log/hd-idle.log -i 600

日志文件会记录硬盘状态变化和休眠事件，便于问题排查。日志配置实现见main.go。

特殊模式与调试选项

-t：立即休眠指定硬盘

功能：直接触发指定硬盘的休眠操作
语法：-t <device_name>
示例：

hd-idle -t sdb

此模式会忽略空闲时间设置，立即执行休眠命令。单次休眠逻辑见main.go。

-d：启用调试模式

功能：输出详细的调试信息
语法：-d
示例：

hd-idle -d -a sda -i 300

调试信息包括设备检测过程、活动监控数据和命令执行结果，有助于配置验证和故障诊断。调试开关定义在main.go。

-s：符号链接解析策略

功能：设置设备符号链接的解析方式
语法：-s <policy>
可选值：0（默认，仅解析一次）、1（持续重试解析）
示例：

hd-idle -s 1 -a /dev/disk/by-label/data

对于使用UUID或标签挂载的硬盘，建议设置为1以确保设备识别的稳定性。策略实现见main.go。

实用配置示例

场景1：基本系统配置

为所有硬盘设置15分钟默认休眠时间，并记录日志：

hd-idle -i 900 -l /var/log/hd-idle.log

场景2：多硬盘差异化配置

• SSD系统盘（sda）不休眠：-a sda -i 0
• 机械数据盘（sdb）30分钟休眠：-a sdb -i 1800
• 备份硬盘（sdc）1小时休眠：-a sdc -i 3600

完整命令：

hd-idle -a sda -i 0 -a sdb -i 1800 -a sdc -i 3600 -l /var/log/hd-idle.log

场景3：调试新配置

验证ATA命令模式下的休眠配置：

hd-idle -d -a sda -c ata -i 60 -p 1

60秒后检查日志确认是否正常休眠。

注意事项与最佳实践

1. 设备名称选择：建议使用/dev/disk/by-id/下的持久化设备路径，避免因设备顺序变化导致配置失效
2. 空闲时间设置：机械硬盘建议设置10-30分钟，SSD可设为0禁用休眠
3. 日志管理：定期轮转日志文件，避免占用过多磁盘空间
4. 系统服务：通过debian/hd-idle.service配置系统服务实现开机自启

通过灵活组合这些参数，hd-idle可以完美适应家庭服务器、NAS存储和桌面电脑等不同场景的硬盘管理需求，既环保节能又能保护硬件设备。

【免费下载链接】hd-idleHard Disk Idle Spin-Down Utility项目地址: https://gitcode.com/gh_mirrors/hd/hd-idle