群晖硬盘「不受支持」？5 分钟把任意硬盘写进 DSM 兼容名单
【免费下载链接】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、SAS 和 M.2 NVMe 的型号加固件版本逐条写入 DSM 的兼容数据库，全程大约 5 分钟。代价是群晖品牌硬盘的官方固件自动更新会停掉；脚本动手前会先备份原始数据库文件，想反悔时一条命令即可整体还原。
背景是这样的：DSM 自带一份硬盘兼容名单，型号不在名单里的盘就会被标记「不受支持」或「未验证」，随之而来的是一堆警告、M.2 NVMe 无法创建存储池，以及 2025 款 Plus 机型在 DSM 7.2.2 下第三方硬盘连池子都建不了。官方推荐的型号确实省心，但那份名单本质上是参考，不是围墙。Synology_HDD_db 的做法很直接：把你的盘填进名单。
原理：它凭什么能成
先看机制，再谈值不值得动手。
DSM 判断一块硬盘是否受支持，靠的是查询一份按机型命名的数据库文件（例如ds1821+_host_v7.db），里面记录着认可的型号、固件版本、容量等字段。脚本做的事就是替你做维护：
- 识别当前 NAS 机型和 DSM 版本，确定要编辑哪些数据库文件；
- 扫描所有硬盘——HDD、SSD、SAS、M.2 NVMe 都算，包括扩展柜和 M.2 PCIe 转接卡上的盘；
- 逐块读出型号和固件版本；
- 备份数据库（如尚无备份），把缺失的条目补写进去；
- 触发 DSM 重新检查一次兼容性。第 5 步是关键：DSM 7 上多数机型因此不用重启就立刻生效。
值得动手的理由很简单：兼容名单决定的是警告多不多、功能开不开，不影响盘本身好坏。你为「认证」标签多付的钱，脚本帮你省回来。
动手：从登录到验证
全程 4 步，命令都给了，照抄即可。
1. 登录：开启 SSH
控制面板 > 终端机和 SNMP > 启用 SSH 服务，然后在电脑上执行：
ssh 用户名@NAS的IP能进到命令提示符就成功了。
2. 放置：把脚本拉进硬盘卷
注意一个前提：别把脚本放进 M.2 卷。DSM 或存储管理器更新后，M.2 卷要等脚本跑完才可用，放在硬盘卷（如/volume1）最稳。新版本脚本检测到自己在 NVMe 卷上会直接拒绝运行。
cd /volume1 && sudo -i git clone https://gitcode.com/GitHub_Trending/sy/Synology_HDD_db cd Synology_HDD_db如果习惯从发布页下载，找 Releases 里的Source code (zip)，存到群晖的文件夹里并解压，别下载到电脑上再传：
确认目录里syno_hdd_db.sh和syno_hdd_vendor_ids.txt两个文件都在。后者缺了的话，NVMe 盘在存储管理器里会被识别为 Unknown brand。
3. 运行：一条命令完成登记
sudo -s syno_hdd_db.sh -nr-n让 DSM 停止自动更新硬盘数据库，防止你写进去的条目被系统悄悄覆盖；-r关闭内存兼容检查，并把最大内存同步为实际安装量（仅 DSM 7.x）。
输出里盯三处就知结果：每块盘跟着一句already exists in xxx_v7.db（已登记的盘）或Added to xxx_v7.db（新写入的盘）；一行Disabled support memory compatibility；收尾的DSM successfully checked disk compatibility.。脚本提示发现新版本时选「是」，它会自己下载最新版重跑。💡 想看清每处改动，加--showedits参数重跑一次即可。
4. 核对：到存储管理器看状态
打开存储管理器，原来标「不受支持」「未验证」的硬盘状态应恢复正常。再进 存储管理器 > 硬盘/SSD > 设置 > 高级，看「最后更新时间」是否为刚才的运行时间：
装了 M.2 硬盘的机型请重启一次再确认。如果开了 DSM 自动更新，建议在任务计划里加一个开机任务跑这个脚本，配合--autoupdate=7（新版本发布满 7 天后自动拉取），DSM 升级后改动不会丢。
参数怎么挑
参数不用背，按目的找就行。
| 你的目的 | 加什么参数 | 补充说明 |
|---|---|---|
| 登记硬盘并防止改动被覆盖 | -n | 官方建议默认就加；唯一不用的场景：你要给群晖品牌盘刷官方固件 |
| 消除非群晖内存警告 | -r | 仅 DSM 7.x 有效；最大内存会同步为实际安装量 |
| 消除 WD 盘「已满 3 年」警告 | -w | 关闭 WD Device Analytics；DSM 7.2.1 及以上已默认关闭，旧系统才需要 |
| 让 M.2 NVMe 能建池建卷 | -p | 转接卡（M2D20 等）上的盘需要脚本开机自动执行才持续生效 |
| 让 DSM 优先从 SSD 读数据 | -S或--ssd=sata1 | 给内部 HDD 标记 write_mostly；--ssd=restore可重置 |
| 无人值守自动更新脚本 | --autoupdate=N | N 为新版本发布后多少天自动更新，适合放进开机任务 |
| 让新 IronWolf 盘被 IHM 识别 | -I | 升级 IronWolf Health Monitor 到 2.5.1，仅 x86_64 机型 |
| 撤销全部改动 | --restore | 配合--ssd=restore连 write_mostly 一起还原 |
| 磁盘仍显示不受支持（最后手段） | -f | 代价大，DSM 7.4 上禁用，见下文「代价与边界」 |
按症状对号入座
| 你看到的现象 | 怎么处理 |
|---|---|
| WD 硬盘弹出「已满 3 年」警告 | 加-w跑一次，存储管理器里警告消失、状态转绿（DSM 7.2.1+ 已默认处理，老系统才用得上） |
| NVMe 只能当缓存、建不了池 | 加-p运行，并在任务计划里设为开机执行；M2D20、M2D18、M2D17、E10M20-T1 等转接卡上的盘同样会被处理 |
| 加装第三方内存被提示不兼容 | 加-r，警告消失，最大内存值与实装一致 |
| 2025 款 Plus 机型 + DSM 7.2.2 建不了池 | 情况比参数复杂，先读 2025_plus_models.md 的专项方案（含 telnet 绕过的装系统流程）；盘写入数据库后若仍显示不受支持，再考虑-f |
| NVMe 显示 Unknown brand、固件版本无法识别 | 脚本会打印出对应的 vendor ID，把它追加到syno_hdd_vendor_ids.txt即可，参见 syno_hdd_vendor_ids.txt |
| 新 IronWolf / IronWolf Pro 盘 IHM 不认 | 加-I运行一次，效果见下图 |
| 硬盘旁仍挂着「未验证」字样 | 不用管，那只是「不在官方名单」的提示，SMART 监控和温度显示照常，不是故障 |
| 想把一切恢复原样 | 运行sudo -s syno_hdd_db.sh --restore --ssd=restore，数据库从备份还原 |
代价与边界
坦率讲清会失去什么、哪些地方要小心：
-n的代价：群晖品牌硬盘的固件自动更新通道被关。想刷官方固件时，先不带-n跑一遍，在存储管理器里执行数据库更新和固件更新，再带常规参数重跑。-f的代价：禁用数据去重、同时锁掉群晖盘固件更新，且官方明确不建议在 DSM 7.4 上使用。只想开 SSD TRIM 的话也别带它。另外 TRIM 本身有坑：RAID 5、RAID 6 或 3 盘以上 SHR 里的第三方 SSD，若盘走 TRIM 的第二种实现方式，开 TRIM 可能直接丢数据。📌- DSM 升级会覆盖改动：系统更新后兼容数据库会被重置，脚本需要重跑。这就是把脚本放进开机任务、配合
--autoupdate的原因。 - 要不要重启：DSM 7 会在脚本跑完后立即重新检查兼容性，无 M.2 盘的机型通常不用重启；装了 M.2 硬盘的机型重启一次最保险。
- 2025 Plus 机型的残留限制：DSM 7.3 已解除 7.2.2 的大部分限制，但第三方 NVMe 默认仍不能建缓存/卷，且未验证硬盘的警告依旧多——这两项脚本都能解决，具体对照 2025_plus_models.md 的表格。⚠️
- 脚本别放错位置：M.2 卷不行（更新后会陷入「卷要等脚本、脚本在卷上」的尴尬，新版会直接退出）；下载后报
bash\r、光标卡死或语法错误，多半是 zip 没解压或下到了网页而非代码包，重新拿 Source code (zip)。 - 动手前的保险：脚本自带数据库备份，但系统级修改值得多一道防线，重要数据先留一份快照或 Hyper Backup 备份。✅
资源都在这里，改动历史可以追到每一版：
- README——功能与参数完整说明
- 2025_plus_models.md——2025 款 Plus 机型限制专项说明
- CHANGES.txt——脚本更新历史
- syno_hdd_vendor_ids.txt——NVMe 厂商 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），仅供参考
