鸿蒙云相册实践手记:用OBS Header签名把照片备份到云端

举报
yd_297284506 发表于 2026/11/15 19:01:41 2026/11/15
【摘要】 今天在鸿蒙开发实践中心做了一个案例:用 OBS 打造个人云相册 App。把过程里最值得记的几件事整理下来:整体怎么做、签名为什么是关键、备份去重怎么做,以及容易踩的坑。 一、要解决的问题手机里的照片越来越多,换机、丢失、误删都可能让回忆丢了。把照片备份到对象存储是最直接的办法:按量使用、不用自己搭服务器、手机端随时能取回。对象存储服务 OBS 提供 REST API,App 不需要后端中转,...

今天在鸿蒙开发实践中心做了一个案例:用 OBS 打造个人云相册 App。把过程里最值得记的几件事整理下来:整体怎么做、签名为什么是关键、备份去重怎么做,以及容易踩的坑。

一、要解决的问题

手机里的照片越来越多,换机、丢失、误删都可能让回忆丢了。把照片备份到对象存储是最直接的办法:按量使用、不用自己搭服务器、手机端随时能取回。对象存储服务 OBS 提供 REST API,App 不需要后端中转,直接和 OBS 对话。

二、整体结构

端侧用 ArkTS 与 ArkUI 写界面,photoAccessHelper 负责读取系统相册、让用户挑选照片和视频;云侧就是 OBS;本地用 preferences 保存备份记录。一次备份的链路是:选图、生成对象键、计算文件 MD5、用签名后的 PUT 请求上传、把结果写进本地记录;查看时再用带签名的 GET 请求拉取对象列表和缩略图。

三、最关键的一步:OBS Header 签名

OBS 不认“谁在调用”,只认请求里的签名。做法是把请求方法、日期、规范化后的资源路径和 x-obs 开头的请求头拼成待签字符串,用 SK 做 HMAC-SHA1 再做 Base64 编码,放到 Authorization 头里,格式是 OBS AK:签名。

AK、SK 在控制台“我的凭证、访问密钥”里创建,创建时只显示一次 SK,要立刻保存好。给这对密钥的权限要收紧:只给目标桶的列举、上传和读取权限,测试结束就轮换或删除。密钥只填在 App 的设置页里,不要写进代码、不要发到聊天记录和公开仓库。设置页的密码框只是不回显,数据本身仍以明文存在应用沙箱里。

四、备份去重:MD5 与 ETag 说了算

对象键按 photo_backup/v2/ 加文件特征生成,特征来自本地 URI、大小、修改时间和 MD5。上传前先查本地记录:同一目标下,MD5 和云端 ETag 能对上就跳过,不重复传;取消后,当前文件要整文件重新上传;记录也按 Endpoint 和桶隔离,换桶、换区域不会串。单文件上传和预览的上限是 64 MiB,超过这个大小要走分段上传,本文不展开。

五、云端怎么看

备份完成后,在云端列表里刷新对象,照片和视频以缩略图展示,可以切换列表和网格视图、打开详情和预览。预览用的是带签名的 GET 请求直接读原对象,公网读取会产生流量费用,缩略图建议做磁盘缓存并设上限,例如 128 MiB、最多 64 张,不要无限制拉原图。

六、实践路径与排障

建议先走快速体验:在鸿蒙开发实践中心的作业中心创建项目,填入案例仓地址,用 AI DevSpace 的云端工作区编译打包,再连云手机安装体验;跑通之后再从空项目按步骤自己实现一遍,印象更深。

常见问题:

  • 返回 403:先核对四项配置,AK、SK、区域 Endpoint、桶名,再核对设备时间;签名对时间敏感,时间偏差大会直接失败。
  • 桶建好了却扣按需费用:核对资源包的区域和单 AZ、多 AZ 策略是否与桶一致,不一致抵扣不上;桶名、区域、冗余策略建好后不能直接改,创建前就要想清楚。
  • 相册为空:确认设备里有测试媒体,并且授予了照片和视频读取权限。

七、收尾与清理

测试用最小权限的专用密钥和非敏感照片。做完后停止不再用的云工作区和云手机,删掉测试对象和不再用的桶,撤销或轮换测试密钥。需要长期用的,再按生产要求做临时授权,不要把长效密钥留在客户端里。

小结

这个案例的骨架很清晰:端侧负责选图和展示,OBS 负责存和取,签名负责证明身份,MD5 与 ETag 负责别重复传。把签名和去重这两件事做对,一个能用的个人云相册就跑起来了。下一步我打算试试超过 64 MiB 的大视频分段上传。

参考:鸿蒙实践案例中心案例仓库 HarmonyOS-APP-OBSCloudAlbum,以及 OBS Header 签名与 OBS API 参考文档。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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