跳到主要内容

引导和启动故障

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. Ensure the Unraid flash device is selected as the UEFI boot device
  5. 保存更改并退出

理解启动顺序​

The Unraid boot sequence has a number of stages:

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

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

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

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

  • 启动菜单条目定义在闪存设备上的syslinux/syslinux.cfg文件中。
  • 你可以通过WebGUI下的主 → Syslinux配置编辑此文件。
  • Memtest86+, which ships with current builds of Unraid, works in both legacy and UEFI modes. For older Unraid versions, obtain a compatible version from the official Memtest site for UEFI.
  • 如果没有选择选项，默认将在超时后引导，这对于无头操作很有用。
3. Linux核心 - 点击展开/折叠

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

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

闪存设备可访问，并开始加载关键服务。这一阶段对配置和网络访问至关重要。

  • 闪存设备在/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)也将启动。

At this point, the Unraid server is fully operational.

引导故障​

当您的服务器无法启动时，系统的故障排除有助于快速识别和解决根本原因。按照以下步骤操作，以避免忽略关键问题或进行不必要的更改。每一步都建立在前一步之上，因此即便某步骤似乎与特定问题无关，也不要跳过。

  1. 如果可能，为闪存设备使用USB 2.0端口。它通常比USB 3.0更可靠且更不容易出问题。
  2. 检查你的BIOS/UEFI设置以确保闪存设备被设置为主引导设备。
  3. 在Windows或macOS计算机上检查闪存设备是否有物理或逻辑错误。
  4. Re-extract the Unraid release bz* files onto the flash device to prevent any potential corruption.
  5. Rebuild the flash device by starting with a clean Unraid copy, then restore your config folder.
  6. 尝试在安全模式下引导以检查是否有插件相关的问题。
  7. Test with a new flash device and perform a clean Unraid installation. This helps determine if there are issues with the server hardware.
  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 校验驱动器

If you have multiple parity drives and had to identify them based on which drives were unmountable, do not use the Parity is Already Valid option. There's a 50:50 chance of getting the assignments wrong, and if you do, your array may appear protected but actually isn't. Always allow parity to rebuild in this scenario to ensure proper protection.

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

识别奇偶校验驱动器​

Using Unraid’s built-in capability (preferred method) - Click to expand/collapse

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

要使用该方法：

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

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

要使用该方法：

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

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

* “WireGuard”和“WireGuard”徽标是Jason A. Donenfeld的注册商标。