"rsync for cloud storage" - Google Drive, S3, Dropbox, Backblaze B2, One Drive, Swift, Hubic, Wasabi, Google Cloud Storage, Azure Blob, Azure Files, Yandex Files
Go azure-blobazure-blob-storageazure-filesbackblaze-b2cloud-storagedropboxencryptionftpfuse-filesystemgogolanggoogle-cloud-storagegoogle-driveonedriveopenstack-swiftrclones3sftpsyncwebdav
docs: add faq entry about re-enabling old TLS ciphers
Nick Craig-Wood4b2c39c58502
diff --git a/docs/content/faq.md b/docs/content/faq.mdindex 0754e09cf..f221fe842 100644--- a/docs/content/faq.md+++ b/docs/content/faq.md@@ -316,3 +316,45 @@ back again when transferring to a different storage system where theoriginal characters are supported. When the same Unicode charactersare intentionally used in file names, this replacement strategy leadsto unwanted renames. Read more under section [caveats](/overview/#restricted-filenames-caveats).++### Why does rclone fail to connect over TLS but another client works?++If you see TLS handshake failures (or packet captures show the server+rejecting all offered ciphers), the server/proxy may only support+legacy TLS cipher suites (for example RSA key-exchange ciphers+such as `RSA_WITH_AES_256_CBC_SHA256`, or old 3DES ciphers). Recent Go+versions (which rclone is built with) have **removed insecure ciphers+from the default list**, so rclone may refuse to negotiate them even+if other tools still do.++If you can't update/reconfigure the server/proxy to support modern TLS+(TLS 1.2/1.3) and ECDHE-based cipher suites you can re-enable legacy+ciphers via `GODEBUG`:++- Windows (cmd.exe):++ ```bat+ set GODEBUG=tlsrsakex=1+ rclone copy ...+ ```+- Windows (PowerShell):++ ```powershell+ $env:GODEBUG="tlsrsakex=1"+ rclone copy ...+ ```+- Linux/macOS:++ ```sh+ GODEBUG=tlsrsakex=1 rclone copy ...+ ```++If the server only supports 3DES, try:++```sh+GODEBUG=tls3des=1 rclone ...+```++This applies to **any rclone feature using TLS** (HTTPS, FTPS, WebDAV+over TLS, proxies with TLS interception, etc.). Use these workarounds+only long enough to get the server/proxy updated.