跳到主要内容

常见问题解答

如果您需要 Unraid OS 的帮助，您有几种支持选项：

目录​

我需要构建或系统配置方面的帮助。我应该去哪里？​

要了解如何构建或升级 Unraid 服务器，请访问 强迫性设计论坛 或加入 Unraid Discord。无论您的经验水平如何，社区都活跃且随时准备协助您。


Unraid 推荐使用哪些控制器？​

Unraid 在非 RAID 主机总线适配器 (HBA) 上表现最好。最好避免使用硬件 RAID 控制器，这些控制器可能会隐藏驱动器健康信息并使维护复杂化。

始终检查固件更新并确保控制器设置为 HBA/IT 模式，而不是 RAID 模式。您可以参考 推荐控制器线程 获取社区已成功测试的型号。


如果内置控制器已满，添加更多存储的最佳方法是什么？​

Unraid allows for the expansion of storage across multiple controllers. You can add a compatible HBA (as mentioned above). Ensure the controller operates in standard HBA (non-RAID) mode and supports AHCI/SATA. Avoid using RAID-only cards, as Unraid requires direct disk access for parity and monitoring.


Unraid 是否具有分配功能，可以记住硬盘上的坏扇区以避免向这些区域写入数据？​

Unraid 使用来自驱动器的 SMART 数据来监控其健康状况并检测坏扇区等问题。SMART 已经内置于现代硬盘和 SSD 中，可跟踪重新分配和待处理扇区等属性。

虽然 Unraid 没有特定的分配功能来避免坏扇区，但它确实使用 SMART 数据通知您是否有任何驱动器显示故障迹象或坏扇区数量增加。此信息可以在驱动器健康状况和 SMART 属性的 WebGUI 中找到。

如果驱动器显示出高计数的重新分配或未决扇区，建议及时更换以防止数据丢失。

如果您对驱动器的健康状况不确定，可以在 常规支持论坛 分享您的 SMART 数据以获得社区的协助。


操作系统与配置​

我能在 Unraid 的虚拟机中使用 HASP 密钥吗？如果使用多个虚拟机，它是如何工作的？​

If your HASP key is a USB dongle, you can assign it to only one VM at a time. Note that two VMs cannot use the same key simultaneously. You might need to pass through an entire USB controller for better compatibility. Always run tests with a Trial license to confirm that your hardware performs as expected.


我的 USB 闪存设备损坏了，而且我没有备份。我该如何恢复我的配置？​

如果您启用了 Unraid Connect 进行闪存备份，则可以使用它进行恢复。如果没有，请获取一个新的高质量闪存驱动器，在其上安装 Unraid，并使用您通过电子邮件收到的注册密钥。重新分配您的驱动器。如果您不记得分配，请在 常规支持论坛 上寻求协助。


如果我忘记了 root 密码，我该怎么办？​

请参考 重置您的密码。

备注

如果您使用加密驱动器并忘记加密密码，无法恢复数据 - 没有后门。


如何完全重新安装 Unraid 系统？（恢复出厂设置）​

  1. 备份任何你希望保留的数据。
  2. 停止array并关闭服务器。
  3. 移除启动设备。
  4. 使用 Unraid USB Flash Creator 工具重新格式化该驱动器并在其上重新安装 Unraid。
  5. 重新插入启动设备并启动您的服务器。
  6. 在 WebGUI 中打开终端并运行 lsblk 以列出所有驱动器（不包括启动设备）。
  7. 清除每个数据驱动器上的现有文件系统：

:::danger[Critical: 破坏性操作

  • 在继续之前，确保您已经备份所需的任何数据

  • 在运行此命令前双重检查设备标识符，通过 WebGUI 或 lsblk

  • 确保您锁定了正确的驱动器 - 错误驱动器的数据损失无法恢复

对于每个数据驱动器，运行：

wipefs /dev/sdX

对于每个数据驱动器，运行：

  1. 继续正常的 Unraid 设置和配置。

如何更改我服务器的主机名？​

要更改 Unraid 服务器的主机名，请在 WebGUI 中导航到 设置 → 系统设置 → 标识。

更改主机名的影响：

  • 新主机名将用于网络标识（例如，通过 http://newname 访问）。
  • 您可能需要重新连接任何使用新主机名的映射网络驱动器或快捷方式。
  • 某些设备或服务可能缓存旧名称；可能需要完全重新启动设备以识别新名称。

我的启动设备报告无效的 GUID。我该怎么办？​

Unraid requires a boot device with a unique hardware GUID (for USB boot, this is usually a USB flash drive). Some manufacturers may reuse GUIDs or use generic values, and counterfeit drives, especially of well-known brands like SanDisk and Samsung—often lack unique GUIDs. For guidance on choosing a compatible drive (including brand and retailer advice), see Create your bootable media and Selecting a replacement device.

In short: Prefer drives from reputable retailers. Consider second-tier brands (e.g., TeamGroup, Transcend, PNY), which are less often counterfeited. Avoid generic or unbranded drives, SSDs, USB card readers, and SD card adapters; they often lack unique GUIDs and may not be supported for booting Unraid.


虚拟化与设备​

每当我关闭分配有 AMD GPU 的 Windows 虚拟机时，它无法重启。我该怎么办？​

许多 AMD GPU 在功能级别复位时会出现问题，从而导致此问题。解决方法包括在 Windows 中关闭前弹出 GPU 或使用通常可以避免该问题的 NVIDIA GPU。


如果 CPU 没有集成图形，如何将主 GPU 传递给虚拟机？​

这是可行的，但需要额外的步骤。请查阅 SpaceInvaderOne 的视频指南，获取详细指导。


存储 & RAID​

Unraid 是否支持 RAID1/5/6/10 等不同的 RAID 类型？​

Unraid 具有独特的存储架构，使其与传统的 RAID 系统区分开来。以下是不同存储选项的比较：

特性 / 能力Unraid parity array (md)BTRFS 池 (cache)ZFS 池（7.x+）传统 RAID 1/RAID 5/RAID 6/RAID 10
Parity / 冗余模型专用 parity 磁盘通过 BTRFS 的软件 RAID 1/RAID 10/RAID 5/RAID 6RAID 1-Z1/Z2/Z3 或镜像条带化 parity (RAID 5/RAID 6) 或镜像 (RAID 10)
数据条带化不可以是的（除了 RAID 1）可以可以
磁盘大小灵活性支持混合大小相似大小更佳每个 vdev 相似更佳需要匹配的大小
一次扩展一块磁盘可以是（添加或更换设备）是的（每个 vdev*）通常否
每个磁盘的文件系统可以不可以不可以不可以
单磁盘读取速度本地磁盘速度聚合（多磁盘）聚合（多磁盘）聚合
重建期间写入劣化最小（仅失败驱动器）取决于级别取决于 vdev 布局显著
Bit rot 检测可选 (BTRFS/ZFS checksum)✅ 内置✅ 端到端 checksums❌ 非固有
Snapshot / 发送-接收❌✅ (BTRFS)✅ 原生❌
推荐生产使用一般媒体存储RAID 1/RAID 10 (避免 RAID 5/RAID 6)**✅ 所有级别稳定Enterprise arrays

* ZFS vdevs 必须通过更换 所有 驱动器或添加新的 vdev 来扩展。
* BTRFS RAID 5/RAID 6 仍然被“实验性”上游标记；谨慎使用。

  • Unraid parity array 非常适合增量扩展，允许不匹配的驱动器大小并且重建压力较小。
  • ZFS pools (available in 7.x) provide enterprise-class redundancy, snapshots, and checksums, making them ideal for VMs and databases.
  • BTRFS pools excel for fast SSD caches, especially in mirrored RAID 1/RAID 10 mode.
  • 传统硬件 RAID 卡_不是_必需的；您可以使用简单的 HBA 让 Unraid 直接管理驱动器。

我目前有一系列设备使用 MBR 风格的分区表格式化，想转换为 GPT。我该如何做？​

为何从MBR转换到GPT？

MBR (主引导记录) 分区支持的磁盘最大为 2TB，并且仅允许最多四个主分区。另一方面，GPT (GUID 分区表) 可以处理更大的磁盘和几乎无限的分区。如果您处理较大的驱动器或需要更好的分区管理，建议转换为 GPT。

Use 维护模式

在开始转换过程之前，将您的 array 放入 维护模式。此步骤确保在转换期间不发生写入操作，从而保护您的数据。

转换过程

  1. 确保您拥有有效的 parity 和当前的启动设备备份。
  2. 从主标签页进入维护模式。
  3. 首先替换并重建您的parity驱动器。
  4. 一次替换每个数据驱动器，并在每次更换后重建array。
  5. 新的驱动器将根据其大小被格式化为适当的分区样式：
    • 2TB或更小：使用MBR分区
    • 大于2TB：使用GPT分区
  6. 在所有驱动器更换并重建后，退出维护模式。

此过程在更改分区格式时保证您的数据安全。

Additional 笔记

  • 分区是自动的：Unraid 会根据磁盘大小自动选择分区类型：

    • 2TB或更小：始终使用MBR分区
    • 大于2TB：始终使用GPT分区

  • 从 Unraid OS 6.9 开始，无论分区样式如何，分区 1 在旋转设备上从 32KiB 开始，在非旋转设备上从 1MiB 开始。 -- 在开始此转换过程之前，请始终备份您的启动设备。


网络​

如何禁用br0桥接？​

是的。br0 桥接是一个允许 Docker 容器和 VMs 直接连接到本地局域网（LAN）并获得其 IP 地址的 Linux 网络桥接器。它充当虚拟网络交换机，将物理网络接口连接到容器和 VMs 使用的虚拟接口。

备注

禁用 br0 意味着 VMs 和 Docker 容器将无法直接访问 LAN，并可能失去一些高级网络功能。


我似乎无法使用 http://tower 或 http://tower.local 连接到 WebGUI。我该怎么办？​

如果在通过主机名连接 WebGUI 时遇到问题，则可能是由于本地 DNS 无法解析服务器名称。请尝试使用 IP 地址直接连接。

如何找到服务器的 IP 地址：

  • 检查您的路由器或交换机的 DHCP 客户端列表，查找标记为“Tower”或类似名称的设备。
  • 如果您在使用 USB Flash Creator 创建启动介质时分配了静态 IP，请使用该地址。
  • 插上显示器和键盘到您的服务器；IP 地址将在本地控制台启动后显示。

该问题的常见原因：

  • 您的计算机和服务器可能在不同的子网或 VLAN 上。
  • 您的路由器可能不支持本地主机名解析。
  • Unraid 服务器可能未连接到网络或网络配置错误。
  • 防火墙或安全软件可能阻止了访问。

如果您仍然无法连接，尝试重启服务器和网络设备，确保所有电缆牢固连接。


安装​

我无法让 USB Flash Creator 在我的启动介质上安装 Unraid。我该怎么办？​

如果 USB Flash Creator 不适用于您的系统或 USB 驱动器，您可以使用手动安装方法来准备您的 Unraid 启动设备。此方法兼容 Windows、macOS 和 Debian/Ubuntu Linux。


我需要配置系统以使用 UEFI 启动。我该如何做？​

您可以通过几种不同的方法设置UEFI启动模式：

安装​

使用 USB Flash Creator 时，在将 Unraid 写入 USB 驱动器之前，选择启用 UEFI 启动模式的选项。

选项 2： 在遗留模式启动后​

在 WebGUI 中，打开设置 → 启动设备（适用于 Unraid 7.3.0 及以上）。在较早版本中，同一页面位于设置 → 闪存设备。

启用 UEFI 启动模式并重新启动服务器。

选项 3：手动重命名文件夹​

在启动卷（USB 驱动器）上，将 EFI~ 文件夹重命名为 EFI（移除波浪号 ~）。

您可以通过几种不同的方法设置UEFI启动模式：

将 Unraid 启动设备（如适用则为 USB）设为主要启动目标，并启用 UEFI 启动模式（如果可用，请务必禁用 CSM/Legacy/Compatibility 模式）。


我使用我的网页浏览器访问 WebGUI 时遇到问题。我该怎么办？​

如果您在使用WebGUI时遇到显示或功能问题，请考虑以下几点：

  • 广告拦截器和内容拦截器： 这些浏览器扩展可能会干扰 WebGUI。尝试将您的 Unraid 服务器添加到广告拦截器的白名单，或为您服务器地址禁用拦截器。
  • **浏览器扩展：**某些扩展可能会阻止脚本或更改页面内容。禁用扩展或尝试使用隐私/无痕窗口。
  • 过时的浏览器： 确保你使用的是现代的、最新的浏览器（如Chrome、Firefox或Edge）。旧版浏览器可能无法完全支持WebGUI。
  • 缓存问题： 清除浏览器缓存或尝试进行硬刷新（Ctrl+F5 或 Cmd+Shift+R）。
  • **网络问题：**确保您的计算机和服务器连接到同一网络和子网。

如果问题仍然存在，请尝试从其他浏览器或设备访问WebGUI。


如何延长我的 Unraid 试用期？​

如果您需要 Unraid 的 30 天免费试用 的更多时间，可以申请延期。在原始试用期到期后，停止 array 并转到 注册 页面。您应该看到一个按钮，允许您申请 15 天的延长。您可以这样做两次，总共延长 60 天，然后需要购买许可证。

important

您必须使用同一个启动设备才能继续试用。更换启动介质将需要从头开始新的试用。