用 Docker 架設可多人同步的 Obsidian 筆記伺服器

Last Updated on 2025-08-18 by william

obsidian 作為地端可離線最強的筆記軟體，若docker自架「可以多人協同合作的 obsidian 伺服器」，就如虎添翼，功能更全面了。

雖然 obsidian 付費後，簡簡單單就能做到同步功能，但有些公司很謹慎，系統盡量都用地端，不想跟外面的系統”勾勾纏”，那你看到本篇文章就賺到了。

• 首先咱門要準備好地端的 docker 環境
  這部分就不多著墨，有興趣可參考這裡，或網路上找文章自行建立。

• 接下來安裝同步用伺服器
  
  github obsidian-sync-share

docker run -d \
--name obsidian-sync-share-server \
-p 8800:8080 \
-v "/root/obsidian-sync-share-server/user_store:/app/user_store" \
alterzz/obsidian-sync-share-server

docker run -d \
--name obsidian-sync-share-server \
-p 8800:8080 \
-v "/root/obsidian-sync-share-server/user_store:/app/user_store" \
alterzz/obsidian-sync-share-server

我們目標很明確，公司地端用，要簡單粗暴，這裡不使用加密(https)方式架設，若需要加密，建議用反向代理伺服器處裡。

• obsidian 安裝外掛

直接執行 obsidian 搜尋 notes sync share 安裝。

如下圖所示：
1. Server 部分請輸入安裝的伺服器網址
2. User 輸入帳號密碼，系統判斷第一次輸入，就會自動建立，請務必自行記錄下來，團隊需要使用。其他團隊成員接著安裝外掛後，輸入相同帳號密碼，並且點選 login 即可
3. Auto-Run 請設定定期同步，這裡建議選一或五分鐘進行同步
4. 若需要用到 git 的，請自行研究，我自己是用其他 git 外掛

以上安裝完畢，我們可以開始進行測試，先前有建議每一或五分鐘就自動同步。
另外請養成習慣，每次編輯就按下同步按鈕，如下圖所示：

這樣其他使用相同帳號登入的團隊成員，就可以收到同步資料，當然該成員修改的也會同步到其他成員，這樣就大功告成了。

可惜這個系統無法做到真正共筆協同合作，相同筆記被別人修改，若來不及同步到自己這邊，自己卻修改則會蓋掉之前的內容(race condition)；若是這樣就必須輔以 git 來進行版控追查被蓋掉的資料。

這外掛2023年後就沒更新了，但試用結果還算ok

今天測試其 git 功能，發現定期同步，會造成無資料異動 也強制提交( commit )，因此緊急修改一版，插件作者也很爽快地合併 🙂