2016-08-04 04:36:28 +08:00
|
|
|
---
|
2016-08-25 05:58:24 +08:00
|
|
|
date: 2016-08-24T23:01:36+01:00
|
2016-08-04 04:36:28 +08:00
|
|
|
title: "rclone"
|
|
|
|
|
slug: rclone
|
|
|
|
|
url: /commands/rclone/
|
|
|
|
|
---
|
|
|
|
|
## rclone
|
|
|
|
|
|
2016-08-25 05:58:24 +08:00
|
|
|
Sync files and directories to and from local and remote object stores - v1.33-DEV
|
2016-08-04 04:36:28 +08:00
|
|
|
|
|
|
|
|
### Synopsis
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rclone is a command line program to sync files and directories to and
|
|
|
|
|
from various cloud storage systems, such as:
|
|
|
|
|
|
|
|
|
|
* Google Drive
|
|
|
|
|
* Amazon S3
|
|
|
|
|
* Openstack Swift / Rackspace cloud files / Memset Memstore
|
|
|
|
|
* Dropbox
|
|
|
|
|
* Google Cloud Storage
|
|
|
|
|
* Amazon Drive
|
|
|
|
|
* Microsoft One Drive
|
|
|
|
|
* Hubic
|
|
|
|
|
* Backblaze B2
|
|
|
|
|
* Yandex Disk
|
|
|
|
|
* The local filesystem
|
|
|
|
|
|
|
|
|
|
Features
|
|
|
|
|
|
|
|
|
|
* MD5/SHA1 hashes checked at all times for file integrity
|
|
|
|
|
* Timestamps preserved on files
|
|
|
|
|
* Partial syncs supported on a whole file basis
|
|
|
|
|
* Copy mode to just copy new/changed files
|
|
|
|
|
* Sync (one way) mode to make a directory identical
|
|
|
|
|
* Check mode to check for file hash equality
|
|
|
|
|
* Can sync to and from network, eg two different cloud accounts
|
|
|
|
|
|
|
|
|
|
See the home page for installation, usage, documentation, changelog
|
|
|
|
|
and configuration walkthroughs.
|
|
|
|
|
|
|
|
|
|
* http://rclone.org/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
rclone
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Options
|
|
|
|
|
|
|
|
|
|
```
|
2016-08-25 05:58:24 +08:00
|
|
|
--acd-templink-threshold int Files >= this size will be downloaded via their tempLink.
|
|
|
|
|
--acd-upload-wait-time duration Time to wait after a failed complete upload to see if it appears. (default 2m0s)
|
|
|
|
|
--ask-password Allow prompt for password for encrypted configuration. (default true)
|
|
|
|
|
--b2-chunk-size int Upload chunk size. Must fit in memory.
|
|
|
|
|
--b2-test-mode string A flag string for X-Bz-Test-Mode header.
|
|
|
|
|
--b2-upload-cutoff int Cutoff for switching to chunked upload
|
|
|
|
|
--b2-versions Include old versions in directory listings.
|
|
|
|
|
--bwlimit int Bandwidth limit in kBytes/s, or use suffix b|k|M|G
|
|
|
|
|
--checkers int Number of checkers to run in parallel. (default 8)
|
|
|
|
|
-c, --checksum Skip based on checksum & size, not mod-time & size
|
|
|
|
|
--config string Config file. (default "/home/ncw/.rclone.conf")
|
|
|
|
|
--contimeout duration Connect timeout (default 1m0s)
|
|
|
|
|
--cpuprofile string Write cpu profile to file
|
|
|
|
|
--delete-after When synchronizing, delete files on destination after transfering
|
|
|
|
|
--delete-before When synchronizing, delete files on destination before transfering
|
|
|
|
|
--delete-during When synchronizing, delete files during transfer (default)
|
|
|
|
|
--delete-excluded Delete files on dest excluded from sync
|
|
|
|
|
--drive-auth-owner-only Only consider files owned by the authenticated user. Requires drive-full-list.
|
|
|
|
|
--drive-chunk-size int Upload chunk size. Must a power of 2 >= 256k.
|
|
|
|
|
--drive-formats string Comma separated list of preferred formats for downloading Google docs. (default "docx,xlsx,pptx,svg")
|
|
|
|
|
--drive-full-list Use a full listing for directory list. More data but usually quicker. (obsolete)
|
|
|
|
|
--drive-upload-cutoff int Cutoff for switching to chunked upload
|
|
|
|
|
--drive-use-trash Send files to the trash instead of deleting permanently.
|
|
|
|
|
--dropbox-chunk-size int Upload chunk size. Max 150M.
|
|
|
|
|
-n, --dry-run Do a trial run with no permanent changes
|
|
|
|
|
--dump-bodies Dump HTTP headers and bodies - may contain sensitive info
|
|
|
|
|
--dump-filters Dump the filters to the output
|
|
|
|
|
--dump-headers Dump HTTP headers - may contain sensitive info
|
|
|
|
|
--exclude string Exclude files matching pattern
|
|
|
|
|
--exclude-from string Read exclude patterns from file
|
|
|
|
|
--files-from string Read list of source-file names from file
|
|
|
|
|
-f, --filter string Add a file-filtering rule
|
|
|
|
|
--filter-from string Read filtering patterns from a file
|
|
|
|
|
--ignore-existing Skip all files that exist on destination
|
|
|
|
|
--ignore-size Ignore size when skipping use mod-time or checksum.
|
|
|
|
|
-I, --ignore-times Don't skip files that match size and time - transfer all files
|
|
|
|
|
--include string Include files matching pattern
|
|
|
|
|
--include-from string Read include patterns from file
|
|
|
|
|
--log-file string Log everything to this file
|
|
|
|
|
--low-level-retries int Number of low level retries to do. (default 10)
|
|
|
|
|
--max-age string Don't transfer any file older than this in s or suffix ms|s|m|h|d|w|M|y
|
|
|
|
|
--max-depth int If set limits the recursion depth to this. (default -1)
|
|
|
|
|
--max-size int Don't transfer any file larger than this in k or suffix b|k|M|G
|
|
|
|
|
--memprofile string Write memory profile to file
|
|
|
|
|
--min-age string Don't transfer any file younger than this in s or suffix ms|s|m|h|d|w|M|y
|
|
|
|
|
--min-size int Don't transfer any file smaller than this in k or suffix b|k|M|G
|
|
|
|
|
--modify-window duration Max time diff to be considered the same (default 1ns)
|
|
|
|
|
--no-check-certificate Do not verify the server SSL certificate. Insecure.
|
|
|
|
|
--no-gzip-encoding Don't set Accept-Encoding: gzip.
|
|
|
|
|
--no-traverse Don't traverse destination file system on copy.
|
|
|
|
|
--no-update-modtime Don't update destination mod-time if files identical.
|
|
|
|
|
--onedrive-chunk-size int Above this size files will be chunked - must be multiple of 320k.
|
|
|
|
|
--onedrive-upload-cutoff int Cutoff for switching to chunked upload - must be <= 100MB
|
|
|
|
|
-q, --quiet Print as little stuff as possible
|
|
|
|
|
--retries int Retry operations this many times if they fail (default 3)
|
|
|
|
|
--size-only Skip based on size only, not mod-time or checksum
|
|
|
|
|
--stats duration Interval to print stats (0 to disable) (default 1m0s)
|
|
|
|
|
--swift-chunk-size int Above this size files will be chunked into a _segments container.
|
|
|
|
|
--timeout duration IO idle timeout (default 5m0s)
|
|
|
|
|
--transfers int Number of file transfers to run in parallel. (default 4)
|
|
|
|
|
-u, --update Skip files that are newer on the destination.
|
|
|
|
|
-v, --verbose Print lots more stuff
|
|
|
|
|
-V, --version Print the version number
|
2016-08-04 04:36:28 +08:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### SEE ALSO
|
|
|
|
|
* [rclone authorize](/commands/rclone_authorize/) - Remote authorization.
|
2016-08-25 05:58:24 +08:00
|
|
|
* [rclone cat](/commands/rclone_cat/) - Concatenates any files and sends them to stdout.
|
2016-08-04 04:36:28 +08:00
|
|
|
* [rclone check](/commands/rclone_check/) - Checks the files in the source and destination match.
|
|
|
|
|
* [rclone cleanup](/commands/rclone_cleanup/) - Clean up the remote if possible
|
|
|
|
|
* [rclone config](/commands/rclone_config/) - Enter an interactive configuration session.
|
|
|
|
|
* [rclone copy](/commands/rclone_copy/) - Copy files from source to dest, skipping already copied
|
|
|
|
|
* [rclone dedupe](/commands/rclone_dedupe/) - Interactively find duplicate files delete/rename them.
|
|
|
|
|
* [rclone delete](/commands/rclone_delete/) - Remove the contents of path.
|
|
|
|
|
* [rclone genautocomplete](/commands/rclone_genautocomplete/) - Output bash completion script for rclone.
|
|
|
|
|
* [rclone gendocs](/commands/rclone_gendocs/) - Output markdown docs for rclone to the directory supplied.
|
|
|
|
|
* [rclone ls](/commands/rclone_ls/) - List all the objects in the the path with size and path.
|
|
|
|
|
* [rclone lsd](/commands/rclone_lsd/) - List all directories/containers/buckets in the the path.
|
|
|
|
|
* [rclone lsl](/commands/rclone_lsl/) - List all the objects path with modification time, size and path.
|
|
|
|
|
* [rclone md5sum](/commands/rclone_md5sum/) - Produces an md5sum file for all the objects in the path.
|
|
|
|
|
* [rclone mkdir](/commands/rclone_mkdir/) - Make the path if it doesn't already exist.
|
2016-08-25 05:58:24 +08:00
|
|
|
* [rclone mount](/commands/rclone_mount/) - Mount the remote as a mountpoint. **EXPERIMENTAL**
|
2016-08-04 04:36:28 +08:00
|
|
|
* [rclone move](/commands/rclone_move/) - Move files from source to dest.
|
|
|
|
|
* [rclone purge](/commands/rclone_purge/) - Remove the path and all of its contents.
|
|
|
|
|
* [rclone rmdir](/commands/rclone_rmdir/) - Remove the path if empty.
|
|
|
|
|
* [rclone sha1sum](/commands/rclone_sha1sum/) - Produces an sha1sum file for all the objects in the path.
|
|
|
|
|
* [rclone size](/commands/rclone_size/) - Prints the total size and number of objects in remote:path.
|
|
|
|
|
* [rclone sync](/commands/rclone_sync/) - Make source and dest identical, modifying destination only.
|
|
|
|
|
* [rclone version](/commands/rclone_version/) - Show the version number.
|
|
|
|
|
|
2016-08-25 05:58:24 +08:00
|
|
|
###### Auto generated by spf13/cobra on 24-Aug-2016
|
