FTP/SFTP Sync Watcher

Eine VS Code Extension für automatischen Upload und Synchronisation von Dateien auf FTP/SFTP Server.

Features

• 🔄 Automatischer Upload beim Speichern - Dateien werden automatisch hochgeladen, wenn sie gespeichert werden
• 👁️ File Watcher - Überwacht Dateiänderungen und synchronisiert automatisch
• 🗑️ Auto-Delete - Optionales Löschen von Remote-Dateien, wenn lokale Dateien gelöscht werden
• 📁 .gitignore Support - Respektiert .gitignore Regeln
• 🚫 Benutzerdefinierte Exclude-Patterns - Schließe Dateien und Ordner mit Glob-Patterns aus
• 🔐 SFTP mit SSH Key Support - Sichere Verbindung mit Private Key Authentifizierung
• 📊 Status Bar Integration - Zeigt den aktuellen Sync-Status an
• ⚡ Robuste Verbindung - Automatische Wiederverbindung bei Verbindungsabbrüchen
• 🔁 Operation Queue - Verhindert hängende Uploads durch Timeout und Retry-Mechanismen
• 🏃 Concurrent Uploads - Mehrere Dateien gleichzeitig hochladen

Warum diese Extension?

Andere FTP/SFTP Extensions haben oft das Problem, dass sie nach einer Weile aufhören zu funktionieren und Dateien nicht mehr hochladen. Diese Extension löst das durch:

• Automatische Wiederverbindung mit exponentialem Backoff (bis zu 5 Versuche)
• Timeout für jede Operation - keine hängenden Uploads mehr
• Health-Checks - erkennt Verbindungsprobleme bevor sie zum Problem werden
• Operation Queue - Uploads werden in einer Queue verarbeitet, nicht blockierend
• Retry-Mechanismus - Fehlgeschlagene Uploads werden automatisch wiederholt

Installation

1. Öffne VS Code
2. Drücke Ctrl+P und gib ein: ext install ftp-sync-watcher
3. Oder installiere manuell mit der VSIX-Datei

Konfiguration

Erstelle eine .ftpsync.json Datei im Root-Verzeichnis deines Projekts:

SFTP Konfiguration (empfohlen)

{
  "name": "Production Server",
  "protocol": "sftp",
  "host": "example.com",
  "port": 22,
  "username": "deploy",
  "privateKeyPath": "~/.ssh/id_rsa",
  "remotePath": "/var/www/html",
  "uploadOnSave": true,
  "watcher": {
    "enabled": true,
    "files": "**/*",
    "autoUpload": true,
    "autoDelete": false
  },
  "ignore": [".git", ".vscode", "node_modules", ".ftpsync.json", "*.log"],
  "useGitIgnore": true
}

FTP Konfiguration

{
  "name": "FTP Server",
  "protocol": "ftp",
  "host": "ftp.example.com",
  "port": 21,
  "username": "ftpuser",
  "password": "your-password",
  "remotePath": "/public_html",
  "secure": true,
  "uploadOnSave": true
}

Konfigurationsoptionen

Commands

Alle Commands sind über die Command Palette (Ctrl+Shift+P) verfügbar:

Kontextmenü

Rechtsklick auf Dateien/Ordner im Explorer:

• Upload File/Folder - Hochladen
• Download File/Folder - Herunterladen

Status Bar

Die Status Bar zeigt den aktuellen Zustand an:

• ☁️ FTP Sync - Watcher inaktiv (klicken zum Starten)
• 👁️ Watching - Watcher aktiv (klicken zum Stoppen)
• 🔄 Syncing... - Upload läuft
• ❌ Error - Fehler aufgetreten (Output für Details prüfen)

Glob-Patterns für Ignore

Beispiele für Exclude-Patterns:

{
  "ignore": [
    ".git", // .git Ordner
    ".vscode", // .vscode Ordner
    "node_modules", // node_modules Ordner
    "*.log", // Alle .log Dateien
    "**/*.map", // Alle .map Dateien in allen Ordnern
    "dist/**", // Alles im dist Ordner
    "!dist/index.html", // Außer dist/index.html
    "temp*", // Alle Dateien/Ordner die mit temp beginnen
    "**/.DS_Store" // Alle .DS_Store Dateien
  ]
}

Watcher-Patterns

Beispiele für Watch-Patterns:

{
  "watcher": {
    "files": "src/**/*.{ts,js,css,html}",
    "autoUpload": true,
    "autoDelete": false
  }
}

Sicherheitshinweise

⚠️ Wichtig:

• Speichere keine Passwörter in der .ftpsync.json - verwende SSH Keys für SFTP
• Füge .ftpsync.json zu .gitignore hinzu, wenn sensible Daten enthalten sind
• Verwende privateKeyPath anstelle von password für SFTP-Verbindungen

Problembehandlung

Verbindungsprobleme

1. Überprüfe Host, Port und Zugangsdaten
2. Stelle sicher, dass der Server erreichbar ist
3. Aktiviere "debug": true für detaillierte Logs
4. Prüfe den Output Channel (FTP Sync: Show Output Channel)

Dateien werden nicht hochgeladen

1. Prüfe die ignore Patterns
2. Stelle sicher, dass uploadOnSave aktiviert ist
3. Prüfe, ob die Datei von .gitignore ausgeschlossen wird

SSH Key Probleme

1. Stelle sicher, dass der Key im OpenSSH Format ist
2. Prüfe die Dateiberechtigungen des Private Keys
3. Bei verschlüsselten Keys: passphrase angeben

Lizenz

MIT License

Beitragen

Contributions sind willkommen! Bitte erstelle einen Pull Request oder melde Issues auf GitHub.