跳到主要内容

更新 Unraid

更新 Unraid OS 可确保您获得最新功能、安全更新和硬件支持。本页概述了标准更新流程，以及故障排除提示和手动更新选项。

有关在 Stable、Beta 和 Release Candidate (RC) 版本之间进行选择的帮助，请参阅Unraid OS 发行类型。

:::note[Prerequisites]

在开始更新之前，请务必完整备份您的启动设备。有关更多详细信息，请参阅备份您的启动设备。

:::

Best 更新前的最佳实践
  1. 备份您的闪存驱动器和任何重要数据。
  2. 阅读您计划安装版本的发布说明。
  3. 将所有插件更新至最新版本。
  4. 可选步骤，停止阵列后再进行。
  5. 在 工具 → 更新操作系统 页面上更新 Unraid OS。
  6. 重启服务器以完成升级。

标准更新流程​

使用带有用户友好界面的新 更新操作系统工具 完成 Unraid 更新：

  1. 在 WebGUI 中，点击右上角的下拉菜单并选择检查更新或者进入工具 → 更新OS。
  2. 查看为服务器当前发布分支显示的更新。
  3. 点击 查看更改日志开始更新。更改日志将显示，供您在点击 继续 之前查看。
  4. 单击 确认并开始更新 以应用所选版本。
  5. 当提示时，重启服务器以完成升级。
备注

要在 Stable 和 Next 发布分支之间切换，请打开右上角账户菜单并选择 管理 Unraid.net 账户。发布分支由 Unraid 账户应用管理，而不是直接在操作系统中管理。

ZFS 存储池升级警告

升级到 Unraid 7.x 时，您可能会在启动过程中或 WebGUI 中看到有关 ZFS 池功能升级的警告。这些警告并不是问题的迹象；它们只是表示您的 ZFS 池正在使用来自旧版本 ZFS 的功能。

升级您的池并不紧急，但如果您决定升级，请注意它可能无法与以前的 Unraid 版本一起使用。这意味着进行升级后，您可能无法返回到以前的 Unraid 版本。

如以往一样，升级您的ZFS池之前，请记得备份数据。

排查升级问题​

如果升级后遇到问题，请查看下面相关部分获取帮助。

升级后 Docker 容器无法正常工作 - 点击以展开/收起

如果您遇到类似 "layers from manifest don't match image configuration" 的错误，您可能需要重新构建您的 Docker 镜像文件。以下是方法：

VMs 显示“无法获取接口 MTU”或网络错误 - 点击以展开/收起

If you have OVMF-based VMs created in older Unraid versions, you might encounter an EFI shell. You can boot the VM by entering the following commands:

  1. 键入 fs0:。
  2. 然后键入 cd efi/boot。
  3. 最后，键入 bootx64.efi。
  4. 导航到 应用 标签页，选择 先前的应用，勾选要重新安装的应用并点击 安装 xx 应用。
VNC 无法访问或速度慢 - 点击以展开/收起

为了解决此问题，在 WebGUI 中编辑 VM，然后在不进行任何修改的情况下点击 Apply。此操作将更新机器类型为最新支持版本。

  1. 前往 VMs 标签页并编辑每个 %%VM%%（确保启用 高级视图）。
  2. 将网络桥接设置为 br0 并点击 应用。
  3. 前往 设置 → VM 管理器（在 高级视图 中）并将默认桥接设置为 br0。
VM 无法启动（出现 EFI shell） - 点击以展开/收起

If you have OVMF-based VMs created in older Unraid versions, you might encounter an EFI shell. You can boot the VM by entering the following commands:

  1. 在 VMs 标签页编辑 %%VM%%（选择 高级视图）。
  2. 将 VNC 视频驱动程序 设置为 QXL（推荐）。如果 QXL 不成功，可以尝试 Cirrus 或 vmvga。
  3. 点击 应用 以保存更改。
VMs 显示“无法获取接口 MTU”或网络错误 - 点击以展开/收起

If you have OVMF-based VMs created in older Unraid versions, you might encounter an EFI shell. You can boot the VM by entering the following commands:

  1. 键入 fs0:。
  2. 然后键入 cd efi/boot。
  3. 最后，键入 bootx64.efi。

如果 fs0: 不起作用，您可以尝试 fs1:。如果问题仍然存在，请访问 Unraid 论坛 寻求帮助。

VNC 无法访问或速度慢 - 点击以展开/收起

为了解决此问题，在 WebGUI 中编辑 VM，然后在不进行任何修改的情况下点击 Apply。此操作将更新机器类型为最新支持版本。

VM 无法启动（出现 EFI shell） - 点击以展开/收起

If you have OVMF-based VMs created in older Unraid versions, you might encounter an EFI shell. You can boot the VM by entering the following commands:

降级 Unraid​

在降级之前，请务必阅读您将降级版本的发行说明。查找标题为"回滚"的部分，因为它包含任何需要执行的重要步骤。

如果您可以访问 WebGUI，您可以转到 工具 → 降级操作系统。 此选项允许您降级到先前安装的版本，而无需从版本历史页面下载 zip 文件。

如果在 工具 → 降级操作系统 下看不到降级选项，请使用下面描述的手动方法。这通常意味着先前版本的文件不在您的闪存驱动器上。

手动降级​

只有当您无法访问 WebGUI 或降级选项不可用时，才需要手动降级。在继续之前，备份您的 USB 闪存设备非常重要。更多详细信息，请参阅 备份您的闪存设备 。

  1. 从 版本历史 下载所需的 Unraid 版本 ZIP 文件。
  2. 在电脑上解压文件。
  3. 访问 flash 网络共享（您的启动卷；即使界面显示为 启动设备，共享名称仍可能是 flash），或将 USB 启动设备连接到您的计算机。
  4. 如果不存在，请创建一个 previous 目录。
  5. 将所有 bz* 和 changes.txt 文件移到 previous 目录中。
  6. 将新的 bz* 和 changes.txt 文件复制到启动驱动器的根目录。
  7. 重新启动您的服务器。