侧边栏壁纸
博主头像
羊刀仙的部落格 博主等级

闲不下来!

  • 累计撰写 235 篇文章
  • 累计创建 56 个标签
  • 累计收到 3 条评论

目 录CONTENT

文章目录

小米云相册/录音轻松同步到NAS/本地,支持多账户、全量/增量/定时备份

羊刀仙
2026-01-21 / 0 评论 / 0 点赞 / 10 阅读 / 0 字 / 正在检测是否收录...
温馨提示:
部分素材来自网络,若不小心影响到您的利益,请联系我们删除。
GW树洞

高速稳定 · 海外专线

  • 自用推荐
  • 90天使用时长
  • 70+ 节点分布
  • IEPL专线 油管4K无压力
  • 全平台客户端
  • 不限制在线设备
立即注册

之前分享小米云笔记备份的内容,有老哥留言分享了小米的云相册备份?

不过当时太忙,忘记了是不是本篇要介绍的这个。

本期要介绍的项目Xiaomi Album Syncer,支持Docker一键部署,能够全量/增量/定时下载小米云服务中的相册/录音到本地,并且支持多账户分区计划存储,对于全家小米的朋友也更为友好。

小米类似的Docker好项目真多啊,笔者再次表示羡慕~

项目相关

完整项目名:Coooolfan/XiaomiAlbumSyncer,可于GitHub搜索。

新版目前仅提供 Web UI,提供 Docker、JVM、原生二进制版本这些部署方式。在跨多个版本升级时,建议先浏览 Releases 页面,查看每个版本的更新内容,以及可能的数据库变更和破坏性更新。

作者希望该项目只做简单的只读和归档,像双向同步功能这种功能,作者表示这种对云端数据的写操作有点让人担心(后续或许会以半手动的方式提供这个接口)。

注意⚠️:不建议使用各种自动升级该工具。

项目功能

  • 📸 下载指定相册中的所有资产
  • ⏭️ 自动跳过已下载的资产
  • 🎵 支持下载录音
  • 🔄 自动刷新 Cookie
  • ⏰ 支持定时任务
  • 📥 支持增量下载(超快)
  • 🗂️ 支持按相册分类存储照片
  • 🌍 友好的 Web UI
  • 📅 填充照片和视频的 Exif 时间信息
  • 📅 填充照片和视频的文件系统时间
  • 👥 支持多小米账号
  • 📃 表达式插值文件下载路径(具体请至项目页)
  • 🔒 SSL 支持(具体请至项目页)
  • 🛡️ Passkey 支持(具体请至项目页)

准备工作

跟之前的云笔记类似的,需要获取小米云的Cookie,也就是PassToken UserId

打开并登录小米云服务。打开第一个「云相册」。

截屏2026-01-19 16.26.37.png

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

截屏2026-01-19 16.29.47 拷贝.png

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

截屏2026-01-19 16.32.43 拷贝.png

部署流程

本次以威联通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,创建新的应用程序。

截屏2026-01-19 16.05.53.png

使用介绍

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

截屏2026-01-19 16.10.19.png

另外可以看到红字的警示部分。不过如果大家仅局域网使用,也没什么太大问题。外面同步的话还是建议https。

设置密码并登入,界面如下图所示。这个活跃度图表展现形式,有点类似GitHub的个人贡献度。

截屏2026-01-19 16.11.34.png

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

截屏2026-01-19 16.38.50.png

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

截屏2026-01-19 16.40.40 拷贝.png

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

截屏2026-01-19 16.42.59.png

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

截屏2026-01-19 16.46.30.png

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

截屏2026-01-19 16.48.04.png

计划也支持手动触发。

截屏2026-01-19 16.50.33.png

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

截屏2026-01-19 16.51.45.png

最后

我个人认为,这个项目对于小米手机用户来说太香了。

感谢观看,本文完。

0

评论区