ftp-sync
ftp-sync ist ein kleines Kommandozeilen-Werkzeug, mit dem ich meine Websites zwischen meinem Rechner und dem Webspace abgleiche. Es ist für meinen eigenen Arbeitsablauf entstanden und läuft bei mir vor jedem Upload. Hier beschreibe ich, wie es funktioniert und warum es so gebaut ist, wie es ist.
Version 1.0.0 vom 20.11.2026 · nicht zum Download
Auf einen Blick
| Auftraggeber | Eigenprojekt |
| Meine Rolle | Konzept, Entwicklung, täglicher Einsatz |
| Umfang | Abgleich lokaler Projekte mit dem Webspace in beide Richtungen, mit Probelauf, Sicherung und Rückfrage vor jedem Upload |
| Start | Oktober 2026 |
Ausgangslage
Ich arbeite an meinen Websites lokal: Code und Theme liegen in Git, getestet wird in einer Testinstanz auf meinem Rechner. Auf den Server kommt das Ganze per FTP, weil ein einfacher Webspace meist nichts anderes anbietet. Das eigentliche Problem ist aber, dass sich bei WordPress auch auf dem Server ständig etwas ändert. Plugins aktualisieren sich, Bilder werden hochgeladen, ein Update tauscht Dateien im Kern aus. Lade ich dann stur meinen lokalen Stand hoch, überschreibe ich im schlimmsten Fall genau diese Änderungen mit einer älteren Fassung.
Die üblichen Programme helfen da nur halb. Ein FTP-Programm vergleicht bestenfalls Datum und Größe und fragt bei jeder Abweichung nach. Ein reines Spiegeln in eine Richtung kennt keinen Unterschied zwischen „lokal neu“ und „auf dem Server geändert“. Ich wollte ein Werkzeug, das sich merkt, wie der Server beim letzten Mal aussah.
Was wichtig war
- Änderungen auf dem Server haben Vorrang und dürfen nie unbemerkt überschrieben werden.
- Auf dem Server wird nie etwas gelöscht. Wegräumen bleibt eine bewusste Handarbeit.
- Vor jedem Upload sehe ich die Liste der Dateien und bestätige sie.
- Zugangsdaten liegen getrennt vom Code, sind nur für mich lesbar und landen nie in Git.
- Die Verbindung ist verschlüsselt, und es braucht nichts außer Python selbst.
Wie es funktioniert
Jeder Abgleich beginnt auf dem Server. Das Werkzeug liest die komplette Dateiliste mit Größe und Änderungszeit, über mehrere Verbindungen gleichzeitig, damit auch große Installationen schnell erfasst sind. Diese Liste vergleicht es mit dem Stand, den es sich beim letzten erfolgreichen Abgleich gemerkt hat.
Hat sich auf dem Server seither etwas getan, holt es genau diese Dateien herunter und hört dann auf. Lokale Dateien, die dabei ersetzt werden, sichert es vorher mit Zeitstempel. Waren sie auch bei mir geändert, steht das ausdrücklich als Warnung da. Danach schaue ich mir die Änderungen in Git an und starte den Abgleich ein zweites Mal. Dieser Stopp ist Absicht: Er zwingt mich, kurz hinzusehen, bevor irgendetwas in die andere Richtung geht.
Erst wenn der Server unverändert ist, kommt der Upload. Das Werkzeug zeigt, welche Dateien neu oder geändert sind, und wartet auf ein Ja. Jede Datei wird zuerst unter einem vorläufigen Namen übertragen und erst am Ende umbenannt, so liegt auf dem Server nie eine halbe Datei. Anschließend merkt es sich den neuen Serverstand.
Dazu kommen ein paar Feinheiten aus dem Alltag. Konfigurationsdateien mit Zugangsdaten, Caches und Protokolle sind vom Abgleich ausgenommen. Beim WordPress-Kern zählt nur die Größe, weil die Zeitstempel nach einem Update nicht zuverlässig sind. Bilder, die jemand auf dem Server gelöscht hat, schiebt es bei mir in ein Archiv außerhalb des Projekts, damit sie nicht beim nächsten Upload wieder auftauchen. Ein Probelauf zeigt alles an, ohne etwas zu verändern, und auf Wunsch gleicht es alle Websites nacheinander ab und gibt am Ende eine Übersicht aus.
Gedanken dahinter
Der wichtigste Gedanke ist wohl, dass ein Abgleich nicht schlau sein muss, sondern vorsichtig. Das Werkzeug löst keine Konflikte selbst und entscheidet nichts, was sich nicht rückgängig machen lässt. Es sorgt nur dafür, dass ich jede Überraschung sehe, solange sie noch harmlos ist. Git auf meinem Rechner ist dabei das Sicherheitsnetz: Was vom Server kommt, sehe ich als ganz normale Änderung und kann es prüfen, übernehmen oder verwerfen.
Bewusst weggelassen habe ich alles, was auf dem Server löscht. Das wäre bequem, aber ein einziger Fehler im Vergleich könnte eine ganze Website leeren. Ab und zu eine alte Datei von Hand zu entfernen, ist mir diese Sicherheit wert.
Warum es keinen Download gibt
ftp-sync ist eng auf meine Arbeitsweise zugeschnitten: auf WordPress, auf meine Ordnerstruktur, auf Git als Sicherheitsnetz und auf die Eigenheiten der Server, mit denen ich arbeite. Bei einem Werkzeug, das Dateien auf fremden Websites überschreiben kann, möchte ich keine halb passende Lösung weitergeben. Den Ansatz beschreibe ich trotzdem gern, vielleicht hilft er dir beim eigenen Aufbau.
Weitere Werkzeuge, Plugins und Websites findest du unter Projekte. Fragen zum Ansatz beantworte ich gern, die Kontaktwege stehen auf der Seite Über mich.