unRAID 6.12 版本升级前的注意事项（附：解决 2.5G 网卡升级后无法进入 unRAID 的问题）

type

status

date

slug

summary

1、备份 U 盘（重要）

💡

请读者们记住并养成习惯：无论你是升级系统还是做一些系统层面的修改，请在做这些操作之前备份系统，并且养成定期备份系统的习惯（如果你用的是正版，正版提供后台备份系统文件到官方服务器的功能）。

请前往 主要（MAIN） —> Flash 中将系统 U 盘的内容进行备份保存：

2、借助升级助手（Update Assistant）做升级前的检查

Update Assistant 功能需要安装 Fix Common Problems 插件，请在 APPS 应用商店下载：

如果读者无法正常下载插件，可以看这里（点击展开）

复制以下命令到 unRAID 命令行窗口中运行：

然后手动到插件页面中进行安装：

找到并选择 fix.common.problems.plg ，然后点击安装（ INSTALL ）

安装好之后，到 工具（TOOLS）—> Update Assistant 进行检测：

如果顺利，那么最后会提示：No issues were found with your server that may hinder the OS upgrade. Youu shoutd be good to go 。

3、更新插件

到插件页面中检查下有没有插件可以更新，有的话更新一下插件。

在新版本发布之前，插件的作者都会提前对新版本进行适配，以便在新版本发布后用户能继续使用插件，避免出现不兼容新版本的情况。

4、暂停定时脚本

如果你安装了 User Script 插件并且设置了相应的脚本，那么你可以先把所有定时脚本暂时都停掉，等升级到新版本调整完成之后，再打开。

5、升级系统

系统下载完成后重启系统即可完成系统升级。

6、解决 2.5G 网卡升级新版本后无法进入 unRAID 的问题

6.1、现象

问题现象体现为升级到 unRAID 6.12 版本之后，无法通过浏览器进入到 unRAID 管理界面，并且如果你查看启动时的控制台输出的信息，可以看到有这么一行提示：

实际上每一次 unRAID 出新版本，多多少少都会有不少人出现相同的问题，比如说下面这个 2022 年的帖子中，一位国外的网友从 6.9 版本升级到 6.10 版本时也出现了一样的问题（一样的报错信息）。

帖子地址：https://forums.unraid.net/topic/123672-upgraded-from-692-to-610-device-eth0-does-not-exist/

6.2、解决办法

对于使用 Realtek（也就是俗称的螃蟹卡）的读者，请检查你的 /boot/config/modprobe.d 路径下是否存在 r8169.conf 这一文件，你来可以通过以下命令检查：

如果不存在，会提示：

如果存在，请使用以下命令删除：

6.3、说明

为什么会出现这样的问题？

首先，如果你用的 2.5G 网卡的网卡芯片是 R8125 类型，那么在 unRAID 中并不是调用的 R8125 驱动，而是 R8169 驱动。但是 R8169 驱动不能很好的发挥 R8125 芯片的网卡（例如可能会造成网卡跑不满 2.5G 传输速率的情况）。

根据我上面那个帖子的贴图其实也看到有不少人都遇到这种情况，所以普遍都反映 R8169 驱动很烂（ it is a terrible driver for 2.5g NIC ）。

所以很多使用 R8125 网卡的朋友都会通过将 R8169 驱动进行屏蔽来解决此问题，例如可以通过以下命令来实现：

这么一来在 /boot/config/modprobe.d 这一目录下就会存在 r8169.conf 这一文件了。

之所以需要让大家删除 r8169.conf 文件，是因为当 unRAID 出新版本之后依然默认使用的是 R8169 驱动（6.12 版本也是如此），所以如果先前你将此驱动屏蔽了，那升级到新版本之后，unRAID 无法调用此驱动来使用你的 2.5G 网卡，网卡就会失效，那么自然就无法连接上 unRAID 了。

所以解决办法就是不去屏蔽 R8169 驱动 —— 具体的操作就是删除 r8169.conf 文件。

那么如果在 6.12 版本中，R8169 驱动依然很烂，我该怎么办？

我没有对应的 2.5G 网卡，不知道在 6.12 版本下的具体表现，目前来说貌似只能是等待别人编译 2.5G 驱动来进行使用了，你可以通过下面的这个帖子来使用这位作者 jinlife 编译的驱动：

Unraid 6.11.5 最新的r8125和r8156网卡驱动补丁

Unraid貌似用了r8169这个驱动来驱r8125，比较老。r8152也是很老的1.12版本，好像驱不动R8156。以下补丁基于6.11.5定制，加了最新的V9.010.01的r8125 2.5G PCI网卡驱动和V2.16.3的r8156 2.5G USB 网卡驱动。解压后把所有文件覆盖到U盘根目录重启即可。覆盖前记得备份原始文件。默认自带r8169的驱动，支持板载网卡r8169和USB网卡r8156共存的情况。如果不需要r8169，需要r8125 PCI网卡的驱动，可以靠如下blacklist屏蔽掉。命令行跑一次，会存到U盘，重启看看。 echo "blacklist r81...