Syncthing Node (P2P)

直接 P2P 接続対応のピアツーピア継続的ファイル同期 — Syncthing のリレーサーバ不要。

本テンプレートは Zeabur の Port Forwarding で BEP 同期プロトコル (TCP/UDP 22000) を公開し、他の Syncthing ピアが Zeabur インスタンスへ直接接続できるようにします。Zeabur インスタンスは常時オンの同期ノードとして動作し、他のデバイスがオフラインでもファイルの同期を維持します。

初回起動

ドメインにアクセス — Syncthing Web UI が開きます
⚠ 1 分以内に GUI パスワードを設定 — Actions > Settings > GUI タブを開き、ユーザー名とパスワードを設定。Web UI は既定で認証なしに公開されます。遅延すると、ドメインをスキャンした第三者がノードを乗っ取る可能性があります
リモートデバイスを追加 — Syncthing インスタンス間でデバイス ID を共有
フォルダを追加 — 同期するフォルダとデバイスを選択

直接 P2P 接続を有効化(リレー不使用)

既定では NAT 配下の Syncthing は Syncthing リレー網にフォールバックする可能性があり、転送速度が制限されます。本テンプレートは TCP/UDP 22000 を事前に公開し、直接接続を可能にします。

手順 1 — フォワードされたアドレスを取得。 Zeabur ダッシュボードで本サービスの Networking タブを開きます。sync-tcp (22000/TCP) と sync-udp (22000/UDP) の 2 つのフォワードエントリが表示され、それぞれ <host>:<port> の形式です。dedicated server プロジェクトでは、サーバの公開 IP と割り当てられたポートになります (実際の値はダッシュボードに表示され、デプロイごとに異なります)。TCP と UDP のフォワードポートは多くの場合 同じ番号 を共有します (Zeabur は同一内部ポートの両 listener に対して 1 つの外部ポートを使用)。

手順 2 — ピアデバイスを設定。 他の Syncthing デバイス (ラップトップ、スマホ、NAS など) で本 Zeabur インスタンスをリモートデバイスとして追加し、デバイスエントリをクリックして Advanced を展開、Addresses フィールドをカンマ区切りで以下に設定:

tcp://FORWARDED_HOST:FORWARDED_TCP_PORT, quic://FORWARDED_HOST:FORWARDED_UDP_PORT

プレースホルダを手順 1 の値に置き換えます。静的アドレスが失敗した時のためにリレーをフォールバックとして残したい場合は末尾に , dynamic を追加。Addresses を dynamic だけにしないでください — global discovery はフォワードされたランダムポートを推測できず、Syncthing は黙ってリレーへフォールバックします。

手順 3 — 確認。 Web UI のリモートデバイスパネルで接続状態が TCP または QUIC (Relay ではない) と表示されることを確認。リレー帯域幅のボトルネックが解消されます。

運用上の注意

/var/syncthing/config を同期しない — デバイスの秘密鍵と Device ID が含まれます。複数マシン間で同期すると Device ID 衝突が発生します。
Zeabur ボリューム上のデータは平文です。 クラウドを信頼できないと見なす場合は、Syncthing の Untrusted Devices / Encrypted Folders 機能を使用してください。
フォワードされたホスト/ポートは変更される可能性があります — Zeabur は通常安定して維持しますが永続性は保証されません。変更された場合はピアデバイスの Addresses を更新してください。
他のクラウドサービスが管理するディレクトリを同期しないでください(iCloud Drive、OneDrive、Dropbox、Google Drive)。Syncthing とファイル所有権を奪い合い、止まらない sync-conflict ファイルが大量発生します。Syncthing フォルダは他の同期エンジンの範囲外のパスに置いてください。

永続データ

設定ファイルと同期データは /var/syncthing に保存(Zeabur ボリュームで永続化)。

ライセンス

MPL-2.0 — GitHub · Official Site · Documentation