Syncthing [Wiki]

Tato stránka je pouze pro čtení. Můžete si pouze prohlédnout zdrojový kód, ale ne ho měnit. Zeptejte se správce, pokud si myslíte, že něco není v pořádku.
====== Syncthing ======

//Vytvořeno: **1.7.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://github.com/syncthing/syncthing|Syncthing]] je open-source nástroj pro průběžnou synchronizaci souborů mezi dvěma nebo více zařízeními. Hodí se pro situace, kdy mají být data uložená na vlastních počítačích, serverech nebo NASu, bez závislosti na Dropboxu, Google Drive nebo jiné centrální cloudové službě. Základní informace jsou na [[https://syncthing.net/|oficiálním webu]] a podrobnosti v [[https://docs.syncthing.net/|oficiální dokumentaci]].

===== K čemu je dobrý =====

Syncthing řeší automatickou synchronizaci vybraných složek mezi zařízeními. Typicky běží jako služba na notebooku, desktopu, domácím serveru, NASu nebo Raspberry Pi a průběžně kopíruje změny mezi zařízeními, která jsou zrovna dostupná.

Praktické scénáře:

  * synchronizace dokumentů mezi desktopem a notebookem,
  * synchronizace poznámek, například Obsidian vaultu,
  * sdílení pracovních adresářů mezi více vlastními stroji,
  * přenos souborů mezi domácím serverem/NASem a klientskými zařízeními,
  * jednoduchá náhrada osobního cloudu bez provozu plnohodnotného Nextcloudu.

Syncthing není primárně zálohovací systém. Umí sice verzování souborů, ale pokud se chyba nebo smazání synchronizuje na všechna zařízení, stále je potřeba mít samostatné zálohy.

===== Jak funguje =====

Podle [[https://docs.syncthing.net/intro/getting-started.html|úvodního návodu]] se Syncthing nastavuje tak, že se nainstaluje na obě zařízení, spustí se lokální webové rozhraní a zařízení se navzájem spárují přes Device ID.

Základní princip:

  - Syncthing se spustí na každém zařízení.
  - Každé zařízení má vlastní kryptograficky odvozené Device ID.
  - Zařízení se musí navzájem přidat do konfigurace.
  - U každé složky se nastaví, se kterými zařízeními se má sdílet.
  - Změny souborů se pak automaticky synchronizují mezi povolenými zařízeními.

Webové GUI běží standardně lokálně na:

<code>
http://127.0.0.1:8384/
</code>

===== Základní pojmy =====

==== Device ====

Device je jedno zařízení zapojené do synchronizace. Může to být notebook, desktop, server, NAS nebo telefon. Zařízení se identifikují pomocí Device ID.

==== Folder ====

Folder je složka, kterou Syncthing synchronizuje. Každá složka má vlastní ID, lokální cestu a seznam zařízení, se kterými se sdílí.

==== Typy složek ====

Konfigurace složek podle [[https://docs.syncthing.net/users/config.html|dokumentace ke konfiguraci]] podporuje několik režimů:

  * **Send & Receive** — běžná obousměrná synchronizace.
  * **Send Only** — zařízení změny pouze posílá a nepřijímá vzdálené změny.
  * **Receive Only** — zařízení změny pouze přijímá a neposílá vlastní úpravy dál.
  * **Receive Encrypted** — režim pro nedůvěryhodné zařízení, kde mají být data uložená šifrovaně.

===== Bezpečnost =====

Podle [[https://docs.syncthing.net/users/security.html|bezpečnostních principů Syncthingu]] je komunikace mezi zařízeními chráněná přes TLS. Zařízení se při navazování spojení ověřují podle certifikátu, jehož otisk je reprezentovaný jako Device ID.

Důležité poznámky:

  * Device ID není tajné heslo, ale veřejný identifikátor zařízení.
  * Soukromé klíče a konfigurační adresář zařízení je potřeba chránit.
  * Kdo získá klíče a konfiguraci zařízení, může se za něj vydávat.
  * Discovery a relay servery mohou pomoci najít zařízení za NATem, ale vlastní synchronizovaná data mají být mezi zařízeními šifrovaná.
  * Webové GUI je ve výchozím stavu dostupné jen z lokálního stroje.

===== Discovery, NAT a relay =====

Syncthing umí zařízení hledat automaticky. Lokálně používá LAN discovery, mimo lokální síť může použít globální discovery server. Pokud nejde navázat přímé spojení, může se použít relay server.

To je praktické hlavně u notebooků a domácích připojení za NATem. Z pohledu soukromí je ale dobré vědět, že discovery a relay infrastruktura může prozrazovat metadata typu Device ID nebo IP adresu. Obsah synchronizovaných souborů tím nemá být zpřístupněný.

===== Instalace a spuštění =====

Syncthing lze instalovat jako běžnou aplikaci nebo službu podle operačního systému. Projekt poskytuje release balíčky, existují balíčky pro linuxové distribuce a dá se provozovat i v Dockeru.

Základní spuštění jádra Syncthingu:

<code bash>
syncthing
</code>

Po prvním spuštění Syncthing vytvoří konfiguraci, vygeneruje klíče zařízení a otevře nebo nabídne lokální webové rozhraní. Pro trvalý provoz na serveru je vhodné nastavit běh jako službu přes systemd, Docker, NAS balíček nebo jiný service manager.

===== Kdy se hodí =====

Syncthing dává smysl hlavně tam, kde:

  * data mají zůstat na vlastních zařízeních,
  * není potřeba centrální cloudové úložiště,
  * synchronizovaná zařízení jsou aspoň občas současně online,
  * stačí sdílení mezi známými zařízeními,
  * je potřeba jednoduchý provoz bez větší serverové aplikace.

Typický domácí setup může vypadat tak, že NAS nebo domácí server běží trvale a notebooky/desktopy se k němu připojují podle dostupnosti. Server pak funguje jako stabilní uzel, přes který se data dostanou i mezi zařízení, která nejsou online ve stejný okamžik.

===== Kdy se nehodí =====

Syncthing není ideální pro:

  * spolupráci mnoha náhodných uživatelů,
  * sdílení souborů přes veřejné odkazy,
  * kancelářskou realtime kolaboraci nad jedním dokumentem,
  * detailní oprávnění na úrovni uživatelů a skupin,
  * situace, kde žádné dvě synchronizované strany nejsou nikdy online zároveň a neexistuje trvale běžící mezilehlý uzel.

V takových případech bývá vhodnější Nextcloud, běžné cloudové úložiště, Git nebo jiný systém podle typu dat.

===== Související poznámky =====

Podle [[https://docs.syncthing.net/users/syncthing.html|dokumentace k příkazové řádce]] je hlavní aplikace command-line program se zabudovaným webovým rozhraním a HTTP API. Díky tomu se dobře hodí jak na desktop, tak na serverový provoz.

Pro infrastrukturu je zajímavé hlavně to, že jde o relativně jednoduchou službu: nepotřebuje databázový server, centrální backend ani uživatelský účet u třetí strany. Každé zařízení je samostatný uzel a důvěra se nastavuje explicitně mezi konkrétními zařízeními.

===== Zdroje =====

  * [[https://github.com/syncthing/syncthing|GitHub — syncthing/syncthing]]
  * [[https://syncthing.net/|Syncthing — oficiální web]]
  * [[https://docs.syncthing.net/|Syncthing Documentation]]
  * [[https://docs.syncthing.net/intro/getting-started.html|Syncthing — Getting Started]]
  * [[https://docs.syncthing.net/users/config.html|Syncthing — Configuration]]
  * [[https://docs.syncthing.net/users/security.html|Syncthing — Security Principles]]
  * [[https://docs.syncthing.net/users/syncthing.html|Syncthing — Command Line Operation]]