用鸿蒙和对象存储打造个人云相册:从备份到预览的实践记录
一、为什么要自己做一个云相册
手机里的照片越来越多,几年下来攒了几万张。系统自带的云服务虽然方便,但空间要另外付费,导出也不自由。自己做一个云相册,目标很朴素:把照片和视频备份到自己的对象存储桶里,随时能在手机上翻到、预览到,存储和流量都看得见、算得清。这次我用 HarmonyOS 做前端应用,后端直接用华为云对象存储服务 OBS,不搭中间服务器。整个链路里最值得琢磨的其实不是界面,而是认证、上传和预览这三件事。
二、整体结构:三部分就够了
第一是端侧应用,用 ArkTS 和 ArkUI 写,负责三件事:读本地相册、把文件传上去、在云端列表里看图和视频。第二是对象存储,用来放照片和视频对象,桶设为私有访问,不公开。第三是鉴权机制。应用不直接持有长期有效的公开链接,而是每次请求都按 OBS 的规则做 Header 签名,带着签名去访问。这样即使链接被别人拿到,没有签名也打不开对象,数据相对安全。三个部分之间只通过 HTTPS 请求打交道,结构简单,出问题也好定位。
三、OBS Header 签名到底在签什么
Header 签名是这个方案里最核心也最容易出错的一环。原理不复杂:客户端用访问密钥 SK,对一段按规则拼好的字符串做 HMAC-SHA1 运算,再做 Base64 编码,生成签名;请求头里带上 Authorization,格式是 OBS 加上 AK 和签名,服务端用同样的规则算一遍,对得上才放行。拼字符串时要按顺序放请求方法、内容 MD5、内容类型、日期、规范化后的自定义请求头和规范化资源,任何一个细节对不上都会返回签名不匹配。
我在这一步吃了两次亏。第一次是设备时间不对,日期对不上导致签名失效,调了很久才发现是时间偏差。第二次是规范化资源写错了,把桶名拼进了不该拼的位置。我的经验是:先把每一步的中间值打印出来逐项核对,再对照官方的签名规范逐字段检查,不要凭感觉拼。另外,AK 和 SK 只填在应用的设置页里,不要写进代码、不要发到聊天记录和截图里,最好用专门的访问密钥并只给它操作这一个桶的最小权限,定期轮换。
四、逐文件上传:进度、取消与去重
备份的流程我设计成逐文件上传:先扫描本地相册,列出待备份的照片和视频,用户可以筛选、多选或者全部备份。上传中的文件显示进度,支持取消。每个文件先算内容的 MD5,再结合目标路径做隔离,同一个目标下内容相同的文件不再重复上传,这样重复备份同一个文件也不会产生重复对象。上传失败时要有明确的状态提示,不能静默失败。
这里有几个细节值得注意。第一,应用对单文件上传做了上限,超过上限的大视频要用分段上传,不能硬塞进普通上传流程。第二,备份记录保存在应用自己的存储里,清除应用数据会丢记录,但云端对象还在,需要从云端重新拉取列表来核对。第三,网络不稳定时重试要有上限和退避,不能无限重试把流量打爆。
五、云端浏览:列表、网格与预览
上传只是第一步,能方便地翻看才是云相册的价值。云端列表通过列举对象接口拿到对象清单,可以在列表和网格两种视图之间切换,点进详情能看到对象的基本信息,图片和视频可以通过认证的 GET 请求预览。预览时要注意两点:第一,私有桶的对象必须带着签名访问,直接拼公开地址是打不开的;第二,预览大文件会产生流量,应用做了单文件预览上限和磁盘缓存上限,缩略图数量也有上限,避免一次把流量和存储打满。
六、容易踩的坑,我整理了一份清单
第一,存储资源包和桶的区域、单多可用区策略必须匹配,否则资源包抵扣不上,会按需计费。第二,买了资源包不会自动建桶,桶要自己去创建,桶名创建后不能直接改,提交前要核对。第三,区域 Endpoint 要填桶所在区域的域名,不要带桶名和对象路径。第四,存储包只抵扣存储费用,公网下载流量和请求次数另外计费。第五,密钥只在应用设置里填写,生产环境应该考虑更合适的临时授权方案,而不是长期密钥。把这些点逐一核对过,实践过程会顺很多。
七、还能怎么扩展
基础功能跑通之后,还可以做几件有意思的事:给超过上限的大视频做分段上传,合并后可读取,失败或取消时有明确处理结果;按对象备份时间把云端照片分组成时间轴,显示时区,支持日期筛选和空态;支持通过系统文件选择器备份指定类型的文档,复用目标隔离和哈希核验;经用户确认把云端照片保存到另一台设备的系统相册。这些扩展都不需要改整体结构,都是在已有能力上加功能。
八、小结
这个云相册做下来,最大的收获是把对象存储的认证、上传、预览完整走通了一遍。技术上没有特别高深的点,关键是把每个环节的规则吃透:签名按什么顺序拼、上传失败怎么处理、预览的流量和缓存怎么控制。按这个思路,换一个存储场景,比如文档归档或者家庭视频备份,做法也是相通的。后续我打算先把分段上传和时间轴这两个扩展做出来,再回头把权限和密钥管理做得更规范一些。
- 点赞
- 收藏
- 关注作者
评论(0)