From 2c72e7f0a219069d1e045fce7db4d9fa27ad82f2 Mon Sep 17 00:00:00 2001 From: Gary Kim Date: Mon, 20 May 2019 08:26:40 +0800 Subject: [PATCH] docs: add implicit FTP over TLS documentation --- docs/content/ftp.md | 55 ++++++++++++++++++++------------------------- 1 file changed, 24 insertions(+), 31 deletions(-) diff --git a/docs/content/ftp.md b/docs/content/ftp.md index 4a87eea1f..979acd4b0 100644 --- a/docs/content/ftp.md +++ b/docs/content/ftp.md @@ -30,45 +30,27 @@ q) Quit config n/r/c/s/q> n name> remote Type of storage to configure. +Enter a string value. Press Enter for the default (""). Choose a number from below, or type in your own value - 1 / Amazon Drive - \ "amazon cloud drive" - 2 / Amazon S3 (also Dreamhost, Ceph, Minio) - \ "s3" - 3 / Backblaze B2 - \ "b2" - 4 / Dropbox - \ "dropbox" - 5 / Encrypt/Decrypt a remote - \ "crypt" - 6 / FTP Connection +[snip] +10 / FTP Connection \ "ftp" - 7 / Google Cloud Storage (this is not Google Drive) - \ "google cloud storage" - 8 / Google Drive - \ "drive" - 9 / Hubic - \ "hubic" -10 / Local Disk - \ "local" -11 / Microsoft OneDrive - \ "onedrive" -12 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH) - \ "swift" -13 / SSH/SFTP Connection - \ "sftp" -14 / Yandex Disk - \ "yandex" +[snip] Storage> ftp +** See help for ftp backend at: https://rclone.org/ftp/ ** + FTP host to connect to +Enter a string value. Press Enter for the default (""). Choose a number from below, or type in your own value 1 / Connect to ftp.example.com \ "ftp.example.com" host> ftp.example.com FTP username, leave blank for current username, ncw -user> +Enter a string value. Press Enter for the default (""). +user> FTP port, leave blank to use default (21) -port> +Enter a string value. Press Enter for the default (""). +port> FTP password y) Yes type in my own password g) Generate random password @@ -77,12 +59,14 @@ Enter the password: password: Confirm the password: password: +Use FTP over TLS (Implicit) +Enter a boolean value (true or false). Press Enter for the default ("false"). +tls> Remote config -------------------- [remote] +type = ftp host = ftp.example.com -user = -port = pass = *** ENCRYPTED *** -------------------- y) Yes this is OK @@ -119,6 +103,12 @@ will be time of upload. FTP does not support any checksums. +### Implicit TLS ### + +FTP supports implicit FTP over TLS servers (FTPS). This has to be enabled +in the config for the remote. The default FTPS port is `990` so the +port will likely have to be explictly set in the config for the remote. + ### Standard Options @@ -191,3 +181,6 @@ FTP could support server side move but doesn't yet. Note that the ftp backend does not support the `ftp_proxy` environment variable yet. + +Note that while implicit FTP over TLS is supported, +explicit FTP over TLS is not.