小米云相册自动备份至NAS：Xiaomi Album Syncer Docker部署全攻略
在先前探讨小米云笔记备份方案时，曾有读者询问有关小米云相册的备份方法。虽然当时未能立即核实，但本次我们将集中介绍一款名为Xiaomi Album Syncer的开源项目。该工具支持通过Docker快速部署，能够以全量、增量或定时方式下载小米云服务中的相册内容与录音文件至本地存储，并具备多账户分区及计划存储功能，对于拥有多台小米设备的家庭用户尤为便利。
项目概览
该项目的完整名称为Coooolfan/XiaomiAlbumSyncer，用户可在GitHub平台直接搜索获取。当前新版本主要提供基于Web的用户界面，并支持Docker容器、JVM环境以及原生二进制文件等多种部署形式。在进行跨版本升级前，建议使用者仔细阅读Releases页面的更新日志，留意可能涉及的数据库结构变动与破坏性更改。
项目开发者强调，该工具目前仅设计为只读和归档用途，暂不提供双向同步功能。开发者认为对云端数据进行写入操作存在一定风险，因此未来或许会考虑以半手动方式开放相关接口。重要提示：不建议启用任何形式的自动更新机制来升级此工具。
核心功能
- 📸 下载指定相册内的全部媒体资源
- ⏭️ 自动跳过已成功下载的资源文件
- 🎵 支持同步下载录音文件
- 🔄 自动刷新身份验证Cookie
- ⏰ 内置定时任务调度器
- 📥 支持增量下载模式，速度极快
- 🗂️ 可按相册目录分类存储照片
- 🌍 提供直观友好的Web管理界面
- 📅 为照片和视频补全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: # 请注意此为威联通NAS路径示例，请根据实际环境替换 - /share/Container/xiaomi/download:/app/download # 指定备份存储地址 - /share/Container/xiaomi/db:/app/db restart: always
在威联通NAS的Container Station中，创建新的应用程序项目，并将上述配置内容粘贴至编辑区域。
使用指南
完成上述部署后，在浏览器中输入NAS设备的IP地址及端口8232，即可访问Xiaomi Album Syncer的Web管理界面。首次访问时，系统会要求初始化一个服务密码，此密码仅用于保护本工具的管理界面，与小米账号或其他外部服务无关。
界面中可能显示关于HTTPS的安全提示。如果仅在局域网内使用，通常不影响功能；但若需从外部网络访问，则强烈建议配置HTTPS加密。成功设置密码并登录后，将看到主仪表盘，其中的活跃度图表在视觉风格上类似GitHub的贡献度日历。
点击顶部导航栏的「设置」选项，进入账户配置页面。
将此前获取的UserId和PassToken分别填入对应输入框，点击保存按钮完成账号绑定。
保存成功后返回主页面，点击「从远程更新整个相册列表」按钮。此操作将同步云端相册元数据，耗时取决于相册数量与网络状况，请保持耐心等待。
请注意，同步操作与计划任务的执行频率不宜设置过高，以避免因请求频繁而触发服务端的风控机制。
创建计划任务时，可以依据不同账户或同一账户下的不同相册，分别设置文件下载至不同的本地文件夹。由于界面选项较多，此处不再逐一截图演示。
计划任务支持随时手动立即触发执行。
手动执行任务后，系统便会开始将云端图片同步备份至指定的NAS存储路径中。
总结
总体而言，Xiaomi Album Syncer为小米手机用户提供了一套高效、自动化的云相册本地备份解决方案，极大地简化了数据归档与管理的流程。希望本指南能帮助您顺利完成配置，实现数据的安全备份。