跳到主要内容

升级 Unraid

升级 Unraid OS 可确保您获得最新功能、安全更新和硬件支持。本页概述了标准升级过程，提供了疑难解答技巧和手动升级选项。

前提条件

在开始升级之前，请确保完整备份您的USB闪存设备。有关更多详细信息，请参阅备份闪存设备。

升级前的最佳实践
  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 容器启动缓慢​

某些升级后，Docker 容器可能需要执行一次性迁移。此过程可能需要一些时间，尤其是在镜像较多时。请耐心等待；首次启动完成后，性能应恢复正常。

升级后 Docker 容器无法正常工作​

如果遇到类似 "layers from manifest don't match image configuration" 的错误，可能需要重建 Docker 镜像文件：

  1. 前往 设置 → Docker 并停止 Docker 服务。
  2. 勾选删除 Docker 镜像的复选框，然后点击删除按钮。
  3. 重新启动 Docker 以重新创建镜像。
  4. 前往 Apps 标签页中的 Previous Apps，勾选要重新安装的项目，然后点击 "Install xx Applications"。

VMs 显示 "cannot get interface MTU" 或网络错误​

如果您曾为 VM 网络使用自定义桥接名称，请按以下步骤将所有 VMs 更新为使用默认 br0 桥接：

  1. 前往 VMs 标签页并编辑每个 VM（确保启用 高级视图）。
  2. 将网络桥接设置为 br0，然后点击 应用。
  3. 前往 设置 → VM 管理器（在 高级视图 中），并将默认桥接设置为 br0。

VNC 无法访问 VMs 或速度较慢​

对于较旧的 VMs，可能需要更新 VNC 视频驱动程序：

  1. 在 VMs 标签页编辑 VM（选择 高级视图）。
  2. 将 VNC 视频驱动程序 设置为 QXL（推荐）。如果 QXL 效果不佳，可尝试 Cirrus 或 vmvga。
  3. 点击 应用 以保存更改。

VM 无法启动（出现 EFI shell）​

如果您在较旧的 Unraid 版本中创建了基于 OVMF 的 VMs，可能会遇到 EFI shell。可输入以下命令启动 VM：

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

如果 fs0: 不起作用，可以改试 fs1:。如果仍有问题，请访问 Unraid 论坛 获取帮助。

尝试启动 VM 时出现 "Invalid machine type" 错误​

要解决此问题，请在 WebGUI 中编辑 VM，然后不做任何更改直接点击 应用。此操作会将机器类型更新为最新支持版本。

升级后 VM 性能较差​

如果升级后 VM 运行缓慢，请前往 VM 设置（在 高级视图 中），并将 Machine 类型版本更新到最新修订版（例如从 i440fx-2.5 改为 i440fx-2.7）。请不要更改前缀，例如不要从 i440fx 切换到 Q35。

降级 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. 重新启动您的服务器。