Syncthing Node (P2P)

支援直接 P2P 連線的持續性點對點檔案同步工具 — 無需依賴 Syncthing 中繼伺服器。

本模板透過 Zeabur Port Forwarding 開放 BEP 同步協定(TCP/UDP 22000),讓其他 Syncthing peer 能直接連線到您的 Zeabur 執行個體。Zeabur 執行個體可作為永遠在線的同步節點,確保即使其他裝置離線,檔案仍保持同步。

首次啟動

1. 開啟網域 — Syncthing Web UI 直接開啟
2. ⚠ 在第一分鐘內設定 GUI 密碼 — 開啟 Actions > Settings > GUI 分頁,設定帳號密碼。Web UI 預設無認證公開暴露;若拖延,任何掃描到您網域的人都可接管節點
3. 新增遠端裝置 — 在 Syncthing 實例之間分享裝置 ID
4. 新增資料夾 — 選擇要同步的資料夾及目標裝置

啟用 P2P 直連(不走中繼)

預設情況下 NAT 後的 Syncthing 可能會回退到 Syncthing 中繼網路,傳輸速度受限。本模板已預先開放 TCP/UDP 22000 以支援直連。

步驟 1 — 找到轉發位址。 在 Zeabur 控制台開啟本服務的 Networking 分頁。您會看到 sync-tcp(22000/TCP)與 sync-udp(22000/UDP)兩個埠的轉發條目,格式皆為 <host>:<port>。在 dedicated server 專案下,這會是您 server 的公網 IP 與分配的埠(實際數值會顯示在 dashboard 上,每次部署不同)。TCP 與 UDP 的轉發埠通常共用 同一個數字(Zeabur 對同一內部埠的兩個 listener 使用單一外部埠)。

步驟 2 — 設定 peer 裝置。 在您的其他 Syncthing 裝置(筆電、手機、NAS 等)上,先新增此 Zeabur 執行個體為遠端裝置,然後點入裝置項展開 Advanced,將 Addresses 欄位設為(逗號分隔):

tcp://轉發主機:轉發TCP埠, quic://轉發主機:轉發UDP埠

將佔位符替換為步驟 1 的值。若想在靜態位址失敗時保留中繼作為 fallback,可在末尾追加 , dynamic。請勿僅保留 dynamic — global discovery 無法推斷轉發的隨機埠,Syncthing 會靜默回退到中繼。

步驟 3 — 驗證。 在 Web UI 的 Remote Devices 面板中,連線狀態應顯示 TCP 或 QUIC(而非 Relay)。中繼頻寬瓶頸被避開。

維運注意事項

• 不要同步 /var/syncthing/config — 它包含裝置的私鑰和 Device ID。跨機器同步會造成 Device ID 衝突。
• 靜態資料在 Zeabur 磁碟區上是明文。 若將雲端視為不可信,請使用 Syncthing 的 Untrusted Devices / Encrypted Folders 功能。
• 轉發主機/埠可能變化 — Zeabur 通常保持穩定但不保證永久。若變化,請更新 peer 裝置上的 Addresses。
• 不要同步其他雲端服務管理的目錄(iCloud Drive、OneDrive、Dropbox、Google Drive)。它們會與 Syncthing 爭奪檔案所有權,產生無止盡的 sync-conflict 衝突檔。Syncthing 資料夾請放在其他同步引擎範圍之外的路徑。

持久化資料

所有設定檔和同步資料儲存在 /var/syncthing(由 Zeabur 磁碟區支援)。

授權

MPL-2.0 — GitHub · Official Site · Documentation