跳到主要内容

引导和启动故障

当您的 Unraid 服务器未正确启动时，如果不清楚启动过程，可能很难找出原因。遵循本指南可让您快速诊断和解决大多数启动问题，确保您的 %%array|阵列%%、%%WebGUI|网页界面%% 和服务以最小的停机时间运行。

准备启动介质​

本主题在准备你的USB设备部分有详细介绍。

注意

在进行更改之前，请始终备份您的启动设备。所有用户特定的设置，包括您的许可证密钥，均存储在 config 文件夹中。重新准备启动设备后恢复此文件夹将有助于保留您当前的配置。

启用UEFI引导​

现代系统通常需要UEFI引导模式以增强安全性和加快启动速度。

要在系统BIOS/UEFI设置中配置UEFI引导：

  1. 在启动时进入主板的BIOS/UEFI设置（通常按F2、DEL或ESC键）
  2. 找到引导选项或引导模式设置
  3. 将引导模式设置为UEFI或禁用CSM的UEFI
  4. 确保将 Unraid 启动设备选为 UEFI 启动目标
  5. 保存更改并退出

理解启动顺序​

Unraid 启动序列有多个阶段：

3. Linux 核心 - 点击展开/折叠

Linux 内核初始化并开始硬件检测。在此阶段，操作系统从引导加载程序中接管控制。

  • 主板 BIOS 可识别 Unraid 可启动设备（通常是 USB 闪存驱动器）。
  • 将启动设备设置为默认启动目标的方式因 BIOS 而异；请查阅主板手册以获取指导。
  • 启动卷同时支持 legacy (CSM) 和 UEFI 启动模式。
  • 对于 UEFI 启动，请确保启动卷上的 EFI 文件夹名称末尾没有连字符 (-)。
4. Flash 依赖服务 - 点击展开/折叠

闪存设备变得可访问并开始加载基本服务。此阶段对于配置和网络访问至关重要。

  • 启动菜单项定义在启动卷上的 syslinux/syslinux.cfg 文件中。
  • 你可以通过WebGUI下的主 → Syslinux配置编辑此文件。
  • Memtest86+ 随同当前版本的 Unraid 提供，可在传统和 UEFI 模式下运行。对于旧版本的 Unraid，请从 官方 Memtest 网站 获取与 UEFI 兼容的版本。
  • 闪存设备必须标记为UNRAID（全部大写）以进行正确挂载。
5. 插件 - 点击展开/折叠

加载第三方扩展和定制以增强系统功能。插件问题可能会阻止成功启动。

  • Syslinux 将 Linux 内核从启动卷加载到 RAM 中。
  • 如果需要，安全引导选项可以抑制插件加载。
  • 此阶段出现的错误通常表明启动设备存在问题。
  • Linux在启动期间检测硬件。
4. 依赖启动卷的服务 - 点击展开/折叠

启动卷变得可访问，并且关键服务开始加载。此阶段对配置和网络访问至关重要。

  • 启动卷挂载到 /boot。
  • 闪存设备上的config/go文件可以在WebGUI启动之前或之后运行用户命令。
  • 使用df命令检查/boot是否已挂载。
  • 启动卷必须标记为 UNRAID（全部大写）才能正确挂载。
  • 此阶段将提供额外的驱动程序和固件。
  • 配置被加载到RAM中。
  • 标准Linux服务，包括网络和WireGuard VPN（如果启用），在此阶段启动。
7. 阵列 - 点击展开/折叠

存储设备已挂载并可用，完成启动过程。这是您的数据变得可访问的地方。

  • 如果启用了自动启动，则在此处启动array；否则，手动启动将是必需的。
  • 驱动器将被挂载为/dev/diskX和/mnt/cache（如果存在）。
6. WebGUI - 点击展开/折叠

基于web的管理接口变得可用，允许远程管理和配置你的服务器。

  • WebGUI在此点启动。
  • 启动卷上的 config/go 文件可以在 WebGUI 启动之前或之后运行用户命令。
7. 阵列 - 点击展开/折叠

存储设备已挂载并可用，完成启动过程。这是您的数据变得可访问的地方。

  • 如果启用了自动启动，则在此处启动array；否则，手动启动将是必需的。
  • 驱动器将被挂载为/dev/diskX和/mnt/cache（如果存在）。
  • 共享在网络中可用作为/mnt/user/sharename。
  • Docker容器将按Docker选项卡中指定的顺序启动，具有可自定义的延迟。
  • 自动启动虚拟机(VMs)也将启动。

此时，Unraid 服务器已完全运行。

引导故障​

当您的服务器无法启动时，系统化的故障排除有助于快速识别和解决根本原因。按照这些步骤操作，以避免遗漏关键问题或进行不必要的更改。每一步都建立在前一步的基础上，即使某个步骤似乎与您的具体问题无关，也不要跳过。

  1. 如果可能，请为启动设备使用 USB 2.0 端口（当通过 USB 启动时）。与 USB 3.0 相比，它通常更可靠且更不容易出现问题。
  2. 检查您的 BIOS/UEFI 设置，以确保 Unraid 启动设备被设置为主要启动目标。
  3. 在 Windows 或 macOS 计算机上检查启动设备是否存在任何物理或逻辑错误。
  4. 将 Unraid 发布版本的 bz* 文件重新解压到启动卷上，以防止任何潜在的损坏。
  5. 通过从干净的 Unraid 副本开始来重建启动介质，然后恢复您的 config 文件夹。
  6. 尝试在安全模式下引导以检查是否有插件相关的问题。
  7. 使用新的启动介质进行测试，并执行干净的 Unraid 安装。这有助于确定服务器硬件是否存在问题。
  8. 如有必要，请将您的许可证转移到新的启动设备。

从丢失的引导驱动器和未知的奇偶校验驱动器恢复​

important

If your Unraid boot drive fails and you don’t have a recent backup or knowledge of which drives are parity, you can recover your system by using Unraid’s ability to recognize data drives by their file systems. Parity drives do not have a valid file system, which helps differentiate them.

  1. 不要启动阵列 除非你对驱动分配很有信心
  2. 记录 曾是什么驱动器是奇偶校验与数据驱动器
  3. 考虑寻求帮助 如果你不确定，请访问Unraid论坛

如果你最近有阵列配置的备份或文档，先查看这些。

如果您的 Unraid 启动驱动器出现故障且没有最近的备份或不知道哪个驱动器是校验盘，通过 Unraid 识别数据盘的文件系统来恢复您的系统。%%Parity drives|校验盘%% 没有有效的文件系统，这有助于区分它们。

Unraid 通过检测现有的有效文件系统来识别数据驱动器。Parity drives 由于缺少文件系统，会显示为无法挂载。此特性使您能够在使用新的启动介质启动后，将 parity drives 与数据驱动器区分开来。

恢复程序​

该程序帮助您在丢失引导驱动器并记不清哪些是奇偶校验与数据驱动器时，恢复阵列配置。请小心谨慎地遵循每一步，以避免数据丢失。

  1. 创建新的 Unraid 启动介质。
  2. 从这个新设备启动服务器（暂时不要分配任何驱动器）。
  3. 激活许可证，使用试用或转移现有许可证。
  4. 使用其中一个方法识别parity drives。
  5. 使用工具 → 新配置重置array，如果可能，保留以前的分配。
  6. 在主选项卡上纠正驱动器分配，确保区分parity和数据驱动器。
  7. 启动array以确认驱动器分配。
  8. 如果parity有效，勾选奇偶校验已有效框。如果无效，允许parity重建。
Multiple 校验驱动器

如果您有多个parity drives并且需要根据哪些驱动无法挂载来识别它们，千万不要使用Parity is Already Valid选项。分配错误的机会是50:50，如果您弄错了，您的array可能看似受保护但实际上并不是。在这种情况下，总是让校验重新建立以确保适当的保护。

  1. 根据新分配审阅和调整任何用户共享的包含/排除。
  2. 运行一次parity check以验证完整性，特别是如果parity没有重建。

识别奇偶校验驱动器​

使用 Unraid 内置功能（推荐方法） - 点击展开/折叠

此方法不需要插件，但会使parity无效，需要重建。

要使用该方法：

  1. 将所有驱动器分配为数据驱动器并启动。
  2. 由于缺乏有效的文件系统，parity drives将显示为不可挂载。
  3. 确认无法挂载的驱动器数与你的parity数量相匹配。
  4. 记录这些驱动器的序列号。
  5. 如有需要，可以检查已挂载的数据驱动器以确认其顺序。
使用未分配设备插件 - 点击展开/折叠

这种基于插件的方法通过以只读模式挂载驱动器来保持parity的有效性。

要使用该方法：

  1. 从应用选项卡安装未分配设备插件。
  2. 将每个磁盘只读地挂载，依次进行。
  3. 那些无法挂载的驱动器很可能是parity drives（无法区分奇偶校验1和奇偶校验2）。
  4. 如有需要，检查已挂载的数据驱动器以识别其顺序。

有关更多信息，请参阅Unraid论坛中的未分配设备插件主题。

* "WireGuard"和 "WireGuard"徽标是Jason A. Donenfeld的注册商标.