鸿蒙个人云相册实战:OBS Header 签名与逐文件备份

举报
yd_239758213 发表于 2026/11/13 03:00:55 2026/11/13
【摘要】 手机里的照片越积越多,只存在本地既怕丢,也难跨设备查看。本文以一个鸿蒙个人云相册实践为例,讲清楚照片如何从手机相册备份到华为云 OBS,并在云端回看:核心是三件事——Header 签名认证、逐文件备份去重、认证预览与缓存。 一、整体架构:没有自建服务器这套方案不设业务后台,端侧 App 直接调用 OBS REST API:端侧:ArkTS + ArkUI,用 photoAccessHelpe...

手机里的照片越积越多,只存在本地既怕丢,也难跨设备查看。本文以一个鸿蒙个人云相册实践为例,讲清楚照片如何从手机相册备份到华为云 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 设计好了,去重就稳了;缓存上限设好了,手机就不会被预览文件撑爆。把这三点做扎实,再补上最小权限凭据和费用核对,就是一个完整、可落地的端云一体小项目。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。