群晖硬盘兼容性完整指南：三步把第三方硬盘加入 Synology HDD

群晖硬盘兼容性完整指南：三步把第三方硬盘加入 Synology HDD_db 兼容列表

【免费下载链接】Synology_HDD_dbAdd your HDD, SSD and NVMe drives to your Synology's compatible drive database and a lot more项目地址: https://gitcode.com/GitHub_Trending/sy/Synology_HDD_db

Synology_HDD_db 是一个修改群晖硬盘兼容性数据库的开源脚本。运行后，它会把 NAS 里已安装的 SATA/SAS 机械硬盘、SSD 与 NVMe M.2 硬盘自动写入 DSM 的兼容列表，让存储管理器中的"该硬盘不在兼容列表中"提示消失，支持 DSM 6 到 DSM 7.4，所有改动随时可以回滚。

群晖用内置的硬盘兼容性数据库来限制可用的盘型，出发点是统一支持口径与稳定性；落到用户身上，就是存储管理器里盘体上的黄色警告图标，以及在部分新型号上，第三方硬盘无法用于创建存储池或缓存。

原理：一句话看懂它的工作方式

DSM 靠/var/lib/disk-compatibility/下的兼容数据库文件判断硬盘是否可用。脚本的做法是：先识别 NAS 型号与 DSM 版本，找到对应的数据库文件，再扫描每块已装硬盘的型号和固件版本，备份原文件后把缺失的盘写入数据库——连接的扩展坞、M.2 PCIe 卡的数据库也在处理范围内。可以理解为替 DSM 补一份它认得出的"花名册"。

在 DSM 7 上运行后，脚本会触发 DSM 重新检查硬盘兼容性，通常无需重启；装有 M.2 硬盘的设备可能需要重启才生效。

快速上手：三步完成

1. 获取脚本

git clone https://gitcode.com/GitHub_Trending/sy/Synology_HDD_db

2. 放到普通卷上

把文件放到普通卷（例如/volume1/scripts/），不要放在 M.2 卷；确认syno_hdd_db.sh与syno_hdd_vendor_ids.txt在同一目录。

3. SSH 登录并执行

sudo -s /volume1/scripts/syno_hdd_db.sh -nr

-n防止 DSM 自动更新覆盖刚改好的数据库，-r关闭内存兼容性检查，两者最常用。路径含空格时，把整条路径用双引号包起来。

输出会列出本次检测到的硬盘及写入的数据库文件；已在列表中的盘显示 already exists 并跳过。

⚙️ 常用参数速查表

参数	作用	适用场景
`-n`/`--noupdate`	阻止 DSM 自动更新硬盘兼容性数据库	默认加上，防止脚本的修改被覆盖
`-r`/`--ram`	关闭内存兼容性检查，并把最大内存设为已安装量（DSM 7.x）	消除"非群晖内存模块"的系统事件通知
`-w`/`--wdda`	禁用 WD Device Analytics	消除 WD 硬盘"使用满 3 年"的误报；DSM 7.2.1 起已内置该行为
`-p`/`--pcie`	允许在未被识别的 PCIe 适配卡的 M.2 上建卷	M2D20、M2D18 等卡用于非官方支持机型
`-S`/`--ssd=DRIVE`	对内盘启用 write_mostly，DSM 优先从内置 SSD 或指定盘读取	加速系统分区读写
`-I`/`--ihm`	将 IronWolf Health Management 更新到 2.5.1	新款 IronWolf / IronWolf Pro 硬盘的健康管理，限 x86_64 机型
`-s`/`--showedits`	显示对数据库文件做的每一处修改	手动执行时核对写入内容
`--restore`	一键撤销脚本所做的全部更改	回滚到修改前状态

两点注意：如需更新群晖品牌硬盘的固件，先不加-n运行脚本，再到存储管理器用"立即更新"刷新数据库，最后带常用参数重新运行一次。-f/--force属于最后手段，DSM 7.4 上不要使用，启用后数据去重和群晖硬盘固件更新都不可用；打算启用 SSD TRIM 的用户同样不能用-f。

使用新款 IronWolf 或 IronWolf Pro 硬盘时，加上-I把健康监控组件升到 2.5.1，存储管理器的健康信息页即可正常显示测试结果。

持久化维护：DSM 更新后怎么办

DSM 更新可能会刷新兼容性数据库，覆盖此前的写入，所以每次更新后需要重跑一次脚本。最省心的做法是建一个开机触发的计划任务：

控制面板 > 任务计划程序 > 创建 > 计划任务 > 用户定义的脚本。
执行用户选 root（脚本需要 root 权限），触发条件设为开机时。
脚本内容填写/volume1/scripts/syno_hdd_db.sh -n，加上-e可关闭执行结果邮件里的彩色文本。

如果 NVMe 卷或 M.2 PCIe 卡在 DSM 更新后需要二次重启，再加上--reboot：由开机任务触发时，检测到系统构建号变化会自动重启一次。脚本每次运行还会检查是否有新版本，配合--autoupdate=天数可以在计划任务中自动更新。

📌 避坑提醒

别把脚本放在 M.2/NVMe 卷：DSM 或存储管理器更新后，M.2 卷在脚本运行前不可用，脚本也会拒绝在 M.2 卷上执行。
首次运行后建议重启 NAS 让更改生效；装有 M.2 硬盘的设备尤其需要。
回滚入口始终可用：--restore还原所有被改过的文件；动过 write_mostly 的话用--restore --ssd=restore。
操作前按自己的备份策略备份重要数据。脚本会自动备份数据库文件，但业务数据不在这次保护范围内。
NVMe 盘显示"Unknown brand"时，脚本会打印出厂商 ID，把它补进syno_hdd_vendor_ids.txt即可。

Synology_HDD_db 只改动 DSM 实际引用的那几个文件，保留原始备份并提供回滚入口，风险边界比较清楚。用非官方列表的盘型为现有群晖扩容、或想把 M.2 硬盘用起来时，跑一次脚本再挂上开机任务即可。2025 系列 Plus 机型剩余的兼容性限制及对应处理，可参考仓库内的 2025_plus_models.md。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考