# Syncthing 檔案同步

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

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

## 安裝

```sh
brew install syncthing
```

## 啟動

```sh
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(勿走公開管道)