Syncthing on KnightLi的博客

Syncthing 多設備多資料夾怎麼管理？拓撲、命名和版本控制

Sun, 31 May 2026 12:23:55 +0800

Syncthing 系列目錄

Syncthing 設備一多，資料夾一多，如果不提前規劃，很快就會變亂。典型情況是：手機、平板、筆電、桌機、NAS 都在同步；資料夾裡又有照片、工作文件、程式碼專案、微信備份、電子書。每一台設備都可能修改，每一個目錄都可能共享，最後你很難判斷「這個檔案到底從哪裡來，又會同步到哪裡去」。

要把 Syncthing 用穩，核心不是多裝幾個客戶端，而是建立一套管理規則：

拓撲上使用星型結構。
資料夾上統一 ID 和路徑。
設備關係上使用引入者。
資料方向上區分備份和雙向同步。
中心節點上開啟版本控制。
暫存檔案用忽略規則過濾。

拓撲：放棄全連接，優先星型

Syncthing 是 P2P 對等架構，但不代表所有設備都要兩兩配對。

如果 5 台設備互相全連接，需要維護 10 組設備關係。新增一個資料夾時，還要在多台設備上接收、設定路徑、確認共享。設備越多，管理成本越高。

更推薦的方式是星型拓撲。

選一台長期在線、空間大、網路穩定的設備作為中心節點：

NAS
群暉
軟路由
迷你主機
24 小時開機的電腦

其他設備只和中心節點配對：

手機 ----\
平板 -----\
筆電 ---- NAS
桌機 ---/

手機不直接加入筆電，筆電也不直接加入桌機。手機要把照片同步給電腦，先同步到 NAS，再由 NAS 同步給電腦。

這樣做的好處是：

新設備只需要和 NAS 配對。
資料夾關係集中在 NAS 上管理。
NAS 可以統一做版本保留。
設備離線時，NAS 仍然能作為緩衝點。

缺點是 NAS 變得更重要了。它應該穩定運作，並且需要單獨備份。

Folder ID 比資料夾標籤更重要

在 Syncthing 中，真正識別一個同步資料夾的是 Folder ID，不是你看到的標籤名稱。

標籤只是顯示名稱，可以在不同設備上不一樣。Folder ID 才是判斷「這些設備上的資料夾是否屬於同一個同步組」的關鍵。

所以，在第一台設備建立資料夾時，建議手動指定規範 ID。

例如：

notes-main
work-docs
backup-pixel-photos
backup-iphone-photos
media-ebooks
code-projects

不要使用隨手產生的隨機 ID，也不要只寫 test、sync、new-folder 這類無法長期維護的名字。

命名規則可以簡單一些：

雙向同步：notes-main、work-docs
手機備份：backup-pixel-photos、backup-iphone-photos
資料分發：media-ebooks、media-music
程式碼目錄：code-projects

以後在其他設備接收共享時，只要看到 Folder ID，就能判斷它是什麼用途。

中心節點路徑要規範

在 NAS 或中心電腦上，建議建立一個統一的 Syncthing 根目錄。

例如：

/volume1/Syncthing/
├── Phone_Backup/
│   ├── iPhone15_DCIM/
│   └── Pixel7_DCIM/
├── Work/
│   ├── Office_Docs/
│   └── Coding_Projects/
├── Notes/
│   └── Main_Notes/
└── Media/
    └── eBooks/

不要把同步目錄散落在系統各處。散落的目錄短期方便，長期一定難維護。

推薦原則：

所有 Syncthing 管理的目錄放在統一根目錄下。
手機備份、工作文件、媒體資料分區存放。
資料夾名稱體現用途，不體現臨時設備狀態。
不把系統目錄、下載快取目錄直接作為長期同步目錄。

如果 Syncthing 跑在 Docker 中，還要注意容器內路徑和宿主機路徑的對應關係。

例如宿主機目錄：

`1`	`/volume1/Syncthing/Phone_Backup/iPhone15_DCIM`

映射到容器內：

`1`	`/var/syncthing/Phone_Backup/iPhone15_DCIM`

Web UI 裡填寫的是容器內路徑，不是宿主機路徑。

引入者：減少多設備配對成本

Syncthing 的 Introducer，中文介面通常稱為「引入者」。

它適合星型拓撲。

做法是：把 NAS 設為引入者。之後新設備只要和 NAS 配對，NAS 就可以把已知設備和共享關係介紹給新設備，減少你在各個設備之間重複掃碼、重複新增的工作。

適合：

家裡有多台電腦和手機。
NAS 是長期中心節點。
經常新增設備。
希望減少設備配對操作。

但不要亂用。

建議：

只把 NAS 或主伺服器設為引入者。
普通手機、平板、臨時電腦不要設為引入者。
新設備加入後，檢查它被自動新增了哪些設備和資料夾。
不信任的設備不要進入引入者管理範圍。

引入者能提高效率，也會擴大自動關聯範圍。它適合有清晰中心節點的網路，不適合混亂的臨時設備環境。

區分備份和雙向同步

多資料夾管理裡，最重要的一件事是：不要所有目錄都用 Send & Receive。

不同目錄的資料方向不一樣。

手機照片備份

手機端：

`1`	`Send Only`

NAS 端：

`1`	`Receive Only`

這樣手機負責發送照片，NAS 負責接收保存。手機清理空間、NAS 整理目錄時，都不容易互相影響。

多端文件和筆記

電腦端：

`1`	`Send & Receive`

NAS 端：

`1`	`Send & Receive`

手機端是否加入雙向同步，要看你是否真的在手機上編輯這些檔案。如果手機只查看資料，可以考慮 Receive Only。

資料分發

NAS 端：

`1`	`Send Only`

其他設備：

`1`	`Receive Only`

適合電子書、安裝包、參考資料這類中心分發目錄。

備份目錄

主設備：

`1`	`Send Only`

備份機：

`1`	`Receive Only`

再配合備份機端版本控制或快照。

NAS 上開啟檔案版本控制

多設備同步最怕誤刪和誤覆蓋。

例如：

某台電腦誤刪了工作文件。
手機清理工具刪了相簿目錄。
兩台設備同時改了同一份筆記。
某個同步規則寫錯，把空目錄同步過去。

因此，中心節點最好開啟檔案版本控制。

在 NAS 的 Syncthing Web UI 中：

打開對應資料夾設定。
進入檔案版本控制。
選擇合適的版本策略。

常用選擇是 Staggered File Versioning，也就是階段版本控制。它會按時間間隔保留歷史版本，越舊保留得越稀疏。

也可以用更簡單的策略：

Trash Can File Versioning：類似回收站。
Simple File Versioning：保留固定數量版本。
Staggered File Versioning：按時間階段保留。

如果不知道選什麼，普通家庭 NAS 可以先從 Trash Can 或 Staggered 開始。

版本控制不是完整備份，但它是多設備同步裡的後悔藥。

用忽略規則過濾暫存檔案

多設備同步程式碼專案、文件目錄或聊天備份時，暫存檔案和快取很容易製造麻煩。

常見問題：

佔用大量頻寬。
產生無意義衝突。
不同系統產生不同快取檔案。
刪除目錄時被忽略檔案阻擋。

可以在資料夾設定的 Ignore Patterns 中新增規則。

通用暫存檔案：

1
2
3

(?d).DS_Store
(?d)Thumbs.db
(?d)*~

Node / Python / Java 專案：

(?d)node_modules/
(?d)__pycache__/
(?d).pytest_cache/
(?d)target/

如果程式碼專案本身已經用 Git 管理，通常不建議用 Syncthing 同步 .git 目錄。可以忽略：

`1`	`(?d).git/`

(?d) 的意思是：如果整個目錄準備被刪除，Syncthing 可以刪除這些本地產生的忽略檔案，不會因為殘留快取而阻止目錄刪除。

忽略規則不要一次寫太複雜。先覆蓋最明顯的快取和暫存檔案，再根據實際衝突慢慢調整。

多資料夾命名範例

可以建立一套固定命名方式。

手機照片：

1
2
3

Folder ID: backup-pixel-photos
Label: Pixel Photos
NAS Path: /volume1/Syncthing/Phone_Backup/Pixel7_DCIM

iPhone 照片：

1
2
3

Folder ID: backup-iphone-photos
Label: iPhone Photos
NAS Path: /volume1/Syncthing/Phone_Backup/iPhone15_DCIM

主筆記庫：

1
2
3

Folder ID: notes-main
Label: Main Notes
NAS Path: /volume1/Syncthing/Notes/Main_Notes

工作文件：

1
2
3

Folder ID: work-docs
Label: Work Docs
NAS Path: /volume1/Syncthing/Work/Office_Docs

電子書：

1
2
3

Folder ID: media-ebooks
Label: eBooks
NAS Path: /volume1/Syncthing/Media/eBooks

只要 ID、標籤、路徑都有規律，多設備之後也不會失控。

總結

Syncthing 的自由度很高，但自由度越高，越需要規則。

多設備、多資料夾場景下，不建議做全連接網狀同步。更穩的方式是讓 NAS 或常開電腦做中心節點，統一 Folder ID、統一路徑、統一版本控制，再用資料夾類型區分備份、雙向同步和資料分發。

這樣既保留了 Syncthing 的 P2P 能力，又把日常管理收束到一台中心設備上。設備再多，資料夾再多，也不會變成一團亂線。

Syncthing 如何同步 iPhone 照片到電腦或 NAS

Sun, 31 May 2026 12:21:54 +0800

Syncthing 系列目錄

在 iPhone 上使用 Syncthing 同步照片，和 Android 很不一樣。

原因很簡單：iOS 系統更封閉，Syncthing 官方沒有提供正式 iOS 客戶端。想在 iPhone 上使用 Syncthing 協議，通常需要第三方相容客戶端。

常見選擇有兩個：

Mobius Sync：比較主流，體驗接近原生 App，部分能力可能需要付費解鎖，具體以 App Store 當前說明為準。
FSync：免費開源的 Syncthing iOS 客戶端。

如果目標是把 iPhone 相簿同步到電腦或 NAS，Mobius Sync 是更常見的選擇。下面以它為例整理配置流程。

先理解 iOS 上的限制

在 Android 上，Syncthing-Fork 可以透過背景服務、執行條件、電池白名單等方式長期執行。但 iOS 不允許第三方同步工具無限制背景常駐。

這意味著：

不能期待它像 NAS 一樣 24 小時同步。
App 進入背景後，同步時間可能很短。
大量照片最好主動打開 App 讓它同步完。
iCloud 最佳化儲存可能影響原圖讀取。

所以，iPhone 端更適合「定期打開 App 同步照片」，而不是完全無感的背景即時同步。

第一步：安裝客戶端並授予權限

在 App Store 安裝 Mobius Sync 後，第一次打開時要重點處理幾個權限。

通知權限

建議允許通知。它可以提示同步狀態、連線狀態或錯誤資訊。

本機網路權限

這個權限非常重要。

iOS 會單獨詢問 App 是否允許存取本機網路。如果不允許，iPhone 可能無法在區域網路內發現你的電腦、NAS 或 Syncthing 節點。

如果之前誤點了拒絕，可以到系統設定中重新開啟。

相簿存取權限

如果要同步照片，必須允許存取相簿。

建議選擇：

`1`	`Full Access to Photos`

如果只給有限照片存取權限，Mobius Sync 可能只能看到你選擇的那部分照片，後續新增照片也可能不同步。

第二步：iPhone 和電腦/NAS 配對

Syncthing 的配對邏輯仍然是互相加入裝置 ID。

在 iPhone 上：

打開 Mobius Sync。
進入 Settings。
打開 Device ID。
保持 QR code 畫面。

在電腦或 NAS 上：

打開 Syncthing Web UI。
點擊 新增遠端裝置。
掃描 iPhone 上的 QR code，或手動輸入裝置 ID。
給裝置起名，例如 My-iPhone。
儲存。

回到 iPhone，等待連線請求提示，然後點擊 Accept。

到這裡，iPhone 和電腦/NAS 已經互相信任，但還沒有共享相簿。

第三步：在 iPhone 上建立相簿同步資料夾

iOS 不像 Android 那樣直接讓你選擇 /DCIM/Camera 路徑。Mobius Sync 對系統相簿做了專門支援，配置時要選擇相簿類型。

在 Mobius Sync 中：

切換到 Folders。
點擊右上角 +。
新建資料夾。

關鍵欄位：

Folder Type：選擇 Camera Roll。
Folder Label：填寫容易識別的名字，例如 iPhone_Photos。
Folder ID：可以保留自動產生，也可以用穩定英文 ID。
Folder Path：保持預設，讓客戶端關聯 iOS 系統相簿。

然後在 Sharing 區域勾選剛剛配對的電腦或 NAS。

第四步：iPhone 端設為 Send Only

相簿同步通常是「手機發給 NAS」，不是雙向編輯。

因此，在 iPhone 端把資料夾類型設為：

`1`	`Send Only`

這樣 iPhone 負責把照片傳送出去，不接收電腦或 NAS 的反向修改。

這個設定可以降低誤操作風險。比如你在電腦端整理備份目錄時，不希望這些改動影響 iPhone 相簿。

但仍然要記住：Syncthing 是同步工具，不是完整備份系統。真正的長期照片安全，還需要 NAS 端快照、檔案版本或獨立備份。

第五步：在電腦或 NAS 端接收照片

iPhone 端儲存後，電腦或 NAS 的 Syncthing Web UI 會出現提示：

`1`	`Device My-iPhone wants to share folder iPhone_Photos`

點擊新增。

設定儲存路徑。

Windows 可以類似：

`1`	`D:\Backups\iPhone_Photos`

Linux 或 NAS 可以類似：

`1`	`/volume1/photos/iphone`

如果 Syncthing 跑在 Docker 中，要填寫容器內路徑。例如宿主機掛載：

`1`	`- /volume1/photos:/var/syncthing/photos`

Web UI 中應填寫：

`1`	`/var/syncthing/photos/iphone`

接收端建議設為 Receive Only

在電腦或 NAS 端，也建議把這個資料夾類型設為：

`1`	`Receive Only`

這樣接收端只接收 iPhone 傳來的照片，不把本地變化同步回 iPhone。

這是第二層保險：

iPhone 端：Send Only
NAS 端：Receive Only

兩邊都按單向備份思路配置，更符合照片歸檔場景。

iOS 背景同步的現實限制

iOS 對背景執行限制很嚴格。即使配置正確，也不要期待 Mobius Sync 一直在背景默默跑。

常見情況是：

App 打開時同步速度正常。
切到背景後還能同步一小段時間。
過一會兒系統會暫停或限制它。
位置變化、系統排程或短暫背景視窗可能再次喚醒。

最可靠的實踐很樸素：

拍了大量照片後，主動打開 Mobius Sync。
讓手機保持亮螢幕或不要太快鎖定。
等待它把新照片同步完。
再關閉 App 或鎖定螢幕。

如果你習慣每隔幾天做一次相簿備份，這個方式比較可靠。

避免 iCloud 最佳化儲存影響同步

如果 iPhone 開啟了：

`1`	`最佳化 iPhone 儲存空間`

系統可能只在本地保留縮圖，原圖留在 iCloud。第三方同步客戶端讀取照片時，可能拿不到完整原圖，導致同步失敗、跳過或需要等待系統下載。

更適合同步備份的設定是：

`1`	`下載並保留原始檔`

路徑通常在：

`1`	`設定 -> Apple ID -> iCloud -> 照片`

如果手機空間不夠，必須開啟最佳化儲存，那麼同步前可能需要先在系統相簿裡打開相關照片，讓 iPhone 把原圖從 iCloud 下載回來，再啟動 Mobius Sync 同步。

大量照片首次同步建議

第一次同步 iPhone 相簿時，可能有幾千張甚至幾萬張照片。建議不要急著一次做完。

可以這樣處理：

先同步少量照片測試。
確認 NAS 路徑正確。
確認資料夾類型是 Send Only / Receive Only。
確認接收端不會反向影響 iPhone。
再開始完整同步。

首次同步時最好：

iPhone 接入電源。
保持 Wi-Fi 穩定。
打開 Mobius Sync 前景執行。
NAS 或電腦保持在線。

照片數量很大時，同步時間可能比較長，這是正常的。

總結

iPhone 可以透過 Mobius Sync 或 FSync 接入 Syncthing 生態，把照片同步到電腦或 NAS。

但 iOS 的關鍵差異是背景限制和相簿權限。配置時要允許本機網路和完整相簿存取，資料夾類型按單向備份設計：iPhone Send Only，NAS Receive Only。如果開啟了 iCloud 最佳化儲存，還要注意本地是否真的有原圖。

用它做照片歸檔時，最穩的方式是定期主動打開客戶端同步，再讓 NAS 負責版本保留、快照和長期備份。

Android 上怎麼用 Syncthing？Syncthing-Fork 設定與照片備份

Sun, 31 May 2026 12:17:19 +0800

Syncthing 系列目錄

Android 上使用 Syncthing，常見選擇有兩個：

Syncthing 官方原版 Android 客戶端。
Syncthing-Fork 社群增強版。

如果只是簡單體驗，兩者都能用。但如果你希望長期同步手機照片、筆記或文件，更推薦 Syncthing-Fork。它對 Android 的背景、電池和網路條件適配更細，支援僅 Wi-Fi 同步、指定 Wi-Fi 同步、僅充電時執行等功能，更適合手機端長期使用。

這篇把 Android 端常規設定和照片備份合在一起講。照片備份是 Syncthing 在手機上的經典用法，但它不應該按普通雙向同步來配置。

為什麼更推薦 Syncthing-Fork

Android 系統會主動限制背景應用。手機熄屏後，系統可能暫停網路、凍結程序，甚至直接殺掉背景服務。普通同步工具如果沒有處理好這些限制，就容易出現「打開 App 才同步，鎖屏後就斷」的情況。

Syncthing-Fork 的優勢主要在手機使用體驗：

可以設定執行條件。
可以只在 Wi-Fi 下同步。
可以只在指定 Wi-Fi 下同步。
可以只在充電時同步。
對 Android 背景限制的適配更實用。

這不代表官方原版不能用，而是 Syncthing-Fork 更像「為手機長期同步場景調過的版本」。

安裝來源

Syncthing-Fork 常見安裝來源包括：

Google Play
F-Droid
GitHub Releases

優先選擇你平時信任的管道。安裝完成後，先不要急著新增裝置，先把權限和背景執行條件處理好。

第一步：授予必要權限

首次打開 Syncthing-Fork 時，重點看兩個權限。

儲存權限

Android 端同步檔案，必須讓應用能讀寫目標目錄。

較新的 Android 版本通常會提示「所有檔案存取權限」或類似權限。如果不給權限，Syncthing-Fork 可能只能看到很有限的目錄，無法讀取相簿、文件或你指定的同步資料夾。

建議：

給 Syncthing-Fork 授予必要的檔案存取權限。
同步目錄盡量放在內建儲存中的普通目錄。
不要優先選擇系統保護目錄。

例如可以使用：

1
2
3

/storage/emulated/0/SyncData
/storage/emulated/0/SyncData/Notes
/storage/emulated/0/SyncData/Photos

如果要同步相機照片，常見路徑是：

`1`	`/storage/emulated/0/DCIM/Camera`

電池最佳化白名單

這是 Android 端最關鍵的一步。

如果 Syncthing-Fork 沒有被排除出電池最佳化，手機鎖屏後系統可能殺掉同步程序。表現就是：你以為它在背景同步，實際上只有打開 App 時才動一下。

建議在系統設定中把 Syncthing-Fork 加入電池最佳化白名單。不同品牌手機名稱不一樣，可能叫：

不最佳化
允許背景執行
允許自啟動
鎖定背景
背景高耗電允許

國產 Android 系統通常還會額外限制背景和自啟動。如果同步不穩定，要同時檢查系統電池管理和應用自啟動設定。

第二步：和 NAS 或電腦配對

Syncthing 的裝置配對邏輯是互相加入 device ID。

假設手機是裝置 A，NAS 或電腦是裝置 B。

在手機端：

打開 Syncthing-Fork。
進入選單。
選擇顯示裝置 ID。
你會看到 QR code 和一長串裝置 ID。

在 NAS 或電腦端：

打開 Syncthing Web UI。
點擊 新增遠端裝置。
掃描手機 QR code，或者手動輸入手機裝置 ID。
給手機起一個清楚的名字，例如 Android-Phone 或 Pixel-Phone。
儲存。

回到手機端，通常會看到連線請求提示。點擊接受。

到這裡，兩台裝置只是建立了信任關係，還沒有同步任何資料夾。

第三步：接收 NAS 或電腦共享的資料夾

如果電腦或 NAS 已經把某個資料夾共享給手機，手機端會收到提示。

例如：

`1`	`裝置 NAS 想共享資料夾 Notes`

點擊新增後，在手機上指定本地路徑。例如：

`1`	`/storage/emulated/0/SyncData/Notes`

儲存後，手機會開始從 NAS 或電腦下載檔案。

這個路徑建議提前手動建好，避免 Syncthing-Fork 自動建立到你不熟悉的位置。

如果你同步的是 Markdown 筆記，要注意是否需要同步應用設定目錄。以 Obsidian 為例，.obsidian 目錄裡有工作區狀態、外掛設定和快取。多端外掛差異很大時，建議先只同步正文和附件。

第四步：把手機照片備份到電腦或 NAS

手機端最常見的需求是把相簿備份到 NAS 或電腦。

照片備份和普通檔案同步不一樣。大多數人想要的是「手機拍照後自動傳到 NAS」，而不是「手機刪了照片，NAS 上也跟著刪」。所以這類場景更接近單向備份，需要特別注意資料夾類型。

推薦組合是：

手機端：Send Only
電腦或 NAS 端：Receive Only

這樣手機負責傳送照片，NAS 負責接收和保存。再配合 NAS 端檔案版本或快照，誤刪風險會小很多。

手機端新增相簿資料夾

在 Syncthing-Fork 的資料夾頁面中：

點擊右上角 +。
新建資料夾。
資料夾標籤填寫容易識別的名字，例如 Pixel_Photos 或 Huawei_DCIM。
資料夾路徑選擇手機相簿目錄。
共享裝置勾選你的電腦或 NAS。

Android 相機照片通常在：

`1`	`/storage/emulated/0/DCIM/Camera`

如果你還想同步截圖、微信圖片或其他 App 保存的圖片，通常需要單獨新增資料夾。例如：

1
2

/storage/emulated/0/Pictures/Screenshots
/storage/emulated/0/Pictures/WeiXin

不同手機和應用路徑可能不同，建議先用系統檔案管理器確認。

手機端改為 Send Only

在手機端資料夾設定中，找到資料夾類型，把預設的：

`1`	`Send & Receive`

改成：

`1`	`Send Only`

這樣手機只負責把照片發出去。

這個設定的意義是：手機是照片來源。你在手機上拍了新照片，Syncthing 會把它傳給 NAS；但 NAS 端的變化不會反向寫回手機。

不過要注意，Syncthing 仍然是同步工具，不是完整備份系統。要想更穩，還需要在 NAS 端開啟檔案版本、快照或單獨備份。

接收端設定保存路徑

手機端儲存後，電腦或 NAS 的 Syncthing Web UI 會彈出提示：

`1`	`裝置 Pixel-Phone 想共享資料夾 Pixel_Photos`

點擊新增。

在接收端設定本地保存路徑。

Windows 可以類似：

`1`	`D:\Backups\Phone_Photos`

Linux 或 NAS 可以類似：

`1`	`/volume1/photos/phone`

Docker 部署時，要填寫容器內路徑。例如宿主機映射：

`1`	`- /volume1/photos:/var/syncthing/photos`

那麼 Web UI 裡應填寫：

`1`	`/var/syncthing/photos/phone`

接收端改為 Receive Only

在電腦或 NAS 端的資料夾進階設定裡，把資料夾類型設為：

`1`	`Receive Only`

這樣接收端只接收手機發來的照片，不把本地變化發回手機。

這是一層保護：即使你在電腦或 NAS 上整理照片、移動檔案、誤刪檔案，也不會直接反向影響手機裡的原圖。

更穩的做法是：NAS 端再開啟檔案版本或快照。因為 Receive Only 可以避免反向影響手機，但不能替代 NAS 自己的歷史版本能力。

第一次同步前先小規模測試

不要一開始就同步幾萬張照片。

建議先這樣測試：

在手機相簿裡臨時放 3-5 張照片。
確認電腦或 NAS 能接收到。
在手機上新增一張照片，看是否自動同步。
在手機上刪除一張測試照片，觀察 NAS 端行為。
確認結果符合預期後，再放開完整相簿。

不同資料夾類型和刪除動作的組合很容易產生誤解，先用小樣本驗證能避免大規模整理成本。

執行條件：防止偷跑流量

Syncthing-Fork 的執行條件很適合 Android。

建議進入設定裡的執行條件，至少開啟：

`1`	`僅在 Wi-Fi 連接時執行`

這樣可以避免在 5G 或 4G 網路下自動同步大檔案。

如果你只想在家裡同步，可以進一步設定指定 Wi-Fi SSID。例如只允許在家裡的 Wi-Fi 下執行，不在公司、飯店或朋友家 Wi-Fi 下同步。

充電時同步：更省電的工作流

如果你不需要即時同步，可以開啟：

僅在充電時執行

這個設定對照片備份特別實用。

一個穩定工作流是：

白天正常拍照、寫筆記。
Syncthing-Fork 不持續背景執行，減少耗電。
晚上回家連接家庭 Wi-Fi。
插上充電器。
Syncthing-Fork 自動執行，把當天照片和檔案同步到 NAS。

這比全天候背景同步更省電，也更符合手機使用習慣。

如果你同步的是隨時要用的筆記，可以不要開啟「僅充電時執行」，而是只限制 Wi-Fi。具體取決於你對即時性的要求。

Android 11 之後的儲存限制

Android 11 之後，系統對儲存存取限制更嚴格。某些目錄可能無法穩定讀寫，尤其是：

1
2

Android/data
Android/obb

SD 卡目錄也可能受限制，具體取決於手機廠商、Android 版本和檔案選擇器授權方式。

建議：

盡量在內建儲存根目錄下建立專用同步目錄。
不要把系統應用私有目錄作為主要同步目錄。
需要同步相簿時，優先選擇 DCIM/Camera 這類普通媒體目錄。
同步筆記時，建議放在 /storage/emulated/0/SyncData/Notes 這類清晰路徑。

穩定比「路徑看起來很原生」更重要。

不建議一開始同步整個：

`1`	`/storage/emulated/0`

這個目錄太大、太雜，裡面有快取、下載、應用資料和臨時檔案，容易帶來效能、權限和衝突問題。

手機端資料夾類型怎麼選

不同場景可以這樣選。

筆記雙向同步

如果手機和電腦都會編輯同一批 Markdown 筆記：

`1`	`Send & Receive`

但要注意衝突。不要在多台裝置上同時編輯同一個檔案。

手機照片備份到 NAS

如果手機主要負責傳送照片：

`1`	`Send Only`

NAS 端可以配合版本保留或快照。

手機只看資料

如果手機只需要拿到 NAS 上的資料，不希望手機誤刪影響其他裝置：

`1`	`Receive Only`

例如把資料庫、電子書、腳本參考檔同步到手機閱讀。

刪除策略要想清楚

很多人會問：手機刪照片後，NAS 上會不會刪？

這取決於資料夾類型和同步狀態。為了減少誤刪風險，建議：

手機端使用 Send Only。
NAS 端使用 Receive Only。
NAS 端開啟檔案版本。
NAS 再做快照或獨立備份。

如果你的真實目標是「歸檔」，還可以讓 Syncthing 先同步到 NAS 的中轉目錄，再由 NAS 定時任務把檔案複製到歸檔目錄。歸檔目錄不再由 Syncthing 管理。

例如：

1
2

/volume1/photos/inbox-phone
/volume1/photos/archive

Syncthing 只寫入 inbox-phone，定時腳本再把照片整理到 archive。

常見問題

鎖屏後不同步

優先檢查：

是否加入電池最佳化白名單。
是否允許背景執行。
是否允許自啟動。
是否啟用了僅充電或僅 Wi-Fi 條件。

很多時候不是 Syncthing-Fork 配錯了，而是系統背景管理把它限制住了。

找不到相簿目錄

先用系統檔案管理器確認實際路徑。常見路徑是：

`1`	`/storage/emulated/0/DCIM/Camera`

如果使用第三方相機或修圖 App，檔案可能在其他目錄。

同步很慢

檢查：

手機和 NAS 是否在同一個 Wi-Fi。
是否走了 Relay。
NAS 端 22000/TCP 和 22000/UDP 是否可用。
手機是否處於省電模式。
是否有大量小檔案。

大量小檔案同步本來就比少量大檔案慢。第一次同步完成後，後續增量通常會輕很多。

刪除手機照片後 NAS 也刪了

這說明你的同步關係把刪除動作也同步過去了。Syncthing 是同步工具，不是天然只增不刪的備份工具。

解決思路：

檢查手機端和 NAS 端資料夾類型。
NAS 端開啟檔案版本。
NAS 再配合快照或獨立備份。
如果目標是歸檔，考慮把手機照片同步到一個中轉目錄，再由 NAS 定時搬運到歸檔目錄。

總結

Android 上使用 Syncthing，關鍵不是安裝 App，而是處理好權限、背景、電池和網路條件。

Syncthing-Fork 更適合長期手機同步。它可以把同步限制在 Wi-Fi、指定 Wi-Fi 或充電狀態下，既減少耗電，也避免行動流量偷跑。

如果你的目標是手機照片備份到 NAS，建議按單向備份思路設定：手機 Send Only，電腦或 NAS Receive Only，再配合 NAS 端檔案版本、快照和獨立備份。同步負責傳輸，真正的長期安全要靠備份策略兜底。

Syncthing 多設備怎麼配置？對等網路、星型拓撲和引入者

Sun, 31 May 2026 12:13:57 +0800

Syncthing 系列目錄

Syncthing 採用的是去中心化 P2P 架構。它沒有傳統意義上的 Server 和 Client，每台設備在協議層面都是對等節點。

但在實際使用時，你可以把它配置成兩種形態：

純對等網路：每台設備都和其他設備直接配對。
星型網路：指定一台 NAS、伺服器或常開電腦作為中心節點，其他設備只和它配對。

兩種方式都符合 Syncthing 的設計，只是管理成本和使用習慣不同。

先理解「對等」和「偽伺服器」

Syncthing 裡的每台設備都有自己的 device ID。只要兩台設備互相加入對方 ID，並且共享同一個資料夾，它們就能同步。

所以，Syncthing 本身沒有「伺服器端必須保存所有資料」這個概念。你看到的「伺服器」，往往只是人為指定的一台常開設備。

例如：

NAS 長期開機、空間大，適合作為中心節點。
手機和筆電經常離線，適合作為邊緣設備。
桌機效能強，但不一定 24 小時開機，可以作為普通同步節點。

這個「中心節點」不是協議上的伺服器，而是你在拓撲設計中讓它承擔管理和中轉角色。

模式一：純對等 Mesh 網路

純對等模式下，每台設備都和其他所有設備配對。

例如你有四台設備：

NAS
桌機
筆電
手機

那麼每台設備都要和另外三台設備建立連線。這樣任何兩台在線設備之間都可以直接同步。

優點：

傳輸路徑更直接。
某台設備離線時，其他在線設備仍然可以互相同步。
不依賴某一個中心節點。

缺點：

設備越多，配對關係越複雜。
新增設備時，需要在多台舊設備上確認和配置。
資料夾共享關係容易分散。

設備數量少時，純對等模式很舒服。比如只有一台電腦和一支手機，或者兩台電腦互相同步筆記，就不需要想太複雜。

但當設備數量變成五六台以上，手動維護全連線關係會越來越麻煩。

模式二：以 NAS 為中心的星型拓撲

星型模式更適合家庭和個人生產力場景。

做法是：選一台長期開機、空間足夠、網路穩定的設備作為中心節點，例如：

NAS
群暉
軟路由
迷你主機
家用 Linux 伺服器

然後其他設備只和它配對：

1
2
3

手機 ----\
筆電 ---- NAS
桌機 ----/

手機不需要直接配對筆電，筆電也不需要直接配對桌機。它們都透過 NAS 間接同步資料。

優點：

管理簡單。
新增設備只需要和 NAS 配對。
NAS 可以承擔版本保留和備份緩衝。
適合 24 小時在線同步。

缺點：

NAS 離線時，其他設備之間不一定能繼續同步。
如果所有流量都經過 NAS，NAS 的網路和磁碟效能會影響體驗。
中心節點權限要管理好。

如果你已經有 NAS 或常開小主機，優先推薦星型拓撲。它保留了 Syncthing 的 P2P 能力，又讓日常管理更接近「中心化同步」。

多設備配置的基本順序

不管用哪種拓撲，Syncthing 的配置順序都是：

先配對設備。
再共享資料夾。
最後在接收端確認路徑。

不要反過來一開始就到處建立資料夾。先把設備關係理清楚，後面才不容易亂。

第一步：設備互聯

假設要連接設備 A 和設備 B。

設備 A 可以是手機，設備 B 可以是 NAS 或電腦。

在設備 A 上：

打開 Syncthing Web UI。
點擊右上角 操作。
選擇 顯示 ID。
複製設備 ID，或者顯示 QR code。

在設備 B 上：

打開 Syncthing Web UI。
點擊 新增遠端設備。
填入設備 A 的 ID。
給設備起一個容易識別的名稱，例如 My-Phone。
儲存。

然後回到設備 A。它通常會彈出提示：設備 B 想要連接。點擊接受。

到這一步，兩台設備已經建立了對等關係，但還沒有開始同步任何資料夾。

第二步：建立並共享資料夾

在設備 A 上點擊 新增資料夾。

常用欄位：

資料夾標籤：給自己看的名字，例如 Notes。
資料夾 ID：跨設備識別用，建議用穩定英文，例如 notes。
資料夾路徑：這台設備上的真實路徑。

然後切換到 共享 分頁，勾選剛剛配對成功的設備 B。

儲存後，設備 A 會把這個資料夾共享邀請發給設備 B。

第三步：接收共享

打開設備 B 的 Web UI，等待幾秒鐘，通常會看到提示：

`1`	`設備 A 想共享一個資料夾`

點擊新增，然後在設備 B 上指定本地儲存路徑。

例如：

`1`	`/volume1/notes`

或者 Docker 部署場景下的容器內路徑：

`1`	`/var/syncthing/notes`

儲存後，同步正式開始。

這裡要注意：不同設備上的路徑可以不一樣。Syncthing 透過資料夾 ID 識別同步關係，不要求每台設備使用相同的本地路徑。

星型拓撲怎麼配置

如果你採用 NAS 中心模式，建議這樣做：

先在 NAS 上部署 Syncthing。
所有手機、電腦、伺服器都只和 NAS 配對。
在 NAS 上建立或接收主要同步資料夾。
每台新設備只加入 NAS 的 device ID。
需要同步哪個資料夾，就在 NAS 和對應設備之間共享。

例如：

NAS
├── notes       -> 桌機、筆電、手機
├── photos      -> 手機、備份碟
├── downloads   -> 桌機、NAS
└── scripts     -> 桌機、筆電

這樣結構非常清楚。你可以把 NAS 當作同步關係的控制面板。

引入者是什麼？

Syncthing 有一個很實用的功能：Introducer，中文介面裡通常叫「引入者」。

它適合多設備場景。

假設你把 NAS 設為引入者。之後新設備只要和 NAS 配對，NAS 就可以把它知道的其他設備介紹給新設備，也可以幫助同步已有的共享關係。

這樣可以減少重複點擊和重複配對。

適合：

家裡有多台電腦和手機。
NAS 作為長期中心節點。
經常新增設備。
希望減少手動維護設備關係。

但也要注意，引入者會擴大自動建立關係的範圍。不要把不完全信任的設備設為引入者，也不要在不清楚拓撲的情況下隨手勾選。

更穩妥的做法是：

只把 NAS 或主伺服器設為引入者。
普通手機、筆電不要設為引入者。
新設備加入後，檢查它被自動加入了哪些設備和資料夾。

資料夾類型決定資料方向

Syncthing 的權限控制主要體現在資料夾類型上。

進入資料夾設定，在選項裡可以調整 Folder Type。

常見三種：

Send & Receive

預設模式。雙方都可以發送和接收變更。

適合：

多設備共同編輯筆記。
多台電腦同步文件。
普通雙向同步目錄。

這是最接近「真正對等」的模式。

Send Only

本機只發送，不接收其他設備的變更。

適合：

資料源頭。
主目錄向其他設備分發。
不希望遠端修改影響本機。

例如你把 NAS 上的某個軟體安裝包目錄設為 Send Only，讓其他電腦只接收。

Receive Only

本機只接收，不把本地改動發送出去。

適合：

備份機。
唯讀鏡像。
防止本地誤刪反向影響主目錄。

例如 NAS 用來接收手機照片，手機端刪除照片時，你不希望 NAS 也跟著刪，就要認真設計資料夾類型和刪除策略。

不同目錄可以用不同拓撲

Syncthing 的拓撲不一定要全站統一。你可以按資料夾設計。

例如：

notes：桌機、筆電、手機、NAS 都使用 Send & Receive。
photos：手機發送，NAS 接收並保留版本。
downloads：NAS 和桌機同步，手機不參與。
backup：主電腦 Send Only，NAS Receive Only。

不要把所有目錄都套進同一種規則。多設備同步真正重要的是資料方向，而不是設備數量。

衝突和誤刪要提前想

多設備同步最常見的問題不是配置失敗，而是同步成功之後發生誤刪或衝突。

容易出問題的場景：

兩台設備同時編輯同一個檔案。
手機端應用自動清理目錄。
一台設備路徑填錯，建立了空目錄並同步過去。
把快取、暫存檔、工作區狀態檔案一起同步。
NAS 端沒有開啟版本保留。

建議：

重要目錄在 NAS 上開啟檔案版本。
使用 .stignore 排除快取和暫存檔。
新資料夾第一次同步前，先用少量測試檔案驗證。
不確定刪除策略時，不要把所有設備都設為 Send & Receive。

總結

Syncthing 是 P2P 對等架構，但不代表你必須把所有設備配成複雜網狀結構。

小規模設備可以用純對等模式；設備多、有 NAS 或常開主機時，更建議使用星型拓撲。讓 NAS 承擔中心節點和引入者角色，其他設備只跟 NAS 建立關係，管理會簡單很多。

真正要想清楚的是：哪些設備可信、哪些目錄要同步、資料從哪裡來、誤刪時誰負責保留版本。拓撲只是手段，資料流向才是配置的核心。

用 Docker 部署 Syncthing：Compose、連接埠和目錄映射避坑

Sun, 31 May 2026 12:12:05 +0800

Syncthing 系列目錄

在 Docker 中部署 Syncthing，很適合 NAS、家用伺服器和 VPS 場景。它可以作為 24 小時在線的同步節點，長期承擔照片、文件、Markdown 筆記或下載目錄的同步任務。

Docker 部署 Syncthing 的重點不是「能不能跑起來」，而是三個問題：

設定目錄要持久化。
需要同步的資料目錄要映射到宿主機。
連接埠和權限要提前處理好。

如果這三點沒有處理好，容器更新後可能遺失設定，Web UI 裡填寫路徑時可能找不到真實目錄，或者同步時出現 Permission denied。

目錄規劃

建議先在伺服器或 NAS 上準備一個獨立目錄，例如：

1
2

mkdir -p ~/syncthing
cd ~/syncthing

這個目錄裡放 docker-compose.yml，並用子目錄保存 Syncthing 設定：

1
2
3

syncthing/
├── docker-compose.yml
└── config/

同步資料目錄可以放在 NAS 或宿主機已有路徑中，例如：

1
2

/volume1/downloads
/volume1/photos

設定目錄和資料目錄要分開。config 保存 Syncthing 自己的設定、密鑰和索引資料庫；downloads、photos 這類目錄才是你要同步的真實資料。

方案一：Docker Compose

更推薦使用 Docker Compose，後續更新、重啟和遷移都更清楚。

在 ~/syncthing/docker-compose.yml 寫入：

version: "3"

services:
  syncthing:
    image: syncthing/syncthing:latest
    container_name: syncthing
    hostname: my-nas-syncthing
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    volumes:
      - ./config:/var/syncthing/config
      - /volume1/downloads:/var/syncthing/downloads
      - /volume1/photos:/var/syncthing/photos
    ports:
      - 8384:8384
      - 22000:22000/tcp
      - 22000:22000/udp
      - 21027:21027/udp
    restart: unless-stopped

啟動：

`1`	`docker compose up -d`

查看狀態：

1
2

docker compose ps
docker logs -f syncthing

打開 Web UI：

`1`	`http://伺服器IP:8384`

首次進入後台後，先設定 GUI 使用者名稱和密碼。

方案二：docker run

如果只是快速測試，也可以直接使用 docker run：

docker run -d \
  --name syncthing \
  --hostname my-nas-syncthing \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -p 8384:8384 \
  -p 22000:22000/tcp \
  -p 22000:22000/udp \
  -p 21027:21027/udp \
  -v /path/to/config:/var/syncthing/config \
  -v /path/to/data1:/var/syncthing/data1 \
  --restart unless-stopped \
  syncthing/syncthing:latest

這裡的 /path/to/config 和 /path/to/data1 必須換成宿主機真實路徑。

例如：

1
2

-v /volume1/docker/syncthing/config:/var/syncthing/config
-v /volume1/photos:/var/syncthing/photos

長期使用時，還是建議改成 Compose 檔案，避免每次重建容器都要重新拼命令。

容器內路徑和宿主機路徑

Docker 新手最容易混淆的是路徑。

比如 Compose 裡寫了：

1
2

volumes:
  - /volume1/photos:/var/syncthing/photos

左邊 /volume1/photos 是宿主機路徑。右邊 /var/syncthing/photos 是容器內路徑。

進入 Syncthing Web UI 新增同步資料夾時，資料夾路徑必須填寫容器內路徑：

`1`	`/var/syncthing/photos`

這樣 Syncthing 實際操作的才是宿主機上的：

`1`	`/volume1/photos`

如果你在 Web UI 裡填 /volume1/photos，容器內部通常沒有這個路徑，Syncthing 可能會報錯，或者在容器檔案系統裡建立一個你並不想要的新目錄。

設定目錄必須持久化

下面這一行很關鍵：

`1`	`- ./config:/var/syncthing/config`

Syncthing 的設定檔、裝置密鑰和索引資料庫都會放在設定目錄裡。如果不把它掛載到宿主機，容器刪除或重建後，裝置 ID 可能變化，原來的裝置配對關係也會失效。

建議把設定目錄放在穩定路徑中，例如：

`1`	`/volume1/docker/syncthing/config`

不要把設定目錄放進臨時目錄，也不要和同步資料目錄混在一起。

連接埠和防火牆

常用連接埠如下：

8384/TCP   Web UI 管理後台
22000/TCP 裝置間同步流量
22000/UDP QUIC 同步流量
21027/UDP 區域網路發現

如果 Syncthing 部署在家用 NAS 上，通常要檢查：

NAS 自帶防火牆是否放行這些連接埠。
Docker 網橋連接埠是否正確映射。
路由器是否隔離了 Wi-Fi 和有線網路。
手機和電腦是否在同一網段。

如果部署在雲伺服器上，還要檢查雲廠商安全群組。尤其是 22000/TCP 和 22000/UDP，如果沒有放行，其他裝置可能只能透過 relay 連接，速度會明顯變慢。

8384 是管理後台連接埠，不建議直接暴露到公網。如果確實要遠端管理，至少要設定強密碼，最好再配合反向代理、HTTPS、存取控制或 VPN。

權限問題：PUID 和 PGID

如果啟動後 Syncthing 能打開 Web UI，但同步目錄時出現：

`1`	`Permission denied`

通常是容器程序沒有宿主機目錄的讀寫權限。

先在宿主機上查看目前使用者的 UID 和 GID：

id

輸出類似：

`1`	`uid=1000(user) gid=1000(user) groups=1000(user)`

然後把 Compose 裡的環境變數改成對應值：

1
2
3

environment:
  - PUID=1000
  - PGID=1000

同時確認宿主機目錄本身允許這個使用者讀寫：

`1`	`ls -ld /volume1/photos`

必要時調整目錄擁有者或權限：

`1`	`sudo chown -R 1000:1000 /volume1/photos`

在 NAS 系統上不要盲目遞迴修改整個共享目錄權限，尤其是多人共享目錄。更穩妥的做法是給 Syncthing 單獨準備一個同步目錄，或者在 NAS 權限管理介面給對應使用者授權。

Web UI 首次安全設定

容器啟動後，訪問：

`1`	`http://伺服器IP:8384`

首次進入後台，Syncthing 通常會提示設定 GUI 使用者名稱和密碼。這一步不要跳過。

建議：

立即設定 GUI 使用者名稱和強密碼。
不把 8384 暴露到公網。
遠端訪問時優先走 VPN、SSH 隧道或受控反向代理。
如果使用反向代理，確認只代理 Web UI，不要誤開放其他不必要連接埠。

如果管理後台被別人控制，對方就可能新增裝置、修改共享目錄、改變同步關係。Syncthing 的同步資料傳輸是加密的，但管理入口本身仍然需要保護。

在 Web UI 中新增同步目錄

以照片目錄為例，Compose 中已經掛載：

`1`	`- /volume1/photos:/var/syncthing/photos`

Web UI 裡新增資料夾時：

Folder Label：可以寫 Photos。
Folder ID：建議使用穩定英文 ID，例如 photos。
Folder Path：填寫 /var/syncthing/photos。
Sharing：選擇要共享給哪些裝置。
Folder Type：按需求選擇 Send & Receive、Send Only 或 Receive Only。

如果這台 Docker 節點是 NAS 中心節點，常見配置是：

普通文件：Send & Receive
手機照片彙整：NAS 上設為 Receive Only
對外分發目錄：NAS 上設為 Send Only

具體選擇要看你的資料流向。不要所有目錄都無腦雙向同步。

更新容器

使用 Compose 時，更新通常是：

1
2

docker compose pull
docker compose up -d

只要設定目錄和資料目錄都正確掛載，更新容器不會遺失裝置 ID、配對關係和同步目錄設定。

更新前可以先備份設定目錄：

`1`	`tar -czf syncthing-config-backup.tar.gz ./config`

設定目錄裡包含裝置私鑰，不要把備份檔案隨便上傳到公共位置。

常見問題

Web UI 打不開

先檢查容器是否運行：

1
2

docker ps
docker logs syncthing

再檢查連接埠映射：

`1`	`docker port syncthing`

如果容器正常，仍然打不開，檢查宿主機防火牆、NAS 防火牆或雲伺服器安全群組。

新增目錄後提示不存在

檢查你在 Web UI 裡填寫的是不是容器內路徑。

例如宿主機路徑是：

`1`	`/volume1/downloads`

容器內路徑是：

`1`	`/var/syncthing/downloads`

Web UI 裡應該填後者。

只能透過 Relay，速度很慢

優先檢查：

22000/TCP 是否放行。
22000/UDP 是否放行。
路由器連接埠轉發是否正確。
雲伺服器安全群組是否同時放行 TCP 和 UDP。
本機防火牆是否攔截 Docker 映射連接埠。

Relay 能提高可連接性，但不適合長期承擔大量同步流量。

同步後檔案權限不對

先確認容器運行使用者是否正確，再確認宿主機目錄權限。Linux、NAS、Windows 共享目錄之間的權限模型不同，不要把 Syncthing 當成權限修復工具。

對於跨系統同步，盡量同步普通檔案和目錄，少同步依賴複雜 ACL、擁有者、擴展屬性的系統目錄。

一個更穩的使用方式

如果你的目標是把 NAS 或伺服器作為中心節點，可以這樣設計：

NAS 上用 Docker 跑 Syncthing。
設定目錄掛載到 /volume1/docker/syncthing/config。
每類資料單獨掛載，例如 /volume1/photos、/volume1/notes。
手機、電腦分別新增 NAS 的裝置 ID。
重要目錄在 NAS 端開啟檔案版本。
Web UI 只在內網或 VPN 內訪問。
NAS 本身再做獨立備份，不把同步當作唯一備份。

這樣 Syncthing 負責裝置間同步，NAS 負責長期在線和版本緩衝，真正的備份再交給快照、外接硬碟或異地備份。

總結

Docker 部署 Syncthing 的關鍵，是把「容器生命週期」和「同步資料生命週期」分開。

容器可以隨時更新、重建、遷移；但設定目錄和資料目錄必須穩定保存在宿主機上。Web UI 裡填寫的是容器內路徑，宿主機權限要透過 PUID、PGID 和目錄授權處理，連接埠要按實際網路環境放行。

只要這幾件事配置清楚，Syncthing 很適合作為 NAS、伺服器和個人裝置之間的輕量同步層。

Syncthing 怎麼用？從裝置配對到檔案同步的實用筆記

Sun, 31 May 2026 11:59:09 +0800

Syncthing 系列目錄

Syncthing 適合用來做多裝置之間的點對點檔案同步。它不是傳統網路硬碟，也不是把所有資料先上傳到某個中心伺服器再下載回來，而是讓已授權的裝置直接交換檔案。

如果你正在考慮用它同步 Markdown 筆記、照片備份、設定檔或家庭 NAS 目錄，重點不只是「能不能同步」，而是先理解幾個基本概念：裝置、資料夾、裝置 ID、同步方向、發現方式和衝突處理。

Syncthing 解決什麼問題

Syncthing 的核心場景是：你有兩台或多台裝置，希望它們之間保持某個目錄一致。

典型例子：

Windows 桌機和筆電之間同步工作資料。
手機和 NAS 之間同步照片或文件。
多台 Linux 伺服器之間同步設定範例、腳本或小型資料目錄。
Obsidian、Joplin 外部附件、Markdown 筆記目錄在多裝置間同步。

它更適合「自己控制裝置和資料」的同步場景。如果你需要多人權限管理、線上預覽、分享連結或協作編輯，傳統網路硬碟或文件協作平台會更合適。

第一次啟動後會發生什麼

官方入門文件建議把兩台機器並行設定。Syncthing 裡，一台機器叫一個 device。你正在設定的機器是 local device，另一台要同步的機器是 remote device。

第一次啟動 Syncthing 時，它會產生設定檔、加密金鑰和裝置 ID，並預設在本機開啟 Web GUI：

`1`	`http://127.0.0.1:8384/`

這個 Web GUI 是日常設定入口。官方文件也提到，預設可能會建立一個 Default Folder，通常對應使用者目錄下的 Sync 資料夾。你可以先用它測試，也可以後面刪除並新增自己的目錄。

裝置 ID 是配對基礎

Syncthing 的裝置配對靠 device ID。

每台裝置首次啟動時都會產生自己的金鑰，裝置 ID 可以理解為這個裝置憑證的可讀指紋。兩台裝置只有互相加入對方的裝置 ID，才會建立連線並同步。

實際操作順序通常是：

在兩台裝置上都啟動 Syncthing。
分別開啟 Web GUI。
在 A 上加入 B 的 device ID。
在 B 上加入 A 的 device ID。
選擇要共享的資料夾。
儲存後等待兩邊連線。

裝置 ID 不需要像密碼一樣保密，但也不要隨便把自己的同步拓撲公開到不必要的地方。真正需要保護的是裝置私鑰、Web GUI 管理權限和同步目錄本身。

資料夾不是自動全機同步

Syncthing 同步的是你明確新增的 folder，不會預設同步整台機器。

每個資料夾都有自己的路徑、ID、共享裝置和同步類型。常見做法是按用途拆分：

notes/：Markdown 筆記。
photos-inbox/：手機照片中轉。
docs/：多裝置文件目錄。
scripts/：小腳本和設定範例。

不要一開始就同步過大的系統目錄、下載目錄或混雜目錄。目錄越複雜，衝突、忽略規則、權限差異和掃描成本越容易變成長期維護問題。

三種常見資料夾類型

官方文件裡把資料夾類型分得很清楚。實際使用時，先理解這三種就夠了。

Send & Receive

這是預設模式。這個資料夾既傳送本機變更，也接收其他裝置變更。

適合：

多台電腦共同編輯筆記。
多裝置共同維護文件。
普通雙向同步目錄。

如果兩台裝置同時改了同一個檔案，Syncthing 會產生衝突檔案，而不是直接靜默覆蓋。

Send Only

這個模式下，本機像「參考副本」。它會向其他裝置傳送變化，但不會套用其他裝置傳來的變化。

適合：

主裝置向備份裝置分發檔案。
希望某台機器上的目錄狀態作為基準。
不希望遠端修改反向影響本機。

如果遠端發生變化，本機可能顯示 out of sync。此時 Web GUI 會提供 Override Changes，用本機狀態覆蓋叢集裡的其他狀態。這個按鈕要謹慎使用。

Receive Only

這個模式和 Send Only 相反。它接收叢集裡的變更，但本地改動不會再傳給其他裝置。

適合：

備份目標。
唯讀鏡像。
不希望本地誤操作污染主同步目錄的裝置。

如果本地出現修改，Web GUI 會提示 Revert Local Changes，可以把本地變更撤回到叢集版本。

防火牆和連接埠要先看

Syncthing 能透過發現服務、NAT、relay 等機制讓裝置互相找到，但網路越清楚，連線越穩定。

官方防火牆文件列出的關鍵連接埠是：

1
2
3

22000/TCP
22000/UDP
21027/UDP

其中：

22000/TCP 用於 TCP 同步流量。
22000/UDP 用於 QUIC 同步流量。
21027/UDP 用於本地發現廣播或多播。

如果裝置在同一個區域網路內，但一直發現不了，優先檢查本機防火牆、路由器隔離、Wi-Fi 和 LAN 是否被分到不同網段。

如果裝置跨公網或跨 NAT，能做連接埠轉發時，直接連線通常比 relay 更好。沒有連接埠轉發時，relay 也可能讓裝置連上，但效能會比直連差。

Linux 上如果使用 ufw 並安裝了對應套件，可以用：

1
2

sudo ufw allow syncthing
sudo ufw status verbose

Web GUI 預設只監聽本機的 127.0.0.1:8384。如果要遠端存取 GUI，可以改成 0.0.0.0:8384，但這代表管理介面對外暴露，必須同時考慮密碼、HTTPS、反向代理或 SSH 隧道。普通家庭場景下，更推薦用 SSH 隧道存取遠端 GUI。

`.stignore` 要放在同步根目錄

如果有些檔案不想同步，可以在同步資料夾根目錄建立 .stignore。

注意幾個細節：

.stignore 必須放在同步資料夾的根目錄。
規則相對於同步根目錄生效。
.stignore 本身不會同步到其他裝置。
檔案內容應使用 UTF-8 編碼。

一個簡單例子：

(?d).DS_Store
node_modules
*.tmp
cache/**
!/cache/keep.txt

(?d) 的作用是：當這些被忽略檔案阻止目錄刪除時，允許 Syncthing 刪除它們。適合 .DS_Store 這類系統自動產生檔案。

驚嘆號 ! 是反向規則，用來把某些檔案重新納入同步。但反向規則可能導致 Syncthing 遍歷本來會忽略的目錄。規則很多時，最好先從簡單規則開始。

檔案版本不是本地復原

Syncthing 支援檔案版本保留，但它的語義容易誤解。

官方文件強調，版本保留是「接收遠端變更時，把舊版本歸檔」。也就是說，如果 A 開啟了版本保留，B 修改了檔案並同步到 A，A 會把被替換的舊檔案保存起來。但如果 A 自己本地修改了檔案，Syncthing 不能替 A 保存修改前的版本。

常見版本策略包括：

Trash Can File Versioning：類似回收桶，被遠端刪除或替換的檔案移到 .stversions。
Simple File Versioning：保留固定數量的歷史版本。
Staggered File Versioning：按時間間隔保留版本，越舊越稀疏。
External File Versioning：交給外部腳本處理。

如果你用 Syncthing 同步重要文件，建議至少在備份目標裝置上開啟簡單版本或回收桶版本。它不能代替完整備份，但能減少誤刪和誤覆蓋的損失。

同步衝突如何產生

Syncthing 會識別衝突。兩台裝置同時修改同一個檔案，而且內容不同，就可能產生類似這樣的衝突檔案：

`1`	`filename.sync-conflict-date-time-modifiedBy.ext`

這比靜默覆蓋安全，但也代表你要定期清理衝突檔案。

容易產生衝突的場景：

多裝置同時開啟同一份 Markdown 筆記。
應用程式自動寫入同一個狀態檔。
同步 .obsidian/workspace.json 這類裝置狀態檔。
Windows、macOS、Android 之間出現大小寫檔名差異。

如果同步筆記，建議把正文、附件和模板同步；工作區狀態、快取、外掛臨時檔要謹慎處理，必要時放進 .stignore。

安全邊界

Syncthing 的安全目標之一是：未授權裝置不能加入同步叢集，傳輸中的檔案內容不能被旁路監聽者讀取。

官方安全文件說明，裝置間流量由 TLS 保護，連線建立時會檢查裝置憑證指紋是否在允許清單中。換句話說，只有雙方配置了彼此的裝置 ID，才會真正建立同步關係。

但這不等於「使用 Syncthing 這件事不可見」。例如：

開啟全域發現時，裝置會向發現伺服器公告裝置 ID 和監聽位址。
本地發現會在區域網路內發送廣播或多播。
relay 伺服器會知道連線裝置的 device ID，但不能解密同步內容。
Web GUI 如果對外開放，會暴露這台機器執行了 Syncthing。

所以安全建議很直接：

不要把 Web GUI 暴露到公網，除非你明確做好認證和加密。
只加入你信任的裝置。
重要目錄配合系統磁碟加密或單獨備份。
不需要全域發現、relay 或自動升級時，可以按場景關閉，但要接受連線便利性下降。

不受信任裝置加密

Syncthing 還支援 Untrusted / Encrypted Devices。這個功能可以讓某個不受信任裝置只保存加密後的資料。

一個典型場景是：你有一台雲端伺服器或外部機器，希望它參與同步、承擔中轉或備份角色，但不希望它看到明文檔案。可信裝置向它傳送資料時，會使用資料夾密碼加密；其他可信裝置拿到同樣密碼後，可以從這個不受信任裝置同步並解密。

但官方文件也提醒，這個功能仍應視為 beta / testing。它適合有明確需求的人謹慎使用，不建議一開始就作為主同步方案。

需要特別記住：

檔案資料、檔名、時間、雜湊和目錄結構會被保護。
資料夾 ID、標籤和大致檔案大小不屬於完整保護範圍。
密碼和 folder ID 要可靠保存。
不受信任裝置上的資料夾類型要設為 Receive Encrypted。

如果只是家庭 NAS、自己的電腦和手機之間同步，通常先用普通可信裝置模式，把系統登入、磁碟加密和備份做好，會更容易維護。

實用設定建議

如果你準備用 Syncthing 長期同步筆記或文件，可以按這個思路設定：

每類資料單獨建資料夾，不要混在一個超大目錄裡。
主力電腦使用 Send & Receive。
NAS 或備份機可以考慮 Receive Only，並開啟檔案版本。
手機端只同步必要目錄，不要同步應用快取目錄。
用 .stignore 排除快取、臨時檔、工作區狀態檔。
區域網路內優先保證 22000/TCP、22000/UDP、21027/UDP 可用。
Web GUI 盡量保持本機監聽，需要遠端管理時優先用 SSH 隧道。
重要資料不要只依賴同步，仍然需要獨立備份。

適合和不適合

Syncthing 適合：

你希望資料主要留在自己的裝置上。
你願意理解裝置配對、同步目錄和衝突處理。
你有 NAS、家用伺服器或多台個人裝置。
你想同步 Markdown、照片中轉、腳本、輕量文件。

Syncthing 不太適合：

需要多人線上協作編輯。
需要網頁端檔案預覽和分享連結。
需要細粒度團隊權限。
不想處理任何網路、防火牆和衝突問題。

它更像一個可靠的「裝置間同步層」，而不是完整的雲端硬碟產品。用得好，Syncthing 可以把 NAS、電腦、手機連成一個可控的資料網路；用得太隨意，也可能因為衝突、誤刪、忽略規則和網路設定變成維護負擔。

Syncthing on KnightLi的博客

Syncthing 多設備多資料夾怎麼管理？拓撲、命名和版本控制

Syncthing 系列目錄

拓撲：放棄全連接，優先星型

Folder ID 比資料夾標籤更重要

中心節點路徑要規範

引入者：減少多設備配對成本

區分備份和雙向同步

手機照片備份

多端文件和筆記

資料分發

備份目錄

NAS 上開啟檔案版本控制

用忽略規則過濾暫存檔案

多資料夾命名範例

推薦整體方案

總結

Syncthing 如何同步 iPhone 照片到電腦或 NAS

Syncthing 系列目錄

先理解 iOS 上的限制

第一步：安裝客戶端並授予權限

通知權限

本機網路權限

相簿存取權限

第二步：iPhone 和電腦/NAS 配對

第三步：在 iPhone 上建立相簿同步資料夾

第四步：iPhone 端設為 Send Only

第五步：在電腦或 NAS 端接收照片

接收端建議設為 Receive Only

iOS 背景同步的現實限制

避免 iCloud 最佳化儲存影響同步

大量照片首次同步建議

推薦配置

總結

Android 上怎麼用 Syncthing？Syncthing-Fork 設定與照片備份

Syncthing 系列目錄

為什麼更推薦 Syncthing-Fork

安裝來源

第一步：授予必要權限

儲存權限

電池最佳化白名單

第二步：和 NAS 或電腦配對

第三步：接收 NAS 或電腦共享的資料夾

第四步：把手機照片備份到電腦或 NAS

手機端新增相簿資料夾

手機端改為 Send Only

接收端設定保存路徑

接收端改為 Receive Only

第一次同步前先小規模測試

執行條件：防止偷跑流量

充電時同步：更省電的工作流

Android 11 之後的儲存限制

手機端資料夾類型怎麼選

筆記雙向同步

手機照片備份到 NAS

手機只看資料

刪除策略要想清楚

常見問題

鎖屏後不同步

找不到相簿目錄

同步很慢

刪除手機照片後 NAS 也刪了

推薦設定

總結

Syncthing 多設備怎麼配置？對等網路、星型拓撲和引入者

Syncthing 系列目錄

先理解「對等」和「偽伺服器」

模式一：純對等 Mesh 網路

模式二：以 NAS 為中心的星型拓撲

多設備配置的基本順序

第一步：設備互聯

第二步：建立並共享資料夾

第三步：接收共享

星型拓撲怎麼配置

引入者是什麼？

資料夾類型決定資料方向

Send & Receive

Send Only

Receive Only

不同目錄可以用不同拓撲

`.stignore` 要放在同步根目錄