1. 项目概述为什么选择TrueNAS Scale如果你正在寻找一个既能当网络附加存储NAS又能跑虚拟机和容器应用的一体化家庭服务器系统TrueNAS Scale 绝对值得你花时间研究。我折腾过不少开源存储方案从早期的FreeNAS到现在的TrueNAS CORE和Scale最终把家里的主力存储和计算节点都迁移到了TrueNAS Scale上。它本质上是一个基于Debian Linux的存储操作系统核心是ZFS文件系统但在此基础上它集成了Kubernetes和容器化应用管理这让它从一个单纯的“硬盘盒子”变成了一个功能强大的“家庭数据中心”。简单来说TrueNAS Scale解决了几个核心痛点第一数据安全。ZFS的写时复制、快照、数据校验和自动修复功能让你不再担心硬盘突然坏掉导致数据全丢。第二应用整合。你不再需要单独部署一台机器跑Docker或者用虚拟机装各种服务在TrueNAS Scale的Web界面上点点鼠标就能部署Nextcloud、Plex、Home Assistant这些常用应用。第三硬件利用最大化。一台性能尚可的机器既能提供高速共享存储又能作为计算节点运行各种服务省电省空间。这次安装指南我会基于最新的“Dragonfish”版本23.10系列带你走一遍从制作安装盘到完成基础配置的全过程。过程中我会穿插我踩过的坑和优化建议目标是让你一次部署成功少走弯路。2. 安装前的核心准备与规划安装本身不难但前期规划不到位后期使用会非常别扭甚至需要推倒重来。这部分比动手安装更重要。2.1 硬件选择与兼容性自查TrueNAS Scale对硬件有一定要求但并非苛刻。它的内核是Linux所以硬件兼容性比一些小众系统好得多。CPU64位处理器是必须的。如果只是做纯存储对CPU要求不高。但如果你想流畅地转码视频比如用Plex或Jellyfin、运行多个虚拟机那么一个多核心的现代CPU是必要的。Intel带核显的CPU如酷睿系列对硬件转码支持很好。AMD的CPU同样支持但部分老型号的核显驱动在Linux下可能需要额外调整。内存这是ZFS系统的“粮食”。官方最低要求8GB但这仅仅是让系统跑起来。我强烈建议至少16GB起步。ZFS会用大量内存作为缓存ARC内存越大缓存命中率越高尤其是随机读写性能提升越明显。如果计划使用虚拟机或很多应用32GB或更多是更稳妥的选择。ECC内存能提供更好的数据完整性但对于家庭环境并非强制。启动设备系统本身需要安装在一块独立的存储设备上。绝对不要将系统安装在你要用于存储数据的那组硬盘里。最佳实践是使用一块小容量的固态硬盘SSD比如120GB或240GB的SATA SSD。它便宜、可靠且能保证系统快速启动。U盘已经不被推荐用于安装因为频繁的日志写入会很快耗尽它的寿命。数据存储设备这就是你的硬盘了。ZFS强烈建议使用相同容量、相同型号的硬盘来组建存储池Pool以获得最佳的性能和数据安全。对于家庭用户常见的配置有镜像Mirror两块硬盘互为镜像类似RAID 1。空间利用率50%读写性能好允许坏一块硬盘。适合对数据安全要求高、容量需求不大的场景。RAIDZ1类似RAID 5需要至少3块硬盘允许坏1块。空间利用率是 (n-1)/n。RAIDZ2类似RAID 6需要至少4块硬盘允许坏2块。安全性更高。条带化Stripe不提供任何冗余所有硬盘数据串联一块坏则全丢。除非是纯缓存或临时数据否则家庭用户慎用。网卡千兆网卡是基础。如果你的网络环境和客户端设备支持2.5G或10G那么升级网卡会带来巨大的内网传输速度提升特别是当你使用SSD缓存或全闪存阵列时。确保网卡型号在Linux内核中有良好驱动Intel和Realtek的常见型号一般没问题。注意在购买硬件前可以去TrueNAS官网的社区论坛看看“硬件推荐”板块有很多现成的配置单可供参考。2.2 安装介质制作与启动现在我们来制作安装U盘。你需要准备一个至少8GB容量的U盘制作过程会清空它里面的所有数据。下载镜像访问 TrueNAS 官方网站找到 TrueNAS SCALE 的下载页面。选择最新的稳定版STABLE镜像通常是一个.iso文件。建议同时校验一下文件的SHA256值确保下载完整。制作启动盘在Windows下我推荐使用 Rufus 这款工具。打开Rufus插入U盘设备会自动识别。点击“选择”找到你下载的.iso文件。其他选项保持默认分区类型GPT目标系统UEFI。点击“开始”它会提示你以“DD镜像模式”写入确认即可。这个过程大概需要5-10分钟。在macOS或Linux下可以使用dd命令或者balenaEtcher这类图形化工具同样简单。调整BIOS/UEFI设置将制作好的U盘插入要安装TrueNAS的机器开机进入BIOS/UEFI设置界面。需要调整的关键项有启动顺序将U盘设为第一启动项。启动模式设置为UEFI如果硬件支持。这比传统的Legacy BIOS模式更现代兼容性更好。关闭安全启动Secure Boot虽然新版本TrueNAS可能支持但为避免不必要的麻烦建议先关闭。SATA模式设置为AHCI。不要用RAID或IDE模式。从U盘启动保存BIOS设置并重启机器应该会从U盘启动进入TrueNAS的安装引导界面。3. 图形化安装流程详解启动后你会看到一个文本菜单。选择第一项 “Install/Upgrade” 开始安装。3.1 安装器界面操作指南安装过程是全图形化的非常直观。选择安装磁盘这是最关键的一步。安装器会列出所有可用的磁盘。请务必准确选择你准备用作系统盘的那块小容量SSD。通常你可以根据磁盘大小和型号来辨别比如选择那个120GB的而不是几个4TB的。选中它空格键然后按回车进入下一步。警告一旦继续该磁盘上的所有现有数据将被永久擦除。分区设置接下来会询问是否为系统盘分区。对于UEFI启动它会自动创建两个分区一个小的EFI系统分区ESP和一个大的系统数据分区。保持默认选项即可不需要手动调整。设置root密码为系统的root用户设置一个强密码。这个密码用于Web界面和SSH的root登录务必牢记。界面会提示密码强度。配置网络安装器会尝试通过DHCP自动获取IP地址。如果成功你会看到获取到的IP、网关和DNS信息。我建议在这里就设置为静态IP这对于服务器来说至关重要避免IP变动导致无法访问。选择你的网卡如eno1或eth0取消勾选 “DHCP”手动填入IPv4地址规划一个内网中固定的IP例如192.168.1.200。子网掩码通常是255.255.255.0或/24。默认网关你的路由器地址如192.168.1.1。DNS服务器可以填路由器的地址或者公共DNS如223.5.5.5和8.8.8.8。主机名可以按喜好设置比如truenas。开始安装确认所有信息无误后选择 “Install” 开始。系统会将文件复制到你的系统盘这个过程大约需要5-15分钟取决于你的U盘和系统盘速度。安装完成安装结束后它会提示你移除安装介质U盘并重启。照做然后机器会从你刚刚安装好的系统盘启动。3.2 首次启动与Web界面登录首次启动TrueNAS Scale会进行一系列初始化时间稍长。启动完成后屏幕上会显示重要的访问信息系统的IP地址就是你刚才设置的静态IP。Web管理界面的URL通常是https://你的IP地址。提示你使用root账号和之前设置的密码登录。在你的日常使用的电脑上打开浏览器输入https://你的TrueNAS IP。例如https://192.168.1.200。由于TrueNAS使用自签名证书浏览器会提示“连接不安全”或“风险警告”这是正常的。点击“高级”或“继续前往”即可。输入用户名root和密码你就进入了TrueNAS Scale的驾驶舱——Web管理界面。4. 初始化配置打造可用的存储系统登录后别急着创建存储池先完成几项基础配置让系统更顺手。4.1 网络与常规设置优化进入“系统设置” - “常规”。时区与语言设置正确的时区和语言。这对于日志时间戳和计划任务非常重要。控制台配置可以在这里修改控制台的键盘布局和菜单选项一般不用动。GUI设置可以修改Web界面的访问端口默认443、协议等非必要不改。进入“网络”界面检查你安装时设置的静态IP是否正确。在这里你也可以绑定额外的IP、配置VLAN等高级网络功能。对于大多数家庭用户一个静态IP足够了。4.2 创建你的第一个存储池Pool这是TrueNAS的核心功能。进入“存储” - “存储池”。点击“添加池”系统会提示你这是一个破坏性操作确认你已备份好数据。命名池给池子起个名字比如tank、data等。这个名字会在共享路径中用到。选择硬盘与布局左侧会列出所有未使用的磁盘。请再次确认不要选中你的系统盘假设我们有4块4TB的硬盘想组建一个RAIDZ2允许坏2块。将这4块硬盘从左侧拖到右侧的“数据VDEV”区域。系统会自动将它们组成一个VDEV虚拟设备。在VDEV类型下拉菜单中选择RAIDZ2。下方会显示预估的可用容量大约是(4-2)*4TB 8TB实际会略少因为单位换算和ZFS元数据占用。加密可选你可以选择加密整个存储池。这提供了额外的安全性即使硬盘被物理盗取数据也无法读取。但务必、务必、务必保管好加密口令和恢复密钥文件如果丢失数据将永久无法恢复。对于家庭环境如果你对安全性没有极端要求可以先跳过。最后检查确认硬盘列表和布局无误后点击“创建”。系统会开始格式化硬盘并创建存储池这个过程需要几分钟。创建完成后你会在存储池列表中看到它并显示健康状态、已用/可用空间等信息。4.3 创建数据集Dataset与配置权限存储池像一个大仓库数据集Dataset就像是仓库里的一个个独立房间你可以给每个房间设置不同的规则。创建数据集在存储池的详情页面点击“添加数据集”。名称根据用途命名如media存放电影音乐、documents、backup等。共享类型如果你主要给Windows电脑用选SMB如果给Linux/Mac或用于应用存储选通用。其他高级选项如压缩、配额等可以先保持默认后续可以随时调整。配置权限数据集创建后点击旁边的“编辑权限”按钮。用户选择root。组选择root。权限将“用户”、“组”和“其他”的权限都勾选上“读”、“写”、“执行”。这是一种简化设置便于初期测试。在生产环境或多人使用时需要更精细的ACL权限控制。勾选“递归应用权限”并点击“保存”。这样在这个数据集下创建的所有文件和文件夹都会继承这个权限。4.4 设置共享服务以SMB为例要让Windows电脑访问需要开启SMB也叫Samba/CIFS共享服务。进入“共享” - “Windows共享(SMB)”点击“添加”。路径点击浏览选择你刚才创建的media数据集。名称共享名客户端会看到这个名字比如Media。描述可选。其他选项如“允许访客访问”可以先不勾我们用密码访问更安全。点击“保存”。系统会提示你需要启动SMB服务。进入“服务”页面找到 “SMB” 服务点击右侧的开关图标启动它并勾选“开机自启”。现在在你的Windows电脑上打开文件资源管理器在地址栏输入\\你的TrueNAS IP如\\192.168.1.200回车。它会提示你输入用户名和密码输入root和你的root密码就能看到名为Media的共享文件夹了可以尝试创建和删除文件来测试读写是否正常。5. 应用部署入门以安装Plex媒体服务器为例TrueNAS Scale的“应用”功能是其一大亮点它基于Kubernetes和Helm但通过Web界面简化成了点选操作。5.1 配置应用商店首次使用前需要先配置应用源。进入“应用”页面。点击“设置”。配置存储系统会要求你为应用分配一个存储位置。点击“选择”在浏览窗口中在你之前创建的存储池如tank下新建一个数据集命名为ix-applications。选择这个数据集作为应用存储位置。这将是所有应用配置和数据的存放地。网络配置确认网络接口正确通常是你的主网卡。其他高级设置如节点IP、DNS等初期保持默认即可。点击“保存”。系统会初始化应用环境这可能需要几分钟期间不要关闭页面。5.2 搜索并安装Plex环境就绪后点击“可用应用”你会看到一个应用列表。在搜索框输入Plex。点击Plex应用图标然后点击“安装”。应用配置应用名称可以保持plex。版本选择最新的稳定版。Plex配置这是最关键的部分。你需要设置一个“主机路径”来映射你的媒体库。在“存储”配置部分点击“添加”。类型选择主机路径。主机路径点击“浏览”找到你存放电影/音乐的media数据集例如/mnt/tank/media。挂载路径填写容器内的路径例如/data。这意味着容器内的/data目录对应着你TrueNAS上的/mnt/tank/media。Plex声明你需要一个Plex账号。如果还没有先去Plex官网注册一个。这里会要求你输入一个“声明令牌Claim Token”。这个令牌可以在你登录Plex官网后在 特定页面 获取该链接有时效性。复制令牌填入。网络配置默认会为Plex分配一个集群内的IP和端口。为了从外部访问更方便我们设置一个“NodePort”或“LoadBalancer”。最简单的是使用“NodePort”。在“网络”配置部分找到服务类型选择NodePort。系统会自动分配一个高位端口如32400。记下这个端口号。资源限制可选可以限制Plex容器使用的CPU和内存防止它占用过多资源影响其他服务。滚动到最下方点击“安装”。系统会开始拉取Plex镜像并创建容器这取决于你的网速可能需要一段时间。安装完成后在“已安装应用”列表里Plex的状态会变为“运行中”。点击它的名称在详情页可以找到访问方式。通常你可以通过http://你的TrueNAS IP:分配的NodePort来访问Plex的Web界面进行媒体库扫描等初始设置。6. 系统维护与数据安全基石系统跑起来不是终点日常维护才能保证长治久安。6.1 配置定期快照与数据保护ZFS的快照功能是“时光机”可以瞬间创建某个时间点的数据副本占用空间极小只记录变化。进入“数据保护” - “定期快照任务”点击“添加”。选择数据集选择你想要保护的数据集比如tank/media。计划设置快照频率。例如可以设置“每1小时”一次保留最近24小时的快照“每天”一次保留最近30天的快照“每周”一次保留最近12周的快照。这样形成了一个时间阶梯。命名前缀可以按计划命名如hourly-、daily-。点击“保存”。现在系统就会自动为你创建和清理快照了。你可以在“存储”-“快照”里手动查看和回滚到任意快照。6.2 配置SMART测试与硬盘健康监控SMART测试可以提前预警硬盘故障。进入“存储” - “磁盘”选择你的数据盘非系统盘。点击“编辑”在“SMART选项”中确保“启用SMART”是打开的。进入“数据保护” - “SMART测试”点击“添加”。磁盘选择所有数据盘。类型选择LONG长测试全面但耗时建议每月一次或SHORT短测试快速建议每周一次。计划设置一个在系统空闲时运行的时间比如每周日凌晨3点。保存后测试会自动运行。你可以在“报告” - “所有报告”中查看SMART测试结果和磁盘温度等信息。6.3 配置系统邮件告警TrueNAS能监控各种状态硬盘错误、池空间不足、更新可用等并通过邮件通知你。进入“系统设置” - “电子邮件”。填写你的发件邮箱信息。以QQ邮箱为例发件地址你的QQ邮箱。发件服务器smtp.qq.com端口465(使用SSL) 或587(使用STARTTLS)。安全模式根据端口选择SSL/TLS或STARTTLS。用户名你的完整QQ邮箱地址。密码这里需要填QQ邮箱的“授权码”不是登录密码。需要在QQ邮箱网页版的设置中申请。填写“收件地址”点击“发送测试邮件”。如果收到说明配置成功。进入“系统设置” - “警报”在这里可以细粒度地设置哪些事件需要触发邮件告警。7. 常见问题与故障排查实录即使按照指南操作也可能会遇到问题。这里记录几个我遇到过的典型情况。7.1 Web界面无法访问症状浏览器输入IP后无法连接。排查检查物理连接网线是否插好交换机/路由器端口灯是否亮检查IP地址到TrueNAS主机接上显示器和键盘登录命令行输入ip a命令查看网卡是否获得了正确的IP地址。如果没有可能是网络配置错误或DHCP问题。检查防火墙确保客户端电脑和TrueNAS主机所在的网络没有防火墙规则阻止了443端口HTTPS的访问。家庭路由器一般没问题。检查服务状态在TrueNAS命令行输入midclt call service.query可以查看所有服务状态确保webserver服务是RUNNING。7.2 存储池状态异常DEGRADED/FAULTED症状在“存储”-“存储池”页面池的状态不是“ONLINE”在线而是“DEGRADED”降级或“FAULTED”故障。排查立即查看详情点击池名称在状态页面会明确提示哪块硬盘出了问题。DEGRADED通常是一块硬盘离线了。检查硬盘电源线和数据线是否松动。重新插拔后在“存储”-“磁盘”中找到该磁盘如果状态恢复为“ONLINE”可以尝试“联机”操作。如果硬盘物理损坏则需要更换新硬盘后进行“替换”操作。FAULTED情况更严重可能有多块盘故障或数据校验错误过多。此时切勿盲目操作首先确保所有硬盘连接正常。然后去社区论坛或查阅文档根据具体错误信息寻找解决方案。在数据安全面前谨慎是第一位的。核心原则对于RAIDZ1允许坏1块盘RAIDZ2允许坏2块。在冗余耗尽前尽快更换故障盘。7.3 应用安装失败或无法启动症状应用一直处于“部署中”或“已停止”状态。排查查看日志点击有问题的应用在详情页找到“日志”选项卡查看容器的启动日志。错误信息通常很直白比如“端口已被占用”、“挂载路径不存在”、“权限错误”。检查端口冲突TrueNAS主机上某个端口可能已被其他应用占用。在应用配置中尝试更换一个NodePort端口号。检查存储路径权限这是最常见的问题。应用容器通常以非root用户如568apps用户运行。如果你挂载的主机路径数据集权限是root:root且没有给“其他”用户读/写权限应用就会因权限不足而启动失败。解决方法要么在数据集权限中给“其他”用户足够的权限简单粗暴要么在应用的高级设置中配置一个“安全上下文”指定正确的用户/组ID更规范。检查资源是否充足如果主机内存严重不足Kubernetes可能无法调度容器。检查系统资源仪表盘。7.4 SMB共享访问速度慢症状从Windows拷贝文件到TrueNAS速度远低于千兆网络应有的水平~110MB/s。排查与优化基础测试在TrueNAS命令行用iperf3测试网络带宽。先在TrueNAS上启动服务端iperf3 -s。在客户端电脑上运行客户端iperf3 -c TrueNAS IP。如果带宽测试结果就低问题在网络网线、网卡、交换机。SMB协议版本旧版SMB1协议效率很低。确保TrueNAS和Windows都使用SMB2或SMB3。在TrueNAS的SMB服务高级配置中可以设置server min protocol SMB2_10。关闭日志对于纯家庭使用可以尝试在SMB共享的“高级选项”中添加两个参数write cache size 262144和strict sync no。这可以提升性能但会牺牲一点数据安全在极端断电情况下可能丢失少量正在写入的数据。请根据自身情况权衡。客户端优化在Windows上可以尝试打开“大型发送卸载”等网卡高级属性。折腾TrueNAS Scale就像搭积木从基础的存储池开始一步步添加数据集、共享、应用、快照保护。整个过程里最深的体会就是“规划先行”和“耐心排错”。硬件选型、网络规划、权限设置这些前期工作做得越细后期就越省心。遇到问题别慌Web界面提供的日志和状态信息非常详细社区论坛和官方文档也是宝藏。这台机器稳定运行后它就不再只是一堆硬件而是你数字生活的可靠基石那种随时能访问自己的数据、服务永远在线的感觉是云服务给不了的踏实感。