3 步搞定群晖「硬盘不受支持」：把第三方盘写入 DSM 兼容数据库（Synology_HDD

3 步搞定群晖「硬盘不受支持」：把第三方盘写入 DSM 兼容数据库（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 是一个开源脚本，能把任意品牌的 HDD、SSD、M.2 NVMe 写进 DSM 内置的兼容硬盘数据库。SSH 登录后执行一行命令，第三方硬盘的"不受支持"警告和功能限制即可解除，全程约 5 分钟，且支持一条命令恢复原状。

适合谁用

装了第三方硬盘/SSD 后，存储管理器一直弹"不受支持""未验证"警告的群晖用户
M.2 NVMe 只能当缓存、想在 DSM 7.2 及以上版本直接建存储池的机型用户
加装了非群晖内存被提示不兼容、或 WD 硬盘用满 3 年被误报的用户
2025 年及之后的 Plus 机型使用第三方硬盘被限制建池、建缓存的用户
不适合：坚持只使用群晖原装硬盘、希望保留官方固件自动更新流程的用户——本脚本的-n参数会停掉群晖硬盘的固件自动更新

准备清单

运行环境：群晖 NAS，DSM 6 或 DSM 7（7.1 / 7.2 / 7.3 / 7.4 均已支持）
权限：控制面板 > 终端机和 SNMP 中启用 SSH 服务，准备一个有 sudo 权限的账户
脚本位置：把脚本放在硬盘卷上（如/volume1），不要放 M.2 卷——DSM 或存储管理器更新后，M.2 卷要等脚本跑完才可用
数据安全⚠️ 运行前用快照或 Hyper Backup 给重要数据留一份。脚本虽会自动备份数据库文件，但系统级修改仍建议多一道保险
文件齐全：脚本目录里必须同时有syno_hdd_db.sh和syno_hdd_vendor_ids.txt，缺后者时 NVMe 会被识别为 Unknown brand

操作流程

第 1 步：开启 SSH 并登录

动作：控制面板 > 终端机和 SNMP > 启用 SSH 服务
命令：

ssh 用户名@NAS的IP sudo -i

预期输出：进入 root 命令行提示符

第 2 步：把脚本放到群晖上

动作：克隆仓库到硬盘卷。也可以手动下载最新 release 的 Source code (zip) 存到群晖后解压，注意选对文件、并解压后再运行。
命令：

cd /volume1 && sudo -i git clone https://gitcode.com/GitHub_Trending/sy/Synology_HDD_db && cd Synology_HDD_db

预期输出：目录中出现syno_hdd_db.sh、syno_hdd_vendor_ids.txt等文件
成功标志：ls能同时看到脚本与厂商 ID 文件

下载时认准 Source code (zip)，网页本身不是脚本

第 3 步：运行脚本写入兼容数据库

动作：以 root 身份运行脚本，-n禁止 DSM 自动覆盖数据库，-r关闭内存兼容检查
命令：

sudo -s syno_hdd_db.sh -nr

预期输出：先列出检测到的 HDD/SSD、M.2 盘、扩展柜型号，再逐条打印每块硬盘的型号与固件，缺失条目被写入对应的*_v7.db文件；结尾出现DSM successfully checked disk compatibility
成功标志：终端无 ERROR，最后一行确认 DSM 已重新检查硬盘兼容性 💡 若提示发现新版本，选"是"，脚本会自动下载最新版重跑

每块盘的型号、固件被逐一登记进机型对应的 db 文件，结尾确认 DSM 已重新检查兼容性

第 4 步：在界面确认生效

动作：打开存储管理器查看硬盘状态；再进存储管理器 > 硬盘/SSD > 设置 > 高级
成功标志：原来标"不受支持"的硬盘状态恢复正常；"Drive Database"一栏的最后更新时间与刚才的运行时间一致 ✅ 装有 M.2 硬盘的机型重启一次后再查

带-n运行后，这个时间戳不会再被系统悄悄改写

第 5 步（建议）：设置开机自动运行

动作：控制面板 > 任务计划 > 创建 > 计划任务 > 用户定义脚本，用户选 root，触发器设为"开机时"，脚本内容填/volume1/Synology_HDD_db/syno_hdd_db.sh -n --autoupdate=7
预期输出：每次开机自动补写数据库，脚本版本落后超过 7 天时自动拉取新版
成功标志：任务执行邮件或运行日志显示正常结束；DSM 更新后修改不再丢失

它是如何工作的

脚本先读取 NAS 型号和 DSM 版本，确定该改哪份数据库文件；然后扫描全部 HDD、SSD、SAS 与 M.2 NVMe，读出每块的型号和固件版本，把缺失条目补写进机型对应的兼容数据库——写之前会先备份原始文件，因此可以用--restore一键撤销。最后触发 DSM 重新检查兼容性，没有 M.2 盘的机型通常无需重启。DSM 升级会重置这些修改，所以需要第 5 步的开机任务来维持。

能力	一句话说明	解决什么场景
硬盘自动登记	扫描 HDD、SSD、SAS、M.2 NVMe，缺失条目写入机型数据库	第三方硬盘被标"不受支持"
数据库防覆盖	`-n`禁止 DSM 自动更新硬盘数据库	修改被系统悄悄抹掉
内存兼容解锁	`-r`关闭非群晖内存警告，最大内存同步为实际安装量	加装第三方内存被提示不兼容
M.2 NVMe 建池	DSM 7.2+ 允许在 M.2 盘上创建存储池与卷	NVMe 只能当缓存
WD 年龄警告清除	`-w`关闭 WD Device Analytics	WD 硬盘超 3 年被误报
一键还原	`--restore`从备份还原数据库	想退回官方原始状态

参数/开关速查

参数	效果	什么时候用
`-n`	禁止 DSM 自动更新硬盘数据库	默认都加上，防止修改被覆盖
`-r`	关闭内存兼容检查，最大内存设为实际安装量（DSM 7.x）	加装过非群晖内存
`-w`	关闭 WD Device Analytics	WD 硬盘超 3 年被误报（DSM 7.2.1+ 默认已关）
`-p`	允许在未知 PCIe 转接卡的 M.2 上创建卷	NVMe 目前只能当缓存
`-S`/`--ssd=DRIVE`	内部 HDD 标记 write_mostly，读写优先走内部 SSD	同机有 HDD 和 SSD、想提速
`--restore`	从备份还原数据库，撤销全部改动	一键回退；配合`--ssd=restore`连 write_mostly 一起还原
`--autoupdate=N`	新版发布满 N 天后自动更新脚本	脚本放进开机任务、无人值守
`-I`	升级 IronWolf Health Monitor 到 2.5.1	新款 IronWolf 盘不被识别（限 x86_64）
`-s`/`--showedits`	打印所有写入数据库的内容	想在终端看清改了什么
`-f`	强制 DSM 不再检查硬盘兼容性	最后手段：会禁用数据去重和群晖硬盘固件更新，DSM 7.4 禁用

📌 注意：只有硬盘在存储管理器里仍显示"不受支持"时才考虑-f，它是有明确代价的。

常见问题自查

现象：报/usr/bin/env: 'bash\r': No such file or directory或syntax error near unexpected token原因：下载了网页而非文件，或 zip 没解压处理：重新下载最新 release 的 Source code (zip)，解压后运行其中的syno_hdd_db.sh
现象：命令执行后光标停住无任何输出原因：文件是 Windows 换行符处理：同样重新下载 zip 包替换后重跑
现象：NVMe 在存储管理器显示 Unknown brand、固件版本"未识别"原因：syno_hdd_vendor_ids.txt中缺少该厂商 ID处理：脚本运行时会打印出对应的 vendor ID，把它补进该文件后再运行一次

看到 Unknown brand 时，按脚本提示补录 vendor ID 即可解决

现象：报No such file or directory原因：zip 未解压直接运行了压缩包，或路径含空格未加引号处理：确认运行的是解压后的.sh文件；路径带空格时用双引号包裹，必要时先sudo chmod +x赋予执行权限
现象：DSM 更新后警告又回来了原因：DSM 升级覆盖了硬盘数据库处理：执行第 5 步的开机任务，并加--autoupdate=7保持脚本自身也是新版
现象：运行后硬盘仍显示"不受支持"原因：个别机型需要强制跳过检查处理：最后手段才用-f运行一次；代价是禁用数据去重和群晖硬盘固件更新，DSM 7.4 上不要使用
现象：硬盘旁边仍有"未验证"字样原因：那是官方兼容名单的展示提示，不是故障处理：无需处理，SMART 监控与温度显示照常工作
现象：不确定运行后要不要重启原因：M.2 相关改动需要重启才生效处理：无 M.2 硬盘通常不用重启（DSM 7 会立即重新检查）；装了 M.2 硬盘的机型重启一次