跳到主要内容

升级 Unraid

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

Prerequisites

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

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

标准升级流程​

使用新的 更新操作系统工具 升级 Unraid，界面友好：

  1. 在 WebGUI 中，点击右上角的下拉菜单并选择检查更新或者进入工具 → 更新OS。
  2. 选择 稳定 通道以获取稳定版本，或选择 下一个 通道以获取测试版和 RC。
  3. 点击 查看更改日志开始更新。更改日志将显示，供您在点击 继续 之前查看。
  4. 单击 确认并开始更新 以应用最新的稳定版本。
  5. 当提示时，重启服务器以完成升级。
备注

您可能需要登录到 Unraid 帐户以访问更新，尤其是对于“下一个”分支版本。

ZFS 存储池升级警告

When upgrading to Unraid 7.x, you may see warnings about ZFS pool feature upgrades during boot or in the WebGUI. These warnings are not a sign of a problem; they simply indicate that your ZFS pool is using features from an older version of ZFS.

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

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

排查升级问题​

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

升级后数组或 Docker 容器启动缓慢 - 点击展开/折叠

某些升级后，Docker 容器可能需要一次性迁移。此过程可能需要时间，尤其是当您有许多镜像时。在此过程中要有耐心；性能会在初始启动后恢复正常。

升级后 Docker 容器无法正常工作 - 点击展开/折叠

如果遇到诸如“图像配置与清单层不匹配”的错误，您可能需要重建 Docker 镜像文件。步骤如下：

  1. 前往 设置 → Docker 并停止 Docker 服务。
  2. 选中删除 Docker 镜像的复选框并单击删除按钮。
  3. 重新启动 Docker 以重建镜像。
  4. 导航到 应用 标签页，选择 先前的应用，勾选要重新安装的应用并点击 安装 xx 应用。
虚拟机显示“无法获取接口 MTU”或网络错误 - 点击展开/折叠

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

  1. 前往 VMs 标签页并编辑每个 %%VM%%（确保启用 高级视图）。
  2. 将网络桥接设置为 br0 并点击 应用。
  3. 前往 设置 → VM 管理器（在 高级视图 中）并将默认桥接设置为 br0。
VNC 访问虚拟机不起作用或速度缓慢 - 点击展开/折叠

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

  1. 在 VMs 标签页编辑 %%VM%%（选择 高级视图）。
  2. 将 VNC 视频驱动程序 设置为 QXL（推荐）。如果 QXL 不成功，可以尝试 Cirrus 或 vmvga。
  3. 点击 应用 以保存更改。
虚拟机无法启动（显示 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. 键入 fs0:。
  2. 然后键入 cd efi/boot。
  3. 最后，键入 bootx64.efi。

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

尝试启动我的虚拟机时出现“无效的机器类型”错误 - 点击展开/折叠

为了解决此问题，请在 WebGUI 中编辑 VM，然后在不做任何更改的情况下点击 应用。此操作将机型更新为最新支持的版本。

升级后虚拟机性能差 - 点击展开/折叠

如果升级后 VM 变慢，进入 高级视图 中的 VM 设置，并将 机型 类型版本更新到最新版本（例如，将 i440fx-2.5 更改为 i440fx-2.7）。请确保不更改前缀（例如，不要从 i440fx 切换到 Q35）。

手动升级或降级​

手动升级通常不必要，但如果无法访问 WebGUI 或需要恢复到之前的版本时可能需要。在进行之前，请务必备份 USB 闪存设备，详细信息可以在备份闪存设备中找到。

使用降级 OS 工具进行降级（如果 WebGUI 可访问）​

如果可以访问 WebGUI：

  1. 登录到 WebGUI。
  2. 导航到 工具 → 降级操作系统。
  3. 之前的版本将列为可供降级的选项。
  4. 点击降级并按提示操作。
  5. 当提示时，重启服务器。
注意

请记住，降级可能会导致插件或 Docker 容器的兼容性问题。请务必提前备份您的 USB 闪存设备和任何重要数据。

手动方法（如果无法访问 WebGUI）​

只有在无法访问 WebGUI 的情况下才使用这些方法：

  1. 从 版本历史 下载所需的 Unraid 版本 ZIP 文件。
  2. 在电脑上解压文件。
  3. 访问 flash 共享或者将 USB 闪存设备连接到电脑。
  4. 如果不存在，请创建一个 previous 目录。
  5. 将所有 bz* 和 changes.txt 文件移到 previous 目录中。
  6. 将新 bz* 和 changes.txt 文件复制到闪存驱动器根目录。
  7. 重新启动您的服务器。