← 返回文章列表

FlareDrive 这几轮修了什么:分享、权限与预览.

muse太棒了!

本文目录

muse太棒了!

FlareDrive:自托管云盘与分享链接

FlareDrive 是我自托管在 Cloudflare Pages + R2 上的个人网盘。11 月 18–19 日这两天,围绕「分享」和「权限」连着做了几轮修补:从一次权限审计出发,修了两个真实漏洞,顺带把分享页时区、预览层级、访客目录分享这些小毛病一并理顺了。这篇记录一下每轮改了什么、为什么改,以及几个踩过的坑。

一、审计先行:只读账号能绕过分享限制

一切的起点是一次权限审计:把每个接口按匿名访客、普通账号、只读账号、管理员逐个过一遍,看服务端到底拦住了谁。

查出两个真问题:

  • 只读账号能签链接。 /api/sign 只检查了「登录」和「读权限」,没检查「只读」。一个只读账号可以给任意能读的文件签一个最长 30 天的 HMAC 链接,而这种链接没有记录、无法撤销——只能等它过期,或者轮换签名密钥。这就绕过了之前给分享接口加的只读拦截。
  • 访客目录默认可写。 写权限的判断里有个兜底:只要是已登录的可写用户,访客目录默认就能写。一个只被授权了自己目录的账号,也能往公开目录里上传、覆盖、删除。

修法都很直接:签链接接口补上只读检查;写权限判断删掉访客目录兜底,写权限只来自账号自己的权限列表。部署前要先确认:需要写公开目录的账号,必须在权限列表里显式配上那个目录,否则自己把自己锁在外面。

审计里顺带确认了几个「没问题」的地方:离线下载(URL 存到指定目录)分得清清楚楚——匿名 401、只读 401、只有对目标目录有写权限的账号才能用,而且权限是在发起任何外部请求之前就检查的;登录限流的 KV 绑定也已确认生效。

二、分享页的时间差了 8 小时

分享链接页显示的有效期,和管理页对不上,差了整整 8 小时。

原因很单纯:分享页是在 Worker 服务端渲染的(UTC),管理页是在浏览器本地渲染的(东八区),同一个时间戳,两边各按各的时区格式化。修法:服务端渲染时把时区固定为 Asia/Shanghai,和作为基准的管理页保持一致。

三、手机上预览为什么慢,和一次被回退的重构

手机上视频预览一直转圈

手机上点开音视频预览,加载特别慢。查下来是三个原因叠加:

  1. 重复下载。 预览组件会先用 Image() 探针把媒体文件下一个遍,探针失败后真正的播放器再下一遍。
  2. 挂载被门控。 媒体元素要等「加载完成」才挂载,可加载完成这件事本身又依赖探针先失败——视频和音频的探针几乎总是立刻失败,之前全靠这个「失败」来解锁。
  3. 文件本身不友好。 公开目录里一个 18 MB 的视频,索引信息(moov)放在文件尾部,播放器得先取到文件尾才能开始播。

第一版重构(媒体立即挂载、加载圈改成遮罩、探针只对图片用)上线后,手机上的体验反而不好,当天就回退了预览部分,只保留了确认有效的时区修复。教训很实在:预览这种和浏览器解码行为强相关的改动,桌面验证通过不等于手机上行;回退本身也是修复的一部分,先把能确定对的改动留下来,错的慢慢再想。

同一台电脑上,Chrome 秒开、Safari 一直卡在加载中——同一机器、同一网络,确认是引擎差异。主嫌疑还是那个 Image() 探针:Chrome 的探针对视频很快报错,加载随即清掉;Safari 的解码器可能一直挂在那个大文件上,加载永远不清。非 faststart 的文件结构又雪上加霜。这个问题还在排队,没彻底解决。

四、分享框被预览盖住:一个 z-index 的故事

在预览里点「分享」,对话框弹出来了,但人是点不到的——因为预览浮层的 z-index 是 10001,所有对话框是 9998。对话框在预览后面变暗、拦截不到点击,只能先关预览。

修法选了「点分享时先把预览关掉」,而不是把对话框层级抬上去。层级数字越抬越乱,不如让同一时刻只存在一个浮层。

五、分享完再删文件,会发生什么

实测了三个问题:

  1. 删除前有提示吗? 有,但只是通用的「确定要删除文件吗?此操作无法撤销」,不会告诉你这个文件正被分享。
  2. 删除会自动撤销分享吗? 不会。分享记录还留在管理列表里,成了一个孤儿。
  3. 之后再打开旧链接呢? 页面显示「分享的文件已被删除」。

另外还撞见一次偶发情况:刚创建的分享链接,打开时短暂显示「不存在或已被撤销」,管理页里却明明是有效的。没能复现,疑似同步延迟,先记下来待观察。

六、访客目录不该有「分享」

访客目录分享:之前与现在

这是最后一轮,也是最有意思的一轮。访客目录本来就是公开可读的,给它建带有效期、密码、下载次数的分享记录,是在误导人:链接「过期」了,文件照样能通过公开直链访问;密码也挡不住一条公开路径。

改法:访客目录的文件点「分享」,不再建记录,直接复制公开直链;服务端 API 同样处理,哪怕直接调接口也不建记录;只读账号依然先被拦截。这条规则对所有访客目录通用,不只针对某一个目录。清查现有的访客分享时发现:普通账号名下本来就没有,什么都不用清。

顺带把权限模型彻底定下来:

  匿名访客 普通账号 只读账号 管理员
读访客目录 ✅ ✅ ✅ ✅
写访客目录 ❌ 需显式授权 ❌ 需显式授权
创建分享(非访客文件) ❌ ✅ ❌ ✅
访客文件点「分享」 — 直接给直链 ❌ 直接给直链

关键的一点是:管理员没有文件访问旁路。管理员的权限是管账号,不是管文件;它自己的权限列表里没有哪个目录,就写不了哪个目录,和普通账号完全一样。

七、几条教训

  • 游客态的验证要在全新浏览器 profile 里做。 共享的 profile 可能还留着登录态,第一次验证就因此作废过。
  • 不要从 jsdmirror 的响应算 SRI。 同一个文件在不同网络下字节可能不同,完整性校验对不上直接白屏;用 jsDelivr 的规范文件算。
  • R2 没有文件夹重命名 API。 移动、重命名 = 新建文件夹 + 逐个复制 + 删原文件夹,删之前必须逐个确认复制成功。
  • 回退不可耻。 预览重构当天就回退了,只保留确认有效的时区修复;先把对的留下,错的慢慢再想。
  • 分享记录和文件是两套东西。 删文件不删分享记录,链接失效和文件删除之间没有联动——这既是现状,也是待办。

版本时间线

版本 时间 内容
v2 11 月 18 日晚 移除二维码分享、文件夹打包下载、「新建文本文档」;游客的分享、复制置灰;音频页内预览;字体 CSS 改非阻塞加载
v3 11 月 18 日晚 搜索回退到旧版显示;加载时隐藏「没有文件」;修复预览加载死锁
v4 11 月 18 日晚 只读用户服务端禁止分享;分享只在点「复制链接」时创建
v5 11 月 19 日 00:09 修只读签链接漏洞、访客目录默认可写
v6 11 月 19 日 09:37 分享页时区固定东八区;移动端预览重构——同日回退预览部分
v7 11 月 19 日 12:54 点分享先关预览,解决层级遮挡
v8 11 月 19 日 16:04 访客目录分享改直链;清查现有访客分享

结尾

这几轮没有一个是大功能,全是「让错误的东西不再误导人」:让只读账号真的只读,让过期真的过期,让公开的东西就大大方方地公开。

下一轮待办:Safari 上预览加载慢的问题还在排队,视频的 faststart 重编码、以及删除文件时提示「该文件已被分享」,都在清单上。


本文由 Muse 协助整理,配图由 AI 生成,流程图为手绘 SVG。