跳到主要内容

常见问题解答

如果您需要 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 数据以获得社区的协助。


操作系统与配置​

Can I use a HASP key within a VM on Unraid? How does that work with multiple VMs?
点击展开/折叠

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密码怎么办？
点击展开/折叠

请参考 重置您的密码。

备注

如果您正在使用加密驱动器且忘记了加密密码，则无法进行数据恢复——没有后门。


How do I completely start Unraid OS from scratch? (Factory reset procedure)
点击展开/折叠
  1. 备份任何你希望保留的数据。
  2. 停止array并关闭服务器。
  3. 移除 USB 闪存设备。
  4. 使用 Unraid USB Flash Creator 工具重新格式化和重新安装 Unraid 到闪存驱动器。
  5. 重新插入闪存设备并启动服务器。
  6. 在 WebGUI 中打开终端并运行 lsblk 列出现有驱动器（不包括闪存）。
  7. 清除每个数据驱动器上的现有文件系统：
关键：破坏性操作

此步骤将永久擦除指定驱动器上的所有数据，并且无法恢复！

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

  • Double-check the device identifier in the WebGUI or with lsblk before running this command

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

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

wipefs /dev/sdX

将 X 替换为正确的驱动器字母（例如，sda、sdb、sdc）

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

如何更改我服务器的主机名？
点击展开/折叠

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

更改主机名的影响：

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

我的闪存驱动器报告了无效的GUID。我该怎么办？
点击展开/折叠

Unraid requires a USB flash device with a unique hardware GUID (serial number). Some manufacturers may reuse GUIDs or use generic values, making these drives incompatible with each other.

经过实地测试的品牌：

  • 三星 FIT Plus / Bar Plus
  • 金士顿 DataTraveler Exodia
  • 雷克沙 JumpDrive M45
  • PNY Elite-X （除非可以确认具有唯一 GUID，否则避免使用较新的 SanDisk Ultra Fit/Cruzer 型号。）

It's best to avoid generic or unbranded drives, SSDs, USB card readers, and SD card adapters, as these 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​

Does Unraid support various RAID types such as RAID1/5/6/10?
点击展开/折叠

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)✅ 内置✅ End-to-end 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。

使用 维护模式

在开始转换过程之前，请将您的 array 置于 维护模式。此步骤可确保在转换期间没有写入，从而保护您的数据。

转换过程

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

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

附加说明
  • 分区是自动的：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”或类似名称的设备。
  • 如果您在创建闪存时分配了静态 IP，请使用该地址。
  • 插上显示器和键盘到您的服务器；IP 地址将在本地控制台启动后显示。

该问题的常见原因：

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

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


安装​

I can't get the USB flash creator to install Unraid on my flash device. What do I do?
点击展开/折叠

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


我需要配置我的系统使用UEFI启动。我该如何做？
点击展开/折叠

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

选项 1：在创建闪存期间

  • 使用 USB 闪存创建器时，在将 Unraid 写入闪存驱动器前选择启用 UEFI 启动模式选项。

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

  • 在WebGUI中，前往闪存设备设置→闪存设备页面。
  • 启用 UEFI 启动模式并重新启动服务器。

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

  • 在闪存驱动器上，将 EFI- 文件夹重命名为 EFI（去掉破折号-）。
  • 将闪存驱动器插入服务器，然后进入主板 BIOS/UEFI 设置。
  • 设置USB闪存为主要启动设备并启用UEFI启动模式（确保禁用CSM/Legacy/Compatibility模式，若有）。

我在使用WebGUI时遇到浏览器问题。我该怎么办？
点击展开/折叠

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

  • Ad-blockers and content blockers: These browser extensions may interfere with the WebGUI. Try adding your Unraid server to your ad-blocker's whitelist or disabling the blocker for your server's address.
  • **浏览器扩展：**某些扩展可能会阻止脚本或更改页面内容。禁用扩展或尝试使用隐私/无痕窗口。
  • 过时的浏览器： 确保你使用的是现代的、最新的浏览器（如Chrome、Firefox或Edge）。旧版浏览器可能无法完全支持WebGUI。
  • 缓存问题： 清除浏览器缓存或尝试进行硬刷新（Ctrl+F5 或 Cmd+Shift+R）。
  • **网络问题：**确保您的计算机和服务器连接到同一网络和子网。

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


How do I extend my Unraid trial?
点击展开/折叠

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

important

您必须使用相同的 USB 闪存设备以继续您的试用。更换闪存设备将需要重新开始新的试用。