Fast Note Sync 自架同步實測，把筆記庫開放給 AI 讀寫

用 AI 摘要這篇文章：

ChatGPT Claude Perplexity Google Grok

Fast Note Sync 是一套「插件加自架伺服器」的 Obsidian 筆記同步方案：插件免費開源、已經上架官方社群市場，後端則是一套你自己架的 Go 服務。實際把伺服器架起來、建帳號、寫筆記、再讓 AI 讀回來之後，我的判斷是這樣：它換到兩件官方付費同步做不到的事，跨裝置的即時同步，加上一個讓 AI 直接讀寫筆記庫的機器入口；代價則是筆記的每一個字都以明文形式住在伺服器上，而且上鎖的責任整個在你。它適合手上有一台常開機器、願意讀文件、能接受這條信任邊界的人。只想按一個按鈕就把同步解決的人，留在官方方案比較省事。

一條 Docker 指令就能開張，但註冊的門是虛掩的

實測當天（2026-10-20）抓下來的官方映像檔是 v3.6.1，映像檔建立時間 2026-08-14。docker run 帶上連接埠 9000 與兩個資料夾掛載，容器開機即用，健康檢查端點回報版本與資料庫連線狀態。啟動紀錄裡還能看到它主動去 GitHub 查最新版本，查不到就退回備援來源，也就是說伺服器本身會提醒你升級。整個部署不到一分鐘，對用過 Docker 的人毫無門檻；這種「一條指令起服務」的體驗，跟之前實測 OpenUI 自架是同一個等級的順（見〈OpenUI 開源 AI 介面產生器〉）。

第一個有意思的細節出現在註冊。直接對註冊 API 發請求會被擋下，回覆「這個操作僅限網頁管理介面的客戶端」，但所謂的限制只是檢查請求表頭裡的客戶端識別欄位。把表頭補上再送一次，帳號就建好了。這層防線擋得住介面層級的誤用，擋不住任何會寫指令碼的人。伺服器設定檔裡開放註冊預設為開，超級管理員欄位預設為零，於是第一個註冊的人登入後會在儀表板看到「建議把自己設為管理員」的提示視窗。換句話說，如果你把這台伺服器直接暴露在公網又沒改設定，任何掃到這個連接埠的人都能建帳號，然後收到同一份管理員邀請。要對外開放，第一步永遠是進設定把開放註冊關掉。

Pin

管理介面照瀏覽器語言顯示，繁中介面是原生內建而非機器翻譯，登入頁、筆記庫管理、備份任務、Git 自動化全都是繁中。不過在地化沒有做完，部分系統訊息還是簡體字，看得出翻譯仍在持續補。整體介面是現代化的管理後台，主題跟著系統設定走、深淺色都能切換，左側一排功能圖示，右側卡片式資訊流，對看慣自架儀表板的人很親切。

你的筆記在伺服器上是一個明文的資料夾

用管理介面建好筆記庫，再透過 REST API 寫入一筆測試筆記之後，我進容器裡看它實際落在磁碟上的長相：每個使用者一個資料夾，每筆筆記一個檔案，內容就是純文字全文，開檔即讀。旁邊另有一組全文搜尋的索引檔與每個使用者獨立的 SQLite 資料庫檔，也就是說伺服器不只存放筆記，還替內容建了可搜尋的索引。資料庫支援 SQLite、MySQL、PostgreSQL 三種，個人用 SQLite 就夠，團隊規模再換大的。

這是整套方案最核心的信任邊界。官方付費同步走端對端加密，伺服器看不到內容；Fast Note Sync 的開發藍圖裡，端對端加密仍然是未勾選的未完成項目，現階段所有內容以明文同步、明文落地。自己架的時候信任圈縮小到你自己的機器，多數人可以接受；但機器被入侵、備份外流，或哪天你把服務搬去共用主機，每一步都要記得這個前提。它附帶的備份功能可以把整庫打包丟到 S3、R2、WebDAV 或本地檔案系統，支援排程全量或增量備份、保留天數自動清理，還能單向鏡像同步到遠端儲存。這些備份同樣是明文，等於把信任邊界再往外畫一圈，圈到哪裡要自己想清楚。這也是所有自架服務的共同課題，Android 備份工具那篇的結論在這裡一樣適用：還原端的可靠性比備份端更值得你花時間（見〈Android-DataBackup 開源備份工具〉）。

誠實說，同步引擎本身就是難寫的軟體。變更紀錄裡 2026 年 7 月的大版本曾修掉一個「兩邊同時寫同一筆筆記，後寫的內容被靜默丟掉但回報成功」的資料遺失問題，也修過檔案重新命名失敗被吞掉、導致資料庫與磁碟不一致的案例。這些修復是加分而不是扣分，願意把這類問題寫清楚並修掉的專案值得信任；但它同時提醒你，任何同步工具上線前，自己的版本控管或額外備份不該省。另外兩個版本門檻值得記住：附件同步需要插件 1.0 版配伺服器 0.9 版以上，設定檔同步則官方自己標註還在測試階段、建議謹慎使用，第一次全庫同步前先把重要庫另存一份。

MCP 整合是真的：26 個工具讓 AI 直接讀寫筆記庫

這套服務最近的宣傳重點是把筆記庫變成「個人 AI 知識庫」，聽起來像行銷話術，實測結果是真的。對 MCP 端點完成初始化交握、送出工具清單請求後，回來的是 26 個工具：筆記的建立、更新、增補結尾、插入開頭、取代內容、改檔名、讀取、列出、刪除、救回，加上查反向連結與正向連結、修改前言屬性；檔案與筆記庫層級也各有整套操作。我用其中一個讀取工具，把先前用 REST 寫入的筆記完整讀了回來，寫入與讀取兩條路都通，這一段不是看文件抄來的。

對使用者的意義是：Claude Code、Cursor 這類支援 MCP 的客戶端，填上伺服器的 MCP 端點與權杖，就能把你的筆記庫當成可讀寫的資料來源（新版客戶端走 StreamableHTTP 標準傳輸，舊客戶端留有 SSE 相容模式）。AI 助手整理完資料直接寫進筆記，或反過來引用你既有的筆記當查證素材，都不需要匯出匯入；透過 MCP 做的修改，也會照樣即時同步到其他裝置上的 Obsidian。管理介面本身也能直接新增與編輯筆記，等於手機沒裝 App 時還有一個網頁端的保險。REST API 獨立存在，附有 OpenAPI 文件，其中增補、開頭插入、取代這幾個端點特別適合接自動化腳本，替還不支援 MCP 的舊工具留了路。

權杖的權限模型做得比多數自架工具細：可以限定協定（REST 或 WebSocket）、客戶端類型、功能範圍（讀或寫），甚至綁定 IP、綁定使用者代理、限定只能碰哪幾個筆記庫，效期天數自選。最小權限原則在這裡是做得到的，例如發一枚只能讀單一筆記庫的權杖給 AI 用，風險就有上限。在管理介面的筆記庫頁面還有一個「授權 Obsidian」按鈕，按下去會自動喚起桌面版的 Obsidian 完成授欉資訊轉移，不想用一鍵流程也可以手動複製貼上，第一次設定不用對著文件逐字抄。

Pin

離線怎麼活：自動合併、歷史版本與垃圾桶

同步工具真正的考驗在斷線之後。這套的設計是離線期間的編輯會在重新連線時自動合併，而不是只留最新版本蓋掉舊的；離線期間的刪除也會在重連後補同步，避免某台裝置上的刪除永遠傳不出去。衝突的深度處理仍然在開發藍圖上（更完整的衝突解決機制列為未來項），所以兩台裝置同時改同一筆筆記同一段的情境，目前依靠自動合併與歷史版本兜底，真要較真就得手動比對。

歷史版本是伺服器端的功能，管理介面與插件裡都能看每筆筆記的修改紀錄並還原到任一版本，需要伺服器 1.2 版以上。刪掉的筆記先進垃圾桶，可以救回，附件的垃圾桶還原則列為後續補上。另外一個對行動裝置使用者友善的設計是附件雲端預覽：圖片、影片之類的附件可以不同步到手機本地，需要時才線上看，儲存空間緊張的人能把同步白名單與排除規則設好，把大檔留在伺服器或丟給 WebDAV 等第三方儲存。PDF 的閱讀進度也會同步，跨裝置接著讀不用手動翻頁。

Pin

大庫的傳輸行為也有得調。3.6 版起的同步協定改用滑動視窗管線，多批上傳與分頁下載可以同時在途，不必像舊版那樣一批確認完才送下一批；視窗大小出廠值是上傳八批、下載四頁，遇到不穩的網路環境可以把任一邊設成零，立刻退回逐批確認的保守模式，等於內建了一顆保險開關。要提醒的是附件同步對大檔沒有魔法，官方文件明說大附件會拉長同步時間，錄影檔、素材庫這類內容更適合靠排除規則分流到專門的儲存，而不是全部塞進同步佇列。

它預設你懂自己在做什麼

把實測中碰到的安全相關細節集中攤開，會看到一致的性格：這套工具假設部署者是自己看得懂設定檔的人。開放註冊預設開、註冊閘門只是表頭、通訊預設走 HTTP 明文，加密連線要自己加 Nginx 反向代理，倉庫有附範本設定檔照抄即可。可信代理白名單預設只信任本機回環位址、MCP 的 DNS 重綁保護預設開啟，看得出作者懂這些攻擊面，只是把「對外公開」的決策留給你。

分享功能值得單獨講。任何一筆筆記都能一鍵產生分享連結，拿到連結的人不需要帳號就能在網頁上讀到全文，筆記裡引用的圖片、音訊、影片也會被自動解析進分享頁，可以再加密碼、設到期日、看存取統計。問題在預設值：分享建立時到期日是空值，也就是永不過期。分享連結要當成公開網址來管理，分享一時、外流一世。

權杖的衛生同樣要自己留意。網頁介面每次登入都會自動簽發一枚效期七天的權杖，舊的不會自動失效；實測反覆登入十多次之後，權杖清單累積到十三枚各自有效的憑證，而清理功能只會清掉已過期的那種。插件端把權杖存進本機設定時做了一層混淆，但讀原始碼會看到，混淆用的金鑰是寫死在程式裡的固定常數，做法是每個位元組對同一個值做互斥或運算。原始碼註解還留著一段歷史：早期版本的混淆金鑰綁定筆記庫名稱，結果使用者透過 iCloud 改了庫名之後金鑰跟著變，舊密文解成亂碼，這正是某些人設定莫名消失的根源，後來才改成固定常數。這層混淆防的是路過的人翻設定檔，防不了任何拿到檔案又看得懂原始碼的人。這些都不是致命傷，而是自架軟體的常見姿態：方便優先，邊界留給你自己畫。

維護在放緩：主線凍結兩個月，修復排隊等合併

專案活躍度呈現一個明顯的反差。一方面，插件已經可以在官方社群市場搜尋 Fast Note Sync 直接安裝，市場描述裡並且明寫「未經 Obsidian 員工人工審核」；如果你看過的教學說它還沒上官方市場、需要手動下載安裝，那是舊資訊，現在兩條路都通。手動安裝仍開放給進階使用者：從發佈頁抓三個檔案丟進插件資料夾即可。兩個倉庫都是 Apache-2.0 授權，插件約三千一百顆星、伺服器兩千四百多顆星，附一百七十多個分支，對 2025 年 3 月才開始的專案來說是健康的數字。開發者以 Ko-fi 與微信打賞雙軌接受贊助，中國大陸使用者另有鏡像倉庫可用。

另一方面，兩個倉庫的主分支最後一次合併都停在 2026 年 8 月 14 日，到實測當天已經兩個月沒有新程式碼進主線。單是插件倉庫，等待合併的修復提案就有十三個，最新一個是 10 月 19 日提交的「防止筆記庫檔案事件靜默丟失」，修的是檔案監看競態這類同步深水區的問題；議題區流動沒停，修復也持續產出，只是合併速度慢了下來，開放議題累積到九十個。部署前該知道的現況是：你能裝到的是 7 月 20 日的插件 2.4.0 與 8 月 14 日的伺服器 3.6.1，而一些已知問題的修復還排在佇列裡。另外插件要求 Obsidian 1.8.7 以上，用戶端太舊要先升級。

三種安裝方式，以及它和官方同步真正的差別

和官方付費同步的比較軸其實只有三條。錢：自架的成本是機器與你的時間，沒有月費，這條對學生與重度使用者有實感。隱私：官方有端對端加密，這裡是明文加自負邊界。能力：官方同步只做同步，這裡多了 REST、MCP、分享頁、版本歷史、垃圾桶、Git 自動化與多種儲存後端的備份，等於一個小型的個人筆記伺服平台。Git 自動化值得一提：設定遠端倉庫後，筆記與附件的變更會自動提交並推送，等於在伺服器備份之外再疊一層版本控制，對工程背景的使用者是免費的保險。

沒有伺服器的人不必硬上，官方同步或雲端硬碟仍然是最省心的答案；只要你有一台常開的機器，這套東西就能把筆記庫升級成可程式化的資產。想在無圖形介面的 Linux 主機上同步，社群也寫了 Python 與 Go 的命令列客戶端。至於「免費同步服務的界線畫在哪」這種商業模式問題，可以對照之前寫過的書籤同步服務案例（見〈藏趣雲書籤同步〉），自架方案的好處正是界線由你決定。

誰該自架，誰該留在官方方案

自架值得的情境很明確：你已經有一台機器在跑服務，想要多裝置即時同步之外再拿到 AI 讀寫入口，而且你能接受筆記明文住在自己機器上這條邊界，並願意花一個下午做關註冊、上 HTTPS、設備份三件事。筆記量級也誠實說：變更紀錄宣稱新版同步管線讓大量筆記的全庫同步快了數倍（作者自述的實測數字，未獨立重測），一般人的幾千則筆記等級不必擔心搬不動。

反過來，如果你從沒碰過伺服器、筆記裡有高度敏感內容、或只是想要手機電腦同步，官方同步的月費仍然是對的選擇，把時間花在寫筆記本上。Markdown 工具鏈的生態已經很完整（見〈markmap Markdown 心智圖〉），同步這塊選自架或託管，差別只在你要不要自己當營運商。

我的建議順序是先用 Docker 在本機把整套跑起來，裝插件連上去，同步走幾天確認行為符合預期，再決定要不要搬到對外主機。搬出去之前把開放註冊關掉、加上 HTTPS、替權杖設好期限，這三步做完，它就是一套誠實且有能力的自架同步系統；跳過這三步，它就是一台對全世界開放的明文筆記伺服器。差別不在軟體，在你。