概述
ClearVault 是一款基于 WebDAV 协议的加密云存储代理服务，专门为飞牛 OS（fnOS）提供了原生应用形态。它允许您将文件加密后，安全地存储到任意 WebDAV 兼容的云盘或 S3 服务，同时通过一个本地目录透明访问这些加密文件，就像使用普通文件夹一样简单。
本指南将引导您在飞牛 OS 上快速完成 ClearVault 的安装、配置与挂载，让您立即开始安全地存储文件。
快速开始步骤（概览）
- 安装应用：从应用商店或手动安装 ClearVault 飞牛原生应用。github仓库 飞牛fpk应用下载地址
- 准备路径：在飞牛 OS 中准备一个云盘挂载点（用于存储加密文件）和一个本地空目录（用于访问文件）。
- 配置权限：在应用设置中授权 ClearVault 访问上述两个路径。
- 初始化与挂载：通过 Web 管理界面完成系统初始化，并启动本地目录挂载。
- 开始使用：在挂载的本地目录中进行文件操作，所有文件将被自动加密并同步到云盘。
第一步：安装 ClearVault 应用
- 在飞牛 OS 的 “应用中心” 搜索 “ClearVault”或手动上传安装。
- 点击安装。您可以选择应用的安装位置，这将决定其后端配置文件和元数据的存储路径（通常在 /volX/@appdata/ClearVault.Native.App/ 目录下）。
- 安装过程中，请务必仔细阅读 安全警告：
- 主密钥：初始化时系统生成的加密密钥，是解密所有数据的唯一凭证。请务必妥善保管，一旦丢失，所有加密数据将永久无法恢复。
- 元数据：存储了文件结构、文件名和密钥信息的本地目录。同样需要备份，丢失后对应文件将无法解密。
- 设置 Web 管理面板的访问密码。此密码用于登录 ClearVault 的管理界面。
- 确认安装完成。
第二步：准备远程挂载点与本地目录
ClearVault 需要两个路径：
- 远端存储路径（用于存放加密文件）：推荐使用飞牛 OS 原生挂载的云盘路径。
- 前往 “文件管理” → “外接存储”，按照飞牛官方指引挂载您的云盘（如阿里云盘、百度网盘等）。
- 记下挂载成功的云盘路径，通常包含一串随机字符，例如 /远程挂载/阿里云盘-abcd1234/ 。
- 本地挂载路径（用于透明访问文件）：这是一个用于访问文件的本地空目录。
- 在飞牛 OS 的文件系统中，选择一个位置（例如 /我的文件/Data/clearvault ），创建一个全新的空文件夹。
第三步：配置应用文件夹访问权限
为了让 ClearVault 能够读写上述两个路径，需要在应用设置中授权。
- 打开 “应用中心”，找到已安装的 ClearVault，点击 “应用设置”。
- 找到 “允许访问以下文件夹” 设置项。
- 点击 “编辑”，分别添加在第二步中准备的 云盘路径 和 本地空目录路径，并确保权限为 “读写”。
- 点击 “确认” 保存设置。
第四步：初始化系统与挂载
- 在应用中心，点击 ClearVault 的 “打开” 按钮，启动其 Web 管理界面。
- 使用 第三步 中设置的 访问密码 登录。
- 系统初始化（首次登录会自动进入）：
- 在 “存储后端” 区域，将 “类型” 选择为 “本地路径”。
- 在 “本地目录” 下拉列表中，选择您授权的云盘路径（即远端存储路径）。注意：这里是配置加密文件存储位置，不是本地访问目录。
- 系统将生成并显示一串 主密钥（Base64格式）。请立即将其复制并保存到安全的地方（如密码管理器）。完成后点击“我已安全保存”。
- 配置本地挂载：
- 在 “FUSE 挂载” 区域，从下拉列表中选择您授权的本地空目录路径（即您准备用于访问文件的路径）。
- 点击 “挂载” 按钮。状态变为 “已挂载” 即表示成功。
第五步：开始使用
现在，您可以直接在飞牛 OS 的 “文件管理” 中，访问您挂载的本地目录（例如 /我的文件/Data/clearvault ）。
- 上传/复制文件：将任何文件或文件夹拖入此目录，ClearVault 会自动对其进行 AES-256-GCM 加密，并将密文上传到您配置的云盘路径。
- 查看/使用文件：在此目录中，您可以像操作普通文件一样打开文档、播放视频（支持快进）、查看图片。所有解密都在本地实时完成。
- 安全效果：在云盘对应的路径中，您只会看到一堆随机命名的加密文件，没有任何原始文件名、目录结构或内容信息。所有隐私信息都安全地存储在您飞牛 NAS 本地的元数据目录中。
- 元数据：原始文件夹结构及相关信息均完整保存在本地的元数据目录中
- 元数据结构：原始文件夹结构及其相关信息完整保存在本地的元数据目录中，包括目录层级、文件名称等元数据结构
重要提醒
- 备份主密钥和元数据：您的主密钥（安装时生成）和元数据目录（默认在应用数据文件夹的 metadata 子目录下）是数据安全的生命线。请务必定期备份。
- 勿强制停止应用：请通过应用中心的“停止”按钮来停止 ClearVault**，避免在命令行强行结束**进程，否则可能导致挂载目录访问异常。
- 上传时文件名显示：上传大文件时，文件可能暂时显示为随机临时名称，上传完成后会自动恢复为正常文件名，此行为为正常现象。
至此，您已完成 ClearVault 在飞牛 OS 上的全部配置，可以享受安全、便捷的端到端加密云存储体验了。
