vault-share

端到端加密的文件分享服务,服务端用 Go,前端用 React:文件在浏览器里加密,密钥只放在链接中浏览器不会发出的那一部分,服务器只保存它读不了的密文。

  • Go
  • React
  • 端到端加密
  • Web Crypto
  • 安全测试
分享一个只能下载一次的文件:发送方拿到分享链接和删除链接,接收方下载之后,链接随即失效。

关键指标

一次分享和下载中,带有链接里的秘密值、解密密钥、文件名或明文的请求
0 / 16
开发过程、生产就绪评审和代码评审中记录的安全问题,其中 5 个高危;63 个已修复,3 个评估后接受,4 个尚未修复,最高为低危
70
在 Docker Compose 部署上通过的黑盒检查;另有 30 项浏览器检查通过
171
开启竞态检测后通过的 Go 测试,含 S3 测试;另有 113 个 Vitest 测试通过
173

对照 OWASP Top 10:2025 的自评,测试对象是测试者自己运行的实例:十个类别中九个通过,日志与告警一项只算部分通过,因为没有任何告警。 安全测试报告

问题与目标

vault-share 是一个文件分享服务,存放文件的服务器读不到文件内容。文件和文件名在上传前就在浏览器里加密,密钥只放在链接中 # 之后的部分,浏览器不会发送这一部分。链接可以设为 1 小时、1 天或 7 天后过期,允许下载 1 到 100 次,也可以阅后即焚。

规格定下的要求有:支持最大 1 GiB 的文件,分块流式加密,不一次性读进内存;可选的密码保护,服务器同样不知道密码;可选的账号,能列出自己分享过的文件,服务器仍然读不到它们;另外要做威胁建模,对照 OWASP Top 10 自评,并写成测试报告。

加密和解密都按 64 KiB 的记录流式进行,内存占用恒定;但上传时密文作为一个 Blob 发出,浏览器可能把它留在内存里,所以接近 1 GiB 的文件在内存小的设备上会比较吃力。下载时,Chromium 系浏览器把解密后的文件直接写入磁盘,其他浏览器先把它放在浏览器存储里,下载完成后再保存。服务器一旦被攻破,仍可以下发窃取密钥的 JavaScript,大多数网页端加密工具都有这个弱点;服务器也能看到每个文件的大小、上传和下载的时间,还能判断它有没有设密码。存放文件名的元数据补齐到整 KiB,所以只有名字超过约 900 字节时才看得出长度。监控和备份由运维者负责:健康检查覆盖数据库、存储和剩余磁盘空间,不检查数据库完整性,也没有告警和自动备份。

架构

发送方浏览器加密文件和文件名,把密文连同由链接里的秘密值派生出的认证密钥一起上传,拿回文件 ID 和删除令牌。发送方把分享链接 /f/id#secret 交给接收方,浏览器不会发送 # 之后的部分。服务器上,Caddy 负责 TLS,把所有请求转发给 vaultd;vaultd 是基于 chi 的 Go 服务,把加密的文件名、令牌哈希和认证密钥存在 SQLite 里,密文存在本地磁盘或 S3 存储桶中。接收方浏览器从链接派生出同样的密钥,用认证密钥签名服务器给出的挑战值;vaultd 校验签名、扣减一次下载次数并发放一次性令牌,浏览器随后取回密文并解密,Chromium 系浏览器直接写入磁盘。

关键决策

  • D012 沿用公开的记录格式

    文件按 RFC 8188 的记录格式加密,也就是 Firefox Send 用过的 aes128gcm 内容编码,只是密钥为 256 位:每条记录 64 KiB,各自用 AES-256-GCM 加密,最后一条带结束标记,文件被改动、调换顺序或截断都会解密失败。沿用这种布局,RFC 第 3.1 节的测试向量(128 位密钥)可以原样跑通。和 Firefox Send 不同的地方都更严格:头部的记录大小不对或带了密钥 ID 都直接拒绝,空文件也照样以一条结束记录收尾。

  • D014 发放令牌时就扣下载次数

    服务器接受签名、发放一次性令牌时扣减下载次数,带条件的 UPDATE 和令牌写入在同一个事务里完成;令牌 5 分钟内有效,只能用一次。Firefox Send 在下载流结束时才计数,也不保证原子性,并发请求可以超出次数上限,中途放弃的下载也不扣次数。相应的代价是,被网络打断的下载同样会用掉一次。挑战值不在服务器上保存状态,是 32 字节的数据,带有用启动时生成的密钥算出的 HMAC 标签,所以大量元数据请求也挤不掉别人待用的挑战值。

  • D019 密码包装链接里的秘密值

    设了密码时,链接里放的是包装过的 16 字节秘密值:Argon2id 以 64 MiB 内存、2 轮从密码派生出一把密钥,再用它以 AES-256-GCM 加密这个秘密值。服务器端没有任何改动,也看不到密码,但能判断文件有没有密码:下载页要等输入正确的密码后才请求元数据,账号里保存的文件记录有密码时是 206 字节,没有时是 148 字节。Firefox Send 只是用 100 轮 PBKDF2 换掉了服务端的验证密钥,链接里仍然带着文件密钥。拿到链接的人仍能离线猜密码,每猜一次付出一次 Argon2id 的代价,所以密码至少要 8 个字符(F21)。

  • D026 服务器打不开的账号密钥

    账号密码不出浏览器。Argon2id 把它变成主密钥,再由 HKDF 派生出登录时发送的认证值和一把包装密钥:认证值到了服务器会再用 Argon2id 哈希一次才保存,包装密钥用来加密随机生成的 256 位账号密钥。登录后分享的每个文件都有一条用账号密钥加密、绑定文件 ID 的记录,里面是秘密值、链接密钥和删除令牌,所以服务器能列出这些文件,文件名却只有浏览器能解开。这种拆分参照了 Bitwarden。忘了密码就会失去账号,已经分享出去的链接仍然有效。

  • D024 不提供公开演示站点

    项目不运行公开实例,用录制的演示和一条启动完整服务的命令代替。匿名的端到端加密文件托管会招来恶意软件和钓鱼,运营者看不到内容,只能靠删除链接应对;Firefox Send 在 2020 年就是因此关停的。公开实例还要直面威胁模型里的剩余风险:来自大量地址的请求可以占满存储配额、耗尽 CPU,而前面没有任何上游防护。

决策记录

难点与解法

  • 五个高危问题有四个出在上传流程

    五个高危问题中有四个和上传有关(F1、F2、F3、F26);第五个来自之后的生产就绪评审:在已有存储上新建数据库,清理会把所有已存文件删掉(F47)。服务器 60 秒的写超时会在回复送达客户端之前切断较长的上传(F3),客户端于是重试;用同一个所有者令牌发起的第二次上传可能覆盖已经存好的文件,请求体出错时还会把它删掉(F2)。现在已存储的内容不会被替换,每次传输按文件大小设定时限,一个文件同一时间只接受一次上传。有这条规则之前,在 S3 上向同一个文件并发上传 40 次,服务器内存从 18 MiB 涨到 341 MiB;S3 上传改为流式、不再缓冲之后,向 10 个文件各上传一次,内存只从 19 MiB 升到 20 MiB(F26)。

  • 先检查、后计数的限额

    锁定机制原先在检查之前询问、检查之后才记账,同时到达的尝试会全部放行。测试中,在一张登录票据上同时提交 40 个错误的二次验证码,有 7 到 20 个被检查,而票据只允许 5 次;同时发出 20 个错误的下载签名,有 11 到 14 个被检查,而 5 次就该锁定该客户端(F38、F39)。现在票据在核对剩余次数的同一条语句里扣掉一次尝试,锁定机制也先登记尝试再检查,已记录的失败加上进行中的尝试可能达到上限时就直接拒绝;修复后验证码最多检查 5 个,签名正好 5 个。这次修复起初把只因有其他尝试在进行而被拒的请求答复成 15 分钟锁定,现在这类请求收到的是 503 busy 和 Retry-After: 5(F42)。之后的代码评审发现,二次验证按账号整体锁定,知道密码的人就能让账号主人既登录不了,也改不了任何设置。现在它按客户端、按已知浏览器、按其余所有浏览器合计分别计数,登录后确认的修改只计入那一次登录(F56)。

  • 验证密钥只留在浏览器里

    一项浏览器检查会记录 Chromium 在上传、下载和重新打开一个普通分享时发出的每个请求,连同请求体一起,搜索其中有没有链接片段、秘密值、文件密钥、元数据密钥、文件名和一段明文,形式包括原文、十六进制、各种对齐位置的 base64、百分号编码和表单编码。16 个请求里一样都没有出现;认证密钥按设计在创建请求里出现一次。评估还发现,规格声称服务器只保存这把密钥的验证值,实际保存的是密钥本身,Firefox Send 也是这样,因此拿到数据库副本的人可以消耗下载次数,但解不开文件。文档现在已如实写明(F20)。