3 步搞定群晖「硬盘不受支持」：把第三方盘写入 DSM 兼容数据库（Synology_HDD_db）
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 硬盘的机型重启一次
结语
兼容名单只是参考，不是围墙。
- 功能与参数完整说明：README.md
- 脚本更新历史：CHANGES.txt
- 2025 Plus 机型限制专项说明：2025_plus_models.md
- 厂商 ID 参考表：syno_hdd_vendor_ids.txt
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考