本内容来源于@什么值得买APP，观点仅代表作者本人 ｜作者：我是王小浪
前情提要：由于网上看到的所有教程，几乎没一个靠谱的，全部都是小白自行捣腾出来的步骤，评论里问题很多，看得让人心疼，所以趁娃子睡了，赶忙整理一篇保姆式的避坑教程。
本教程优势如下：1.全程在群晖桌面上窗口式操作，不需要开启SSH权限，不需要下载SSH客户端，不需要使用群晖SSH最高权限，也不需要懂Linux命令，避免一切不必要的风险；
2.不浪费一丝一毫的NAS硬件资源，不需要Docker运行Linux操作系统容器，也不需要装什么Docker网页管理面板，Docker原生运行，性能直接拉满；
3.关键步骤反复叮嘱加图解，避免踩坑，贴心呵护直至顺利配置完成。
先说正题，操作流程如下：
一、管理员登录群晖桌面，这是句废话，但还是要说，举例，我的管理员账号为【xlang】。
二、打开群晖【File Station】，苹果手机如何开启增量下载，新建所需文件夹及文件：docker/icloudpd/xlanghomes/xlang/Photos/iCloudhomes/xlang/Photos/iCloud/.mounted，
三、打开群晖【套件中心】安装【Docker】套件。
四、打开安装好的【Docker】套件，点击左侧菜单【注册表】，搜索关键词“icloudpd”，双击下载星标最多的那个【boredazfcuk/icloudpd】。
五、左侧菜单切换到【映像】，稍等片刻，待下载完成后，双击开始创建容器。
六、容器名称，看你喜好，例如我就随手输了个“icloudpd-xlang”，然后点击左下方的【高级设置】。
七、勾选“启用自动重新启动”，这个不是必须的，如果你想长期丢那让NAS自动运行，那就勾上，不勾也是可以的。
八、切换到【存储空间】设置栏，添加以下两个文件夹的状态路径：docker/icloudpd/xlang --> /confighomes/xlang/Photos/iCloud --> /iCloud
1.选择文件夹docker/icloudpd/xlang，装载路径/config
2.选择文件夹homes/xlang/Photos/iCloud，装载路径/iCloud
如下图所示：
九、切换到【环境】设置栏，新增以下三个变量：apple_id:xxx@xxx.comTZ:CST-8download_path:iCloud
1. apple_id:xxx@xxx.com必须，输入你的iCloud服务的AppleID。
2. TZ:CST-8非必须，中国时区按这个填写，网上清一色的要求填写Asia/Shanghai是无效的，还不如不新增这个变量。
3. download_path:/iCloud必须，否则默认为/home/${user}/iCloud。
如下图所示：
十、点击右下角“应用”，返回到创建容器主界面，点击“下一步”，最后点击“完成”启动创建好的容器。
步骤1：打开手机的【设置】，点击【通用】，找到【日期与时间】；苹果手机增量下载在哪里设置 步骤2：关闭【自动设置】，这时就可以把时间设置为今天之后的任意日期，也可以是一个月后。修改好日期之后，返回菜单，找到刚刚。
ERROR Keyring file /config/python_keyring/keyring_pass.cfg does not exist.INFO - Please add the your password to the system keyring using the --Initialise script command line option.INFO - Syntax: docker exec -it <container name> sync-icloud.sh --InitialiseINFO - Example: docker exec -it icloudpd sync-icloud.sh --InitialiseINFO Restarting in 5 minutes...
1.打开手机里面的 设置，再点开 通用。2.然后在通用里面找到 日期与时间。3.点开进入到日期与时间页面，然后关闭 自动设置。4.关闭自动设置之后，在下方就会出现此时的北京时间，如下图。5.点击这个时间就会出现一个滚轮。
如下图所示：
十二、好了，到了要屏住呼吸的时刻了：1.切换到【终端机】一栏，点击【新增】右侧的下拉小箭头；
2.选择【通过命令启动】；
1、首先解锁自己的苹果手机，然后在手机上找到并打开【设置】选项，如图所示。2、然后在打开的设置页面中，进入【个人中心】，如图所示。3、接着在个人中心页面中，选择【iTunes Store与App Store】，如图所示。4、然后在新。
3.在弹出的对话框输入“/bin/sh”后点击【确定】；
苹果手机增量下载可以参照如下操作：一、进入到应用商店下载的应用，在流量模式下，无法下载大于150MB的软件，这时候不要关闭APP Stroe，点击“好”忽略提示。二、然后在“设置”页面点击“通用”进入。三、在“通用”界面中选。
4.左侧菜单选择打开刚刚新建的【sh】终端；
5.输入以下命令后回车，进行初始化：
sync-icloud.sh --Initialise
十三、开始进行苹果账号的双重认证了，创建cookie文件，有效期默认为90天，到期后需再进行一次认证：
1.如下图所示，按提示输入你的AppleID密码，盲输，这里不会显示你输入的内容，输入完成后回车；
Enter iCloud password for email@address.com:
2.如密码正确，会提示询问你是否保存，输入“y”后回车，不然就全剧终了；
Save password in keyring? [y/N]: y
3.这时候你登录了AppleID的设备上会提示是否允许登录的弹窗，先不要理会，在提示询问后输入数字“0”后回车；
Which device would you like to use? [0]: 0
4.在收到提示的设备上，点击【允许】登录，获取弹窗验证码，将该验证码按下面提示输入后回车；
Please enter validation code: 123456
5.校验通过后，Apple会通过短信，注意是短信发送二次验证码，这时候你设备上再有弹窗点击【允许】即可，弹窗验证码无需理会，短信验证码收到后，如下图所示，按提示输入数字0后回车，按提示输入6位数字的短信验证码，回车后完成二次验证文件的创建。
十四、所有配置到此结束，重启容器，查看日志，看到以下内容，说明运行成功，在iCloud中生成文件列表，等着自动下载iCloud照片即可，默认为24小时增量下载一次，默认下载原始尺寸文件。
用上述方法，下载iCloud上12740个原尺寸照片及视频，用时9小时45分钟完成，而采用iPhone下载，从2月6日18点52分13秒开始，到现在（2月9日18点56分）刚好72个小时，还剩5660个文件等待下载中，期间无数次因为手机内存被占满，导致微信无法使用（提示微信正常使用需5.4G空间），只能删除已下载已备份的内容，来腾出一点运行空间。
1、首先打开手机主屏上的“设置”，在设置列表中，点击“蜂窝移动网络”一栏,接着打开“蜂窝移动网路”的开关。打开苹果应用商店下载你需要的软件，如果软件超过100M的时会卡在等待WIFI的状态，这个时候不要关闭“蜂窝移动网络。
一些扩展小知识：
1.网上最开始的开源软件是icloud_photos_downloader，也就是【注册表】里搜到的排第二的那个【icloudpd/icloudpd】，由于作者弃更，已经一年多没有更新了，虽然如此，但仍要感谢鼻祖大佬作出的贡献。
2.目前用的【boredazfcuk/icloudpd】是现作者在原【icloudpd】的基础上拓展而来，功能相当全面，配置也很简单，简直上天，可能由于作者对Docker的了解不够深入，所以给出的操作方法依然是Linux命令行的方式来配置，这一点可能导致了很多人第一步就去用Docker去安装一个Linux的操作系统，然后再安装Portainer来管理Docker，白白浪费大量的性能资源，这里还是要提醒大家避坑。
例如以下教程：
【知乎】如何备份iCloud照片到NAS？作者一开始就用Docker安装了Ubuntu 20.04环境，然后再用大量的命令行部署Docker环境，接着再安装Docker管理面板Portainer以方便日后管理Docker，循环套娃，浪费掉大量性能。
【知乎】通过icloudpd间接实现iOS后台自动备份照片至群晖作者进行了基础研究，避免了部分资源的浪费，但是用开启群晖SSH，安装SSH客户端，用群晖系统root权限来进行配置，里面也有大量的没必要的操作。
【知乎】群晖用docker的icloudpd同步icloud照片至Synology Photos并自动刷新作者在上一篇教程上进行了修改，可能是排版原因，看的更加不知所云。
【小白记录】群辉 docker iCloud照片原尺寸备份作者采用的是最开始的icloudpd，也是一开始就安装了Ubuntu，最后应该是成功了，但是配置繁琐，容易出错，每次备份100个照片。
3.所有的教程中，时区的设置都是Asia/Shanghai，这是个无效设置，最终结果就是容器运行时间为UTC时间，比北京时间晚8个小时，正确的设置应该是【CST-8】，不介意的话，影响不大，创建容器时可以不新增【TZ】这个变量。
icloudpd的一些扩展功能：
小提示：以下变量均可以在容器停止运行时进行增改，来调整相应的设置。
synchronisation_interval:43200
1、连接WIFI后下载。2、连接其他手机分享的热点使用流量下载。3、在App Store选择想下载的应用，弹出提示后选择“好”，回到桌面发现应用处于“等待中”状态。进入手机设 置-通用-日期与时间，关闭自动设置，并把时间调后一。
2.设置多个容器同步的分钟数，默认为0，如果需要自动同步过多AppleID的iCloud内容，可以进行设置，新增变量synchronisation_delay，例如30分钟，避免多账户同时访问遭到苹果的风控限制。
synchronisation_delay:30
3.设置iCloud账户身份验证类型，默认为2FA，如果启用了双重认证，则有效值为2FA，否则为Web，如iCloud账户未启用双重认证，则必须新增变量authentication_type，设置为Web，如下所示：
authentication_type:Web
4.设置下载目标目录的文件夹结构，变量folder_structure，默认为 {:%Y/%m/%d}（年/月/日），可按需进行调整，例如：年/月
folder_structure:{:%Y/%m}
5.设置是否跳过已下载检查（增量同步），默认为False（不跳过），也就是默认为每次启动只同步新增内容，如果要重新完全同步，可设置变量skip_check的值为True
skip_check:True
6.设置扫描“最近删除”文件夹，并删除其中找到的所有文件，意思是，你手机上删除的照片，是否同步删除，默认为不扫描，也就是不同步删除，如果你想同步删除或恢复，可设置变量auto_delete的值为True
auto_delete:True
7.设置要下载的照片大小，默认为original（原始尺寸），如需调整，可设置变量photo_size的值为original（原始尺寸）、medium（中等质量）、thumb（缩略图），如下所示（二选一）：
photo_size:mediumphoto_size:thumb
8.设置是否下载时将HEIC文件转换为JPEG格式，同时保留原始文件，如设置此变量convert_heic_to_jpeg，不论为何值，则转换。
9.设置HEIC文件到JPEG转换的质量，可设置变量jpeg_quality，数值为0（最低质量）到100（最高质量），默认为90，如想得到最高质量的转换，可如下设置：
jpeg_quality:100
10.设置是否强制使用云上贵州为下载源，如你的iCloud由云上贵州运营，而你的NAS又在国外，可以设置变量icloud_china，不论何值，将强制以icloud.com.cn作为下载源，NAS在国内不用，自动会解析到云上贵州的IP。
好了，教程到此结束，那么多照片那么好看、值得纪念，是应该好好保存，祝大家配置顺利，使用愉快！熟练的话，2分钟应该是可以配置好的。
我是王小浪，一个很懒的人，所以很少会耐心出教程，本来准备录个视频的，但是因为懒，不准备出了，我要去带娃子了，以后再检查是否有错别字。
