鸿蒙个人云相册实战:OBS Header 签名与逐文件备份
手机里的照片越积越多,只存在本地既怕丢,也难跨设备查看。本文以一个鸿蒙个人云相册实践为例,讲清楚照片如何从手机相册备份到华为云 OBS,并在云端回看:核心是三件事——Header 签名认证、逐文件备份去重、认证预览与缓存。
一、整体架构:没有自建服务器
这套方案不设业务后台,端侧 App 直接调用 OBS REST API:
- 端侧:ArkTS + ArkUI,用 photoAccessHelper 读取用户授权的相册媒体;
- 云侧:华为云 OBS 提供对象存储,桶设为私有;
- 传输:PUT 上传、GET 下载、List 列举对象,全部走 HTTP 并用签名认证。
省掉中间服务意味着认证逻辑必须放在端侧做对:签名错一个字节,OBS 就会返回 403。
二、OBS Header 签名:HMAC-SHA1 认证
OBS 的 Header 认证不依赖 SDK,关键是按规范构造待签字符串,再用 SK 做 HMAC-SHA1 并 Base64 编码,放到 Authorization 头里:
Authorization: OBS <Access Key ID>:<Signature>
Signature = Base64(HMAC-SHA1(SK, StringToSign))
StringToSign 由请求方法、Content-MD5、Content-Type、Date 和规范化资源按行拼接:
StringToSign = HTTP-Verb + "\n"
+ Content-MD5 + "\n"
+ Content-Type + "\n"
+ Date + "\n"
+ CanonicalizedResource
CanonicalizedResource 是 "/桶名/对象键"。如果请求携带了 x-obs- 开头的自定义头,这些头也要按字典序拼进待签字符串,漏掉任何一个都会导致签名不匹配。
ArkTS 里的签名步骤可以写成这样(示意代码,凭据用占位符):
// 1. 构造待签字符串
const stringToSign = `${method}\n${contentMd5}\n${contentType}\n${date}\n/${bucket}/${objectKey}`;
// 2. 用 SK 做 HMAC-SHA1,再 Base64 编码
const signature = await hmacSha1Base64(sk, stringToSign);
// 3. 拼出认证头,随请求一起发出
const authorization = `OBS ${ak}:${signature}`;
排障经验:签名 403 时先核对四件事——设备时间是否准确、Endpoint 是否对应桶所在区域、对象键的 URL 编码是否多编或漏编、Date 头与待签字符串里的日期是否一致。
三、逐文件备份与去重:MD5 + ETag
云相册的备份要做到“重复不传、中断可续、取消可重传”,关键在对象键和本地记录的设计。
对象键由本地 URI、文件大小、修改时间与 MD5 共同生成,统一放在 photo_backup/v2/ 前缀下。上传前先查本地备份记录:记录按 Endpoint 和桶隔离,同一目标下拿本地 MD5 与云端 ETag 比对,一致就跳过,不再上传。
状态机很简单,也很实用:
- 待备份:本地图库中尚未有成功记录的文件;
- 上传中:逐文件显示进度,取消后当前文件需要整文件重新上传(当前不支持字节级断点续传);
- 已完成:MD5 与 ETag 一致的记录,重复备份直接跳过;
- 失败:保留失败状态,可再次发起。
要注意:清除应用数据会丢掉本地记录,备份会把已传文件当作新文件重新比对;备份也不支持后台定时任务,需要用户主动发起。
四、云端列表、缩略图与认证预览
备份只是第一步,能在云端翻出来看才有意义。列表用 OBS 的 List 接口分页拉取对象,详情页展示对象名、大小与最后修改时间。照片和视频以缩略图网格展示,点开后用带签名的认证 GET 拉取原对象预览。
为防止缓存把手机撑爆,要设硬上限:单个预览文件不超过 64 MiB,磁盘缓存上限 128 MiB,缩略图最多保留 64 张。超出时按策略清理,而不是无限增长。
还有一个容易踩的坑:列表里的 lastModified 是 OBS 对象的上传/备份时间,不是照片的 EXIF 拍摄时间。按时间分组时,文案要写成“备份时间”,不能写成“拍摄时间”。
五、安全:AK/SK 的正确姿势
设置页的 AK、SK 输入框虽然是密码态显示,但凭据仍以明文保存在应用沙箱的 preferences 中,仅用于教学调试,不能当作生产方案。正确做法是:
- 用专用的 IAM 用户,只开“编程访问”,并把权限收敛到一个测试桶:
obs:bucket:ListBucket、obs:object:PutObject、obs:object:GetObject; - AK/SK 只填在 App 设置里,不放进代码、日志、截图或公开问题中;
- 测试结束及时撤销或轮换密钥,删除测试对象和不再需要的桶。
生产应用应当使用临时授权方案,而不是把长期密钥写进客户端。
六、费用与配额提醒
OBS 按存储、请求和流量计费,公网下载流量、读写请求以及超出资源包额度或有效期的用量仍可能产生费用。资源包只抵扣符合地域、存储类别和冗余策略的存储费,桶的区域与资源包区域不一致时无法抵扣。开始前,先在控制台确认桶的区域、冗余策略与资源包是否匹配,再开始大批量备份。
小结
一个能用的鸿蒙云相册,技术上并不依赖多么复杂的后端:签名做对了,认证就通了;对象键和 MD5 设计好了,去重就稳了;缓存上限设好了,手机就不会被预览文件撑爆。把这三点做扎实,再补上最小权限凭据和费用核对,就是一个完整、可落地的端云一体小项目。
- 点赞
- 收藏
- 关注作者
评论(0)