Mikä on Syncthing?

Syncthing on avoimen lähdekoodin ohjelma, joka pitää kansiot synkronoituina laitteidesi välillä suoraan ja ilman keskitettyä palvelinta. Projekti tarjoaa virallisen näköistiedoston syncthing/syncthing, jonka web-käyttöliittymä kuuntelee porttia 8384 ja jonka synkronointiprotokolla käyttää TCP:lle porttia 22000 ja QUIC:lle porttia 22000. Samaan verkkoon kuuluvat laitteet löytävät toisensa portin 21027 broadcast-lähetysten avulla.

Työkalun kuvaus

Tämä työkalu luo Syncthingille compose.yaml-tiedoston, joka noudattaa projektin Docker-README-tiedostoa. Oletuksena se käyttää isäntäverkkotilaa, jota README suosittelee, koska Syncthing voi tällöin nähdä paikallisverkossasi olevat laitteet. Tässä tilassa työkalu poistaa STGUIADDRESS-muuttujan käytöstä, jolloin käyttöliittymä kuuntelee Syncthing-asetuksissa määritettyä osoitetta, joka on oletuksena 127.0.0.1:8384. Voit myös valita siltaustilan. Tällöin työkalu julkaisee käyttöliittymän portin, TCP- ja UDP-synkronointiportin sekä etsintäportin ja varoittaa siltaustilan aiheuttamista rajoituksista. Määrität isäntänimen, käyttäjän ja ryhmän PUID- ja PGID-muuttujilla, valinnaisen UMASK- ja PCAP-muuttujan, datakansion sekä muita kansioita isännältä. Käyttöliittymän osoitetta seuraava terveystarkistus lisätään. Kaikki luodaan selaimessasi.

Ominaisuudet

  • Suositeltu isäntäverkkotila tai siltaustila, jossa portit 8384, 22000/tcp, 22000/udp ja 21027/udp julkaistaan
  • Käyttöliittymän kuunteluosoite isäntätilassa sekä varoitus, kun siihen voi muodostaa yhteyden muilta koneilta
  • Käyttöliittymäportin sidontaosoite siltaustilassa, kuten 127.0.0.1
  • PUID, PGID, UMASK ja PCAP sekä laitteen nimeä varten määritettävä isäntänimi
  • Isännän datakansio tai nimetty Docker-taltiotila, joka määritetään puolestasi
  • Synkronoitavat lisäkansiot, joista jokainen voidaan määrittää valinnaisesti vain luku -tilaan
  • README-tiedoston terveystarkistus, jonka portti ja osoite on mukautettu käyttöliittymän mukaan
  • Muut ympäristömuuttujat, tiedostoa selittävät kommentit sekä lataus nimellä compose.yaml

Esimerkit

Oletusasetukset tuottavat Syncthingin Docker-README-tiedoston esimerkin:

services:
  syncthing:
    image: syncthing/syncthing
    container_name: syncthing
    hostname: syncthing
    network_mode: host
    environment:
      PUID: "1000"
      PGID: "1000"
      STGUIADDRESS: ""
    volumes:
      - ./st-sync:/var/syncthing
    healthcheck:
      test: curl -fkLsS -m 2 127.0.0.1:8384/rest/noauth/health | grep -o --color=never OK || exit 1
      interval: 1m
      timeout: 10s
      retries: 3
    restart: unless-stopped

Vinkkejä

  • Tallenna tulos nimellä compose.yaml ja käynnistä se komennolla docker compose up -d. Avaa sitten http://127.0.0.1:8384
  • Dockerin oletussiltaustila piilottaa laitteidesi paikalliset osoitteet, joten yhteyden muodostaminen kestää kauemmin tai tapahtuu välityspalvelinten kautta. Käytä isäntätilaa, kun se on mahdollista
  • Näköistiedosto kuuntelee oletuksena osoitteessa 0.0.0.0:8384. Siksi isäntätila poistaa STGUIADDRESS-muuttujan käytöstä ja siksi siltaustilassa julkaistu käyttöliittymäportti kannattaa sitoa osoitteeseen 127.0.0.1, ellet halua käyttää sitä muilta koneilta
  • Kun käyttöliittymään voi muodostaa yhteyden muilta koneilta, määritä käyttöliittymälle salasana ja ota TLS käyttöön Syncthing-asetuksissa
  • PUID- ja PGID-tunnuksilla täytyy olla kirjoitusoikeus datakansioon ja lisäämiisi kansioihin
  • Täällä lisäämäsi kansiot näkyvät Syncthingissä säilön sisäisen polun alla, joten valitse kyseinen polku, kun lisäät kansion käyttöliittymässä
  • Synkronointiportti säilyy porttina 22000, koska Syncthing ilmoittaa muille laitteille, että niiden tulee muodostaa yhteys tähän porttiin