# 家庭NAS系统

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

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

```{image} images/image_WhAhbaXsvon4yFx8QXqcrj1znjg.webp
:width: 800px
:height: 476px
```

# 开发资源汇总

## 开发配件清单

| **配件名称** | **数量** | **规格参数** |
| --- | --- | --- |
| Quectel Pi H1智能主控板 | 1块 | Quectel Pi H1智能主控板 |
| USB-C电源适配器 | 1个 | 27W USB Type-C接口充电器1.2米线长中规电源PD电源适用于树莓派5代 |
| USB-C DP显示线/Micro HDMI线 | 1根 | 规格：DP 1.4；线长：1m；接口：USB-C（公头）- USB-C（公头）  <br>规格：Micro HDMI 2.0；线长：1m；接口：HDMI-A（公头）-HDMI-D（公头） |
| 网线 | 1根 | 线长：1m；传输速率：千兆； |
| SSD固态硬盘 | 1块 | 树莓派原装固态硬盘套件含256GB高速固态硬盘和Raspberry Pi M.2 HAT+ 兼容PCIe Gen3适用于树莓派5 |
| CPU散热风扇 | 1个 | 树莓派5代官方原装散热器带导热贴 |
| 显示屏 | 1个 | 24英寸HDMI显示器 |

## 配件实物参考

```{image} images/image_QHp7bBX9DodutJxSOmZc0HPQnJc.webp
:width: 1768px
:height: 1279px
```

# 快速上手

## 开发准备

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

## 硬件连接

### **散热风扇安装**

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

```{image} images/image_ILn2bhKBYohBy0xwZQjcaNtznbn.webp
:width: 800px
:height: 489px
```

### **SSD固态硬盘安装**

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

- 安装完成后正面图：

```{image} images/image_X5SxbWQcGokpnVxnLnrcHPhXnjd.webp
:width: 1140px
:height: 473px
```

- 安装完成后背面图：

```{image} images/image_JS3ibLnR3oOEaDxGO9DcH0S5neb.webp
:width: 1153px
:height: 486px
```

- 安装完成后侧面图：

```{image} images/image_XEbobs9hSoDQldxtzBdcucDen1e.webp
:width: 1171px
:height: 366px
```

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

```{image} images/image_VbF5bDNZeonKBBxtB5AcywUFnng.webp
:width: 796px
:height: 442px
:align: center
```

### **显示连接**

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

```{image} images/image_RMl7bAsPWo2KivxizfvcncvEnvg.webp
:width: 800px
:height: 600px
```

### **输入设备连接**

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

```{image} images/image_IvzfbBKPCocWUGxYHd0cCok4nGc.webp
:width: 800px
:height: 463px
```

### **网络连接**

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

```{image} images/image_CX0DbZEBZozUFixSqnIc5VCmn7F.webp
:width: 800px
:height: 413px
```

### **跳线帽连接**

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

```{image} images/image_EZhLbf9XdoxpjsxNAQtcraW3nRe.webp
:width: 800px
:height: 512px
```

### **供电连接**

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

```{image} images/image_PIAabQxWooaiJZxCt3Yc1YQ6nkb.webp
:width: 800px
:height: 620px
```

### **连接完成参考**

```{image} images/image_TTSAbVTcIoUsl1x0WQwclAH3nUh.webp
:width: 1002px
:height: 582px
```

## 项目实现

### **更新软件源**

```bash
sudo apt-get update
```

### **安装Samba服务**

```bash
sudo apt-get install samba
```

### **创建挂载文件夹**

```bash
sudo mkdir /mnt/resource
```

### **设置挂载文件夹权限**

```bash
sudo chown -R username: /mnt/resource/
```

### **查看硬盘信息**

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

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

```{image} images/image_WlnDbXNH7oOH3exBrPycv1OWn4b.webp
:width: 608px
:height: 526px
```

- 格式化SSD硬盘

```bash
sudo mkfs.ext4 /dev/nvme0n1  #根据硬盘实际挂载位置来格式化硬盘设备
```

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

```bash
sudo blkid
```

```{image} images/image_AT6ebwRfWohfdlxeqa5c5LpVnkq.webp
:width: 1261px
:height: 355px
```

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

```bash
df -h
```

```{image} images/image_GdHFbNfjco6YWAx0TxpceNJEnJh.webp
:width: 703px
:height: 213px
```

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

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

```{image} images/image_PGyqbLVLloQETvxBHdgcEn9Enwe.webp
:width: 755px
:height: 139px
```

### **修改配置文件**

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

```bash
sudo apt install vimsudo vim /etc/fstab
```

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

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

```{image} images/image_QgCnbY5kAo0f3ZxAc9XcT1hsnNf.webp
:width: 841px
:height: 57px
```

### **挂载设备**

```bash
sudo mount /mnt/resource
df -h
```

```{image} images/image_DFAKbfMoqoB4OoxP9Uicubh0n2b.webp
:width: 684px
:height: 201px
```

### **配置Samba用户**

```bash
sudo smbpasswd -a username
```

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

### **修改Samba配置文件**

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

```bash
sudo vim /etc/samba/smb.conf
```

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

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

### **检查配置**

```bash
sudo testparm -s
```

```{image} images/image_BPT8b3gS4o27knxKDHkc5T6lnGh.webp
:width: 819px
:height: 543px
```

### **重启Samba服务**

```bash
sudo systemctl restart smbd
sudo systemctl enable smbd
```

### 添加防火墙规则

```plaintext
#添加放行端口
sudo iptables -A INPUT -p tcp -m tcp --dport 445 -j ACCEPT
sudo iptables -A INPUT -p tcp -m tcp --dport 139 -j ACCEPT
#设置客户端IP允许通过防火墙
sudo iptables -A INPUT -p icmp --icmp-type echo-request -s 192.xx.xx.xx -j ACCEPT
#保存规则
sudo sh -c 'iptables-save > /etc/iptables/rules.v4'
```

### 测试Samba服务

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

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

```{image} images/image_AZXCbw3hfokXNfx8xCAcqMrHnTb.webp
:width: 644px
:height: 66px
```

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

```bash
net view \\[NAS_IP]
```

```{image} images/image_A9AMbFhPiowk8cx5PD8cgnFOnfb.webp
:width: 701px
:height: 272px
```

## 连接NAS服务器

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

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

```bash
cd /mnt
sudo chmod 777 resource/
```

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

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

```{image} images/image_XMl5bNjnGoCapBxCzEHc3R8JnKb.webp
:width: 872px
:height: 631px
```

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

```{image} images/image_Eqm2bPidwoET2UxspxRcuBOSn8b.webp
:width: 775px
:height: 125px
```

### SCP命令

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

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

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

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

### CasaOS

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

- **更新源**

```bash
sudo apt update
```

- **安装Docker**

```bash
sudo apt install docker.io
```

- **启动Docker服务**

```bash
sudo systemctl start docker
sudo systemctl enable docker
```

- **检查Docker服务状态**

```bash
sudo systemctl status docker
```

启动成功后如下：

```{image} images/image_BH5JbmX8BoG0LVxwfZEc1UOlnGb.webp
:width: 1168px
:height: 347px
```

- **安装完整的wget**

```bash
sudo apt install wget -y
```

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

```{image} images/image_RS8FbSDrhoumK2x8QwzchOqPnfb.webp
:width: 378px
:height: 172px
```

- **安装casaos服务**

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

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

```{image} images/image_H6fGbVJ6ZoUlPQxIU8fcBSD5nBf.webp
:width: 1135px
:height: 574px
```

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

```{image} images/image_QQ5SbciEaoWLqUxBu7wcjTFInEw.webp
:width: 1047px
:height: 615px
```

```{image} images/image_LlIIbUoXEoS4ZxxFrG0cjjt2nHb.webp
:width: 1906px
:height: 928px
```

# 应用演示

<div class="video-preview">
  <video width="100%" controls preload="none">
    <source src="videos/video_Aq42bOx1xoCdL4xOFRYcT11dnlD.mp4" type="video/mp4">
    Your browser does not support the video tag.
  </video>
  <div class="video-caption">
    <strong>Home-NAS-System</strong>
  </div>
</div>


# 技术支持与贡献

如在使用过程中遇到问题，欢迎在 [移远官方论坛](<https://forumschinese.quectel.com/t/topic/11378>) 提交技术咨询，我们的技术支持团队将及时为您解答。