Filtrare file in un trasferimento rclone

Usa i filtri rclone per escludere da un trasferimento copie di sicurezza, cartelle temporanee o estensioni indesiderate. Elenca prima i percorsi selezionati, poi prova copy con le stesse regole. Un filtro limita un comando client; non limita ciò a cui può accedere una credenziale dosya rubata.

Prima di iniziare

Gli esempi caricano il contenuto di ./sample-source in una cartella esistente filter-checks tramite una connessione WebDAV chiamata dosya-webdav. Crea una struttura di origine innocua con report.pdf, draft.bak, tmp/cache.txt e photos/photo.jpg; scegli una destinazione senza file importanti.

Per configurare una nuova connessione, crea una chiave in Profilo → Chiavi API → Crea una chiave API. Scegli Accesso completo, seleziona Spazio di lavoro e in Restrizioni e scadenza → Protocolli → Solo quelli che scelgo consenti WebDAV. Salva la chiave completa dos_… quando la generi. In Integrazioni → WebDAV copia l’intero URL HTTPS di montaggio. Esegui rclone config, scegli una nuova connessione webdav, Vendor other, quell’URL, l’email del proprietario come User e la chiave API nella richiesta nascosta Password. Mantieni privata la configurazione: l’offuscamento della password rclone è reversibile.

Un montaggio normale elenca sei raccolte; scrivi tramite All, non in una vista intelligente come Images. Con una chiave ancorata a una cartella, gli elementi della cartella scelta sono già alla radice: sostituisci dosya-webdav:All/filter-checks sotto con dosya-webdav:filter-checks. Crea prima la destinazione in File o con rclone mkdir. Permessi della chiave e ruolo nello spazio di lavoro devono entrambi consentire WebDAV e il trasferimento; l’accesso completo non può ampliare il ruolo.

Passaggi: escludi file e prova il trasferimento

1. Verifica i due percorsi. Il primo argomento di copy è l’origine; il secondo riceve i file. Per scaricare, inverti i percorsi e scegli una destinazione locale vuota. Questi esempi non usano mai sync.
2. Elenca i file di origine selezionati. Le opzioni --exclude ripetute omettono file .bak ovunque e la struttura tmp al primo livello:

rclone lsf ./sample-source --recursive --files-only --exclude '*.bak' --exclude '/tmp/**'

Nella struttura di esempio attenditi report.pdf e photos/photo.jpg. Non dovrebbero apparire draft.bak o tmp/cache.txt. Una / iniziale ancora la regola alla radice dell’argomento di origine; /tmp/** non esclude photos/tmp/cache.txt. ** attraversa i separatori di directory, mentre * resta in un segmento del percorso. Usa barre oblique nei pattern su ogni piattaforma. Maiuscole e minuscole contano, a meno che tu non aggiunga volutamente --ignore-case.

3. Prova senza scrivere. Mantieni esattamente gli stessi filtri:

rclone copy ./sample-source dosya-webdav:All/filter-checks --exclude '*.bak' --exclude '/tmp/**' --dry-run -vv

Leggi percorsi previsti ed eventuali errori. Una simulazione può contattare o elencare la destinazione, ma non carica i file previsti; i contatori simulati non provano che i byte siano arrivati. Se è selezionato un nome inatteso, correggi la regola e ripeti elenco e anteprima.

4. Esegui la copia verificata. Rimuovi solo --dry-run e mantieni percorsi e regole:

rclone copy ./sample-source dosya-webdav:All/filter-checks --exclude '*.bak' --exclude '/tmp/**' --progress

Racchiudi i pattern tra virgolette affinché la shell passi il carattere jolly a rclone. Le virgolette singole funzionano negli esempi con shell POSIX e PowerShell; usa le doppie nel Prompt dei comandi Windows. Non usare dosya-webdav:*.pdf al posto di un filtro.

Includi tipi selezionati o ordina regole miste

Per i soli PDF usa la famiglia di inclusione da sola:

rclone lsf ./sample-source --recursive --files-only --include '*.pdf'

--include aggiunge implicitamente una regola finale che esclude tutto. Se servono sia tipi consentiti sia eccezioni, usa solo la famiglia filter, senza mescolare --include, --exclude e --filter. Crea transfer.rules fuori dalla struttura di origine con questo contenuto:

# Drop private and temporary material before allowing document types.
- /private/**
- *.bak
+ *.pdf
+ *.jpg
- **

Le regole sono eseguite dall’alto verso il basso; vince la prima corrispondenza. + *.pdf da solo non rifiuta tutto il resto, quindi qui - ** finale è essenziale. Sono supportati commenti # e ; su righe intere; un commento sulla stessa riga diventa parte del pattern. Mantieni lo stesso file per tutta la procedura:

rclone lsf ./sample-source --recursive --files-only --filter-from ./transfer.rules
rclone copy ./sample-source dosya-webdav:All/filter-checks --filter-from ./transfer.rules --dry-run -vv --dump filters
rclone copy ./sample-source dosya-webdav:All/filter-checks --filter-from ./transfer.rules --progress
rclone check ./sample-source dosya-webdav:All/filter-checks --filter-from ./transfer.rules --one-way --download

Per la struttura di esempio il file di regole seleziona report.pdf e photos/photo.jpg. check --download legge i byte per confrontarli e consuma la quota di download. --one-way controlla i file selezionati dall’origine senza richiedere che la destinazione sia priva di elementi aggiuntivi. Uscita zero, elenco previsto e verifica dei byte riuscita attestano il risultato della copia filtrata; un’uscita diversa richiede indagine.

Risultato previsto e rischi di eliminazione

Vengono copiati solo i file scelti dalle regole verificate. I file locali esclusi restano sul computer e il normale copy non elimina gli oggetti presenti solo nella destinazione. Nomi corrispondenti possono comunque essere sostituiti se rclone decide di trasferirli; dosya scrive una nuova versione con conservazione limitata, senza garantire un recupero permanente.

Se cambi il comando in sync, i file della destinazione nell’ambito selezionato possono essere eliminati per corrispondere all’origine. Di norma i percorsi esclusi sono protetti dall’eliminazione sync; --delete-excluded rimuove la protezione e può eliminare proprio i file nascosti dai filtri. rclone purge ignora i filtri. Non usarli come scorciatoia per pulire questa prova. L’eliminazione remota sposta i file idonei nel cestino e ne revoca i link di condivisione; un’eliminazione nella destinazione locale non è recuperabile dal cestino dosya.

Risoluzione dei problemi

Non è selezionato nulla. Controlla barra relativa alla radice, maiuscole e minuscole e se hai indicato solo una directory (/photos/) invece dei suoi file (/photos/**). --dump filters -vv mostra le regole applicate; non cambiare direzione del trasferimento mentre controlli i pattern.

Un’eccezione viene ignorata. Metti l’esclusione prima dell’inclusione più ampia nel file dei filtri. Mescolare famiglie di filtri non conserva l’ordine visivo della riga di comando; converti il comando in un unico file --filter-from.

403, blocco o rifiuto per quota. I filtri non aggirano restrizioni di ruolo o chiave, destinazioni bloccate, estensioni vietate o spazio disponibile. Il caricamento WebDAV richiede Content-Length e una cartella superiore esistente. Per un 429 rispetta Retry-After e riduci la concorrenza del client; più flussi GET di intervallo possono richiedere --multi-thread-streams 0 oltre a --transfers 1 durante il download.

Guide correlate

• Configurare una connessione rclone dosya
• Capire le eliminazioni di copy e sync
• Regole ufficiali dei filtri rclone