群晖硬盘提示不受支持？用它写进官方兼容名单，警告当天消失
【免费下载链接】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
第三方硬盘装进群晖 NAS，存储管理器立刻标出「不受支持」，建池、扩容处处受限。开源脚本 Synology_HDD_db 能把你硬盘的型号和固件直接写进群晖兼容数据库，全程约 5 分钟，多数机型不用重启。
动手前自查：适用条件、风险与备份
- 适用：DSM 6 和 DSM 7 全系，含 2025 款 Plus 机型；覆盖 SATA/SAS 硬盘、SSD 与 M.2 NVMe。
- 脚本会改什么：修改当前机型对应的兼容数据库文件（如
ds1821+_host_v7.db）。运行前自动备份原文件，也提供--restore一键回滚。 - 要付出的代价：常用参数
-n会禁止 DSM 自动更新硬盘数据库，群晖原装硬盘的固件自动更新随之停掉。需要时不带-n跑一次，更新完再带-n跑回来。 - 你需要备份的：重要数据建议先用快照或 Hyper Backup 留一份。系统级改动，多一道保险不亏。
快速上手：一条命令跑通
SSH 登录 NAS，把脚本放进硬盘卷（别放 M.2 卷），两条命令拉取并运行：
cd /volume1 sudo git clone https://gitcode.com/GitHub_Trending/sy/Synology_HDD_db && cd Synology_HDD_db sudo -s ./syno_hdd_db.sh -nr预期输出：每块硬盘的型号后跟already exists in xxx_v7.db，结尾一行DSM successfully checked disk compatibility.。看到这句，硬盘已写入兼容名单，多数机型立刻生效。
完整操作步骤：5 步写入兼容数据库
第 1 步：启用 SSH。操作：控制面板 → 终端机和 SNMP，勾选启用 SSH 服务。命令：
ssh 用户名@NAS的IP成功标志：出现user@NAS:~$提示符。
第 2 步：下载脚本。操作：在硬盘卷（如/volume1）执行上面的git clone，目录里必须同时保留syno_hdd_db.sh和syno_hdd_vendor_ids.txt两个文件。成功标志：ls能看到这两个文件。
第 3 步：运行脚本。操作：
cd /volume1/Synology_HDD_db sudo -s ./syno_hdd_db.sh -nr成功标志：输出中依次出现HDD/SSD models found: 1、每块盘的already exists in，以及Disabled support disk compatibility.、Disabled support memory compatibility.。💡 提示发现新版本时选"是"，脚本会自己下载最新版重跑一遍。
第 4 步：核对输出。重点盯三行：already exists in（型号+固件已入库）、Disabled support memory compatibility.（内存警告已关）、DSM successfully checked disk compatibility.（DSM 已重新检查）。✅ 三行齐全即写入完成。
第 5 步：验证。进入存储管理器确认状态，见下一节；装 M.2 盘的机型重启一次再查。
脚本运行输出：每块硬盘的型号和固件都被写入机型、M.2 卡与扩展柜的数据库文件，结尾确认 DSM 已重新检查兼容性
如何验证写入已生效
入口一：存储管理器 → 硬盘/SSD。原来标「不受支持」的硬盘恢复正常状态，「最后检查时间」为刚才的运行时间。
入口二：存储管理器 → 硬盘/SSD → 设置 → 高级 → 硬盘数据库。这里的「最后更新时间」应停在脚本运行时刻——带-n运行后，这个时间戳不会再被系统悄悄改写。
「最后更新时间」停在脚本运行时刻，说明群晖兼容数据库的修改已锁定生效
进阶参数速查
| 参数 | 效果 | 什么时候用 |
|---|---|---|
-w | 关闭 WD Device Analytics | WD 硬盘超 3 年被误报（DSM 7.2.1+ 已默认关闭） |
-p | 允许在 M.2 NVMe 上创建存储池与卷 | NVMe 目前只能当缓存 |
--restore | 从备份还原数据库，撤销全部改动 | 想一键回退；配--ssd=restore连 write_mostly 一起还原 |
--autoupdate=N | 新版本发布满 N 天后自动更新脚本 | 脚本放入开机任务、无人值守 |
-I | 升级 IronWolf Health Monitor 到 2.5.1 | 新款希捷 IronWolf 盘不识别 |
-S | 内部 HDD 标记 write_mostly，读写优先走 SSD | 同时有 HDD 和 SSD，想提速 |
--showedits | 打印所有写入内容 | 想在终端看清改了什么 |
📌-f是最后手段：仅在硬盘仍显示「不受支持」时使用，会禁用数据去重与群晖硬盘固件更新，DSM 7.4 禁用此参数。
高频问答
问：运行后要不要重启？答：无 M.2 盘的机型通常不用，DSM 7 会立即重新检查兼容性；装了 M.2 盘的机型重启一次再确认。
问：DSM 更新后还要再跑吗？答：要。更新会覆盖修改，建议在任务计划里把脚本设为开机运行，再配--autoupdate=7自动拉新版。
问：还看到「未验证」提示是故障吗？答：不是。那只是官方名单提示，SMART 监控与温度显示照常工作。
问：-f什么时候才用？答：只在硬盘仍显示「不受支持」的关头。代价是禁用数据去重和群晖硬盘固件更新，DSM 7.4 上禁用。
问：脚本该放哪？答：/volume1这类硬盘卷。放 M.2 卷会在 DSM 更新后卡住——M.2 卷要等脚本跑完才可用。
问：运行报bash\r或语法错误？答：下载的文件有问题，重新拉取 Source code (zip) 并确认已解压。NVMe 显示 Unknown brand 时，检查目录里是否有syno_hdd_vendor_ids.txt，缺了按提示把 vendor ID 补进去。
结语
硬盘兼容名单只是官方的一份名单——把硬盘写进名单之后，建池和兼容状态由你的硬件说了算，而不是由名单说了算。
- 功能与参数完整说明：README.md
- 2025 Plus 机型限制专项说明：2025_plus_models.md
- 脚本更新历史：CHANGES.txt
- 厂商 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），仅供参考
