NAS 设置（控制面板）模块产品需求文档

文档信息

项目	内容
文档名称	NAS 设置（控制面板）模块产品需求文档
版本号	v1.0
创建日期	2026-02-10
文档状态	初稿
产品负责人	[待填写]
技术负责人	[待填写]

1. 文档概述

1.1 文档目的

本文档旨在详细描述 NAS（网络附加存储）设备中设置（控制面板）模块的产品需求，为产品设计、开发、测试及后续迭代提供明确的功能定义和实现指导。

1.2 适用范围

本文档适用于 NAS 系统设置模块的全部功能点，涵盖设备信息查看、用户权限管理、系统配置、存储管理、网络设置、硬件控制及数据迁移等核心能力。

1.3 术语定义

术语	定义
NAS	Network Attached Storage，网络附加存储
RAID	Redundant Array of Independent Disks，独立磁盘冗余阵列
SMART	Self-Monitoring, Analysis and Reporting Technology，自我监测、分析及报告技术
UPS	Uninterruptible Power Supply，不间断电源
WOL	Wake On LAN，网络唤醒
DLNA	Digital Living Network Alliance，数字生活网络联盟
Samba	一种实现 SMB 协议的免费软件，用于文件共享
SSH	Secure Shell，安全外壳协议
OCUlink	一种高速数据传输接口

2. 产品背景与目标

2.1 产品背景

NAS 设备作为个人及小型企业的核心数据存储中心，需要提供一个集中化的管理入口，使用户能够方便地配置系统、管理存储、控制权限及监控硬件状态。设置（控制面板）模块是用户与 NAS 系统交互的核心界面。

2.2 产品目标

易用性：提供直观的界面，降低用户配置门槛
完整性：覆盖 NAS 管理的全部核心功能
安全性：确保用户数据和系统配置的安全
可扩展性：支持未来功能扩展和硬件升级

2.3 成功指标

用户能够在 5 分钟内完成基础系统配置
存储管理操作成功率 ≥ 99%
用户权限配置错误率 ≤ 1%
系统设置页面加载时间 ≤ 2 秒

3. 用户画像

3.1 主要用户类型

3.1.1 家庭用户（初级）

特征：对技术了解有限，主要使用 NAS 进行照片备份和媒体播放
需求：简单直观的设置流程，清晰的引导提示
使用场景：初次设置、添加家庭成员账户、查看存储空间

3.1.2 技术爱好者（中级）

特征：具备一定的技术背景，喜欢自定义配置
需求：丰富的配置选项，高级功能支持
使用场景：RAID 配置、网络高级设置、SSH 访问

3.1.3 小型企业管理员（高级）

特征：负责企业数据管理，重视安全性和稳定性
需求：精细的权限控制、完善的日志审计、备份策略
使用场景：多用户管理、存储池规划、UPS 配置

4. 功能架构

mindmap
  root((设置控制面板))
    关于本机
      设备信息
      系统信息
      远程访问ID
      硬件信息
      外部接口连接状况
      网络信息
    用户管理
      新增用户
      修改用户
      删除用户
    通用设置
      语言
      时区
      时间格式
      桌面背景
      系统重置
      高级设置
    存储管理
      盘位状态
      存储池管理
      存储池新增
    网络设置
      连接
    硬件控制
      电源
      UPS
      蜂鸣器控制
      风扇控制
      灯光控制
      一键拷贝
    数据迁移

5. 功能模块详细说明

5.1 关于本机

5.1.1 功能概述

提供设备基本信息、系统状态、硬件配置及网络连接的集中展示，帮助用户全面了解 NAS 设备的运行状况。

5.1.2 设备信息

功能项	需求描述	优先级
设备名	显示当前设备名称，支持在线修改	P0
SN（序列号）	显示设备序列号，支持显示/隐藏切换，支持一键复制	P0
运行时间	显示系统累计运行时长，格式：x天x小时x分x秒	P1

交互细节：

设备名修改流程：

sequenceDiagram
    participant U as 用户
    participant UI as 界面
    participant API as 后端API

    U->>UI: 点击编辑图标
    UI->>U: 弹出输入框（显示当前名称）
    U->>UI: 输入新设备名
    U->>UI: 点击确认保存
    UI->>UI: 前端校验（2-30字符）
    alt 校验通过
        UI->>API: 发送修改请求
        API->>API: 检查名称唯一性
        alt 名称可用
            API->>UI: 返回成功
            UI->>U: 显示成功提示，更新显示
        else 名称已存在
            API->>UI: 返回错误
            UI->>U: 显示错误提示
        end
    else 校验失败
        UI->>U: 显示格式错误提示
    end

SN 显示/隐藏：默认隐藏，点击眼睛图标切换显示状态
SN 复制：点击复制按钮，复制成功后显示 Toast 提示

5.1.3 系统信息

功能项	需求描述	优先级
当前版本	显示系统固件版本号	P0
系统时间	显示当前系统时间，支持同步设置	P0
检查更新	提供系统更新检查入口，引导至更新流程	P1

5.1.4 远程访问 ID

功能项	需求描述	优先级
ID 显示	显示远程访问唯一标识	P0
ID 修改	支持用户自定义远程访问 ID	P1
显示/隐藏	支持隐私保护切换	P1
复制功能	支持一键复制到剪贴板	P1

5.1.5 硬件信息

CPU 信息：

字段	说明
型号	显示 CPU 具体型号
核心&线程数	显示物理核心数和逻辑线程数
当前温度	实时显示 CPU 温度，超过阈值时告警

内存信息：

字段	说明
型号	显示内存条型号
数量&容量	显示内存条数量和单条/总容量
类型	显示内存类型（如 DDR4/DDR5）
频率	显示内存运行频率

GPU 信息：

字段	说明
GPU 型号	显示 GPU 具体型号（如设备配备）

5.1.6 外部接口连接状况

接口类型	显示内容	状态标识
网口	连接状态、连接速率	已连接/未连接
USB-A 口	设备连接状态、设备类型	已连接/未连接
雷电口	连接状态、设备信息	已连接/未连接
HDMI 口	连接状态、输出分辨率	已连接/未连接
OCUlink	连接状态	已连接/未连接

5.1.7 网络信息

功能项	子项	说明
网口名	-	显示网口标识（如 eth0、eth1）
网口启用情况	-	显示网口是否启用
网卡型号	-	显示网卡硬件型号
IPV4	地址	IP 地址
	连通情况	网络连通状态检测
	地址获取方式	DHCP / 静态 IP
IPV6	地址	IPv6 地址
	连通情况	网络连通状态检测
	地址获取方式	DHCP / 静态 IP
网络配置	带宽	当前连接速率
	传输模式	全双工 / 半双工
	MTU 值	最大传输单元

5.2 用户管理

5.2.1 功能概述

提供系统用户的创建、修改、删除及权限管理功能，支持管理员账户和子账户的差异化管理。

5.2.2 新增用户

步骤	功能项	需求描述	校验规则
1	用户名	设置用户登录名	2-20 字符，支持字母/数字/下划线，不可重复
2	密码	设置登录密码	8-32 字符，需包含大小写字母和数字
3	可访问文件夹	设置用户可访问的目录范围	多选，支持文件夹树形选择
4	读写权限	设置文件夹访问权限	只读 / 读写

流程图：

flowchart LR
    A[点击新增用户] --> B[填写用户名/密码]
    B --> C[选择可访问文件夹]
    C --> D[设置读写权限]
    D --> E[确认创建]
    E --> F{校验通过?}
    F -->|是| G[创建成功]
    F -->|否| H[显示错误提示]
    H --> B

#### 5.2.3 修改用户

**用户修改流程：**

```mermaid
flowchart TD
    A[选择用户] --> B{用户类型}
    B -->|管理员| C[修改管理员信息]
    B -->|子账户| D[修改子账户信息]

    C --> C1[修改密码]
    C --> C2[修改头像]
    C1 --> C3[验证原密码]
    C3 --> C4{验证通过?}
    C4 -->|是| C5[设置新密码]
    C4 -->|否| C6[提示密码错误]
    C6 --> C1

    D --> D1[修改可访问文件夹]
    D --> D2[修改读写权限]
    D --> D3[重置密码]
    D3 --> D4[管理员直接设置新密码]

    C5 --> E[保存修改]
    C2 --> E
    D1 --> E
    D2 --> E
    D4 --> E
    E --> F[更新成功提示]

管理员账户：

功能项	需求描述
修改密码	支持修改当前管理员密码，需验证原密码
修改头像	支持上传自定义头像图片

子账户：

功能项	需求描述
修改可访问文件范围	重新分配文件夹访问权限
修改密码	管理员可直接重置子账户密码

5.2.4 删除用户

功能项	需求描述
删除子账户	删除子账户及其配置，可选择是否保留用户数据
安全确认	删除前需二次确认，防止误操作

5.3 通用设置

5.3.1 功能概述

提供系统级的基础配置选项，包括语言、时区、时间格式、桌面外观及系统重置等功能。

5.3.2 语言设置

语言选项	优先级
简体中文	P0
繁体中文	P1
英语（UK）	P1
英语（US）	P1
法语（FR）	P2
意大利语（IT）	P2
西班牙语（ES）	P2

5.3.3 时区设置

提供全球时区列表
支持自动检测当前时区
支持夏令时自动调整

5.3.4 时间格式

格式选项	示例
24 小时制	14:30
12 小时制	02:30 PM
日期格式	YYYY-MM-DD / DD/MM/YYYY / MM/DD/YYYY

5.3.5 桌面背景

提供预设壁纸库
支持自定义上传图片
支持纯色背景设置

5.3.6 系统重置

重置类型	说明	风险提示
恢复出厂设置	清除所有用户数据，恢复初始状态	需多次确认，明确告知数据丢失风险
重置网络设置	恢复网络配置为默认值	可能导致远程连接中断

5.3.7 高级设置

功能项	需求描述	优先级
加入 Beta 测试	允许用户参与系统 Beta 版本测试	P2
SSH	启用/禁用 SSH 远程访问	P1
网页终端	在 Web 界面提供终端访问	P2
HTTPS	启用/配置 HTTPS 安全访问	P1
DLNA 设置	配置 DLNA 媒体服务参数	P2
Samba 服务设置	配置 SMB 文件共享参数	P1
搜索索引	管理文件搜索索引的构建和更新	P2

5.4 存储管理

5.4.1 功能概述

提供硬盘状态监控、存储池管理及 RAID 配置等核心存储功能，确保数据安全性和存储效率。

5.4.2 盘位状态

SATA 盘位信息：

字段	说明
硬盘品牌型号	显示硬盘制造商和型号
硬盘容量	显示硬盘总容量
硬盘健康状态	显示健康/警告/错误状态
SMART 信息	详细的 SMART 监测数据
文件系统格式	ext4/Btrfs/NTFS 等
归属的存储池	显示所属存储池名称
通电时长	硬盘累计通电时间
硬盘温度	实时温度监测

SSD 固态盘位信息：

字段与 SATA 盘位相同，针对 SSD 特性增加：

写入寿命百分比
剩余寿命预估

5.4.3 存储池管理

存储池信息展示：

字段	说明
存储池名称	支持自定义修改
存储池大小	可用/已用/总容量
当前存储池模式	Basic/JBOD/RAID0/RAID1/RAID5/RAID6

存储池操作：

操作	需求描述	风险提示
扩展 RAID	接入新硬盘后扩展存储池容量或冗余度	根据当前 RAID 模式和新硬盘数量判定可扩展模式
格式化存储池	清空存储池数据，保留 RAID 配置	数据将全部丢失
删除存储池	删除存储池并解除 RAID，释放硬盘	数据将全部丢失，硬盘恢复独立状态

存储池删除流程：

flowchart TD
    A[点击删除存储池] --> B[显示风险提示弹窗]
    B --> C{用户确认?}
    C -->|取消| D[取消操作]
    C -->|确认| E[要求输入确认密码]
    E --> F{密码正确?}
    F -->|否| G[密码错误提示]
    G --> E
    F -->|是| H[检查存储池状态]
    H --> I{是否有正在进行的任务?}
    I -->|是| J[提示等待任务完成]
    I -->|否| K[执行删除操作]
    K --> L[解除RAID关系]
    L --> M[释放硬盘]
    M --> N[删除完成提示]

    style B fill:#fff3cd
    style K fill:#f8d7da

5.4.4 存储池新增

组合使用（RAID）：

RAID 模式	最少硬盘数	容错能力	可用容量
RAID 0	2	无	100%
RAID 1	2	1 块	50%
RAID 5	3	1 块	(N-1)/N
RAID 6	4	2 块	(N-2)/N
JBOD	2	无	100%

单个使用（Basic）：

选择单块硬盘作为独立存储空间
无冗余保护

创建流程：

flowchart TD
    A[开始创建存储池] --> B{选择模式}
    B -->|组合使用| C[选择RAID模式]
    B -->|单个使用| D[选择单块硬盘]
    C --> E[选择硬盘]
    D --> F[确认配置]
    E --> F
    F --> G{配置确认?}
    G -->|取消| B
    G -->|确认| H[初始化存储池]
    H --> I{初始化成功?}
    I -->|是| J[创建完成]
    I -->|否| K[显示错误信息]
    K --> F
    J --> L[结束]

    style A fill:#e1f5ff
    style J fill:#d4edda
    style K fill:#f8d7da

5.5 网络设置

5.5.1 功能概述

提供网络连接配置功能，支持有线网络参数设置。

5.5.2 连接设置

功能项	需求描述
网络模式	DHCP 自动获取 / 静态 IP
IP 地址	手动设置 IP 地址（静态模式下）
子网掩码	设置子网掩码
网关	设置默认网关
DNS 服务器	主/备 DNS 服务器设置
MAC 地址	显示/克隆 MAC 地址

5.6 硬件控制

5.6.1 功能概述

提供对 NAS 硬件组件的精细控制，包括电源管理、UPS 配置、蜂鸣器、风扇、灯光及一键拷贝功能。

5.6.2 电源管理

功能项	需求描述	优先级
通电自动开机	断电恢复后自动启动系统	P1
自动开关机计划	设置定时开关机时间表	P2
远程唤醒（WOL）	支持网络唤醒功能	P2

5.6.3 UPS 配置

功能项	需求描述
UPS 信息	显示连接的 UPS 设备信息
断电自动关机时间	断电后延迟多久自动关机
电量阈值关机	UPS 电量低于设定值时自动关机

5.6.4 蜂鸣器控制

功能项	需求描述
当前状态	显示蜂鸣器启用/禁用状态
关闭蜂鸣器	手动关闭蜂鸣器提示音

5.6.5 风扇控制

模式	说明
静音	降低风扇转速，减少噪音
普通	平衡散热与噪音
全速	最大转速，优先散热
高级（V2）	用户自定义风扇曲线

5.6.6 灯光控制

状态指示灯：

硬盘状态灯
电源状态灯
网络状态灯

氛围灯：

预设模式	说明
数据海洋	蓝色系呼吸效果
绚丽霓虹	多彩渐变效果
自定义	手动设置颜色和亮度

5.6.7 一键拷贝

功能项	需求描述
功能开关	启用/禁用一键拷贝功能
拷贝目的地	设置外接设备数据拷贝的目标文件夹

5.7 数据迁移

5.7.1 功能概述

提供数据迁移功能，支持从其他设备或云存储迁移数据到本 NAS。

5.7.2 需求说明

待补充具体需求：

支持的迁移源类型
迁移数据类型
迁移流程设计
断点续传支持

数据迁移流程（预留）：

flowchart TD
    A[开始数据迁移] --> B[选择迁移源类型]
    B --> C1[本地设备]
    B --> C2[远程NAS]
    B --> C3[云存储]

    C1 --> D[选择源设备]
    C2 --> D
    C3 --> D

    D --> E[验证源访问权限]
    E --> F{验证通过?}
    F -->|否| G[显示连接错误]
    G --> D
    F -->|是| H[选择要迁移的数据]
    H --> I[选择目标位置]
    I --> J[确认迁移设置]
    J --> K{开始迁移?}
    K -->|否| L[取消迁移]
    K -->|是| M[执行数据迁移]
    M --> N{迁移完成?}
    N -->|是| O[迁移成功]
    N -->|否| P{是否支持断点续传?}
    P -->|是| Q[保存迁移进度]
    P -->|否| R[迁移失败提示]

    style O fill:#d4edda
    style R fill:#f8d7da

6. 非功能性需求

6.1 性能需求

指标	要求
页面加载时间	≤ 2 秒
设置保存响应时间	≤ 1 秒
存储池操作响应	≤ 3 秒
并发用户支持	≥ 10 个同时在线管理

6.2 安全需求

类别	要求
身份认证	所有管理操作需验证用户身份
权限控制	基于角色的权限管理（RBAC）
操作审计	记录关键操作日志
数据加密	敏感配置加密存储
会话管理	自动超时退出机制

权限控制模型：

flowchart TB
    subgraph 角色定义
        A[管理员] --- B[子账户]
    end

    subgraph 权限范围
        C[系统设置] --- D[用户管理]
        E[存储管理] --- F[文件访问]
    end

    subgraph 操作类型
        G[查看] --- H[创建]
        I[修改] --- J[删除]
    end

    A -->|拥有全部权限| C
    A -->|拥有全部权限| D
    A -->|拥有全部权限| E
    B -->|无权限| C
    B -->|受限权限| D
    B -->|受限权限| E
    B -->|授权范围| F

    C --> G
    C --> H
    C --> I
    C --> J

6.3 可靠性需求

指标	要求
系统可用性	≥ 99.9%
数据一致性	配置变更原子性保证
故障恢复	支持配置备份与恢复

6.4 兼容性需求

类别	要求
浏览器支持	Chrome、Firefox、Safari、Edge 最新 2 个版本
移动端适配	支持平板设备访问
多语言	支持文档定义的 7 种语言

7. 界面与交互设计

7.1 布局结构

flowchart TB
    subgraph 顶部导航栏
        A[Logo] --- B[搜索框] --- C[用户头像/菜单]
    end

    subgraph 主体区域
        subgraph 左侧菜单栏
            D[关于本机]
            E[用户管理]
            F[通用设置]
            G[存储管理]
            H[网络设置]
            I[硬件控制]
            J[数据迁移]
        end

        subgraph 主内容区域
            K[功能模块内容展示]
        end
    end

    顶部导航栏 --- 主体区域

    style 顶部导航栏 fill:#f5f5f5
    style 左侧菜单栏 fill:#fafafa
    style 主内容区域 fill:#ffffff

7.2 交互原则

一致性：相同类型的操作使用统一的交互模式
反馈：操作后提供明确的视觉或文字反馈
容错：危险操作提供二次确认，支持撤销
效率：常用功能提供快捷入口

7.3 错误处理

场景	处理方式
网络异常	显示重试按钮，保留用户输入
权限不足	明确提示所需权限，引导申请
操作失败	显示具体错误原因和解决建议
数据冲突	提供冲突解决选项

错误处理流程：

flowchart TD
    A[用户操作] --> B{操作类型}

    B -->|读取操作| C[加载数据]
    B -->|写入操作| D[提交数据]

    C --> E{网络正常?}
    E -->|否| F[显示网络错误]
    F --> G[显示重试按钮]
    G --> C
    E -->|是| H{权限足够?}
    H -->|否| I[显示权限不足提示]
    I --> J[引导申请权限]
    H -->|是| K[显示数据]

    D --> L{校验通过?}
    L -->|否| M[显示校验错误]
    M --> N[保留用户输入]
    L -->|是| O{提交成功?}
    O -->|否| P[显示错误原因]
    P --> Q[提供解决建议]
    O -->|是| R[显示成功提示]

    style F fill:#fff3cd
    style I fill:#fff3cd
    style M fill:#fff3cd
    style P fill:#f8d7da
    style R fill:#d4edda

8. 附录

8.1 待确认事项

序号	事项	负责人	状态
1	数据迁移模块详细需求	[待分配]	待补充
2	网络设置 - 连接子项详细需求	[待分配]	待补充
3	RAID 扩展规则详细定义	[待分配]	待确认
4	氛围灯预设模式完整列表	[待分配]	待补充

8.2 参考文档

功能框架文档

8.3 修订记录

版本	日期	修订内容	修订人
v1.0	2026-02-10	初始版本创建	Claude
v1.1	2026-02-10	优化流程图为标准 Mermaid 语法	Claude

文档结束

目录