2016-12-27 20:52:30 +00:00
|
|
|
---
|
|
|
|
title: "FTP"
|
|
|
|
description: "Rclone docs for FTP backend"
|
|
|
|
---
|
|
|
|
|
2020-05-22 11:22:52 +00:00
|
|
|
{{< icon "fa fa-file" >}} FTP
|
2016-12-27 20:52:30 +00:00
|
|
|
------------------------------
|
|
|
|
|
2017-05-24 22:24:46 +00:00
|
|
|
FTP is the File Transfer Protocol. FTP support is provided using the
|
2016-12-27 20:52:30 +00:00
|
|
|
[github.com/jlaffaye/ftp](https://godoc.org/github.com/jlaffaye/ftp)
|
|
|
|
package.
|
|
|
|
|
2017-05-03 20:45:01 +00:00
|
|
|
Here is an example of making an FTP configuration. First run
|
2016-12-27 20:52:30 +00:00
|
|
|
|
2017-05-03 20:45:01 +00:00
|
|
|
rclone config
|
|
|
|
|
2017-05-24 22:24:46 +00:00
|
|
|
This will guide you through an interactive setup process. An FTP remote only
|
|
|
|
needs a host together with and a username and a password. With anonymous FTP
|
|
|
|
server, you will need to use `anonymous` as username and your email address as
|
|
|
|
the password.
|
2016-12-27 20:52:30 +00:00
|
|
|
|
|
|
|
```
|
2017-05-03 20:45:01 +00:00
|
|
|
No remotes found - make a new one
|
|
|
|
n) New remote
|
|
|
|
r) Rename remote
|
|
|
|
c) Copy remote
|
|
|
|
s) Set configuration password
|
|
|
|
q) Quit config
|
|
|
|
n/r/c/s/q> n
|
|
|
|
name> remote
|
|
|
|
Type of storage to configure.
|
2019-05-20 00:26:40 +00:00
|
|
|
Enter a string value. Press Enter for the default ("").
|
2017-05-03 20:45:01 +00:00
|
|
|
Choose a number from below, or type in your own value
|
2019-05-20 00:26:40 +00:00
|
|
|
[snip]
|
2019-08-26 09:47:17 +00:00
|
|
|
XX / FTP Connection
|
2017-05-03 20:45:01 +00:00
|
|
|
\ "ftp"
|
2019-05-20 00:26:40 +00:00
|
|
|
[snip]
|
2017-05-03 20:45:01 +00:00
|
|
|
Storage> ftp
|
2019-05-20 00:26:40 +00:00
|
|
|
** See help for ftp backend at: https://rclone.org/ftp/ **
|
|
|
|
|
2017-05-24 22:24:46 +00:00
|
|
|
FTP host to connect to
|
2019-05-20 00:26:40 +00:00
|
|
|
Enter a string value. Press Enter for the default ("").
|
2017-05-24 22:24:46 +00:00
|
|
|
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
|
2019-05-20 00:26:40 +00:00
|
|
|
Enter a string value. Press Enter for the default ("").
|
|
|
|
user>
|
2017-05-24 22:24:46 +00:00
|
|
|
FTP port, leave blank to use default (21)
|
2019-05-20 00:26:40 +00:00
|
|
|
Enter a string value. Press Enter for the default ("").
|
|
|
|
port>
|
2017-05-24 22:24:46 +00:00
|
|
|
FTP password
|
2017-05-03 20:45:01 +00:00
|
|
|
y) Yes type in my own password
|
|
|
|
g) Generate random password
|
|
|
|
y/g> y
|
|
|
|
Enter the password:
|
|
|
|
password:
|
|
|
|
Confirm the password:
|
|
|
|
password:
|
2019-05-20 00:26:40 +00:00
|
|
|
Use FTP over TLS (Implicit)
|
|
|
|
Enter a boolean value (true or false). Press Enter for the default ("false").
|
|
|
|
tls>
|
2017-05-03 20:45:01 +00:00
|
|
|
Remote config
|
|
|
|
--------------------
|
2016-12-27 20:52:30 +00:00
|
|
|
[remote]
|
2019-05-20 00:26:40 +00:00
|
|
|
type = ftp
|
2017-05-24 22:24:46 +00:00
|
|
|
host = ftp.example.com
|
|
|
|
pass = *** ENCRYPTED ***
|
2017-05-03 20:45:01 +00:00
|
|
|
--------------------
|
|
|
|
y) Yes this is OK
|
|
|
|
e) Edit this remote
|
|
|
|
d) Delete this remote
|
|
|
|
y/e/d> y
|
2016-12-27 20:52:30 +00:00
|
|
|
```
|
|
|
|
|
2017-05-03 20:45:01 +00:00
|
|
|
This remote is called `remote` and can now be used like this
|
|
|
|
|
|
|
|
See all directories in the home directory
|
|
|
|
|
|
|
|
rclone lsd remote:
|
|
|
|
|
|
|
|
Make a new directory
|
|
|
|
|
|
|
|
rclone mkdir remote:path/to/directory
|
|
|
|
|
|
|
|
List the contents of a directory
|
|
|
|
|
|
|
|
rclone ls remote:path/to/directory
|
|
|
|
|
|
|
|
Sync `/home/local/directory` to the remote directory, deleting any
|
|
|
|
excess files in the directory.
|
|
|
|
|
2020-06-05 16:04:23 +00:00
|
|
|
rclone sync -i /home/local/directory remote:directory
|
2017-05-03 20:45:01 +00:00
|
|
|
|
|
|
|
### Modified time ###
|
|
|
|
|
|
|
|
FTP does not support modified times. Any times you see on the server
|
|
|
|
will be time of upload.
|
|
|
|
|
|
|
|
### Checksums ###
|
|
|
|
|
|
|
|
FTP does not support any checksums.
|
|
|
|
|
2020-05-16 19:28:15 +00:00
|
|
|
### Usage without a config file ###
|
|
|
|
|
|
|
|
An example how to use the ftp remote without a config file:
|
|
|
|
|
|
|
|
rclone lsf :ftp: --ftp-host=speedtest.tele2.net --ftp-user=anonymous --ftp-pass=`rclone obscure dummy`
|
|
|
|
|
2019-07-27 15:58:33 +00:00
|
|
|
#### Restricted filename characters
|
|
|
|
|
|
|
|
In addition to the [default restricted characters set](/overview/#restricted-characters)
|
|
|
|
the following characters are also replaced:
|
|
|
|
|
|
|
|
File names can also not end with the following characters.
|
2020-05-25 23:30:30 +00:00
|
|
|
These only get replaced if they are the last character in the name:
|
2019-07-27 15:58:33 +00:00
|
|
|
|
|
|
|
| Character | Value | Replacement |
|
|
|
|
| --------- |:-----:|:-----------:|
|
|
|
|
| SP | 0x20 | ␠ |
|
|
|
|
|
|
|
|
Note that not all FTP servers can have all characters in file names, for example:
|
|
|
|
|
|
|
|
| FTP Server| Forbidden characters |
|
|
|
|
| --------- |:--------------------:|
|
|
|
|
| proftpd | `*` |
|
|
|
|
| pureftpd | `\ [ ]` |
|
|
|
|
|
2019-05-20 00:26:40 +00:00
|
|
|
### 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
|
2020-05-19 11:02:44 +00:00
|
|
|
port will likely have to be explicitly set in the config for the remote.
|
2019-05-20 00:26:40 +00:00
|
|
|
|
2020-05-22 11:22:52 +00:00
|
|
|
{{< rem autogenerated options start" - DO NOT EDIT - instead edit fs.RegInfo in backend/ftp/ftp.go then run make backenddocs" >}}
|
2018-10-01 19:48:54 +00:00
|
|
|
### Standard Options
|
|
|
|
|
|
|
|
Here are the standard options specific to ftp (FTP Connection).
|
|
|
|
|
|
|
|
#### --ftp-host
|
|
|
|
|
|
|
|
FTP host to connect to
|
|
|
|
|
|
|
|
- Config: host
|
|
|
|
- Env Var: RCLONE_FTP_HOST
|
|
|
|
- Type: string
|
|
|
|
- Default: ""
|
|
|
|
- Examples:
|
|
|
|
- "ftp.example.com"
|
|
|
|
- Connect to ftp.example.com
|
|
|
|
|
|
|
|
#### --ftp-user
|
|
|
|
|
2019-06-15 11:01:29 +00:00
|
|
|
FTP username, leave blank for current username, $USER
|
2018-10-01 19:48:54 +00:00
|
|
|
|
|
|
|
- Config: user
|
|
|
|
- Env Var: RCLONE_FTP_USER
|
|
|
|
- Type: string
|
|
|
|
- Default: ""
|
|
|
|
|
|
|
|
#### --ftp-port
|
|
|
|
|
|
|
|
FTP port, leave blank to use default (21)
|
|
|
|
|
|
|
|
- Config: port
|
|
|
|
- Env Var: RCLONE_FTP_PORT
|
|
|
|
- Type: string
|
|
|
|
- Default: ""
|
|
|
|
|
|
|
|
#### --ftp-pass
|
|
|
|
|
|
|
|
FTP password
|
|
|
|
|
|
|
|
- Config: pass
|
|
|
|
- Env Var: RCLONE_FTP_PASS
|
|
|
|
- Type: string
|
|
|
|
- Default: ""
|
|
|
|
|
2019-06-15 11:01:29 +00:00
|
|
|
#### --ftp-tls
|
|
|
|
|
|
|
|
Use FTP over TLS (Implicit)
|
|
|
|
|
|
|
|
- Config: tls
|
|
|
|
- Env Var: RCLONE_FTP_TLS
|
|
|
|
- Type: bool
|
|
|
|
- Default: false
|
|
|
|
|
2019-04-13 10:01:58 +00:00
|
|
|
### Advanced Options
|
|
|
|
|
|
|
|
Here are the advanced options specific to ftp (FTP Connection).
|
|
|
|
|
|
|
|
#### --ftp-concurrency
|
|
|
|
|
|
|
|
Maximum number of FTP simultaneous connections, 0 for unlimited
|
|
|
|
|
|
|
|
- Config: concurrency
|
|
|
|
- Env Var: RCLONE_FTP_CONCURRENCY
|
|
|
|
- Type: int
|
|
|
|
- Default: 0
|
|
|
|
|
2019-06-15 11:01:29 +00:00
|
|
|
#### --ftp-no-check-certificate
|
|
|
|
|
|
|
|
Do not verify the TLS certificate of the server
|
|
|
|
|
|
|
|
- Config: no_check_certificate
|
|
|
|
- Env Var: RCLONE_FTP_NO_CHECK_CERTIFICATE
|
|
|
|
- Type: bool
|
|
|
|
- Default: false
|
|
|
|
|
2019-10-26 10:04:54 +00:00
|
|
|
#### --ftp-disable-epsv
|
|
|
|
|
|
|
|
Disable using EPSV even if server advertises support
|
|
|
|
|
|
|
|
- Config: disable_epsv
|
|
|
|
- Env Var: RCLONE_FTP_DISABLE_EPSV
|
|
|
|
- Type: bool
|
|
|
|
- Default: false
|
|
|
|
|
2020-02-01 10:31:42 +00:00
|
|
|
#### --ftp-encoding
|
|
|
|
|
|
|
|
This sets the encoding for the backend.
|
|
|
|
|
|
|
|
See: the [encoding section in the overview](/overview/#encoding) for more info.
|
|
|
|
|
|
|
|
- Config: encoding
|
|
|
|
- Env Var: RCLONE_FTP_ENCODING
|
|
|
|
- Type: MultiEncoder
|
|
|
|
- Default: Slash,Del,Ctl,RightSpace,Dot
|
|
|
|
|
2020-05-22 11:22:52 +00:00
|
|
|
{{< rem autogenerated options stop >}}
|
2018-10-01 17:36:15 +00:00
|
|
|
|
2017-05-03 20:45:01 +00:00
|
|
|
### Limitations ###
|
|
|
|
|
|
|
|
Note that since FTP isn't HTTP based the following flags don't work
|
|
|
|
with it: `--dump-headers`, `--dump-bodies`, `--dump-auth`
|
2016-12-27 20:52:30 +00:00
|
|
|
|
2017-05-18 15:20:26 +00:00
|
|
|
Note that `--timeout` isn't supported (but `--contimeout` is).
|
2016-12-27 20:52:30 +00:00
|
|
|
|
2017-07-23 15:10:23 +00:00
|
|
|
Note that `--bind` isn't supported.
|
|
|
|
|
2017-05-03 20:45:01 +00:00
|
|
|
FTP could support server side move but doesn't yet.
|
2019-01-29 09:47:16 +00:00
|
|
|
|
|
|
|
Note that the ftp backend does not support the `ftp_proxy` environment
|
|
|
|
variable yet.
|
2019-05-20 00:26:40 +00:00
|
|
|
|
|
|
|
Note that while implicit FTP over TLS is supported,
|
|
|
|
explicit FTP over TLS is not.
|