跳到主要内容

升级 Unraid

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

:::note[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 容器无法正常工作 - 点击以展开/收起

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

  1. 前往 设置 → Docker 并停止 Docker 服务。
  2. 选中删除 Docker 镜像的复选框并单击删除按钮。
  3. 重新启动 Docker 以重建镜像。
  4. 导航到 应用 标签页，选择 先前的应用，勾选要重新安装的应用并点击 安装 xx 应用。
升级后阵列或 Docker 容器启动较慢 - 点击以展开/收起

在某些升级后可能需要对 Docker 容器进行一次性迁移。此过程可能需要一些时间，特别是如果您有很多镜像。在此过程中请耐心等待；性能应在初始启动后恢复正常。

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

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

  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:

手动升级或降级​

手动升级通常不必要，但如果无法访问 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. 重新启动您的服务器。