对于小米用户，云相册的数据安全和便捷访问是个痛点。一个开源项目Xiaomi Album Syncer提供了完美的解决方案，它能通过Docker将相册和录音自动备份到个人NAS，支持多账户和定时任务，实现数据的自主可控。
智能速览
支持Docker一键部署，提供友好的Web UI。
可实现全量、增量及定时备份，并自动跳过已下载文件。
同时支持相册与录音文件的同步下载。
允许多个小米账号分区管理，适合家庭用户。
能够保留照片的Exif信息与文件系统时间。
精华内容
要实现小米云数据的自主管理，关键在于找到一个稳定可靠的同步工具。Xiaomi Album Syncer正是为此而生，它提供了从部署到执行的完整流程。
核心功能一览
Xiaomi Album Syncer是一个功能丰富的同步工具。它不仅能下载指定相册中的所有照片和视频，还支持录音文件的备份。其增量备份功能速度极快，并能自动跳过已下载的资产，避免重复操作。
该项目支持多小米账户，可以为不同家庭成员设置独立的备份计划。同时，它会自动填充照片和视频的Exif时间信息，并更新文件系统的时间戳，保证文件信息的准确性。
为了安全和管理，项目设计了友好的Web UI，并支持SSL加密和Passkey认证。但作者明确表示，该项目专注于只读归档，暂不考虑双向同步等写操作，以避免云端数据风险。
部署前的准备
部署前，需要从小米云服务获取两个关键参数：PassToken和UserId。
首先，在浏览器中登录小米云服务，并进入「云相册」页面。点击右上角头像，选择「我的小米账号」。随后，打开浏览器的开发者工具，切换到「应用程序/Application」标签页，找到「Cookie」存储。
在Cookie列表中，分别找到名为「passToken」和「userId」的条目，将其完整值复制出来备用。这两个值是后续程序连接小米云服务的凭证。
Docker部署实战
本项目推荐使用Docker Compose进行部署，过程简单快捷。以威联通NAS为例，创建一个`docker-compose.yml`文件，内容如下：
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
需要注意，`volumes`项中的本地路径需根据实际NAS环境进行修改。此配置将程序的下载目录和数据库目录映射到了NAS的本地文件夹中，确保数据持久化。
Web界面配置
部署完成后，通过浏览器访问`NAS_IP:8232`即可进入Web界面。首次访问需设置一个独立的管理密码，用于保护本项目的访问安全。
登录后，在「设置」页面将之前获取的UserId和PassToken填入并保存。返回主页，点击「从远程更新整个相册列表」来同步云端相册信息。此过程耗时取决于相册数量和网络状况。
之后便可以创建计划任务，灵活指定不同账户或相册的备份目标文件夹，实现精细化的数据管理。计划任务支持手动触发，也支持按设定周期自动执行。
使用注意事项
在使用过程中，有几点需要特别注意。作者不建议对该工具进行自动升级，因为跨版本升级可能涉及数据库变更或破坏性更新，应手动查阅Release说明后再操作。
此外，由于频繁请求小米云服务接口可能触发风控机制，不建议将相册列表同步和计划任务的执行频率设置得过高。若需在外网访问，强烈建议配置SSL证书以确保数据传输安全。
这个项目为小米用户提供了一个将云端数据资产牢牢掌握在自己手中的有效途径。通过简单的配置，就能实现安全、自动化的本地备份，极大提升了数据主权和安全感。你是否也在寻找类似的个人数据管理方案？
