企业官网建设流程全解析

Synology_HDD_db指南：2条命令把硬盘加进群晖兼容名单

【免费下载链接】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里插了新硬盘，存储管理器就弹出"兼容性未经过验证"，存储池建不了，SSD的TRIM选项还灰着。Synology_HDD_db就是来解决这件事的：它把你的HDD、SSD、NVMe的型号和固件版本写进群晖官方兼容名单（drive database）。读完这篇，你能通过SSH跑两条命令让全部第三方硬盘进白名单，出了问题还能一条命令撤干净。

第三方硬盘提示"未经验证"怎么办：先把三件事说清楚

① 是白名单机制（whitelist）在限制你。群晖对硬盘有套"入场许可证"制度：不在官方兼容性列表里的盘，DSM就不完全信任——警告弹出来、存储池建不了、TRIM开不了。更麻烦的是DSM会定期自动更新这份列表，你手动做的改动随时会被覆盖回去。

② 脚本只动数据库文件，而且先备份。它改的是你机型对应的硬盘兼容数据库文件和DSM相关兼容性开关；动手前先把原始数据库文件备份，--restore能随时撤掉全部修改，试错成本很低。

③ 什么情况下不该用。机器里全是群晖原装硬盘的，不用跑。需要更新群晖品牌硬盘固件时，先别加-n——先在存储管理器里做数据库更新，再按平时参数重跑脚本。

运行脚本前如何做准备：三个检查

1. 版本是否支持。DSM 6与DSM 7（7.1/7.2/7.3/7.4）都能用，2025系列及之后的Plus机型也支持。DSM 7.3已放宽7.2.2的部分限制，但第三方NVMe仍建不了缓存/卷，这个脚本能解决，详见 2025_plus_models.md。

2. 别把文件放在M.2卷上。DSM或存储管理器更新后，M.2卷要等脚本跑完才可用——脚本放那里会死循环。放/volume1/scripts最稳。

3. 获取文件有两种方式。

• git clone：一条命令把整个项目（脚本、厂商ID表等必需文件）放进NAS的固定文件夹，命令在下一节。
• 从仓库Releases页下载 Source code (zip)，解压存到NAS里，保证syno_hdd_db.sh和syno_hdd_vendor_ids.txt在同一目录；机型不支持M2D20/M2D18这类扩展卡的话，还需包里的 dtc 文件。

2条命令让硬盘进官方名单：SSH解锁

SSH登录NAS，两条命令依次执行：

git clone https://gitcode.com/GitHub_Trending/sy/Synology_HDD_db /volume1/scripts/syno_hdd_db sudo -s /volume1/scripts/syno_hdd_db/syno_hdd_db.sh -nr

• sudo -s：先提升到root权限再运行，脚本需要root。
• -n：阻止DSM自动更新硬盘数据库、覆盖你的修改（需要更新群晖品牌硬盘固件时例外）。
• -r：仅DSM 7.x，关闭内存兼容性检查（非原装内存不再被念叨），并把最大内存设置对齐到实际安装量。

跑完看到的输出应类似下图：各硬盘型号"already exists in db"，兼容性检查与内存检查已禁用，DSM完成复检。

首次运行后可能要重启NAS才能看到效果；装了M.2硬盘的，重启基本逃不掉。DSM更新后记得再跑一次，或干脆在任务计划程序里设成每次开机自动运行。

Synology_HDD_db参数怎么选：按风险分三档

不用逐个背参数，找到你的目标、对号入座即可。

低风险日常（✅ 放心用）

• 新第三方硬盘解锁：-nr（就是上面两条命令里的组合）
• 核实脚本改了什么：-s（即--showedits），打印它对数据库文件的具体修改
• WD硬盘3年误报警告：-w禁用 WD Device Analytics（DSM 7.2.1起默认已禁用）
• 希捷IronWolf健康检测不认新盘：-I把 IronWolf Health Monitor 更新到 2.5.1（仅x86_64机型）
• 撤销脚本做的全部修改：--restore

中风险进阶（⚠️ 理解机制再用）

• 第三方SSD/NVMe开TRIM：不加-f，正常跑-nr后DSM会自动放开TRIM开关
• 扩展卡M.2建卷：-p启用未知PCIe适配器上的M.2建卷，需要配开机自启任务
• SSD负责读、HDD负责写：-S自动把内部HDD标记为 write_mostly，--ssd=sata1,sata2手动指定读盘，--ssd=restore恢复默认；NVMe不能当读盘，找不到内部SSD时脚本会直接提示

高风险最后手段（🔥 不懂别碰）

• -f：仅用于脚本跑完硬盘在存储管理器仍显示不受支持。副作用：数据去重被禁用、群晖品牌硬盘不能再更新固件、DSM 7.4下直接失效
• -i：把列表中标记"不兼容"的硬盘改成"支持"，除非你完全清楚后果

不能踩的红线与一键回滚：安全网

• 🔥RAID 5 / RAID 6 / SHR里有3块及以上SSD时，除非确定你的SSD采用"方法1"TRIM，否则别开TRIM。方法2的TRIM用在3块以上阵列上可能导致数据丢失。
• 🔥DSM 7.4下不要用-f，该版本直接失效，别浪费时间。
• ⚠️脚本别放M.2卷（死循环）；想用TRIM就别加-f（互相冲突）。

安全网：一条命令回滚全部修改，write_mostly也一起恢复：

sudo -s /volume1/scripts/syno_hdd_db/syno_hdd_db.sh --restore --ssd=restore

延伸阅读：M.2扩展卡、扩展单元与IronWolf硬盘的进阶场景

用不上的直接跳过。

• 扩展卡（M2D20/M2D18/M2D17/E10M20-T1）用户：脚本会在不官方支持这些卡的机型上启用它们，并确认M.2卷支持已打开；较新型号在DSM 7.2及以上可直接在存储管理器里创建M.2存储池。部分新型号需搭配作者的 Synology_enable_M2_card 脚本。
• 扩展单元（DX517、RX418等）用户：不用加参数，脚本自动检测已连接的扩展单元，把里面的硬盘写进对应单元的兼容数据库。
• 希捷IronWolf用户：跑完-I后，健康检测结果能重新回到Normal：

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