qrypt 网盘加密挂载工具快速上手
Github 项目传送
本文档将带你用最小的配置在 5 分钟内跑通 qrypt ，直观感受它的工作方式。
简介
qrypt 是一个加密虚拟文件系统。它把云盘挂载到你电脑上的一个本地文件夹里，每个云盘对应这个文件夹下的一个子目录。
支持多种云盘后端，文件在传输和存储时可以进行 rclone 兼容的加密。
下载与安装
从 releases 页面 下载对应系统的压缩包：
系统 |
文件名 |
|---|
macOS (Intel) |
qrypt_版本_darwin_amd64.tar.gz |
macOS (Apple Silicon) |
qrypt_版本_darwin_arm64.tar.gz |
Linux (amd64) |
qrypt_版本_linux_amd64.tar.gz |
Linux (arm64) |
qrypt_版本_linux_arm64.tar.gz |
Windows (amd64) |
qrypt_版本_windows_amd64.zip |
Windows (arm64) |
qrypt_版本_windows_arm64.zip |
解压后得到一个名为 qrypt 的可执行文件（ Windows 上为 qrypt.exe）。
你可以把它放到 PATH 中的某个目录，也可以直接在文件所在目录下运行。
验证安装：
./qrypt --help
Windows：使用 .\qrypt.exe --help，或放入 PATH 后直接运行 qrypt --help。
编写配置文件
qrypt 需要一个配置文件来知道挂载到哪里、接入哪些云盘。
创建一个名为 qrypt.toml 的文件，写入以下内容：
mount_point = "~/Qrypt"
[[mounts]]
name = "local"
type = "localfs"
[mounts.params]
root_path = "/tmp/qrypt-data"
[mounts.encryption]
password = "my-password"
filename_encryption = "standard"
filename_encoding = "base32"
这个配置文件定义了一个云盘，指向本机的 /tmp/qrypt-data 目录，并开启了加密。
Windows：将 root_path 改为本地的一个目录，例如：
root_path = "C:\\qrypt-data"
每个配置项的含义：
mount_point —— 文件管理器里看到的挂载目录，所有云盘都会出现在这个文件夹里
[[mounts]] —— 每条 mounts 配置对应一个云盘服务，可以写多条
name —— 这个云盘在挂载点下的子目录名称
type —— 云盘类型，这里是 localfs（本地目录）
root_path —— 该云盘后端存储的实际路径
[mounts.encryption] —— 该云盘的加密配置，开启后文件名和文件内容会被加密
准备演示目录
在本地创建一个目录，用来模拟云盘后端：
系统 |
命令 |
|---|
macOS / Linux |
mkdir -p /tmp/qrypt-data |
Windows |
mkdir C:\qrypt-data |
查看文件系统
运行以下命令，qrypt 会读取配置文件并展示文件系统的顶层结构：
./qrypt fs list /
Windows：.\qrypt.exe fs list /
你应该能看到类似这样的输出：
local/
云盘已就绪，local 目录下的文件会被加密存储。
上传和读取文件
先创建一个测试文件：
系统 |
命令 |
|---|
macOS / Linux |
echo "hello qrypt" > /tmp/hello.txt |
Windows |
echo hello qrypt > C:\hello.txt |
上传到 qrypt 文件系统中：
源文件（根据上一步调整） |
命令 |
|---|
macOS / Linux |
./qrypt fs put /tmp/hello.txt /local/hello.txt |
Windows |
.\qrypt.exe fs put C:\hello.txt /local/hello.txt |
读取刚才上传的文件：
./qrypt fs cat /local/hello.txt
终端会输出：
hello qrypt
查看云盘中的文件列表：
./qrypt fs list /local
查看加密效果
现在看一下后端目录里实际存储了什么：
系统 |
命令 |
|---|
macOS / Linux |
ls /tmp/qrypt-data |
Windows |
dir C:\qrypt-data |
你可能看不到 hello.txt，而是一个类似 b4l6gr1s6t1q0tas6dl0q0mb0s62kbj0 的无意义文件名。用 cat 查看这个文件的内容：
系统 |
命令 |
|---|
macOS / Linux |
cat /tmp/qrypt-data/b4l6gr1s6t1q0tas6dl0q0mb0s62kbj0 |
Windows |
type C:\qrypt-data\b4l6gr1s6t1q0tas6dl0q0mb0s62kbj0 |
输出是一串二进制乱码。即使他人拿到了后端文件，也无法读取原始内容。
注意：你的加密文件名很可能和上面不同，因为 salt 是随机生成的。
挂载为本地文件夹
前面的操作没有挂载也能进行。如果你想通过文件管理器直接操作，可以挂载它：
./qrypt mount
macOS 用户：需要先安装 macFUSE 才能使用挂载功能。
Windows 用户：需要先安装 WinFsp 才能使用挂载功能。
挂载成功后，打开文件管理器并进入 ~/Qrypt，你会看到一个 local 文件夹。你可以像操作普通文件夹一样拖入文件、双击打开、删除文件。所有操作都会被 qrypt 处理后转发到后端目录，文件在存储时会被加密。
qrypt 的工作方式
几句话了解 qrypt 的核心概念：
- 挂载点（ mount_point ）：所有云盘汇聚到一个本地目录。每个云盘是挂载点下的一个子目录。
- 驱动（ mounts ）：每条
[[mounts]] 配置对应一个云盘服务。qrypt 内置了多种云盘驱动，这里用的 localfs 是最简单的一种。
- fs 命令：即使不挂载，也能用
fs list、fs put、fs cat、fs get 等命令直接操作文件。这在脚本和远程环境中尤其方便。
下一步
你已经体验了 qrypt 的基本流程。接下来可以：
- 换成真实云盘（支持的驱动列表）——把
type 改为 aliyundrive、quark、yun139、webdav、s3 或 baidu_netdisk，并填写对应的认证参数
- 了解其他配置项（完整配置参考）——缓存、带宽控制、日志等
- 配置开机自动挂载
