不少家用小米手机的用户，习惯把照片直接备份到小米云相册，图个方便。但时间长了，会发现：云空间越来越不够用：照片和视频越来越多，不得不升级套餐； 数据不在自己手上：想迁移、做家庭相册、多地备份，都没本地 NAS 灵活。

这篇文章就是教家庭 NAS 用户，用开源工具 XiaomiAlbumSyncer，把小米云相册按相册分类同步到 NAS：

✅ 一次性全部下载

✅ 只下载新的照片，速度快

✅ 每天/每周自动同步

✅ 自动跳过已下载的，补全 EXIF/文件时间，方便管理

适用范围：极空间、群晖、威联通、TrueNAS、Unraid、Ubuntu 家庭服务器等，只要能用 Docker 就行。

0. 准备工作

  1. 一台能用 Docker 的 NAS/主机

  2. 一个存储目录（建议新建文件夹，方便管理和备份）

  3. 能打开小米云网页版的浏览器（获取 passToken 和 userID）

  4. 注意安全：passToken 就像“钥匙”，别泄露，密码要复杂

注意：小米云的“私密相册”通常不能用这种方法同步，得在手机或网页上手动导出/下载。

1. 为什么要“云相册 → NAS”

NAS 对家庭用户来说，重要的是：

  • 更自由地管理照片：按年份/相册/家庭成员整理，或者导入家庭相册应用（后面会说）

  • 更灵活的备份：可以做 3-2-1 备份（NAS + 移动硬盘 + 异地云/异地 NAS）

  • 更省钱：迁移后可以减少云空间，甚至不用订阅了

2. Docker 部署

这里用飞牛 NAS 举例，其他方法可以看 XiaomiAlbumSyncer 部署

✅ docker-compose.yml

name: xiaomi-album-syncer
services:
  app:
    image: coolfan1024/xiaomi-album-syncer:latest
    container_name: xiaomi-album-syncer
    ports:
      - 38232:8080   # 左侧端口可以改
    volumes:
      - ./download:/app/download
      - ./db:/app/db
    restart: unless-stopped

1. 在飞牛页面找到 Docker，切换到 Compose -> 新增项目

0-IZhK

2. 填写项目名称和路径，把 docker-compose.yml 内容复制到来源框

0-LsQj

3. 返回 Docker管理页面，在 容器菜单中可以看到运行状态

0-dncQ

3. 首次登录

在浏览器输入：http://NAS IP:38232 打开，第一次会让你设置管理员密码，注意：

  • 别用生日/手机号/123456

  • 建议：12 位以上，包含大小写、数字、符号

  • 如果 NAS 可以公网访问，密码更要复杂

0-Lxax
0-bUjE

4. 获取小米云 passToken 和 userID

这是整个流程里需要手动操作的一步，但也不难。

4.1 登录小米云网页版

在电脑浏览器打开小米云服务网页： https://i.mi.com，登录小米账号，进入云相册。如果提示“信任此设备/授权”，按提示完成。

0-xgIN
5-zJsW.png
640-hMAL

  • Windows：按 F12

  • Mac：⌥ Option + ⌘ Command + I

在开发者工具里找到 Application（应用）/ Storage（存储） → Cookie，选择 https://account.xiaomi.com，在 Cookie 列表里找到： passToken 和 userID 并复制下来。

0-vifG

4.3 回到 XiaomiAlbumSyncer 设置页填写

在工具页面的 Settings/设置 里填入对应的值，保存。

640-OHdY

5. 获取相册列表

填完 token 后，通常要两步：

  1. 刷新相册列表（把你的小米云相册都拉下来）

  2. 在计划（Plan/Schedule）里创建任务：选择相册、下载照片/视频、选择增量策略

通常会有“从远程更新整个相册列表”的选项，点一下就能看到相册。

640-QRNt
640-TZUg

注意：相册多的用户，刷新要耐心等一两分钟。

6. 创建同步计划

6.1 第一次迁移（全部）

建议先做一次“全部搬家”，之后再改成增量定时。

推荐设置：

  • 下载照片 ✅

  • 下载视频 ✅（视频大的话，可以先只下载照片）

  • 选择：全部相册（或者先选几个试试）

  • 设置：

    • ✅ 跳过已存在的文件

    • ✅ 填充 EXIF 时间（相册应用识别时间更准）

    • ✅ 填充文件系统时间（方便按时间排序）

创建好任务后，点 立即执行，看看日志对不对。

640-ofay
640-xxjh
0-jjnL
0-Pbyf
0-xnmX

6.2 每天自动同步（增量 + 定时）

全部下载完后，改成“每天凌晨”或者“每周一次”。

家庭使用推荐：

  • 每天 03:00 同步（不影响白天网速）

  • 打开“跳过已下载”，避免重复下载

  • 按相册分类存储

7. 同步完怎么做成“家庭相册”？

下载到 NAS 只是开始，更方便的是“像手机相册一样浏览”。

可以把下载目录接入这些家庭相册方案：

  • 飞牛：相册功能

  • 极空间：极相册功能

  • 群晖：Synology Photos

  • 威联通：QuMagie / Photo Station

  • 通用 Docker：Immich / PhotoPrism

8. 备份（别只存一份）

很多人觉得“放 NAS 就安全了”，其实 NAS 也会坏、会误删、会中勒索病毒。

推荐简单的 3-2-1 备份：

  • 3 份数据：小米云（短期保留）+ NAS 主存储 + 备份盘/备份 NAS

  • 2 种介质：NAS 硬盘 + USB 移动硬盘（或另一台 NAS）

  • 1 份异地：另一处住所的 NAS / 云盘 / 亲友家硬盘

如果打算停掉小米云，至少要做到 NAS + USB 硬盘 两份备份再取消。

9. 常见问题

Q1：同步速度慢？

  • 第一次全量下载本来就慢，尤其视频多

  • 尽量晚上跑

  • 看 NAS 的 CPU/硬盘是不是占用太高

Q2：提示登录失效/获取不到相册？

  • passToken 可能过期

  • 重新登录小米云网页，重新获取 Cookie

Q3：照片时间不对、排序乱？

  • 开启 填充 EXIF 时间/文件系统时间

  • 同步完再导入相册应用

Q4：私密相册没同步下来？

  • 一般不能通过这种方法获取

  • 需要手机或网页手动下载

10. 总结

如果想把家庭照片掌握在自己手里，又想保留“自动备份”的方便：

  • 用 XiaomiAlbumSyncer 把小米云相册全部搬回 NAS

  • 用 增量 + 定时 来同步

  • 再接入 NAS 的“相册”应用，并做好 额外备份

这样既能减少云订阅费用，又能好好保存家庭照片。