任意硬盘写进群晖兼容数据库：5 分钟清掉不受支持警告
【免费下载链接】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 会自动读出每块硬盘的型号与固件，写进 DSM 的兼容数据库，并触发一次兼容性重检。跑完即清除第三方硬盘提示，多数机型无需重启。
能力总览：脚本实际能做什么
| 能力 | 效果 | 适用场景 |
|---|---|---|
| 自动登记硬盘 | 扫描 HDD、SSD、SAS 与 M.2 NVMe，把缺失条目补进机型对应数据库 | 第三方硬盘被标"不受支持" |
| 锁定数据库更新 | -n禁止 DSM 自动更新硬盘数据库 | 防止改动被系统悄悄覆盖 |
| 解锁内存兼容 | -r关闭非群晖内存警告，最大内存同步为实际安装量 | 加装第三方内存被提示不兼容 |
| 清除 WD 年龄警告 | -w关闭 WD Device Analytics | WD 硬盘超 3 年误报 |
| 允许 M.2 建池 | -p允许在 M.2 NVMe 上建池与卷 | NVMe 只能当缓存 |
它是怎么做的：脚本到底改了哪些东西
DSM 内置一份硬盘兼容数据库，按"型号 + 固件版本"匹配，名单外的盘一律不受支持。Synology_HDD_db 会读取每块在装硬盘的型号与固件，和该机型对应的*_v7.db文件比对，把缺失条目逐条补写进去，最后触发 DSM 重新检查兼容性。
脚本改动前会自动备份数据库。-n会锁定数据库自动更新，让改动不被覆盖，代价是群晖自家硬盘的固件自动更新同步停掉。想撤销时，--restore可以从备份还原。整个过程只是把你的盘写进名单，不碰数据，随时可回退。
硬盘写进兼容数据库的操作步骤
1. 开启 SSH目的：脚本需要 root 权限运行，得先有命令行通道。在 控制面板 > 终端机和 SNMP 里启用 SSH 服务，再用ssh 用户名@NAS的IP登录。 成功判断：终端出现命令提示符，可以输入命令。
2. 获取脚本目的：把脚本和配套文件放到硬盘卷上（别放 M.2 卷）。
cd /volume1 && sudo -i git clone https://gitcode.com/GitHub_Trending/sy/Synology_HDD_db && cd Synology_HDD_db成功判断：ls能看到syno_hdd_db.sh与syno_hdd_vendor_ids.txt两个文件。
3. 运行脚本目的：把硬盘写进数据库并锁定更新。
sudo -s syno_hdd_db.sh -nr成功判断：每块硬盘的型号固件后跟already exists in xxx_v7.db，随后出现Disabled support memory compatibility，收尾一行DSM successfully checked disk compatibility。💡
4. 验证生效目的：确认改动在 DSM 界面落地。 成功判断：存储管理器里原来的"不受支持""未验证"恢复正常；进入 存储管理器 > 硬盘/SSD > 设置 > 高级，"最后更新时间"就是刚才运行时间。装有 M.2 硬盘的机型重启后再查一次。✅
进阶开关：哪些参数对应哪些情况
| 开关 | 效果 | 什么时候用 |
|---|---|---|
--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 不要用 |
场景速配：不同硬盘该选哪个参数
- WD 硬盘用了 3 年多：DSM 弹"已满 3 年"是 WDDA 检测所致。加
-w跑一次，存储管理器里该警告消失，状态恢复绿色。 - M.2 NVMe 只能当缓存：加
-p运行，并在任务计划里设开机自动执行。可自查的结果：存储管理器允许在 M.2 NVMe 上建池，M2D20 等转接卡上的盘也被识别。 - 2025 Plus 机型装第三方硬盘：DSM 7.2.2 下第三方盘建不了池。脚本把盘写进数据库后重新建池，警告清除；仍显示"不受支持"再加
-f。 - 新款 IronWolf 盘健康监控不识别：加
-I升级监控工具，可自查 IronWolf Health 页签显示 Normal。
常见问题：重启、覆盖与 -f 的用法
运行后必须重启吗？通常不用，DSM 7 会立即重检兼容性。装了 M.2 硬盘的机型重启一次。
DSM 更新会不会覆盖我的改动？会。在任务计划里设开机任务运行脚本，配合--autoupdate=7自动拉新脚本。⚠️ 重要数据建议先用快照或 Hyper Backup 留一份。
-f 代价是什么？禁用数据去重和群晖硬盘固件更新，只在硬盘仍显示"不受支持"的最后关头用，DSM 7.4 直接禁用。
还有"未验证"提示是故障吗？不是。那只是官方名单提示，SMART 监控与温度显示照常。
运行报 bash\r 或语法错误？下载的 zip 没解压或下错了页面，重新下载 Source code (zip) 解压后再跑。
脚本目录有什么文件要求？syno_hdd_vendor_ids.txt必须在同一目录，缺了 NVMe 会被识别为 Unknown brand。
收尾
盘写进数据库后，存储管理器不再弹"不受支持"，硬盘的选择不再被名单卡住。
资源链接
- README.md：功能与参数完整说明
- 2025_plus_models.md：2025 款 Plus 机型限制专项说明
- CHANGES.txt：脚本更新历史
- syno_hdd_vendor_ids.txt：厂商 ID 参考表
【免费下载链接】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），仅供参考
