跳到主要内容

引导和启动故障

When your Unraid server fails to start correctly, it can be challenging to identify the cause without a clear understanding of the boot process. Following this guide lets you quickly diagnose and resolve most startup problems, ensuring that your array, WebGUI, and services are operational with minimal downtime.

准备闪存设备​

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

注意

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

启用UEFI引导​

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

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

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

理解启动顺序​

Unraid 启动序列有多个阶段：

1. BIOS 启动 - 点击展开/折叠

BIOS/UEFI 固件初始化硬件并定位可启动设备。这是整个启动过程的基础。

  • 主板 BIOS 识别出 Unraid 可启动的闪存设备。
  • 将闪存设备设置为默认引导设备因BIOS而异；请查阅主板手册以获得指导。
  • 闪存设备支持**传统(CSM)和UEFI**引导模式。
  • 对于UEFI引导，请确保闪存设备上的EFI文件夹末尾没有连字符（-）。
2. Syslinux 启动加载程序 - 点击展开/折叠

引导加载程序呈现启动选项并将 Linux 内核加载到内存中。此阶段决定运行哪个操作系统或诊断工具。

  • 启动菜单条目定义在闪存设备上的syslinux/syslinux.cfg文件中。
  • 你可以通过WebGUI下的主 → Syslinux配置编辑此文件。
  • Memtest86+ 随同当前版本的 Unraid 提供，可在传统和 UEFI 模式下运行。对于旧版本的 Unraid，请从 官方 Memtest 网站 获取与 UEFI 兼容的版本。
  • 如果没有选择选项，默认将在超时后引导，这对于无头操作很有用。
3. Linux 核心 - 点击展开/折叠

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

  • Syslinux从闪存设备将Linux核心加载到RAM中。
  • 您会看到控制台消息显示bz*文件正在加载。
  • 这一阶段的错误通常表示闪存设备问题。
  • Linux在启动期间检测硬件。
4. Flash 依赖服务 - 点击展开/折叠

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

  • 闪存设备在/boot上挂载。
  • 如果挂载失败，你可能还会看到登录提示，但这表示引导不完全。
  • 使用df命令检查/boot是否已挂载。
  • 闪存设备必须标记为UNRAID（全部大写）以进行正确挂载。
  • 此阶段将提供额外的驱动程序和固件。
  • 配置被加载到RAM中。
  • 标准Linux服务，包括网络和WireGuard VPN（如果启用），在此阶段启动。
5. 插件 - 点击展开/折叠

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

  • 安装的插件在此步骤加载。
  • 如果需要，安全引导选项可以抑制插件加载。
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 3.0 更可靠且问题更少。
  2. 检查你的BIOS/UEFI设置以确保闪存设备被设置为主引导设备。
  3. 在Windows或macOS计算机上检查闪存设备是否有物理或逻辑错误。
  4. 重新提取 Unraid 发布版本的 bz* 文件到闪存设备上，以防止潜在的损坏。
  5. 通过从干净的 Unraid 副本开始重建闪存设备，然后恢复您的 config 文件夹。
  6. 尝试在安全模式下引导以检查是否有插件相关的问题。
  7. 使用新的闪存设备进行测试，并执行干净的 Unraid 安装。这有助于确定服务器硬件是否存在问题。
  8. 如有必要，将许可证转移到新的闪存设备上。

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

important

如果驱动器分配不正确，此恢复过程涉及数据丢失风险。继续之前：

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

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

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.

Unraid identifies data drives by detecting existing valid file systems. Parity drives, which lack a file system, appear unmountable. This characteristic allows you to distinguish parity drives from data drives after booting with a new flash device.

恢复程序​

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

  1. Create a new Unraid boot drive.
  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的注册商标。