Syncthing zwischen zwei Macs und dem NAS

Anleitung: ~/Developer mit Syncthing zwischen MacBook, Mac mini und einem UGREEN-NAS abgleichen, nur über ein Direktkabel, dazu eine externe Fotoplatte als Spiegel auf dem NAS.

Artikel Erstellt Aktualisiert

Geprüft von adrian am

Zwei Macs, ein NAS und ein Kabel dazwischen. Ich arbeite mal am MacBook, mal am Mac mini, und ~/Developer soll auf beiden gleich aussehen. Seit November 2026 spiegelt dasselbe Setup auch meine Fotosammlung von einer externen Platte aufs NAS. Syncthing übernimmt den Abgleich, das NAS ist der Knoten, der immer läuft. Ein Spiegel allein ist noch kein Backup, denn auch Löschungen wandern mit. Dafür sorgen die Versionierung auf dem NAS und mein verschlüsseltes pCloud-Backup.

Wie eine Änderung vom MacBook auf das NAS kommt · Stimme: ElevenLabs (elevenlabs.io)

Stand

~/Developer (rund 77.000 Dateien und 36 GiB nach den Ignore-Regeln) läuft zwischen MacBook und NAS. Der Mac mini ist geplant. Den Ordner Library (2,9 TB, rund 174.000 Dateien) habe ich am 2026-11-18 dazugenommen. Sein erster Scan dauert am MacBook rund 20 Stunden, auf dem NAS rund 8 Stunden. Das abschließende Aufräumen auf dem NAS steht noch aus.

Aufbau

  • NAS: UGREEN DXP4800 Plus mit UGOS. Syncthing 2.1.6 läuft in Docker, angelegt über die Docker-App von UGOS. Weboberfläche auf Port 8384, Abgleich auf Port 22001.
  • Macs: die Syncthing-App aus Homebrew (brew install --cask syncthing), kein Docker.
  • Netz: ein USB-Adapter mit 5 GbE am Mac, direkt am 10-GbE-Anschluss des NAS. Netz 192.168.100.0/24, NAS .2, Mac .1, ohne Router. Den Adapter stecke ich zwischen den beiden Macs um, es hängt also immer nur ein Mac dran.
Ordner-ID Am Mac Auf dem NAS (im Container) Typ auf dem NAS
developer ~/Developer /var/syncthing/home/Developer Senden & Empfangen
Library /Volumes/G-DRIVE ArmorATD/Library /var/syncthing/Library Nur empfangen

Abgleich nur über das Kabel

Über das Heimnetz darf der Abgleich nie laufen. Jedes Gerät hat die Adresse des anderen fest eingetragen und nimmt nur Verbindungen aus dem Kabelnetz an:

Wo Gerät Adressen Erlaubte Netzwerke
MacBook, Mac mini NAS tcp://192.168.100.2:22001 192.168.100.0/24
NAS jeder Mac tcp://192.168.100.1:22000 192.168.100.0/24

Eine Adresse dynamic gibt es nicht, damit spielen Gerätesuche und Relays keine Rolle. Steckt das Kabel nicht, wird eben nicht abgeglichen. Beide Macs haben am Adapter dieselbe IP, Syncthing unterscheidet sie an der Geräte-ID. Versucht das NAS den Mac zu erreichen, der gerade nicht dran ist, landet es beim anderen und bricht wegen der falschen ID ab. Das erzeugt nur Zeilen im Log.

Am Mac dürfen hier nur 192.168.100.x-Adressen auftauchen:

netstat -an -p tcp | grep ESTABLISHED | grep -E '\.2200[01] '

Ports auf dem NAS

Die UGOS-App „Sync & Backup“ bringt ein eigenes Syncthing mit (syncspace) und belegt schon die Ports 22000 und 21027. Mein Container veröffentlicht den Abgleich deshalb auf 22001 und lässt die lokale Gerätesuche (21027/udp) weg. Die Macs haben die Adresse des NAS ohnehin fest eingetragen.

Die Compose-Datei

Die Docker-App von UGOS nimmt nur eine einzige Compose-Datei und liest eine .env nicht zuverlässig. Meine compose.yaml hat deshalb die NAS-Werte als Standardwerte (${VAR:-Standard}), und ich füge sie unverändert in die App ein. Am Mac überschreibt eine lokale .env Pfade und Ports für einen Testlauf.

services:
  syncthing:
    image: syncthing/syncthing:${SYNCTHING_VERSION:-2.1.6}
    container_name: syncthing
    hostname: ${SYNCTHING_HOSTNAME:-dxp4800-syncthing}
    restart: unless-stopped
    environment:
      PUID: ${PUID:-1000}
      PGID: ${PGID:-10}
      TZ: ${TZ:-Europe/Berlin}
    volumes:
      - ./data/config:/var/syncthing/config
      - ${HOME_DIR:-/home/adrian}:/var/syncthing/home
      - ${LIBRARY_DIR:-/volume1/Library}:/var/syncthing/Library
    ports:
      - "${GUI_PORT:-8384}:8384"
      - "${SYNC_PORT:-22001}:22000/tcp"
      - "${SYNC_PORT:-22001}:22000/udp"
    networks:
      - syncthing

networks:
  syncthing:
    name: syncthing
  • Eingebunden ist der ganze Home-Ordner meines NAS-Benutzers. Ein weiterer Ordner von dort braucht also keine Änderung an der Compose-Datei.
  • /var/syncthing/home selbst nie als Ordner anlegen. Darin steckt Developer, und ineinander verschachtelte Syncthing-Ordner kommen sich in die Quere.
  • .ssh teile ich nicht. Der Container läuft als mein Benutzer und könnte dort schreiben.
  • Freigegebene Ordner außerhalb des Homes, etwa /volume1/Library, brauchen einen eigenen Mount.
  • In data/config liegen Schlüssel und Index des NAS. Ohne cert.pem und key.pem bekommt das NAS eine neue Geräte-ID und muss neu gekoppelt werden.

In der UGOS-App: Projekt → Erstellen bzw. bearbeiten, Name syncthing, Speicherpfad docker/syncthing, data/config vorher anlegen. Beim Redeploy lasse ich „Pull the latest image“ aus, der Tag ist ohnehin fest.

Ignore-Regeln

Jeder Ordner hat eine .stglobalignore, die mitsynchronisiert wird. Dazu hat jedes Gerät eine eigene .stignore, die Syncthing nie abgleicht, mit nur einer Zeile:

#include .stglobalignore

Für ~/Developer schließen die Regeln node_modules, .venv, target, .cache, Python-Caches, .DS_Store, Docker/*/data und Kartendownloads (*.osm.pbf) aus. Von 126 GB werden rund 30 GB abgeglichen, ein einziger Rust-Build-Ordner hat allein 59 GB. Docker/*/data bleibt draußen, weil dort laufende Datenbanken liegen. Schreiben zwei Macs dieselben Datenbankdateien, gehen sie kaputt.

Zwei Regeln aus der Praxis:

  • Die .stignore muss da sein, bevor der Ordner hinzugefügt wird. Sonst lädt Syncthing erst einmal alles hoch, auch node_modules.
  • Fehlt die .stglobalignore, scheitert das Include und der Ordner stoppt. Ein Ordner mit Nur empfangen könnte die Datei dann nie bekommen. Auf dem NAS habe ich sie deshalb vor dem Anlegen von Library von Hand erstellt, mit derselben SHA-256-Prüfsumme wie auf der Platte.

Einen Mac einrichten

  1. Adapter einstecken und die feste IP 192.168.100.1/24 ohne Router setzen.
  2. brew install --cask syncthing
  3. ~/Developer leer anlegen und zuerst .stignore und .stglobalignore hineinkopieren.
  4. Das NAS mit Adresse und erlaubtem Netz hinzufügen und developer mit dem Pfad ~/Developer teilen.
  5. Auf dem NAS das Gerät annehmen und dort Adresse und erlaubtes Netz eintragen.

Der Ordner Library: eine externe Platte als Master

Meine Fotos, Videos und die Backups des Lightroom-Katalogs liegen auf einer externen HFS+-Platte (G-DRIVE). Die Platte ist der Master, das NAS ein Spiegel. Neue Dateien, Änderungen und Löschungen auf der Platte kommen auf dem NAS an, egal an welchem Mac die Platte steckt. Zurück geht nichts, weil das NAS den Ordner dauerhaft mit Nur empfangen führt. Was direkt auf dem NAS geändert wird, zum Beispiel per SMB, erscheint dort als „Lokale Änderungen“ und lässt sich auf den Stand der Platte zurücksetzen.

Auf jedem Gerät hat der Ordner die ID Library und „Berechtigungen ignorieren“ ist an. Ohne das gälte jede Datei als geändert: Die Kopien auf dem NAS haben ACLs und rwxrwxrwx, die Dateien auf der Platte 644. Für Fotos spielen Dateirechte ohnehin keine Rolle. Auf dem NAS nutzt der Ordner die Versionierung Papierkorb mit 14 Tagen. Gestaffelt wäre bei 2,9 TB Daten und 2,2 TB freiem Platz zu viel.

Erstabgleich mit Daten auf beiden Seiten

Auf dem NAS lag schon eine fast gleiche Kopie. UGOS „Sync & Backup“ hatte den Ordner bis August 2026 abgeglichen. Seine Spuren (#SyncVersion, .stfolder-*) stehen in den Ignore-Regeln, und sein Auftrag muss aus, damit nicht zwei Sync-Programme gegeneinander arbeiten.

  1. Auf dem NAS den Ordner von Hand anlegen: ID Library, Nur empfangen, Berechtigungen ignorieren, geteilt mit dem MacBook. Das geht auch ohne Kabel, die Verbindung kommt, sobald das Kabel steckt.
  2. Beide Seiten hashen lassen. Das NAS schließt erst seinen eigenen Scan ab, bevor es etwas holt. Gleiche Dateien bekommen dann nur Version und Änderungszeit, ohne Übertragung. Während des Scans liefen etwa 0,2 MB/s über das Kabel, nur Indexdaten.
  3. Erst wenn beide Scans fertig sind: auf dem NAS die „Lokalen Änderungen“ durchsehen und „Lokale Änderungen zurücksetzen“ klicken, falls noch etwas übrig ist. In der Liste sollten nur Dateien stehen, die seit August von der Platte gelöscht wurden. Wer früher klickt, löscht alles, was das MacBook noch nicht gemeldet hat.

So lief es: Der Scan auf dem NAS dauerte rund 22 Stunden bei 35 bis 50 MB/s. Unterwegs standen unter „Lokale Änderungen“ fast alle Dateien des Ordners, mehr als 170.000. Das sah bedrohlich aus, war aber nur Buchhaltung. Das NAS hatte viele Dateien gehasht, bevor es den Index des MacBooks kannte, weil das Kabel noch nicht steckte und das MacBook selbst noch scannte. Diesen Dateien gab es eine eigene Version, und in einem Ordner „Nur empfangen“ gilt jede eigene Version als lokale Änderung. Die REST-API (/rest/db/file) zeigte auf beiden Seiten denselben Block-Hash, dieselbe Größe und dieselbe Änderungszeit, nur die Version war verschieden. Der alte UGOS-Index hilft dabei nicht: „Sync & Backup“ basiert zwar auch auf Syncthing, hat aber eigene Geräte-IDs und eine eigene Datenbank. Nach dem Scan übernahm das NAS für jede gleiche Datei die Version des MacBooks, ohne etwas zu kopieren, und lud die 38 GiB, die seit August neu waren. Am Ende stimmte der lokale Stand mit dem globalen überein (173.455 Dateien, 2,86 TiB), nichts war lokal geändert, und Zurücksetzen war nicht nötig.

Platte und Adapter wandern zusammen

Wenn ich den Mac wechsle, nehme ich Platte und Netzwerkadapter mit. Library ist auf beiden Macs mit derselben ID und demselben Pfad eingerichtet.

  • Der Mac ohne Platte meldet „folder marker missing“ und stoppt den Ordner. Das ist der Normalzustand.
  • Der Mac mit Platte prüft beim Anstecken die Änderungen nach Änderungszeit und Größe und gleicht dann ab.
  • Jeder Mac hat seinen eigenen Index. Das erste Einrichten am zweiten Mac heißt einmal die ganze Platte scannen, rund 20 Stunden.
  • Vor dem Wechsel warte ich auf „Aktuell“, werfe die Platte aus und stecke dann Platte und Adapter um. Bei Library hat die Platte selbst den aktuellen Stand. Bei developer ist das Warten wichtiger, weil dort jeder Mac seine eigene Kopie hat.
  • .stfolder nie von Hand anlegen, solange die Platte fehlt. Syncthing sähe einen leeren Ordner und gäbe die Löschungen weiter.

Die Syncthing-App braucht Zugriff auf Wechselmedien (Systemeinstellungen → Datenschutz & Sicherheit → Dateien und Ordner). Die Platte muss genau als /Volumes/G-DRIVE ArmorATD erscheinen. Hängt macOS ein 1 an, werfe ich sie aus und stecke sie neu an.

Den Developer-Pfad auf dem NAS umziehen

Anfangs war nur /home/adrian/Developer eingebunden, als /var/syncthing/Developer. Mit dem Wechsel auf den Home-Mount musste sich der Pfad ändern. Nach dem Redeploy meldete Syncthing „folder marker missing“ und hielt developer an, ohne etwas zu löschen. Dann habe ich den Ordner pausiert und unter Aktionen → Erweitert → Ordner → developer → Path auf /var/syncthing/home/Developer gestellt. Nach Speichern und Fortsetzen fand Syncthing dort dieselben Dateien samt .stfolder und machte mit dem vorhandenen Index weiter. Die Prüfung dauerte Sekunden, übertragen wurde nichts.

Lange Scans am MacBook

Für den Scan über 20 Stunden bleibt das MacBook am Netzteil, der Deckel offen. Die Einstellung „Prevent automatic sleeping on power adapter when the display is off“ setzt am Netzteil sleep 0, was pmset -g custom zeigt. Wer die Einstellungen eines Ordners speichert, auch nur ein neues Label, startet dessen Scan wieder bei 0 %. Schon gehashte Dateien erkennt Syncthing an Zeit und Größe und liest sie nicht noch einmal.

Was auf einen neuen Mac mitmuss

Das Gegenstück zu data/config ist am Mac ~/Library/Application Support/Syncthing. cert.pem und key.pem halten die Geräte-ID, config.xml Geräte, Ordner und Einstellungen. Den Index baut Syncthing neu auf, das kostet einen kompletten Scan. Migrationsassistent und Time Machine bringen den Ordner mit. Bei einer sauberen Neuinstallation sichere ich die drei Dateien und lege sie zurück, bevor Syncthing zum ersten Mal startet.

Worauf ich achte

  • Konflikte: Wird dieselbe Datei auf beiden Macs bearbeitet, bevor sie sich abgeglichen haben, behält Syncthing beide Fassungen (*.sync-conflict-*).
  • Git: .git-Ordner werden mitsynchronisiert. Das geht gut, solange ich nicht auf beiden Macs gleichzeitig im selben Repository arbeite. Für Repositories mit Remote bleibt git push die Sicherung.
  • Docker-Projekte in ~/Developer laufen nur auf einem Gerät, weil ihre Datenordner ausgeschlossen sind.
  • Syncthing auf NAS und Macs bleibt in derselben Hauptversion (2.x).

Noch offen

  • Den alten Library-Auftrag in UGOS „Sync & Backup“ abschalten.
  • Den Mac mini für developer und Library einrichten.
  • Nach dem ersten Plattenwechsel prüfen, ob in Library Dateien *.sync-conflict-* auftauchen.

Beruht auf

  • Syncthing: Library-Ordner und Home-Mount (Chat 2026-11-18/19) (raw/2026/2026-11-19/syncthing-library-ordner-und-home-mount-chat-2026-11-18-19.md) [chat]

Mehr dazu

Thema

  • Backup Kopien von Daten, die sich nach Löschen, Schaden oder Verlust zurückholen lassen, und wie man sie anlegt, aufbewahrt und testet.
  • Self-Hosting Dienste auf einem Server betreiben, über den du selbst verfügst, statt die gehostete Fassung eines Anbieters zu nutzen.

Nutzt

  • Syncthing Quelloffenes Programm, das Ordner direkt zwischen Geräten abgleicht, ohne Cloud-Dienst dazwischen. Jedes Gerät hat eine eigene ID und einen eigenen Schlüssel.

Siehe auch

  • Verschlüsseltes pCloud-Backup mit rclone Anleitung: ein nächtliches, clientseitig verschlüsseltes Backup vom Mac nach pCloud mit rclone und launchd, mit 90-Tage-Archiv und getesteter Wiederherstellung.

In der Graph-Ansicht zeigen