感谢一直以来对本博客的关注与支持！无论您是刚接触 Unraid 的新手，还是资深用户，你们的每一次阅读和反馈都为我带来了写作的动力。随着 2025 年的到来，我希望继续为大家提供实用、有趣、深入的 Unraid 系统教程和技术文章，但与此同时，我也想更贴近大家的需求与期待。因此，我诚挚地邀请读者参与，共同规划未来的内容方向。

征求意见：2025 年你希望看到哪些 Unraid 系统教程？

MoviePilot 是一个开源项目，旨在帮助用户轻松搭建自己的电影和媒体库管理系统，特别适合在家庭 NAS（网络附加存储）服务器上运行。本教程将基于 Unraid 系统，介绍最新的 MoviePilot V2 安装和使用方法，并配套结合下载和影音播放的搭建，帮助大家实现一整套完成的家庭影音搭建过程。

Unraid MoviePilot V2 自动化家庭影音全流程搭建

不少朋友在刚接触 Unraid 的时候都不太了解它是如何存储文件的，比如说不知道文件写入 Unraid 时会存储到哪个硬盘上，或者因为不了解存储逻辑而误将缓存池格式化，导致数据丢失。因此，本文将从 Unraid 的基础知识入手，介绍其如何组织与管理文件。

新手教程：Unraid 是如何存储文件的？

先前，有位朋友付费让我协助配置 NAS 外网访问。在给这位朋友搭建和沟通的过程中，了解到这位朋友对于一些网络基础概念和网络应用还不是很清楚，例如“端口映射”、“域名”、“DDNS”、“反向代理”和“SSL”等。其实不光是这位朋友，我先前接触到的很多新手中也都存在概念和知识理解不到位的情况，从而导致在实现外网访问的过程中出现偏差，进而导致无法正确实现目的。因此，本文将给大家介绍一些相关的基础知识，帮助大家更好的去实现外网访问。

新手教程：拥有公网 IP 下的外网访问 NAS 的过程（原理介绍）

Jackie 日报系列会介绍 Jackie 每天都做了哪些事，以及有哪些有意思的事跟大家分享。今日的主题是：Unraid 不能科学上网的排查方法。

Unraid 不能科学上网的排查方法

2024年6月26日，官方公布了 7.0 测试版的消息，正式宣告 7 开头版本的到来。那为什么 Unraid 不继续使用 6 开头的版本号？7.0 版本有哪些新的功能和改动值得注意？我什么时候可以用上 7.0 版本？Unraid 未来的发展计划是怎样的…博主将为大家一一介绍与 7.0 版本相关的重要信息。

Unraid 7.0 前瞻

硬盘无法休眠的原因很多，这里尝试整理各种会造成 Unraid 硬盘无法休眠的因素提供给大家参考，同时介绍如何使用 Dynamix Cache Directories 插件。

常见问题-13：硬盘无法休眠

前段时间不少朋友表示在使用 CD2（CloudDrive2） 进行网盘挂载的时候，会出现不能正常读取或者系统报错的情况，考虑到不少网友都希望在 Unraid 上面使用 CD2 ，因此本篇文章将给大家介绍如何在 Unraid 上面正确使用 CD2 进行网盘挂载。

CloudDrive2 在 Unraid 上面正确挂载网盘的方式

由于 Unraid 系统是安装在 U 盘中，所以只要是 U 盘出现了损坏那么就会直接导致系统无法使用，而最坏的情况就属于 U 盘出现了物理上的不可逆的损坏，并且还没有任何的系统备份可以使用。此类问题属于比较常见的问题，所以博主根据先前处理的案例给大家总结此类问题的解决办法和相关的信息。

常见问题-12：Unraid 的 U 盘坏了该如何恢复数据

当你在 Win 系统上通过 SMB 修改 Unraid 上的文件时，你可能会遇到“你需要来自 TOWER\nobody 的权限才能对此文件进行更改”的权限不足提示，这个问题一般是由于 SMB 用户的“组”权限不足所导致，本文将对此问题的原因进行解析并提供对应的解决方法。

常见问题-11：SMB 文件权限问题

2024-02-19 这天，Unraid 官方公告了新的付费模式，我整理了相关的信息并做了相应的解读来供大家参考，希望能让大家更清楚的了解新付费模式的具体细节和其中相关的要点。

2024 Unraid 新付费制解读

修改 Unraid 的 Docker 镜像加速地址，实现 Docker 镜像下载速度加速。

新手教程：Docker 镜像加速

此问题常见于系统升级之后出现，不少人升级系统后就会跳出此错误信息，并且原先设置了自动启动的虚拟机无法自启动。本文介绍了如何解决此问题的办法：对 vfio-pci 做 dummy change 。

常见问题-10：VM Autostart disabled due to vfio-bind error 解决办法

一位论坛的朋友遇到了 zfs 存储池无法挂载的情况，在帮他处理的过程中使用到了很多相关的 zfs 命令和操作方法，这篇文章是对当时处理过程的一个简单的归纳和整理。

zpool 常用操作及数据恢复

由于 Unraid 的 APPS （应用市场）上的插件主要是存储在 Github 中，所以不少国内的用户在 APPS 上安装插件时往往无法正常下载（或者下载速度很慢），所以这里博主提供一些常用插件列表以及手动安装的命令，来方便大家通过命令来手动进行安装。

常用插件下载（国内镜像手动安装）

2024-01-22：这天帮一位网友安装 CD2 挂载小雅的时候出现无法挂载的情况，错误提示为权限不足。经过多次尝试之后发现是由于 Docker 使用“目录”作为文件存储形式所导致，将其更改为 docker.img 模式之后就可以解决了。

常见问题-9：CloudDrive2 无法挂载（IO Error Permission denied）

dockur/windows 是一个可以将 Windows 系统安装在 Docker 容器中的项目，你可以通过安装 Docker 的形式来去安装并使用 Windows 系统。本文将给大家介绍如何使用这个 Docker 容器去安装各种 Windows 系统，已经相关的配置方法和注意事项。

WindowsinDocker：安装在 Docker 中的 Windows

不少朋友在升级 Unraid 版本时出现了 Docker 服务不能使用或者系统阵列无法启动的情况，这种情况往往出现在横跨大版本进行更新后出现。由于大版本之间不管是系统内核还是对应的软件之间都有了比较大的更新，所以从理论上来说升级后出现问题也是可以预料到的，因此为了最大化帮助大家避免升级后出现问题的情况，本文将会给读者们介绍 Unraid 在升级前应该进行哪些工作的铺垫。

新手教程：Unraid版本升级和转正升级的注意事项

这个东西是干嘛的请自行搜索，我把大致的方法写出来，方便有需要的朋友可以参考。需要说明的是我写下次文章时作者已经半年没有更新了，而且 Gihub 仓库也已经归档，所以以前还能不能用就不动了。另外，avdc 的上游项目 yoshiko2/movie_data_Capture 目前开始收费了，如果你需求更多一点建议可以付费使用，体验会好很多。

AVDC : Movie Data Capture Docker

目前国内的云盘用户越来越多，将数据备份到云盘是再常见不过的需求。前段时间一位朋友问我关于 Unraid 上云盘同步的方法并发给我一片文章做参考，我看了文章并实施之后发现效果很不错，因此决定将具体的实施方法写下来给到大家参考。此方法会使用到 Alist、CloudDrive 和群晖的 CloudSync 套件，我简称为“三叉戟”，具体的各个工具的安装和使用方法都会在文章中进行详细的说明，以便尽最大可能帮助大家能够顺利实施此方案。

Unraid 云盘同步方案：“三叉戟”同步（Alist-CloudDrive2-CloudSync）

Docker 服务无法启动一般可以通过重启 UNRAID 和删除 docker.img 文件来解决，而容器消失的问题往往与中文语言包插件有关，可以尝试重新安装语言包来解决。

常见问题-8：Docker 服务无法启动/容器消失的解决办法

Unraid 拓展阵列存储是一件比较简单的事情，替换硬盘也是如此。本文给读者朋友们介绍如何在 Unraid 中安全地替换阵列中的硬盘，以此来保证数据的完整。

新手教程：如何替换阵列里面的硬盘

由于 Unraid “聚合视图”功能的存在，用户共享文件夹（User Shares）是文件存储与管理的基本对象，文件在硬盘上的存储与读写会以共享文件夹的一些列属性为依据运作。本文将向读者介绍 Unraid 共享文件夹作用以及使用案例，方便新手朋友能更好的理解和使用 Unraid 。

新手教程：Unraid 默认共享文件夹的作用以及分配方法的说明

本文着重于向新手朋友们介绍 Unraid 存储目录结构的相关知识，让大家能够更好的去在 Unraid 上面去管理文件。

新手教程：unRAID 存储目录结构说明

在 unRAID 中，rsync 命令最常被作为文件传输工具所使用，了解并熟悉使用 rsync 命令可以让你轻松的在 unRAID 上实现文件的拷贝、转移和同步。

unRAID 通用文件传输工具 —— Rsync 命令

由于目前不少人习惯将 unRAID 的网关地址设置为旁路由（透明网关）的 IP 地址，以此来让 unRAID 可以走代理来使用。但是这种方式会将 unRAID 上的所有流量发送给旁路由，从而出现 BT/PT 下载的流量也走了代理的情况。为了解决此问题，可以通过给 unRAID 分配第二个网口用于 Docker 自定义网络的形式去解决。

新手教程：将 Docker 的自定义网络绑定到第二个网口

由于国内防火墙的原因，导致很多新手朋友刚开始接触 unRAID 的时候就被应用商店无法访问拦在门外了。这是因为 CA 访问的是国外的服务器，并且你在下载 CA 内的插件或者 Docker 时主要访问的是 Github 与 Docker Hub 而这两个服务器，而这两个服务器在国内恰恰也是访问起来比较慢，这些因素综合起来就造成了 CA 要么访问不到，要么访问很慢。

新手教程：CA 应用商店代理

unraid 共享文件夹旁边的感叹表示数据没有存放到有数据冗余的地方。

常见问题-7：共享文件夹旁边的感叹号是怎么回事

unRAID 系统与其它系统相比，最大的一个区别是 unRAID 是加载到内存中运行的，这也意味着想要系统稳定运行，内存的稳定显得更为重要。

unRAID内存的重要性以及内存测试方法

Unraid 的校验盘用于保护阵列硬盘的数据，但不少新手还不太清楚校验盘的工作原理，因此本文将给大家介绍有关校验盘的相关基础知识和注意事项。

新手教程：什么是校验盘，校验盘有什么作用

8月31日，Unraid 发布了 6.12.4 版本，此版本最大的更新是从系统层面解决了 macvlan call traces 问题。除了介绍此问题之外，本文还会对其他的相关更新做相应的介绍。

6.12.4 关于失联问题的解决办法以及相关更新说明

购买官方正版之后，却没有收到官方的激活密钥邮件，此时该怎么办？

常见问题-6：购买正版付款之后没有收到官方邮件

最近有位朋友遇到了在 Unraid 上万兆网卡无法跑满速度的情况，但由于博主经验不足，未能解决问题。因此我搜索了相关的资料，整理了可能会影响万兆速度的因素供大家参考。

Unraid 实现万兆网络的注意事项

在 unRAID 上，我需要多大的内存？

常见问题-5：unRAID上我需要多大的内存？

前两天有位朋友从博客上联系到我寻求帮助，表示 Unraid 系统无法正常运行，即使更换了3个U盘也还是提示“U盘损坏”导致系统不能正常运行。

换了3个U盘还是提示损坏：因内存而导致的罕见Unraid崩溃问题

unBALANCE 插件是 unRAID 上一个好用的文件转移工具，可以将一个硬盘内的所有数据转移到另一个硬盘中，也可以将某个共享文件夹内散布在各个硬盘的文件同一进行转移。

unBALANCE 文件转移工具使用方法和应用案例介绍

不少新入门 Unraid 的朋友往往对缓存策略感到比较迷惑，不清楚其中的原理，尤其今年6月份新版 Unraid 对原来的缓存策略进行了修改，进一步导致了新手朋友的疑惑。针对这种情况，本文将详细的对旧版和新版下的 Unraid 缓存策略进行详细的讲解，并提供了应用案例和常见问题解答，帮助新手朋友更好的理解缓存策略。

新手教程：详解 Unraid 缓存策略及应用案例

RustDesk 是一款远程桌面开源软件，对硬件（CPU 内存）和带宽的要求很低，即使是最低配置的云服务器都可以使用，并且在使用体验上完全可以平替市面上常见的 Todesk 、向日葵抑或是 TeamViewer 等远程桌面工具。
本文将介绍在Unraid 和云服务器部署的流程。

RustDesk 开源远程桌面服务部署

当因密码输入错误出发 unRAID 的禁止登陆策略，或者希望重置密码时该如何处理？

常见问题-4：unRAID 忘记密码怎么办

这里我想跟大家聊一针对近期这些问题的一些情况，如果你有注意过的话，基本上每一次版本更新，论坛上都会随之出现关于 2.5G 网卡的问题求助帖（尤其是 Realtek 的 2.5G 网卡），尤其是近期 6.12 版本出来之后，论坛上关于网络这一块的问题出现的更频繁了。
为什么会这样，为什么每一次系统新版本就会导致我系统出现问题，Unraid 系统做的就这么差么？

为什么我的 UNRAID 不稳定、总出问题 —— 针对近期论坛反馈我的感受

本文将给读者们介绍如何在 unRAID 上通过插件去备份 appdata 文件夹中的各项 Docker 配置文件，以此确保即使出现了意外数据也不会丢失。

Appdata Backup - Docker/U盘/虚拟机配置备份插件

本篇文章将给大家介绍如何在 IOS 或者 Android 上通过 APP 访问 unRAID 上的文件，并实现增删改查。

新手教程：如何在手机管理unRAID上的文件

有不少新手不太理解 Unraid 上阵列与缓存池之间的关系，尤其是 6.12 版本开始支持 ZFS 文件系统之后，缓存池可配置的选项更丰富了，但选项多了往往也让人无从抉择。本文将从基础开始给读者讲解阵列和缓存基本信息和含义，并从逻辑关系上梳理这两者的关系。

新手教程：阵列与缓存池

不少新手刚接触 unRAID 时不太清楚怎么样正确安装 Docker，并且容易遇到关于权限这一块的问题，比如说 appdata 文件夹的文件权限不正确导致 Docker 容器起不来的情况。本文将从基础的内容开始给新手朋友们介绍如何正确在 unRAID 上安装 Docker。

新手教程：如何在 unRAID 上正确安装 Docker

不少使用 unRAID 的朋友或多或少都遇到这样的问题：当我下载（如 QB/TR 等 P2P 下载），CPU 负载会很高；又或者当拷贝文件到 unRAID 时 CPU 占用率居高不下。其实这些问题都与 unRAID 自身特有的 SHFS 文件系统有关，这个文件系统是基于 FUSE 创建而来。那么本文将给大家详细的介绍问题的现象、本质和解决办法，让大家能更好的理解 unRAID 这个系统对文件存储的逻辑。

为什么unRAID下载/拷贝文件时CPU占用高：详解FUSE-SHFS、I/O问题和解决办法

如果 U 盘因某些原因（如断电）导致了物理的损坏或者系统文件的损坏，那么就会造成系统无法正常运行，比如说 Web 管理界面无响应、交互缓慢或者出现错乱等；又或者出现一些不正常的现象，但系统日志看不出来明显的报错。如果你遇到了类似的问题，那么你可以考虑重装一下 unRAID 系统，这里作者给大家介绍如何无损、安全的重装 unRAID 系统，包括更换系统版本也是同样的思路。

常见问题-3：如何安装/重装/更换unRAID系统（附安装包下载地址）

这段时间 6.12 版本出来之后，不少人遇到了 unRAID 失联的问题，但实际上类似的问题在 6.12 版本之前也或多或少有出现，因为这个问题跟特定的硬件（比如说路由器）和系统软件层面有关，有时候影响不大，但有时候影响大了就会出现这里所说的"失联”问题。本片文章将给大家介绍此问题的详细信息和相应的解决办法。

unRAID macvlan 失联问题解析（以及如何给Docker分配独立网口）

目前，许多人选择在 NAS 上添加一块 Tesla P4 显卡，以便于使用 Emby、Jellyfin 或者 Plex 等软件进行硬解码。P4显卡价格便宜（二手约400元左右），而且能够高效解码HEVC（H26.5）10bit 8K 的影音文件。
但鉴于有不少新手还不了解如何在 unRAID 上给 Docker 添加参数，来调用 Nvidia 的显卡实现 GPU 解码，所以本文将给大家介绍实现方法和一些常见的问题。

新手教程：给Docker添加Nvidia显卡硬解

很多人会遇到重启或开机时不能正常启动 unRAID 的情况，这里作者介绍以下几种方法保证 unRAID 可以正确的启动或者加载。

常见问题-2：如何保证unRAID正确开机

在传统的旁路由（透明代理）方案中，为了能够科学上网，内网设备需要以旁路由为网关，然后旁路由以主路由为网关来让设备正常联网。在这种网络结构中存在多种弊端，比如说当旁路由掉线了，那么所有以旁路由为网关的设备将直接掉线。在本文，作者将介绍一种可以完美替代旁路由结构的网络搭建方案，可以有效的提升网络的速度和稳定性等。

iKuai与Openwrt的有机结合：传统旁路由方案的完美替代

2023年6月14日，unRAID 官方宣布 6.12 正式版发布，从此开始 unRAID 原生支持 ZFS 这一优秀的文件系统。那么在升级到这种大版本前，我们需要注意什么事情、需要做哪些准备工作，本文将给大家详细介绍，并且还会介绍如何解决 2.5G 网卡在升级到 6.12 版本后无法使用的问题。

unRAID 6.12 版本升级前的注意事项（附：解决 2.5G 网卡升级后无法进入 unRAID 的问题）

在之前的文章《unRAID ZFS 入门（一）：ZFS 介绍》中，作者介绍了 ZFS 文件系统的一些基本概念，那么在本文作者将给大家介绍如何在 unRAID 系统上（ 6.12 版本）去创建并使用 ZFS 存储池。如果你尚未升级到 6.12 版本还在观望中，那么也可以参考本文的内容去了解 ZFS 的一些实际使用情况。

unRAID ZFS 入门（二）：在 unRAID 中创建 ZFS RAIDZ 阵列存储池

由于在Linux内核启动阶段，由于帧缓冲占用了显卡设备，导致显卡设备在进行虚拟机直通时无法正常直通，出现 BAR 1: can't reserve 的报错信息。本文章介绍了问题的实际原因并提供相应的解决办法。

解决显卡直通 kernel: vfio-pci BAR 1: can't reserve 问题

前段时间把软路由换了下来，换上刷了 Padavan 的红米 AC2100 硬路由。由于需要在 unRAID 上开启另一个网段的 IP 给到 Docker 用，因此就必须要在 Padavan 上设置第二个网段 IP 来正常给同网段的应用提供路由。本文章记录了在 Padavan 和 unRAID 上的设置过程，以此作为实现 unRAID 双网卡走不同网关的目的。

unRAID 双网卡双网关分流实验：以 Padavan 路由为例

unRAID 安装黑群晖虚拟机时，当群晖虚拟机安装进度达到 59% （正在安装 DiskStation Manager）左右之后无法安装、IP 无法访问并且 CPU 某一个核心出现满负荷的情况。

解决黑群晖虚拟机安装进度卡在59%无法安装

本文讲介绍如何在 unRAID 上安装 Lskypro 开源图床，来让读者朋友们实现私有图床的部署，然后借助 PicGO 软件来打造一个舒适的写作环境。

Lskypro + PicGO 搭建私有图床和环境

Jitsi 是一个自由开源的跨平台语音（VoIP）、视讯会议和即时通讯服务，本文介绍如何在 unRAID 上搭建属于自己的一套视频会议服务。

Jitsi 开源视频会议安装教程 

除了单独对共享文件夹开启 SMB 访问的方式之外，还可以利用自定义 SMB 参数或插件来实现 root share，这两种方式各有优缺点，读者根据自身的情况使用才是最好的。

新手教程：unRAID 开启 SMB 的其他方法

unRAID 的日志是存储在内存中的，所以当 unRAID 重启或者关机的时候，先前的运行日志就会清空。当我们遇到一些宕机或者莫名重启的情况时，我们没有办法定位原因，因为日志已经被清空了。所以对于使用 unRAID 系统的读者来说，开启 unRAID 的日志服务器来保存日志，作者认为是一个有必要的措施，并且方法也很简单。

unRAID开启日志服务器

Nastool 是一款 NAS媒体库管理工具，可用于：订阅影片、自动下载、海报刮削、PT站刷流等多功能一体化工具，本教程从零开始教会读者如何搭建这一工具。

Nastool 影音库搭建全流程教程

不同于群晖，unRAID 默认情况下是没有回收站功能的，所以当你在通过 SMB 共享删除一些文件的时候就没有办法恢复了。但得益于 unRAID 的插件功能，第三方开发者开发出了可以让 unRAID 实现回收站功能的插件。本文章介绍如何安装、配置和使用 Recycle Bin 插件，来帮助大家更好的使用 unRAID。

unRAID 安装 Recycle Bin 插件开启回收站功能

有时候我们会遇到 unRAID 无法访问的情况，造成的原因可能有很多，本篇文章也没办法对所有可能的因素做出解释，因此本文主要介绍：删除 unRAID 系统下的网络配置文件来让 unRAID 重置网络设置。作者平时在协助别人解决网络问题时也会经常使用到，这种方式相对通用，可作为大家排查网络问题的方法之一。

常见问题-1：unRAID无法访问

Intel 从11代 CPU 开始不再支持 GVT-g（代号为 Rocket Lake 的CPU除外），也就是说以前直通核显的方法，不再适用于11代开始的 CPU。但2023年3月20日左右，一位国内的高手开发了一款插件，通过开启 unRAID 的 SR-IOV 驱动来实现核显虚拟化直通这一目的。本篇文章将给大家介绍什么是 SR-IOV 技术、如何使用插件完成核显的虚拟化直通和相关问题等。

unRAID 11~13 代CPU开启 SR-IOV 实现虚拟机核显直通

从 6.12 版本（2023年3月发布测试版）开始，unRAID 开始原生支持 ZFS 文件系统，如果你还不了解 ZFS，那么本篇文章将带你入门。

unRAID ZFS 入门（一）：ZFS 介绍

2023年3月15日，unRAID 官方正式通告 6.12.0-RC1 版本上线（RC2版本3月20日上线），unRAID 正式原生支持 ZFS 文件系统（以前得靠插件）。本篇文章主要跟大家介绍一下 unRAID 在新版本中都更新了哪些东西，以及 ZFS 的一些基本知识。

unRAID 6.12.0 RC 版本更新和 ZFS 的一些说明

目前 Transmission 4.x 版本的 Docker 不再内置第三方的主题，本篇教程提供手动安装 transmission-web-control 主题的安装方法。

JackieWu

💬订阅资讯

订阅 Unraid 资讯频道