告别 iCloud 空间焦虑三步用 docker-icloudpd 搭建免费私有照片同步系统【免费下载链接】docker-icloudpdAn Alpine Linux container for the iCloud Photos Downloader command line utility项目地址: https://gitcode.com/GitHub_Trending/do/docker-icloudpd从 5GB 免费额度到家庭私有云相册一份面向新手、可照着操作的 iCloud 照片备份教程。自动处理 HEIC 格式、支持国区账号、还能用 Telegram 远程遥控同步。手机里存着孩子成长的点滴iCloud 却一次次弹窗提醒你空间已满——这是很多家庭的共同困境。今天要介绍的开源项目docker-icloudpd能把你的 iCloud 照片同步到自建服务器上一次性解决存储空间、备份安全和格式兼容三大烦恼。先讲一个朋友的故事。老周家三台 iPhone、一台 iPad全家照片加起来超过 200GB。每年 iCloud 扩容费 700 多元照片却还是越拍越挤更让他后怕的是有一次手机掉水里他翻遍云端才发现很多旧照片早就被系统压缩成了低清版本。于是他把目光投向了把照片搬回自己家的方案——也就是 docker-icloudpd 在做的事。从 5GB 焦虑说起为什么全家照片需要一个自己的服务器我们先算一笔账。苹果白送的 iCloud 只有 5GB连一部手机的系统备份都装不下。想多存照片就只有几条路方案年成本隐私格式可控长期可持续iCloud 付费扩容持续上涨依赖第三方受苹果限制越用越贵网盘手动上传会员费存别人服务器一般繁琐易漏docker-icloudpd 私有同步一次性投入数据完全在自己手里可自动转 JPG一劳永逸自己搭同步服务还有三个隐性好处一是格式转换iPhone 默认的 HEIC 照片格式在很多设备上打不开容器可以在下载时自动转成通用的 JPG二是集中管理全家人的设备照片统一进一个目录不用再挨个手机导出三是数据主权照片存在你自己的硬盘上删不删、怎么用你自己说了算。认识主角docker-icloudpd 这个照片搬运工到底能干什么一句话概括docker-icloudpd 是一个基于 Alpine Linux 的轻量级 Docker 容器内置了开源的 iCloud Photos Downloader 工具相当于一个不知疲倦的照片搬运工——它定期登录你的 iCloud 账号把新照片、视频搬到指定目录然后安静地等着下一轮。它的核心能力清单如下安全存储凭证账号密码保存在容器内的系统密钥环keyring中不落地明文文件全自动同步按你设定的间隔默认 24 小时定时拉取增量照片️HEIC 转 JPG下载同时自动转换旧照片也能批量补转双因子认证管理自动生成 MFA Cookie到期前主动提醒支持命令行或 Telegram 远程重新认证健康自检内置 healthcheck下载异常时容器会标记为 unhealthy方便接入自动重启️防呆保护只有检测到挂载目录里的.mounted标记文件才执行同步防止存储卷意外卸载后把系统盘写满最贴心的是整个容器只有几百 MB 大小跑在树莓派、旧笔记本或者任何一台 NAS 上都没压力完全不用为它准备豪华配置。三步完成私有云相册搭建一杯咖啡时间跑通首次同步第一步准备一个安全屋目录先在服务器上建好照片的存放目录并放一个名为.mounted的标记文件——这是容器开工前的通行证确保它不会在磁盘挂载异常时乱写数据mkdir -p /home/你的用户名/iCloud touch /home/你的用户名/iCloud/.mounted提示这里的目录路径要和你下面 compose 文件里的挂载路径保持一致包括 iCloud 的拼写大小写。第二步用 Docker Compose 一键起容器新建docker-compose.yml内容如下services: icloudpd: image: boredazfcuk/icloudpd container_name: icloud_photos_sync restart: always environment: - TZAsia/Shanghai - user你的用户名 volumes: - icloudpd_config:/config - /home/你的用户名/iCloud:/home/你的用户名/iCloud healthcheck: test: /usr/local/bin/healthcheck.sh start_period: 30s volumes: icloudpd_config:这段配置做了三件事把/config目录做成持久化卷存放认证 Cookie把宿主机的照片目录挂进容器并开启健康检查。然后启动docker compose up -d容器启动后会自动生成默认配置文件/config/icloudpd.conf后续所有参数都在这里调整。第三步初始化认证完成首次同步进入容器执行初始化命令按提示输入 Apple ID 和密码然后在你手机上点允许登录再把收到的六位验证码填回去docker exec -it icloud_photos_sync sync-icloud.sh --Initialise认证通过后容器会生成一个 MFA Cookie 并开始第一轮照片拉取。看到日志里出现 Multifactor authentication cookie generated就说明大功告成了——首次同步会下载全部照片之后每次只拉新增内容。一分钟读懂核心参数把同步策略调成你的节奏初始化完成后编辑/config/icloudpd.conf就能精细控制同步行为。新手建议优先关注这几个配置项作用推荐值apple_id要同步的 iCloud 账号你的 Apple IDdownload_interval两次同步的间隔秒8640024 小时folder_structure照片目录组织方式{:%Y/%m/%d}按年/月/日归档convert_heic_to_jpeg是否把 HEIC 转成 JPGtruejpeg_quality转换后的 JPG 质量90icloud_china国区账号设为 truefalseskip_check照片上万张后设为 true 提速falsenotification_type同步结果通知渠道telegram / wecom 等举个例子如果你在国区、希望照片按日期归档、并自动转成 JPG只需在配置里这样写apple_idyouricloud.com icloud_chinatrue folder_structure{:%Y/%m/%d} convert_heic_to_jpegtrue jpeg_quality90两个实用建议同步间隔不要低于 12 小时太频繁容易被苹果限流如果你的照片库超过几千张把skip_check设为true可以明显加快每次同步的启动速度。进阶玩法一个容器管全家Telegram 遥控同步与认证docker-icloudpd 最让我惊喜的是它的家庭友好设计——一份 compose 文件里可以定义多个服务实例每个成员一个独立账号、独立目录、互不干扰项目自带的docker-compose.example.yml就是标准双用户示例。更酷的是远程操控能力。只要把notification_type设为telegram并配置好机器人就有两个非常实用的玩法远程触发同步人在外面拍了一堆好照片直接给 Telegram 机器人发一条消息内容是你在配置里设置的user用户名容器收到后会立刻开始同步不用等晚上定时任务远程重新认证苹果把 Cookie 有效期从 90 天缩短到 30 天后重新认证成了一件高频操作。现在只需给机器人发用户名 auth容器会回消息找你要验证码把手机收到的六位数字发回去整个认证就完成了——出差在外也能随时续命另外如果你已经有 Nextcloud 服务开启nextcloud_upload等配置后每次下载的文件会自动上传到 Nextcloud相当于给照片上了双保险。告别报错5 个高频问题一次讲清Q1日志提示 Keyring file does not exist容器还没初始化。执行docker exec -it 容器名 sync-icloud.sh --Initialise完成密码入库即可。Q2提示 Cookie 过期或容器变 unhealthyMFA Cookie 每 30 天过期一次。本地执行docker exec -it 容器名 reauth.sh重新认证配合 Telegram 可在手机上远程完成。Q3照片库很大同步总是很慢把skip_checktrue打开跳过新文件检查环节同时确认同步间隔在 12 小时以上避免被苹果限流。Q4开了苹果高级数据保护ADP功能这个功能会加密 iCloud 数据并关闭网页端访问而容器依赖网页接口下载照片所以必须先在 Apple ID 设置中关闭 ADP否则无法同步。Q5国区账号一直登录失败把icloud_chinatrue写进配置容器会改用 icloud.com.cn 完成登录和下载。核心要点回顾docker-icloudpd把 iCloud 照片同步到自建服务器一次投入长期受益数据主权完全回归自己三步上手建目录放.mounted标记 → compose 起容器 →--Initialise完成双因子认证通过/config/icloudpd.conf可控制归档结构、HEIC 转 JPG、国区支持、同步频率等全部行为支持多用户多账号一个服务器即可集中管理全家人的照片配合 Telegram 还能远程触发同步、远程重新认证记住两个排查口诀没初始化就找--InitialiseCookie 到期就用reauth.sh大图库务必开skip_check如果你也受够了 iCloud 的空间提醒和逐年上涨的扩容费不妨今天就花十分钟把 docker-icloudpd 跑起来让全家人的照片真正回家。【免费下载链接】docker-icloudpdAn Alpine Linux container for the iCloud Photos Downloader command line utility项目地址: https://gitcode.com/GitHub_Trending/do/docker-icloudpd创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考