跳到正文
Obsidian × iCloud的設定步驟

ObsidianiCloud同步設定步驟

本頁面由日文原文機器翻譯而成。 閱讀日文原文

將iPhone和Mac的Obsidian連線到iCloud Drive的同一個保管庫的步驟。 確認相同的Apple Account、保管庫的放置位置、終端上的檔案。 從SimpleMemo開始追記時,也要設定連線、儲存地址,分別確認寫入和其他終端的同步。

閱讀正文
本頁目錄

Obsidian用iCloud同步怎麼辦?

一言以蔽之

開啟iCloud Drive後,在“iCloud Drive → Obsidian”資料夾中建立保管庫。 iPhone的話,在新建保管庫時開啟“儲存到iCloud”即可,如果是Mac的話,只需在檔案選擇器中選擇iCloud Drive中的Obsidian資料夾即可。

2臺從“作為保管庫開啟資料夾”開始指定相同的資料夾。 官方檔案提醒放置位置,如果在iCloud Drive/Obsidian/[保管庫名]之外製作的話,可能會出現同步問題。

步驟1: 開啟iCloud Drive

在同步的終端上登入同一個Apple Account,啟用iCloud Drive。 設定畫面的名稱因OS版本而異,所以Apple的設定指南也請確認。

  1. iPhone / iPad
    “設定”→自己的賬戶→在“iCloud”中開啟Drive,開啟“同步這個iPhone”或“同步這個iPad”。
  2. Mac
    “系統設定”→自己的賬戶→“iCloud”→“Drive”開啟“同步此Mac”。

步驟2:在iCloud裡面建造保管庫

用第一個1臺製作。 從iPhone和Mac哪個製作都可以,但是製作方法不一樣。 iPhone是切換1個,Mac是自己選擇資料夾。

用iPhone / iPad製作時

  1. Obsidian,點選“新建保管庫”。
  2. 輸入保管庫的名字。
  3. 開啟“儲存到iCloud”。 這裡是本體。 在關閉狀態下製作的話,那個保管庫只留在終端裡面。
  4. 點選“製作”。

用Mac製作時

  1. Obsidian,選擇“新建保管庫”。
  2. 檔案選擇器移動到iCloud Drive → Obsidian。
  3. 製作保管庫用的資料夾,並命名。
  4. 選擇“製作”就完成了。
為什麼在“Obsidian”資料夾裡

iCloud Drive中,有應用程式為自己使用的領域。 帶有Obsidian應用程式圖示的“Obsidian”資料夾就是那個,iOS版的Obsidian讀寫就是這裡面。 用相同名字自己製作的純資料夾是另一回事,官方檔案“請不要使用沒有應用程式圖示的純資料夾”點名警告。

步驟3:2臺開啟同一個保管庫

2臺不新建。 去開啟已有的資料夾。 如果在這裡新建的話,就會排列一個同名的保管庫2。

  1. 在2臺的Mac或iPhone上開啟Obsidian。
  2. 開啟保管庫切換器,選擇“作為保管庫開啟資料夾”。
  3. iCloud Drive → Obsidian,選擇1臺製作的保管庫資料夾。

官方程式確認的3專案

官方指南提醒注意的是保管庫的位置、檔案的退避、同步方式的混合。 確認以下專案,操作後用同一個筆記確認反映。

絆倒 1

保管庫在“Obsidian”資料夾外面

正確的位置是iCloud Drive/Obsidian/[保管庫名]。 iCloud Drive正下方和“檔案”中建造的保管庫,從iOS版的Obsidian看不到,會產生同步問題。 確認方法如下。

  1. 用iPhone開啟“檔案”App。
  2. 點選“瀏覽”,選擇“地點”下方的iCloud Drive。
  3. 保管庫在Obsidian資料夾中。 在更改位置之前,請備份到另一個位置,確認不要覆蓋同名的保管庫。 變更後用Obsidian開啟,確認筆記本和其他終端的同步。
絆倒 2

iCloud正在從終端撤離檔案

iCloud有將未使用的檔案實體從終端中驅逐出來,只留在雲端的機制。 Obsidian可以直接訪問保管庫裡的東西,如果沒有實體的話,就會被當作找不到檔案。 官方文件的FAQ明確指出,這種退避是同步問題的原因。 處理方式在macOS的版本中不同。

環境 要做的事情 影響範圍
macOS 15(紅杉)以後 iCloud Drive內的Obsidian資料夾右擊,選擇“維持下載” 只有Obsidian的資料夾
macOS 14(Sonoma)以前 iCloud設定的關閉“最佳化Mac儲存” 終端上的所有iCloud儲存

官方文件將此定位為“是任意的,但為了保持讀取速度,強烈推薦”。 macOS 14之前的設定除了Obsidian以外也有效果,所以需要了解這一點後再關閉。

絆倒 3

重複同步方式

官方文件在“避免混用同步服務”一節中說明,不要用多個服務同步同一個庫,例如同時使用 Obsidian Sync 與 iCloud。這是為了防止資料衝突或損壞。如果免費的 iCloud 已能滿足需求,但仍想試用官方 Sync,請先將同步方式統一為其中一種,再進行切換。

出於同樣的原因,避免Windows的iCloud Drive。 官方文件明確指出,iCloud的推薦系統為macOS、iOS、iPadOS,Windows上的iCloud Drive可能會發生檔案的重複和損壞。 如果同時使用Windows和Android的話,就會選擇iCloud以外的方式。

iCloud攜帶的是“整個資料夾”

保管庫是只是一個資料夾,裡面除了寫的Markdown檔案外,還有包含設定的.obsidian資料夾。 iCloud Drive以資料夾為單位同步,所以不僅是筆記,設定也會一起攜帶。 對很多人來說,這是方便的預設(主題和熱鍵都在2臺上)。

如果想按終端劃分設定的話,官方文件介紹按終端更改設定資料夾的功能(Syncthing的章節中也寫著“如果想按終端劃分設定,請將.obsidian從同步物件中移除”,前提是設定在保管庫中)。 iCloud沒有排除指定,如果想分開的話就使用這個功能。

官方資料和實機確認範圍

2026年9月30日重讀了Obsidian官方的英語・日語同步指南。 參考了關於保管庫的位置、下載狀態、同步方式的混合的指南。 翻譯的更新時間可能因語言而異,如果操作不一致,也請確認英文版。 閱讀資料和實施,以及在終端之間同步是另外的確認。 這次更新沒有實際測量iCloud的同步時間和同時編輯時的行為。

iCloud上面的保管庫,從外面寫入

SimpleMemo可以直接在允許訪問的保管庫的筆記本上補充。 在iPhone上寫入和透過iCloud在其他終端上反映是不同的階段。 首先確認儲存地址的寫入,然後確認Mac等相同的筆記。

📁 設定連線和保管庫的訪問
在iPhone上開啟Obsidian連線,從檔案App中選擇可用的保管庫資料夾允許訪問。 訪問資訊會保留,但移動或許可權變更後可能需要重新選擇。 可以直接寫入選定的資料夾時,無需開啟Obsidian即可新增。
📝 留言地址
追記地址是設定的每日筆記或Inbox筆記。 確認檔名、儲存位置,開啟“Obsidian 寫入測試”中顯示的筆記,確認測試文。每日筆記的補充詳情也可以參考。
🤝 按順序處理寫入
實現中NSFileCoordinator來協調檔案訪問,並透過佇列依次處理寫入。這是應對寫入衝突的措施,並不保證在包括其他裝置同時編輯和 iCloud 同步在內的所有環節中,都不會遺漏寫入。
⏳ 沒寫的部分
無法立即寫入的專案,在對應的路徑中保留在終端內,在應用程式的正面迴歸時再次嘗試。 保留正文是用AES-GCM加密儲存的實現。 請確認保留、失敗顯示和儲存目的地的筆記。 在iCloud上反映到其他終端的時間會根據通訊、檔案的狀態而變化,不一定是一定的秒數。
確認在保管庫的留言

開啟連線,設定保管庫和補充地址,確認簡短的測試文。 寫入測試不傳送郵件,之後確認iCloud同步到其他終端。

從App Store下載
App Store下載二維碼 PC使用者用智慧手機讀取

常見問題

保管庫放在iCloud Drive的什麼地方好呢?
不是iCloud Drive的正下方,而是iCloud Drive中的“Obsidian”資料夾中。 官方檔案是 iCloud Drive/Obsidian/[保管庫名] 這一位置,並明確要求使用帶有 Obsidian 應用圖示的資料夾,不要使用沒有該圖示的普通資料夾。請在“檔案”App 中開啟“瀏覽 → iCloud Drive”,確認庫位於 Obsidian 資料夾內。
在iPhone中筆記本是空的或者不是最新的
檔案的未下載,還要確認賬戶、保管庫的位置、iCloud Drive的狀態。 Obsidian官方解釋說,檔案退避可能會引起同步問題。 在Mac端,確認macOS 15以後的“保持下載”、14之前的“最佳化Mac儲存”的設定。 僅透過Mac的設定變更,iPhone方面的問題不一定能解決。
iCloud和官方Obsidian Sync都可以同時使用嗎?
官方檔案以“避免同步服務的混合”為指導,不要將同一個保管庫同步到多個服務(例如:Obsidian Sync和iCloud同時使用)。 理由是為了防止資料的衝突和損壞。 1個保管庫請保留1個同步方法。 方式本身的比較是同步方法總結。
Windows的iCloud Drive也可以同步嗎?
官方檔案明確規定,iCloud的推薦系統為macOS・iOS・iPadOS,Windows上的iCloud Drive可能會發生檔案重複和損壞。 如果想包含Windows和Android的話,請選擇iCloud以外的同步方法。
SimpleMemo可以寫入iCloud上面的保管庫嗎?
需要訪問對應的保管庫和Obsidian連線,設定追記地址。 直接寫入資料夾的話,不開啟Obsidian就追加。 首先在“Obsidian 寫入測試”中確認儲存目的地的正文,然後用其他終端開啟相同的筆記,確認iCloud的反映。 寫入、同步時間、同時編輯時的成功不能一律保證。
驗證環境和驗證範圍

更新確認:2026年9月30日。 核對了Obsidian官方的同步指南和Apple的iCloud Drive設定指南、SimpleMemo的保管庫訪問、寫入、保留處理的來源。 沒有進行實機測量。 同步時間、同時編輯時的結果、分發版中所有條件的動作,僅憑這個核對無法確認。 2026年8月27日記載的Linux資料比較也不是iCloud的實機驗證。 設定變更後,請確認簡短的測試文的儲存和其他終端的反映。

相關頁面

參考文獻