家庭NAS系统

概述

家庭NAS系统基于Quectel Pi H1智能主控板搭建，通过SSD固态硬盘提供高速存储，利用Samba服务实现文件共享，支持多种访问方式，为家庭用户提供便捷的私有化部署解决方案。

开发配件清单

配件实物参考

开发准备

Quectel Pi H1智能主控板出厂默认搭载Debian 13系统镜像，因此无需再次烧录镜像，仅需按照如下步骤操作即可。

硬件连接

散热风扇安装

先将散热风扇的排线插入智能主控板的FAN插槽中，然后将散热器上的两端固定在智能主控板预留的插孔中，如下：

SSD固态硬盘安装

首先安装3个尼龙柱，用3个短螺钉固定尼龙柱底部，然后再安装GPIO转接头，用力按压，保证所有的引脚都安装到位，接着再将PCIe转接线完全均匀地插入智能主控板的PCle端口后，从两侧向下推动PCle接口的支架，将PCIe转接线牢牢固定到位。

• 安装完成后正面图：

• 安装完成后背面图：

• 安装完成后侧面图：

• 最后将M.2 HAT+设置在尼龙柱顶部，并使用3个长螺钉，将M.2 HAT+固定到位。

显示连接

将HDMI线一端接入智能主控板的HDMI接口，另一端接入显示器的HDMI接口。

输入设备连接

将USB键盘、鼠标接入智能主控板的两个USB-A接口上，若用无线输入设备，将接收器插入USB口即可。

网络连接

将网线一端接入智能主控板的千兆网口，另一端接入路由器的网口（确保路由器已联网）。

跳线帽连接

智能主控板左上角标有AUTO_POWER_ON丝印的排针，确保已经用跳线帽短接。

供电连接

将USB-A电源线的USB-A端接入电源适配器，USB-C端接入智能主控板的电源口（通常标注POWER IN）。

连接完成参考

项目实现

更新软件源

sudo apt-get update

安装samba服务

sudo apt-get install samba

创建挂载文件夹

sudo mkdir /mnt/resource

设置挂载文件夹权限

sudo chown -R username: /mnt/resource/

查看硬盘信息

1.先查看每个分区对应的设备

awk 'NR > 2 {printf "%-10s %s\n", $4, $3 / 1024 / 1024 " GB"}' /proc/partitions

2.查看需要挂载存储设备的文件系统类型（注：Quectel Pi H1智能主控板默认用ext4挂载，如果外接存储设备的文件系统类型不符合，需要重新格式化存储设备）

sudo blkid

3.查看当前挂载情况（若/mnt/resource下已有挂载点则需要先卸载该挂载点 ）

df -h

4.查看对应分区的UUID及用户的uid和gid

ls -lha /dev/disk/by-uuid
id username

修改配置文件

这里使用256GB固态硬盘作为NAS服务器，所以选择nvme0n1作为扩展分区进行挂载，修改fstab文件。

sudo apt install vim
sudo vim /etc/fstab

按下 ESC+"i" 在文件最后添加下面语句，添加完成后按下ESC+"Shift + :"，再输入wq并回车保存退出。

#这里用ext4作为文件系统，参考上个步骤查询到的分区文件类型
#添加nofail选项，nofail选项允许在设备不存在时正常启动
UUID=上个步骤查询到的UUID /mnt/resource ext4 defaults,nofail 0 0

挂载设备

sudo mount /mnt/resource
df -h

配置samba用户

sudo smbpasswd -a username

注：输入当前的用户名及密码，注意这里的用户必须是已经存在的Linux用户。

修改samba配置文件

输入下面命令打开配置文件

sudo vim /etc/samba/smb.conf

在文件最后添加下面的语句（其中括号中的内容是对外展示的磁盘名）

[resource]
    comment = Resource
    create mask =0777
    directory mask = 0777
    path = /mnt/resource
    valid users = pi
    read only = no
    vfs objects = catia fruit streams_xattr

检查配置

sudo testparm -s

重启Samba服务

sudo systemctl restart smbd
sudo systemctl enable smbd

测试Samba服务

• 测试挂载文件夹是否有相关权限，输入下面命令，测试文件出现则证明可以对该文件夹进行相关操作了。

sudo -u username touch /mnt/resource/test_from_kane.txt

• 在Windows CMD中测试Samba共享连通性，显示自定义的resource文件夹即证明NAS服务器搭建成功。

net view \\[NAS_IP]

连接NAS服务器

Windows文件资源管理器（最简单）

• 在Quectel Pi H1智能主控板的控制台依次输入命令，给予用户最高操作权限。

cd /mnt
sudo chmod 777 resource/

• 接着在控制台输入ip address命令查询智能主控板的ip地址。

• 打开Windows文件资源管理器，在搜索栏输入"\智能主控板的ip地址"，按下回车后，可以看到两个共享文件夹。

• 在windows文件资源管理器上打开resource文件夹后，用户就可以直接在挂载文件夹下进行添加、删除、修改等操作了。

SCP命令

• 从Windows上传文件至NAS服务器。

scp "需要上传的文件路径" 智能主控板用户名@ip地址:/mnt/resource/

• 从Windows上传整个文件夹至NAS服务器。

scp -r "需要上传的文件夹路径" 智能主控板用户名@ip地址:/mnt/resource/

CasaOS

CasaOS是一个基于Docker生态系统的开源家庭存储解决方案，专为家庭用户设计，旨在提供简单、易用且优雅的私人存储服务。它允许用户通过一个友好的图形界面快速搭建和管理各种家庭娱乐和智能应用，如媒体服务器、网盘和广告拦截器等。

• 更新源

sudo apt update

• 安装Docker

sudo apt install docker.io

• 启动Docker服务

sudo systemctl start docker
sudo systemctl enable docker

• 检查Docker服务状态

sudo systemctl status docker

启动成功后如下：

• 安装完整的wget

sudo apt install wget -y

若出现下面的选项框，直接回车即可。

• 安装casaos服务

sudo apt install curl
curl -fsSL https://get.casaos.io | sudo bash

安装成功后，复制红框位置的网址至浏览器打开。

创建用户后登录进去点击Files，在Root目录下找到NAS服务器挂载的文件夹后，您就可以直接在这里进行上传、删除、修改等操作了。