对于小米手机用户而言，云端数据的安全性和可控性一直是关注重点。Xiaomi Album Syncer项目提供了一套完整的解决方案，能够将小米云相册和录音数据自动同步到本地NAS或存储设备，支持多账户管理、增量备份和定时任务，为数据私有化提供了实用工具。
智能速览
支持Docker一键部署，提供Web UI管理界面
可全量/增量下载小米云相册和录音文件
支持多小米账号分区存储，适合家庭使用
提供定时任务功能，自动跳过已下载内容
可按相册分类存储，自动填充Exif时间信息
精华内容
通过简单的Docker部署，即可建立小米云数据到本地的安全通道，实现数据的自主可控和长期保存。
项目特性
Xiaomi Album Syncer是一个专为小米云服务设计的同步工具，采用只读归档的设计理念，避免对云端数据进行写操作。项目提供Docker、JVM和原生二进制三种部署方式，新版主要基于Web UI进行操作管理。核心功能包括相册资产下载、录音文件同步、自动Cookie刷新、增量备份等，特别适合需要将小米云数据迁移到本地存储的用户。
获取认证信息
部署前需要从小米云服务获取必要的认证信息。首先登录小米云服务，进入云相册页面，点击右上角用户头像选择「我的小米账号」。在浏览器开发者工具中找到应用程序/Application选项，定位到Cookie项，完整复制passToken与userId的值，这两个参数是后续连接小米云服务的关键凭证。
Docker部署配置
以威联通NAS为例，通过Docker Compose进行部署。配置文件需要映射两个重要目录：/app/download用于存放同步的相册数据，/app/db用于存储项目数据库。将容器8080端口映射到主机8232端口（可自定义），设置restart策略为always确保服务持续运行。部署完成后通过NAS_IP:8232访问Web界面。
界面操作设置
首次访问需要设置独立的访问密码，与小米账号无关。登录后在设置页面填入之前获取的userId和passToken，点击保存。然后点击「从远程更新整个相册列表」同步相册信息，此过程耗时取决于相册数量和网络状况。为避免触发小米的风控机制，不建议频繁调用同步接口。
计划任务配置
项目支持灵活的计划任务配置，可为不同账户或同一账户的不同相册设置独立的下载路径和执行计划。支持表达式插值定义文件存储路径，可按相册名称、日期等维度分类存储。计划任务支持手动触发和定时自动执行，执行过程中会自动跳过已下载的文件，实现高效的增量备份。
