五分鐘搞定，群暉NAS自動同步iCloud照片（原尺寸或自動轉換為JPG格式）

作者：我是王小浪

前情提要：

由於網上看到的所有教程，幾乎沒一個靠譜的，全部都是小白自行搗騰出來的步驟，評論裡問題很多，看得讓人心疼，所以趁娃子睡了，趕忙整理一篇保姆式的避坑教程。

本教程優勢如下：

1。全程在群暉桌面上視窗式操作，不需要開啟SSH許可權，不需要下載SSH客戶端，不需要使用群暉SSH最高許可權，也不需要懂Linux命令，避免一切不必要的風險；

2。不浪費一絲一毫的NAS硬體資源，不需要Docker執行Linux作業系統容器，也不需要裝什麼Docker網頁管理面板，Docker原生執行，效能直接拉滿；

3。關鍵步驟反覆叮囑加圖解，避免踩坑，貼心呵護直至順利配置完成。

先說正題，操作流程如下：

一、管理員登入群暉桌面，這是句廢話，但還是要說，舉例，我的管理員賬號為【xlang】。

二、開啟群暉【File Station】，新建所需資料夾及檔案：

docker/icloudpd/xlang

homes/xlang/Photos/iCloud

homes/xlang/Photos/iCloud/。mounted

三、開啟群暉【套件中心】安裝【Docker】套件。

四、開啟安裝好的【Docker】套件，點選左側選單【登錄檔】，搜尋關鍵詞“icloudpd”，雙擊下載星標最多的那個【boredazfcuk/icloudpd】。

五、左側選單切換到【映像】，稍等片刻，待下載完成後，雙擊開始建立容器。

六、容器名稱，看你喜好，例如我就隨手輸了個“icloudpd-xlang”，然後點選左下方的【高階設定】。

七、勾選“啟用自動重新啟動”，這個不是必須的，如果你想長期丟那讓NAS自動執行，那就勾上，不勾也是可以的。

八、切換到【儲存空間】設定欄，新增以下兩個資料夾的狀態路徑：

docker/icloudpd/xlang ——> /config

homes/xlang/Photos/iCloud ——> /iCloud

1。選擇資料夾docker/icloudpd/xlang，裝載路徑/config

2。選擇資料夾homes/xlang/Photos/iCloud，裝載路徑/iCloud

如下圖所示：

九、切換到【環境】設定欄，新增以下三個變數：

apple_id:

xxx@xxx。com

TZ:

CST-8

download_path:

/iCloud

1。 apple_id：xxx@xxx。com

必須，輸入你的iCloud服務的AppleID。

2。 TZ：CST-8

非必須，

中國時區按這個填寫，網上清一色的要求填寫Asia/Shanghai是無效的

，還不如不新增這個變數。

3。 download_path：/iCloud

必須，否則預設為/home/${user}/iCloud。

如下圖所示：

十、點選右下角“應用”，返回到建立容器主介面，點選“下一步”，最後點選“完成”啟動建立好的容器。

十一、回到Docker介面，雙擊剛剛建立好的“icloudpd-xlang”容器，檢視日誌，可以看到容器的執行情況，右下角轉圈圈的圖示多重新整理幾次，會看到下面的錯誤提示，就可以進入最激動人心的金鑰檔案建立的過程。

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

sync-icloud。sh ——Initialise

INFO      - Example： docker exec -it icloudpd sync-icloud。sh ——InitialiseINFO     Restarting in 5 minutes。。。

如下圖所示：

十二、好了，到了要屏住呼吸的時刻了：1。切換到【終端機】一欄，點選【新增】右側的下拉小箭頭；

2。選擇【透過命令啟動】；

3。在彈出的對話方塊輸入“/bin/sh”後點擊【確定】；

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位數字的簡訊驗證碼，回車後完成二次驗證檔案的建立。

Please choose an option： ［0］： 0

Please enter two-factor authentication code： 123456

十四、所有配置到此結束，重啟容器，檢視日誌，看到以下內容，說明執行成功，在iCloud中生成檔案列表，等著自動下載iCloud照片即可，預設為24小時增量下載一次，預設下載原始尺寸檔案。

用上述方法，

下載iCloud上12740個原尺寸照片及影片，

用時9小時45分鐘完成，

而採用iPhone下載，

從2月6日18點52分13秒開始，

到現在（2月9日18點56分）剛好72個小時，

還剩5660個檔案等待下載中，

期間無數次因為手機記憶體被佔滿，

導致微信無法使用（提示微信正常使用需5。4G空間），

只能刪除已下載已備份的內容，

來騰出一點執行空間。

一些擴充套件小知識：

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的一些擴充套件功能：

小提示：以下變數均可以在容器停止執行時進行增改，來調整相應的設定。

1。設定同步時間週期，預設為86400秒（24小時），自動運行同步iCloud上新增的 內容，如需修改，可在建立容器時，新增一下變數

synchronisation_interval

，並設定相應的值，例如43200（12小時）、129600（36小時）等，理論上設定為1秒也是可以的，但是蘋果傾向於限制過於頻繁的訪問其伺服器連結，預設設定個人認為是最佳值，iPhone會立即將檔案上傳到iCloud，如果手機丟失，當天拍攝的內容在iCloud也是安全的，容器會在晚上執行時下載這些內容。

synchronisation_interval：43200

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：medium

photo_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。

以上就是一般用得到的變數設定，如需瞭解其它不常用的功能設定，可以訪問【boredazfcuk/icloudpd】作者在Docker Hub頁面，地址：https：//registry。hub。docker。com/r/boredazfcuk/icloudpd/

好了，教程到此結束，那麼多照片那麼好看、值得紀念，是應該好好儲存，祝大家配置順利，使用愉快！熟練的話，2分鐘應該是可以配置好的。

我是王小浪，一個很懶的人，所以很少會耐心出教程，本來準備錄個影片的，但是因為懶，不準備出了，我要去帶娃子了，以後再檢查是否有錯別字。