homebrew-notes/syncthing.md

Syncthing 檔案同步

持續性、點對點的檔案同步程式,在兩台以上裝置間即時雙向同步。去中心化、沒有中央伺服器、資料不經過第三方雲端,裝置間走 TLS 加密。開源(MPLv2)。版本 2.1.2。

參考:https://docs.syncthing.net/

安裝

brew install syncthing

啟動

brew services start syncthing        # 開機自動啟動的背景服務
brew services restart syncthing      # 升級後重啟

# 或不裝背景服務,只跑一次
syncthing --no-browser --no-restart

啟動後在瀏覽器開 http://127.0.0.1:8384 進 Web GUI 設定。

運作方式

• 每台裝置有唯一的 Device ID(裝置憑證推導出的密碼學指紋)
• 兩台裝置互相交換 Device ID 即建立信任連線
• 建立 Folder 並分享給指定裝置,即開始雙向同步
• 透過本地/全域探索與中繼找到彼此,無需固定 IP

常用 CLI

指令	說明
syncthing --version	印出版本
syncthing cli show system	顯示系統狀態(含本機 Device ID)
syncthing cli config devices list	列出已配對裝置
syncthing cli config folders list	列出同步資料夾
syncthing generate	產生設定與金鑰(首次啟動用)
syncthing --no-browser	啟動時不自動開瀏覽器
syncthing --gui-address=<addr>	指定 GUI 監聽位址

安全模型

• Release 二進位檔以 GPG 簽章;自動升級用編譯進去的 ECDSA 簽章驗證
• macOS 與 Windows 二進位檔有程式碼簽章
• 裝置間連線一律 TLS 加密

社群與回報

• 官方論壇:https://forum.syncthing.net/
• Bug 回報:https://github.com/syncthing/syncthing/issues
• 安全性問題:寄 security@syncthing.net(勿走公開管道)