企业官网建设流程全解析

3 步解决群晖「硬盘不受支持」警告：把任意硬盘写进 Synology 兼容数据库

【免费下载链接】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 兼容数据库，硬盘即可恢复「受支持」状态，全程约 5 分钟，只需 SSH 登录执行两条命令。代价是群晖品牌硬盘的固件自动更新会停掉，且 DSM 更新后需要重跑一次脚本。

一分钟判断：适不适合你

• 适合：第三方 HDD、SSD、SAS 或 M.2 NVMe 在存储管理器中标记为「不受支持」。
• 适合：加装了非群晖内存被反复提示警告，或 M.2 NVMe 只能当缓存、建不了存储池。
• 适合：WD 硬盘满 3 年被误报警告，或新款希捷 IronWolf 不被健康监控识别。
• 适合：DSM 6 与 DSM 7（含 7.1/7.2/7.3/7.4），包括 2025 款及以后的 Plus 机型。
• 不适合：全部使用群晖原装盘的用户，无需任何改动；期待硬盘获得官方认证保障的，官方名单仍是唯一标准。

它是怎么起作用的

DSM 内置一份按机型区分的硬盘兼容数据库，只认名单内的型号：第三方盘从插上那一刻起就被标记「不受支持」，非群晖内存弹警告、M.2 NVMe 不能建存储池，2025 款 Plus 机型在 DSM 7.2.2 下第三方硬盘甚至无法直接建池（限制明细见 2025_plus_models.md）。Synology_HDD_db 的思路很直接：读取每块在装硬盘的型号与固件版本，与当前机型对应的数据库文件比对，先把原始文件备份，再把缺失条目补写进去，最后触发 DSM 重新检查兼容性。换来的收益是警告消失、M.2 建池解锁、内存警告关闭；失去的是用-n参数后硬盘数据库的自动更新被禁用，群晖原装硬盘不再自动更新固件，且 DSM 大版本更新后数据库可能被覆盖，需要重跑脚本（可以设置成开机自动执行）。

运行界面：每块硬盘的型号和固件被逐条写进机型对应的数据库文件，结尾确认 DSM 已完成兼容性重查

开始操作：SSH 三步跑完脚本

第 1 步：开启 SSH 并登录

做什么：DSM 网页端进入 控制面板 > 终端机和 SNMP，打开「启用 SSH 服务」。然后在本机终端执行：

ssh 用户名@NAS的IP

成功标志：输入密码后出现命令行提示符，即可进入第 2 步。

第 2 步：把脚本拉到硬盘卷上

做什么：切到 root，把仓库克隆到硬盘卷（如/volume1）。⚠️ 不要放 M.2 卷：DSM 或存储管理器更新后，M.2 卷要等脚本跑完才可用。一行拉取：

sudo -i cd /volume1 && 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。后者必须与脚本同目录，缺了它 NVMe 会被识别为 Unknown brand。💡 若 git clone 不可用，可到项目 Releases 页面下载最新版本的 Source code (zip) 解压到/volume1，注意只下载 zip 附件本身，下错文件会出现bash\r或语法错误。

先在右侧 Releases 列表点选最新版本，再在下方 Assets 区域点击 "Source code (zip)" 附件下载

第 3 步：运行脚本

做什么：在脚本目录运行。-n禁止 DSM 自动更新硬盘兼容数据库，防止你的改动被覆盖；-r关闭内存兼容检查，并把「最大内存」同步为实际安装量：

cd /volume1/Synology_HDD_db sudo -s ./syno_hdd_db.sh -nr

成功标志（按顺序出现）：

1. 开头列出HDD/SSD models found: N等，说明已扫描到硬盘；
2. 每块硬盘一行xxx (固件版本) already exists in dsXXX_host_v7.db（已在名单）或Added xxx to ...（新写入）；
3. Disabled drive db auto updates.与Disabled support memory compatibility.；
4. 结尾输出DSM successfully checked disk compatibility.✅

💡 若提示There is a newer version of this script available，回答 y 即可，脚本会自行下载最新版并重跑一遍。

验证是否生效：存储管理器两处查看

1. 存储管理器主界面：原来标「不受支持」「未验证」的硬盘状态恢复正常。若个别盘仍显示「未验证」，这通常只是官方名单提示，S.M.A.R.T. 监控与温度显示照常工作，不是故障。
2. 存储管理器 > 硬盘/SSD > 设置 > 高级：Drive Database 区域的「最后更新时间」应为刚才的运行时间。带-n运行后，系统不会再自动更新这份数据库，该时间戳也就不会被悄悄改写。

「最后更新时间」停在脚本运行时间——这是写入生效的最直接证据

关于重启：DSM 7 下脚本会立即触发兼容性重查，通常无需重启；装了 M.2 硬盘的机型建议重启一次再查（脚本结尾也会提示You may need to reboot the Synology）。另一个自查办法：原样重跑一次脚本，每块盘都显示already exists in即说明条目已牢固写入数据库。

参数速查：回退与无人值守更新

⚠️-f只在硬盘跑完常规流程后仍显示「不受支持」时才考虑，代价是失去数据去重和群晖盘固件更新能力，DSM 7.4 上不要用。 📌 脚本目录里必须同时有syno_hdd_vendor_ids.txt，它是 NVMe 厂商 ID 对照表（见文末资源），缺了它 DSM 会把 NVMe 显示为 Unknown brand。

遇到这些问题时

场景 1：跑完脚本，硬盘仍显示「不受支持」动作：最后手段，加-f重跑一次（DSM 7.4 禁用此参数），然后刷新存储管理器。 自查：硬盘状态恢复正常；记住去重与固件更新已按上述代价关闭。

场景 2：报bash\r: No such file or directory、syntax error或光标卡住不动动作：说明下错了文件（下到了网页）或 zip 没有解压。重新到 Releases 页面下载 Source code (zip)，解压出syno_hdd_db.sh后再运行。 自查：重跑后能正常输出HDD/SSD models found即文件正确。

场景 3：硬盘显示「未验证」（Unverified）动作：脚本会把数据库中unverified的条目改写为受支持（输出中可见Edited unverified drives in ...）；若重启后仍有提示，它只是官方名单提示，不影响 S.M.A.R.T. 与温度监控。 自查：存储管理器中该盘的 S.M.A.R.T. 数据、温度均正常显示即非故障。

场景 4：M.2 NVMe 只能当缓存，建不了存储池动作：加-p运行脚本，并在任务计划中设置开机自动执行（脚本每次启动后生效）。 自查：存储管理器允许在 M.2 NVMe 上创建存储池，M2D20 等转接卡上的硬盘同样被识别。

场景 5：新款希捷 IronWolf 盘不被健康监控识别动作：加-I运行一次（x86_64 CPU 机型），把 IronWolf Health Monitor 升级到 2.5.1。 自查：存储管理器中硬盘的 IronWolf Health 页签显示Test Result: Normal。

IronWolf Health 页签中 Test Result 恢复 Normal，即-I升级生效

结语与资源

兼容名单本来就是参考，不是围墙。把硬盘写进名单之后，硬件的选择权回到你自己手里——而第三方硬件不受官方保障这一点，也一并由你接手。

• README.md：功能清单、全部参数与排障表
• 2025_plus_models.md：2025 款及以后 Plus 机型第三方硬盘限制专项说明
• CHANGES.txt：脚本更新历史，可对照自己遇到的版本行为
• syno_hdd_vendor_ids.txt：NVMe 厂商 ID 参考表，遇到 Unknown brand 时按脚本提示往里补

【免费下载链接】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