群晖 Storage Manager(存储管理器)里那块自己买的硬盘旁边挂着”未验证”或”不兼容”,看到这几个字确实让人想拔硬盘。Synology HDD db 是一个针对群晖 NAS 的开源脚本,它会自动扫描你装的所有 SATA/SAS 硬盘、SSD 和 M.2 NVMe 盘,把不在官方认证列表里的型号写进群晖的兼容硬盘数据库,顺带能处理内存警告、SSD 缓存、IronWolf 监控等一堆群晖硬件限制,DSM 6 到 DSM 7.4 都能用。
为什么 Storage Manager 总盯着第三方硬盘不放
群晖内部维护着两份数据库文件:一份是认证硬盘列表,一份是不兼容列表。Storage Manager 判断一块盘”能不能用”,查的就是这两份文件。第三方硬盘只要不在认证列表里,就会显示”未验证”;进了不兼容列表,更直接标”不兼容”。
更麻烦的是,DSM 会自动从群晖服务器同步更新这个硬盘数据库。就算你手动改好了,一次自动更新就能把改动冲掉——这也是为什么单靠手动改配置走不远,需要一个能反复执行的脚本方案。Synology HDD db 就是干这个的:每次运行都把你现有的盘重新写进数据库,并用 -n 参数把自动更新关掉,让改动长期存活。
脚本到底动了什么,会不会改坏系统
⚠️ 先说清楚边界:脚本只修改群晖兼容硬盘数据库相关的配置文件(以及你主动开启的可选开关),不碰数据分区,也不碰存储池结构。
它每次运行做的事大致是:
- 识别 NAS 型号和 DSM 版本,确定该改哪几份 db 文件
- 列出所有已装硬盘的型号和固件版本
- 对每块盘检查是否已在兼容数据库里,缺的补进去
- 有扩展柜(Expansion Unit)或 M.2 PCIe 卡时,把对应的 db 文件也一并处理
- 可选:关闭内存兼容性检查、禁用西数 WDDA 年龄警告、设置 SSD 优先读取等
改动全部落在配置文件层面,脚本在首次修改前会自动备份原始数据库文件。反悔也简单,--restore 一键回滚:
sudo -s /volume1/scripts/Synology_HDD_db/syno_hdd_db.sh --restore
执行后会看到脚本逐项还原改动并提示完成;要连 write_mostly 之类的写入优化一起还原,再加 --ssd=restore。
先把脚本放到 NAS 上
脚本本身是一个 shell 脚本加一个厂商 ID 清单文件,克隆仓库下来就能跑。
方式一:浏览器下载
用 File Station 或 Download Station 下载最新版 Source code (zip),解压到共享文件夹即可。
方式二:SSH 克隆
SSH 登录 NAS 后执行,执行后你会看到仓库被完整克隆进 /volume1/scripts:
-
cd /volume1/scripts
-
git clone https://gitcode.com/GitHub_Trending/sy/Synology_HDD_db
克隆下来后检查三个文件是否都在同一个目录:
syno_hdd_db.sh(主脚本)syno_hdd_vendor_ids.txt(NVMe 厂商 ID 清单,和脚本必须同目录)dtc(或含 dtc 的 bin 目录,仅在 NAS 用了不受官方支持的 E10M20-T1 / M2D20 / M2D18 扩展卡时才需要)
⚠️ 两个存放位置的坑:别把脚本放在 M.2 卷上——DSM 或 Storage Manager 更新后 M.2 卷要先等脚本跑完才可用,脚本放在那里等于自锁;路径里最好别有空格,实在有的话运行时整个路径用双引号包住,例如
sudo -s "/volume1/my scripts/syno_hdd_db.sh -n"。
第一次运行:SSH 里敲哪条命令
在 DSM 的 控制面板 > 终端机和 SNMP 里开启 SSH 并允许 root 登录,然后 SSH 连上 NAS,执行(把路径换成你的实际路径),执行后你会看到脚本打印 NAS 型号、DSM 版本、检测到的每块盘,以及每块盘写入数据库的结果:
sudo -s /volume1/scripts/Synology_HDD_db/syno_hdd_db.sh -n

最常用的参数组合:
| 参数 | 作用 |
|---|---|
-n |
阻止 DSM 自动更新兼容硬盘数据库,保证改动不被冲掉 |
-r |
关闭内存兼容性检查(DSM 7.x),并把最大内存设为实际安装量 |
-nr |
上面两者组合,最常用的一行命令 |
关于 -n 有个反向操作要记一下:如果你想给群晖原厂硬盘刷固件,先不加 -n 跑一次脚本,去 存储管理器 > 硬盘/SSD > 设置 > 高级 里执行”立即更新”,更新完成后再用你惯用的参数重新跑一遍,防止自动更新把第三方盘的记录洗掉。

如果想亲眼确认脚本改了什么,加 --showedits 再跑一次,执行后输出里会按盘列出它对 host db 和 db.new 文件做的具体编辑:
sudo -s /volume1/scripts/Synology_HDD_db/syno_hdd_db.sh -n --showedits
怎么让 DSM 更新或重启后改动还在
DSM 一旦升级,硬盘数据库可能被重置,第三方盘的记录又得重写。手动记得去补跑当然可以,但更稳妥的做法是设置开机自动运行:
- 打开 控制面板 > 任务计划程序 > 新增 > 触发任务
- 任务类型选 用户自定义脚本,用户选 root
- 触发事件选 启动
- 在脚本框粘贴命令并保存

任务里的命令建议带上 -e(关闭彩色输出,邮件里的日志更好读)和 --autoupdate(脚本发布新版超过 N 天后自动更新自身,适合无人值守场景):
/volume1/scripts/Synology_HDD_db/syno_hdd_db.sh -nr -e --autoupdate=3
执行后可以在任务的运行日志或邮件通知里确认没有报错。
按需选装:从 SSD 优先读到 IronWolf 监控
基础写入数据库之外,Synology HDD db 还有一组按需求开启的开关,不用就别带:
| 参数 | 作用 | 适用场景 |
|---|---|---|
-S |
给内置 HDD 设置 write_mostly,让 DSM 优先从内置 SSD 读取 | 混插了 SSD 和 HDD 的机型 |
--ssd=sata1 |
手动指定哪块盘作为 DSM 优先读取盘 | -S 自动识别不符预期时 |
-w |
禁用 WDDA(西数设备分析),消除西数盘满 3 岁的误报警告 | 老西数盘;DSM 7.2.1 起已默认关闭 |
-I |
升级 IronWolf Health Management 到 2.5.1 | 希捷 IronWolf 用户,限 x86_64 |
--reboot |
DSM 更新且 build 号变化后自动重启 | NVMe 卷需要二次重启的场景 |

脚本还会顺带做两件容易忽略的事:让 DSM 允许对第三方 SSD/NVMe 开启 TRIM;检查 M.2 卷支持是否启用(有 M.2 盘的机型改完可能需要重启一次才生效)。
⚠️ TRIM 有一条硬边界:RAID 5、RAID 6 或 3 块以上 SSD 的 SHR 环境里,如果你的盘用的是 TRIM 方法 2,开启 TRIM 可能导致数据丢失。拿不准就先别开。
出问题了往哪查
按出错现象对号入座,大部分情况不用深挖:
| 现象 | 原因 | 处理 |
|---|---|---|
/usr/bin/env: 'bash\r': No such file or directory |
文件是 Mac 行尾格式 | 重新下载官方 zip 包 |
| 光标卡住不动 | Windows 行尾格式 | 重新下载官方 zip 包 |
| syntax error near unexpected token | 下载到的是网页而非文件 | 重新下载官方 zip 包 |
| No such file or directory | 没解压、跑的是 zip,或路径含空格没加引号 | 解压后直接运行 syno_hdd_db.sh |
如果还是报 No such file or directory,检查两件事:确认你解压后运行的是 syno_hdd_db.sh 而不是压缩包本身;确认脚本有可执行权限,没有就执行:
sudo chmod +x "/volume1/scripts/Synology_HDD_db/syno_hdd_db.sh"
另外两个高频问题:
- NVMe 盘显示 Unknown brand(未知品牌):脚本会直接打印出该盘的 vendor ID 并提示你把它加进
syno_hdd_vendor_ids.txt(和脚本同目录),格式类似0x025e="Solidigm"。 - 2025 系列及以后 Plus 机型:DSM 7.3 已放开大部分 7.2.2 的限制,剩下的两条——第三方 NVMe 盘不能建缓存/卷、未验证盘的警告刷屏——Synology HDD db 都能解决。但 DSM 7.2.2 里”全新 2025 Plus 机型只用未认证 HDD 初始化存储池”这条路被锁死,脚本绕不开,得走 telnet 临时放行安装的特殊流程,具体步骤看仓库里的 2025_plus_models.md。
最后说下退路:万一改出幺蛾子,--restore 能把脚本做过的改动全部撤销,配合它自动维护的数据库备份,折腾的门槛其实不高。把它放到共享文件夹里、设好开机自启,之后基本就是放着不管的事;真要动手时记得先读一遍 README 的参数列表。
硬盘该选哪块是你说了算,剩下的交给脚本就行。