之前分享小米云笔记备份的内容,有老哥留言分享了小米的云相册备份?
不过当时太忙,忘记了是不是本篇要介绍的这个。
本期要介绍的项目Xiaomi Album Syncer,支持Docker一键部署,能够全量/增量/定时下载小米云服务中的相册/录音到本地,并且支持多账户分区计划存储,对于全家小米的朋友也更为友好。
小米类似的Docker好项目真多啊,笔者再次表示羡慕~
项目相关
完整项目名:Coooolfan/XiaomiAlbumSyncer,可于GitHub搜索。
新版目前仅提供 Web UI,提供 Docker、JVM、原生二进制版本这些部署方式。在跨多个版本升级时,建议先浏览 Releases 页面,查看每个版本的更新内容,以及可能的数据库变更和破坏性更新。
作者希望该项目只做简单的只读和归档,像双向同步功能这种功能,作者表示这种对云端数据的写操作有点让人担心(后续或许会以半手动的方式提供这个接口)。
注意⚠️:不建议使用各种自动升级该工具。
项目功能
- 📸 下载指定相册中的所有资产
- ⏭️ 自动跳过已下载的资产
- 🎵 支持下载录音
- 🔄 自动刷新 Cookie
- ⏰ 支持定时任务
- 📥 支持增量下载(超快)
- 🗂️ 支持按相册分类存储照片
- 🌍 友好的 Web UI
- 📅 填充照片和视频的 Exif 时间信息
- 📅 填充照片和视频的文件系统时间
- 👥 支持多小米账号
- 📃 表达式插值文件下载路径(具体请至项目页)
- 🔒 SSL 支持(具体请至项目页)
- 🛡️ Passkey 支持(具体请至项目页)
准备工作
跟之前的云笔记类似的,需要获取小米云的Cookie,也就是PassToken 与 UserId。
打开并登录小米云服务。打开第一个「云相册」。

然后点击右上角用户头像,然后点击「我的小米账号」,会进入以下界面。

如下图。接着打开浏览器的开发者工具,选择「应用程序/Application」,找到「Cookie」项,将
passToken 与 userId后面对应的值分别(完整)复制备用。

部署流程
本次以威联通NAS为例,通过Docker Compose的方式进行部署。
部署代码如下:
services:
app:
image: coolfan1024/xiaomi-album-syncer:latest
container_name: xiaomi-album-syncer
ports:
- "8232:8080" # 冒号左侧端口可改
volumes:
# 注意这是威联通的路径,请自行替换
- /share/Container/xiaomi/download:/app/download # 备份地址
- /share/Container/xiaomi/db:/app/db
restart: always
打开威联通的Container Station,创建新的应用程序。

使用介绍
按照上文内容进行部署,浏览器输入NAS_IP:8232即可访问服务界面。首次进入需要初始化服务密码(此密码仅用于访问此项目,与任何外部服务或者小米无关)。

另外可以看到红字的警示部分。不过如果大家仅局域网使用,也没什么太大问题。外面同步的话还是建议https。
设置密码并登入,界面如下图所示。这个活跃度图表展现形式,有点类似GitHub的个人贡献度。

点击顶部的「设置」,进行账号配置。

将ID和Token分别复制进框内,点击保存。

保存后回到主页,如下图,点击「从远程更新整个相册列表」。此接口为同步接口,具体时长取决于相册数量和网络情况。请耐心等待。

这个的频率以及计划任务的频率不建议太高,因为仍然有请求频率过高触发风控的可能。

创建计划任务,这边可以根据不同的归属账户或者同一账户的不同相册,设置下载到不同的文件夹。其他内容一张截图放不下,就不具体演示。

计划也支持手动触发。

我手动执行后,图片便备份到了NAS。

最后
我个人认为,这个项目对于小米手机用户来说太香了。
感谢观看,本文完。
评论区