Τι είναι το Syncthing;

Το Syncthing είναι ένα πρόγραμμα ανοιχτού κώδικα που διατηρεί συγχρονισμένους τους φακέλους μεταξύ των συσκευών σας, απευθείας και χωρίς κεντρικό διακομιστή. Το έργο παρέχει μια επίσημη image, syncthing/syncthing, της οποίας το web GUI ακούει στη θύρα 8384 και της οποίας το πρωτόκολλο συγχρονισμού χρησιμοποιεί τη θύρα 22000 για TCP και QUIC. Οι συσκευές στο ίδιο δίκτυο εντοπίζουν η μία την άλλη μέσω broadcast στη θύρα 21027.

Περιγραφή εργαλείου

Αυτό το εργαλείο δημιουργεί ένα compose.yaml για το Syncthing, σύμφωνα με το Docker README του έργου. Από προεπιλογή χρησιμοποιεί δικτύωση κεντρικού υπολογιστή, όπως συνιστά το README, επειδή έτσι το Syncthing μπορεί να εντοπίζει τις συσκευές στο τοπικό σας δίκτυο. Σε αυτήν τη λειτουργία το εργαλείο καταργεί τη μεταβλητή STGUIADDRESS, ώστε το GUI να ακούει στη διεύθυνση που έχει οριστεί στις ρυθμίσεις του Syncthing, δηλαδή από προεπιλογή στη 127.0.0.1:8384. Μπορείτε επίσης να επιλέξετε λειτουργία bridge. Σε αυτήν την περίπτωση το εργαλείο δημοσιεύει τη θύρα του GUI, τη θύρα συγχρονισμού για TCP και UDP, καθώς και τη θύρα εντοπισμού, και σας προειδοποιεί για το κόστος της λειτουργίας bridge. Ορίζετε το όνομα κεντρικού υπολογιστή, τον χρήστη και την ομάδα με τα PUID και PGID, ένα προαιρετικό UMASK και PCAP, τον φάκελο δεδομένων και επιπλέον φακέλους από τον κεντρικό υπολογιστή. Προστίθεται ένας έλεγχος λειτουργίας που ακολουθεί τη διεύθυνση του GUI. Όλα δημιουργούνται στο πρόγραμμα περιήγησής σας.

Δυνατότητες

  • Δικτύωση κεντρικού υπολογιστή, όπως συνιστάται, ή λειτουργία bridge με δημοσιευμένες τις θύρες 8384, 22000/tcp, 22000/udp και 21027/udp
  • Η διεύθυνση ακρόασης του GUI στη λειτουργία κεντρικού υπολογιστή, με προειδοποίηση όταν είναι προσβάσιμη από άλλους υπολογιστές
  • Μια διεύθυνση σύνδεσης για τη θύρα του GUI στη λειτουργία bridge, όπως η 127.0.0.1
  • Τα PUID, PGID, UMASK και PCAP, καθώς και ένα όνομα κεντρικού υπολογιστή για το όνομα της συσκευής
  • Ένας φάκελος δεδομένων στον κεντρικό υπολογιστή ή ένας επώνυμος τόμος Docker, ο οποίος δηλώνεται αυτόματα
  • Επιπλέον φάκελοι προς συγχρονισμό, καθένας προαιρετικά μόνο για ανάγνωση
  • Ο έλεγχος λειτουργίας από το README, προσαρμοσμένος στη θύρα και τη διεύθυνση του GUI
  • Οποιαδήποτε άλλη μεταβλητή περιβάλλοντος, σχόλια που εξηγούν το αρχείο και λήψη ως compose.yaml

Παραδείγματα

Οι προεπιλεγμένες ρυθμίσεις δίνουν το παράδειγμα από το Docker README του Syncthing:

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

Συμβουλές

  • Αποθηκεύστε το αποτέλεσμα ως compose.yaml και εκκινήστε το με docker compose up -d. Στη συνέχεια ανοίξτε το http://127.0.0.1:8384
  • Η προεπιλεγμένη λειτουργία bridge του Docker αποκρύπτει τις τοπικές διευθύνσεις των συσκευών σας, οπότε συνδέονται αργά ή μέσω relay. Χρησιμοποιήστε τη λειτουργία κεντρικού υπολογιστή όποτε είναι δυνατό
  • Η image ακούει από προεπιλογή στη 0.0.0.0:8384. Για αυτό η λειτουργία κεντρικού υπολογιστή καταργεί τη STGUIADDRESS και η λειτουργία bridge θα πρέπει να δεσμεύει τη δημοσιευμένη θύρα του GUI στη 127.0.0.1, εκτός αν θέλετε να είναι προσβάσιμη από άλλους υπολογιστές
  • Όταν το GUI είναι προσβάσιμο από άλλους υπολογιστές, ορίστε κωδικό πρόσβασης για το GUI και ενεργοποιήστε το TLS στις ρυθμίσεις του Syncthing
  • Ο φάκελος δεδομένων και οι φάκελοι που προσθέτετε πρέπει να είναι εγγράψιμοι από τα PUID και PGID
  • Οι φάκελοι που προσθέτετε εδώ εμφανίζονται στο Syncthing κάτω από τη διαδρομή μέσα στο container, επομένως επιλέξτε αυτήν τη διαδρομή όταν προσθέτετε τον φάκελο στο GUI
  • Η θύρα συγχρονισμού παραμένει η 22000, επειδή το Syncthing ενημερώνει τις άλλες συσκευές να συνδέονται σε αυτήν τη θύρα