1
0
Fork 0
mirror of https://github.com/rclone/rclone.git synced 2026-07-11 03:17:58 +00:00
"rsync for cloud storage" - Google Drive, S3, Dropbox, Backblaze B2, One Drive, Swift, Hubic, Wasabi, Google Cloud Storage, Azure Blob, Azure Files, Yandex Files https://rclone.org
  • Go 98.4%
  • Shell 0.5%
  • Python 0.4%
  • HTML 0.3%
  • JavaScript 0.2%
  • Other 0.1%
Find a file
Nick Craig-Wood 0baac15c49 drive: detect shortcut loops to avoid infinite recursion
A folder shortcut pointing at one of its own ancestor folders (for
example a shortcut to FolderX placed inside FolderX) made rclone recurse
forever when dereferencing shortcuts, duplicating the folder contents
until the disk was full.

Rclone now detects when a folder shortcut targets an ancestor directory
using the directory cache, leaves that shortcut out of the listing and
logs an ERROR, so the rest of the drive can still be copied.

Fixes #7118
Fixes #9565
Closes #9051
2026-07-10 18:45:41 +01:00
.github build: fix multiple CVEs by upgrading to go1.26.5 2026-07-08 15:00:33 +01:00
backend drive: detect shortcut loops to avoid infinite recursion 2026-07-10 18:45:41 +01:00
bin docs: add missing Huawei Drive docs 2026-05-01 14:06:11 +01:00
cmd config: add config unset command to remove options from a remote - fixes #9541 2026-07-10 18:45:41 +01:00
cmdtest build: use sequence Split introduced in go1.24 2025-09-15 12:45:57 +01:00
contrib docker volume plugin: add missing fuse3 dependency #6844 2023-03-15 15:57:53 +00:00
docs drive: detect shortcut loops to avoid infinite recursion 2026-07-10 18:45:41 +01:00
fs config: add config unset command to remove options from a remote - fixes #9541 2026-07-10 18:45:41 +01:00
fstest fstests: check opening an object doesn't change its fingerprint 2026-07-09 17:46:31 +01:00
graphics graphics: optimise images losslessly with ImageOptim 2026-02-25 12:45:49 +00:00
lib drive, googlephotos: warn in config wizard before using the shared client_id #9580 2026-07-07 12:35:37 +01:00
librclone librclone/ctest: add Windows support and fix memory management 2026-03-31 10:51:15 +01:00
vfs vfs/vfscache: fix IO error by recreating the cache file if it has been removed 2026-07-09 17:46:31 +01:00
.gitattributes Add go mod and sum to gitattributes for consistent line endings 2024-04-13 11:16:42 +02:00
.gitignore gui: don't run fetch-gui on make 2026-04-11 15:27:05 +01:00
.golangci.yml build: adjust lint rules to exclude new errors from linter update 2025-12-08 14:45:06 +00:00
.markdownlint.yml docs: fix misspellings 2026-05-15 20:12:47 +02:00
CODE_OF_CONDUCT.md docs: add code of conduct 2025-08-22 11:42:51 +01:00
CONTRIBUTING.md github: modernise issue and pull request templates 2026-06-18 13:22:19 +01:00
COPYING Initial commit - some small parts working 2012-11-18 17:32:31 +00:00
Dockerfile build: disable docker builds on PRs & add missing dockerfile changes 2025-02-12 21:29:01 +00:00
go.mod internxt: add Move and DirMove methods for server-side file and directory operations 2026-07-09 12:42:21 +01:00
go.sum internxt: add Move and DirMove methods for server-side file and directory operations 2026-07-09 12:42:21 +01:00
MAINTAINERS.md github: add CODEOWNERS for per-area review routing 2026-06-22 15:18:26 +01:00
Makefile build: add make fetch-gui-and-commit to fetch and commit the embedded GUI 2026-05-01 12:46:46 +01:00
MANUAL.html Version v1.74.0 2026-05-01 15:56:56 +01:00
MANUAL.md Version v1.74.0 2026-05-01 15:56:56 +01:00
MANUAL.txt Version v1.74.0 2026-05-01 15:56:56 +01:00
notes.txt docs: spelling: etc. 2020-10-28 18:16:23 +00:00
rclone.1 Version v1.74.0 2026-05-01 15:56:56 +01:00
rclone.go lib: add plugin support 2019-09-29 11:05:10 +01:00
README.md docs: add missing Huawei Drive docs 2026-05-01 14:06:11 +01:00
RELEASE.md docs: Fix RELEASE.md 2026-06-22 15:18:26 +01:00
VERSION Start v1.75.0-DEV development 2026-05-01 17:15:20 +01:00

rclone logo

rclone logo

Website | Documentation | Download | Contributing | Changelog | Installation | Forum

Build Status Go Report Card GoDoc Docker Pulls

Rclone

Rclone ("rsync for cloud storage") is a command-line program to sync files and directories to and from different cloud storage providers.

Storage providers

  • 1Fichier 📄
  • Akamai Netstorage 📄
  • Alibaba Cloud (Aliyun) Object Storage System (OSS) 📄
  • Amazon S3 📄
  • ArvanCloud Object Storage (AOS) 📄
  • Bizfly Cloud Simple Storage 📄
  • Backblaze B2 📄
  • Box 📄
  • Ceph 📄
  • China Mobile Ecloud Elastic Object Storage (EOS) 📄
  • Citrix ShareFile 📄
  • Cloudflare R2 📄
  • Cloudinary 📄
  • Cubbit DS3 📄
  • DigitalOcean Spaces 📄
  • Digi Storage 📄
  • Dreamhost 📄
  • Drime 📄
  • Dropbox 📄
  • Enterprise File Fabric 📄
  • Exaba 📄
  • Fastly Object Storage 📄
  • Fastmail Files 📄
  • FileLu 📄
  • Filen 📄
  • Files.com 📄
  • FlashBlade 📄
  • FTP 📄
  • GoFile 📄
  • Google Cloud Storage 📄
  • Google Drive 📄
  • Google Photos 📄
  • HDFS (Hadoop Distributed Filesystem) 📄
  • Hetzner Object Storage 📄
  • Hetzner Storage Box 📄
  • HiDrive 📄
  • Hitachi Content Platform (HCP) 📄
  • HTTP 📄
  • Huawei Cloud Object Storage Service(OBS) 📄
  • Huawei Drive 📄
  • iCloud Drive 📄
  • ImageKit 📄
  • Internet Archive 📄
  • Internxt 📄
  • Jottacloud 📄
  • IBM COS S3 📄
  • Impossible Cloud 📄
  • Intercolo Object Storage 📄
  • IONOS Cloud 📄
  • Koofr 📄
  • Leviia Object Storage 📄
  • Liara Object Storage 📄
  • Linkbox 📄
  • Linode Object Storage 📄
  • Magalu Object Storage 📄
  • Mail.ru Cloud 📄
  • Memset Memstore 📄
  • MEGA 📄
  • MEGA S4 Object Storage 📄
  • Memory 📄
  • Microsoft Azure Blob Storage 📄
  • Microsoft Azure Files Storage 📄
  • Microsoft OneDrive 📄
  • Minio 📄
  • Nextcloud 📄
  • Blomp Cloud Storage 📄
  • OpenDrive 📄
  • OpenStack Swift 📄
  • Oracle Cloud Storage 📄
  • Oracle Object Storage 📄
  • Outscale 📄
  • OVHcloud Object Storage (Swift) 📄
  • OVHcloud Object Storage (S3-compatible) 📄
  • ownCloud 📄
  • pCloud 📄
  • Petabox 📄
  • PikPak 📄
  • Pixeldrain 📄
  • premiumize.me 📄
  • put.io 📄
  • Proton Drive 📄
  • QingStor 📄
  • Qiniu Cloud Object Storage (Kodo) 📄
  • Rabata Cloud Storage 📄
  • Quatrix 📄
  • Rackspace Cloud Files 📄
  • RackCorp Object Storage 📄
  • rsync.net 📄
  • Scaleway 📄
  • Seafile 📄
  • Seagate Lyve Cloud 📄
  • SeaweedFS 📄
  • Selectel Object Storage 📄
  • Servercore Object Storage 📄
  • SFTP 📄
  • Shade 📄
  • SMB / CIFS 📄
  • Spectra Logic 📄
  • Storj 📄
  • SugarSync 📄
  • Synology C2 Object Storage 📄
  • Tencent Cloud Object Storage (COS) 📄
  • Uloz.to 📄
  • US3 Object Storage 📄
  • Wasabi 📄
  • WebDAV 📄
  • Yandex Disk 📄
  • Zadara Object Storage 📄
  • Zoho WorkDrive 📄
  • Zata.ai 📄
  • The local filesystem 📄

Please see the full list of all storage providers and their features

Virtual storage providers

These backends adapt or modify other storage providers

  • Alias: rename existing remotes 📄
  • Archive: read archive files 📄
  • Cache: cache remotes (DEPRECATED) 📄
  • Chunker: split large files 📄
  • Combine: combine multiple remotes into a directory tree 📄
  • Compress: compress files 📄
  • Crypt: encrypt files 📄
  • Hasher: hash files 📄
  • Union: join multiple remotes to work together 📄

Features

  • MD5/SHA-1 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
  • Bisync (two way) to keep two directories in sync bidirectionally
  • Check mode to check for file hash equality
  • Can sync to and from network, e.g. two different cloud accounts
  • Optional large file chunking (Chunker)
  • Optional transparent compression (Compress)
  • Optional encryption (Crypt)
  • Optional FUSE mount (rclone mount)
  • Multi-threaded downloads to local disk
  • Can serve local or remote files over HTTP/WebDAV/FTP/SFTP/DLNA

Installation & documentation

Please see the rclone website for:

Downloads

License

This is free software under the terms of the MIT license (check the COPYING file included in this package).