Benutzerdefinierte Rclone-Flags und erweiterte Optionen in RcloneView-Jobs verwenden
RcloneView übernimmt die üblichen Fälle automatisch, aber die wahre Stärke von rclone liegt in seinen Flags. Zu wissen, welche man hinzufügt -- und wo -- kann Übertragungszeiten halbieren oder hartnäckige Randfälle lösen.
Rclone verfügt über Hunderte von Kommandozeilen-Flags, die alles steuern, von der Parallelität der Übertragung über das Checksummen-Verhalten bis hin zur Wiederholungslogik. RcloneView bietet eine übersichtliche Oberfläche für die häufigsten Vorgänge, ermöglicht aber auch das Einfügen benutzerdefinierter Flags in jeden Job für Situationen, in denen die Standardeinstellungen nicht ausreichen. Dieser Leitfaden behandelt die nützlichsten Flags, wann man sie verwendet und wie man sie in RcloneView konfiguriert.
Alle Clouds an einem Ort verwalten & synchronisieren
RcloneView ist eine plattformübergreifende GUI für rclone. Vergleichen Sie Ordner, übertragen oder synchronisieren Sie Dateien und automatisieren Sie Multi-Cloud-Workflows mit einer klaren, visuellen Oberfläche.
- Ein-Klick-Jobs: Kopieren · Synchronisieren · Vergleichen
- Zeitpläne & Verlauf für zuverlässige Automatisierung
- Funktioniert mit Google Drive, OneDrive, Dropbox, S3, WebDAV, SFTP und mehr
Kernfunktionen kostenlos. Plus-Automatisierungen verfügbar.
Wo man in RcloneView benutzerdefinierte Flags hinzufügt
RcloneView unterstützt benutzerdefinierte Flags an zwei Stellen:
- Job-Konfiguration -- beim Erstellen oder Bearbeiten eines Jobs (Kopieren, Synchronisation, Verschieben) gibt es ein Feld für zusätzliche Flags. Geben Sie sie genau so ein, wie Sie es auf der Kommandozeile tun würden.
- Terminal -- für einmalige Befehle öffnen Sie das Terminal-Panel und geben den vollständigen rclone-Befehl mit allen benötigten Flags ein.
Flags, die zu einem gespeicherten Job hinzugefügt wurden, bleiben über alle Läufe hinweg erhalten, sodass Sie sie einmal konfigurieren und sie bei jeder Ausführung des Jobs angewendet werden -- einschließlich geplanter Läufe.
Performance-Tuning-Flags
Diese Flags wirken sich direkt auf die Übertragungsgeschwindigkeit und den Ressourcenverbrauch aus.
--transfers N
Steuert, wie viele Dateien parallel übertragen werden. Standard ist 4.
--transfers 16
Erhöhen Sie diesen Wert bei vielen kleinen Dateien oder wenn der Anbieter hohe Parallelität unterstützt. S3, B2 und Wasabi verkraften 16-32 parallele Übertragungen gut. Google Drive kann oberhalb von 8-10 drosseln.
--checkers N
Steuert, wie viele Dateien parallel geprüft (verglichen) werden. Standard ist 8.
--checkers 32
Erhöhen Sie diesen Wert, wenn Sie Sync- oder Check-Vorgänge auf Verzeichnissen mit vielen Dateien ausführen. Die Prüfphase ist oft der Engpass, nicht die Übertragung.
--fast-list
Verwendet weniger API-Aufrufe zum Auflisten von Verzeichnissen, indem alle Objekte in einer einzigen Anfrage angefordert werden. Deutlich schneller bei S3-kompatiblen Anbietern mit großen Buckets.
--fast-list
Kompromiss: verbraucht mehr Speicher, da die gesamte Auflistung im Speicher gehalten wird. Bei Buckets mit Millionen von Objekten kann dies mehrere Gigabyte RAM belegen.
--no-traverse
Überspringt das Auflisten des Ziels vollständig. Nützlich, wenn wenige Dateien in ein Ziel mit Millionen vorhandener Dateien kopiert werden.
--no-traverse
Ohne dieses Flag listet rclone das gesamte Ziel auf, um vorhandene Dateien zu prüfen. Wenn Sie wissen, dass das Ziel größtenteils irrelevant ist (z. B. das Kopieren von 10 neuen Dateien in einen Bucket mit 5 Millionen Objekten), spart --no-traverse mehrere Minuten Auflistungszeit.
--buffer-size
Steuert den In-Memory-Puffer pro Dateiübertragung. Standard ist 16 MiB.
--buffer-size 64M
Erhöhen Sie diesen Wert bei großen Dateien auf Verbindungen mit hoher Bandbreite, um E/A-Stockungen zu reduzieren. Verringern Sie ihn, wenn der Speicher begrenzt ist.
--multi-thread-streams N
Anzahl der Streams für Multi-Thread-Downloads einer einzelnen Datei. Standard ist 4.
--multi-thread-streams 8
Hilfreich beim Herunterladen großer einzelner Dateien von Anbietern, die Byte-Range-Anfragen unterstützen.
Vergleichs- und Verhaltens-Flags
Diese Flags ändern, wie rclone entscheidet, was übertragen wird.
--size-only
Vergleicht Dateien nur anhand der Größe, ignoriert Änderungsdatum und Checksummen.
--size-only
Verwenden Sie dies, wenn Zeitstempel unzuverlässig sind (häufig bei manchen SFTP-Servern) oder wenn Sie den schnellstmöglichen Vergleich wünschen, auf Kosten des Übersehens von Änderungen bei gleicher Größe.
--ignore-existing
Überspringt Dateien, die bereits auf dem Ziel vorhanden sind, unabhängig von Größe oder Datum.
--ignore-existing
Ideal für inkrementelle Uploads, bei denen Sie vorhandene Dateien nie ändern -- nur neue hinzufügen. Deutlich schneller als der Vergleich jeder Datei.
--ignore-size
Vergleicht Dateien nur anhand des Änderungsdatums, ignoriert die Größe.
--ignore-size
Selten benötigt, aber nützlich bei Anbietern, die für bestimmte Dateitypen falsche Größen melden.
--update
Überspringt Dateien, die auf dem Ziel neuer sind.
--update
Nützlich für bidirektionale Workflows, bei denen Sie nur Dateien kopieren möchten, die auf dem Ziel älter sind.
Wiederholungs- und Zuverlässigkeits-Flags
--retries N
Anzahl der Wiederholungen für fehlgeschlagene Vorgänge. Standard ist 3.
--retries 10
Erhöhen Sie diesen Wert bei unzuverlässigen Netzwerken oder Anbietern mit intermittierenden Fehlern.
--retries-sleep DAUER
Wartezeit zwischen Wiederholungen. Standard ist 0.
--retries-sleep 5s
Fügt eine Verzögerung zwischen Wiederholungen hinzu, nützlich bei Rate-Limiting durch den Anbieter.
--low-level-retries N
Anzahl der Wiederholungen für Low-Level-Vorgänge (HTTP-Anfragen). Standard ist 10.
--low-level-retries 20
--timeout DAUER
IO-Leerlauf-Timeout. Standard ist 5m0s.
--timeout 10m
Erhöhen Sie diesen Wert bei sehr langsamen Verbindungen oder Anbietern mit hoher Latenz.
Debugging- und Logging-Flags
Wenn ein Job fehlschlägt oder sich unerwartet verhält, helfen diese Flags bei der Diagnose des Problems.
-v / -vv
Ausführliche und sehr ausführliche Ausgabe.
-v
Zeigt jede Datei während der Übertragung sowie grundlegende Fortschrittsinformationen. Verwenden Sie -vv für detaillierte Debug-Ausgaben einschließlich HTTP-Anfragen.
--log-file PFAD
Schreibt Logs in eine Datei anstelle der Konsole.
--log-file /tmp/rclone-debug.log
--log-level DEBUG
Legt die Log-Ebene explizit fest.
--log-level DEBUG
Erzeugt die detaillierteste Ausgabe. Verwenden Sie dies beim Melden von Problemen oder beim Untersuchen unerwarteten Verhaltens.
--dry-run
Simuliert den Vorgang, ohne Änderungen vorzunehmen.
--dry-run
Führen Sie dies immer zuerst aus, wenn Sie eine neue Flag-Kombination testen, um zu bestätigen, dass sie das tut, was Sie erwarten.
Job-spezifische Flag-Konfiguration
RcloneView ermöglicht es Ihnen, unterschiedliche Flag-Sets für unterschiedliche Jobs zu speichern. Einige praktische Kombinationen:
Sync großer Dateien zu S3:
--transfers 8 --checkers 16 --fast-list --buffer-size 64M
Inkrementelles Backup kleiner Dateien:
--transfers 32 --checkers 64 --ignore-existing --fast-list
Vorsichtige Synchronisation mit vorherigem Dry-Run:
--dry-run -v
Entfernen Sie dann --dry-run für den eigentlichen Lauf.
Fehlgeschlagene Übertragung debuggen:
-vv --log-file /tmp/debug.log --retries 1
Flags, die Sie meiden sollten, wenn Sie nicht wissen, was Sie tun
| Flag | Risiko |
|---|---|
--delete-before | Löscht Zieldateien vor der Übertragung -- gefährlich, wenn die Übertragung auf halbem Weg fehlschlägt |
--max-delete N ohne Test | Kann die Bereinigung verhindern, wenn zu niedrig eingestellt |
--no-check-certificate | Deaktiviert die TLS-Überprüfung -- Sicherheitsrisiko |
--ignore-checksum | Überspringt die Integritätsprüfung -- untergräbt den Sinn von Checksummen |
Best Practices
- Mit Standardeinstellungen beginnen -- die Standardeinstellungen von rclone sind für die meisten Workloads sinnvoll. Fügen Sie Flags nur hinzu, wenn Sie ein konkretes Problem oder einen messbaren Engpass haben.
- Mit --dry-run testen, bevor Sie neue Flags auf Produktions-Jobs anwenden.
- Ihre Flags dokumentieren -- notieren Sie beim Speichern eines Jobs mit benutzerdefinierten Flags, warum jedes Flag dort ist, damit Sie (oder Teammitglieder) die Absicht später nachvollziehen können.
- Vorher und nachher benchmarken -- messen Sie Übertragungszeiten mit und ohne Performance-Flags, um zu bestätigen, dass sie für Ihren Workload tatsächlich helfen.
- -v für Produktions-Jobs verwenden -- der geringe Mehraufwand lohnt sich für die Einsicht in das, was während jedes Laufs passiert ist.
Verwandte Anleitungen:
- Integrität von Cloud-Dateien mit Check und Compare überprüfen
- Unterbrochene und fehlgeschlagene Übertragungen wiederherstellen
- Cloud-zu-Cloud-Übertragungen und Synchronisation
Unterstützte Cloud-Anbieter
