手把手教你通过Docker在飞牛NAS部署icloudpd，实现苹果iCloud照片自动同步到本地。完整支持Live Photos和RAW格式，节省每月订阅费用，拿回数据掌控权。附详细配置、问题解决与SEO优化。
当5GB免费空间遇上数千张珍贵记忆
对于数亿苹果用户而言，iCloud的5GB免费空间就像一道无形的枷锁——刚刚拍了几百张照片，系统就频繁弹出“存储空间已满”的警告。升级到50GB每月6元，200GB每月21元，2TB每月68元……年复一年的订阅费用累积起来，竟是一笔不小的数字。
更令人不安的是，将所有珍贵记忆完全托付给云端服务，总让人缺乏一种“实实在在”的安全感。万一账户异常、服务变更，或者单纯想减少每月固定支出，有没有一种方案能够让我们既保留苹果生态的便捷，又将照片数据牢牢掌握在自己手中？
答案是肯定的。今天，我将为你详细介绍如何利用开源工具 icloudpd，在飞牛NAS上搭建一个完全免费、自主可控的苹果照片同步方案，一次性解决存储空间与数据自主权的双重焦虑。
icloudpd（iCloud Photo Downloader）是一个基于Python开发的开源命令行工具，专门用于从iCloud照片库下载内容到本地设备。虽然它以“下载器”为名，但其功能远不止简单的批量下载。
本期项目开源地址: https://github.com/lausen/icloudpd
核心功能亮点
- 📱 支持多平台：Linux、Windows、macOS
- 🔄 支持多种模式：
- 📥 下载新照片：默认模式，只下载iCloud上新增的照片。
- 🔄 同步模式：不仅下载新照片，还会删除本地已经在iCloud上删除的照片。
- 🚚 搬运模式>下载新照片后，直接从iCloud上删除。慎用哦！
- 🎬 支持Live Photos：会把Live Photos的图片和视频分开下载。
- 📸 支持RAW图片：支持RAW格式，包括RAW+JPEG。
- 🕵️ 自动去重：防止重复下载同名照片。
- 👀 持续监控：可以设置定期检查iCloud变化。
安装使用
- 环境：fnOS 1.0.0；
手机设置
避免Apple服务器将返回一个 ACCESS_DENIED错误:
- 在网页上启用访问iCloud数据，在iPhone/iPad上启用
>Settings > Apple ID > iCloud > Access iCloud Data on the Web - 禁用高级数据保护，在iPhone/iPad上禁用
>Settings > Apple ID > iCloud > Advanced Data Protection
部署指南
- 部署方式：docker-compose文件
为避免"请注意yml语法"的提示，不建议直接复制粘贴，而是手敲或从后台获取。
services:
icloudpd:
image: docker.1ms.run/icloudpd/icloudpd:latest
container_name: icloudpd
restart: unless-stopped
network_mode: bridge
tty: true
ports:
- "8090:8080"
volumes:
- /share/media/photos:/data
environment:
TZ: Asia/Shanghai
command: >
icloudpd
--directory /data
--username XXXXXXX@qq.com
--mfa-provider webui
--domain cn
--password-provider webui
--watch-with-interval 3600
注意：根据实际情况替换【username】那一行
▼打开文件管理新建"../docker/icloudpd文件夹，直接复制icloudpd.yml文件内容并粘贴到docker-compose（或上传文件）来部署容器；
使用说明
打开浏览器输入http://NAS的IP:8090。（没有苹果机，没有对应账号绑定邮箱，信息不完整而部署失败，没法贴图，见谅。知晓步骤应该够了吧）
▼后续填写密码、验证码等信息；
▼开始等待下载（其他演示号主提到，输入好几次密码才成功，如果输入密码失败，可多尝试几次），下载完成后再去到NAS设备，能看到照片按照年月日进行备份。
打个分
综合评价：👍👍👍（省钱）；
个人体验：❤❤❤（手动下载）；
部署难度：😄（简单如喝水）。
结语
我猜有些朋友会提到，只能【手动下载】；对，这个需要手动去下载>（批量），不是【无感备份】；
我去思考过场景，号主的安卓/鸿蒙机装了飞牛APP 是能联网自动备份，但ios考虑到安全，所以飞牛APP 苹果版是不支持【无感备份】；（近无感也有法子，据我了解的都太折腾，另外我也无苹果机，所以欢迎有法子的老伙计在评论区留言分享）
那么，不太能追求到无感，可以用本期项目满足省钱需求，也不错。
觉得内容不错？我要
