FTP
FTP连接器是基于FTP/SFTP协议实现文件传输的通道，通过FTP连接器可与外部FTP服务器进行文件交换。
- FTP（File Transfer Protocol，文件传输协议）是TCP/IP 协议组中的协议之一。FTP协议包括两个组成部分：FTP服务器和FTP客户端。其中FTP服务器用来存储文件，用户可以使用FTP客户端访问位于FTP服务器上的资源。
- SFTP（SSH File Transfer Protocol，安全文件传输协议）是FTP的安全版本，也是SSH协议的一部分，可通过安全SHELL数据流轻松进行数据传输和数据访问。SFTP也被称为SSH文件传输协议，它提供了一个安全的连接来传输文件，并在本地和远程系统上遍历文件系统。
默认情况下，FTP协议使用TCP端口中的20和21这两个端口，其中20端口用于传输数据，21端口用于传输控制信息（命令）。是否使用20端口作为传输数据的端口与FTP使用的传输模式有关。如果采用主动模式，则数据传输端口为20；如果采用被动模式，则最终使用的端口由服务器端和客户端协商决定。
创建FTP连接
- 登录新版ROMA Connect控制台。
- 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。
- 选择“FTP”连接器。
- 在弹窗中配置连接器信息，完成后单击“确定”。
参数
说明
连接名称
填写连接器实例名称。
协议
选择FTP连接所使用的协议，当前支持选择“FTP”和“SFTP”。
主机IP
FTP服务器的IP地址。
端口
FTP协议中，默认使用TCP端口中的20和21两个端口，其中20端口用于传输数据，21端口用于传输控制信息（命令）。
用户名
FTP用户名。
认证方式
当协议选择“SFTP”时需要配置。
选择SFTP的认证方式。
- 密码认证
- 公钥认证
私钥
当协议选择“SFTP”时，且认证方式选择“公钥认证”需要配置。
输入完整的私钥内容（以 -----BEGIN 开头）。
私钥口令
当协议选择“SFTP”时，且认证方式选择“公钥认证”需要配置。
输入私钥口令。
密码
FTP用户密码。
开启被动模式
当协议选择“FTP”时需要配置。
是否开启被动模式。
被动模式用于解决因防火墙或路由器导致的FTP连接失败问题（服务器需支持被动模式）。
描述
填写连接器的描述信息，用于识别不同的连接器。
支持的动作
- 写入文件
- 获取目录列表
- 获取文件内容
- 拷贝文件
- 移动文件
- 删除文件
- 获取文件元数据
- 提取文件
配置参数
|
参数 |
说明 |
|---|---|
|
路径 |
目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 |
|
文件名 |
填写需要写入的文件名。 |
|
写入内容 |
填写需要写入的内容。 |
|
写入策略 |
选择需要写入的策略。
|
|
参数 |
说明 |
|---|---|
|
路径 |
目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 |
|
标记路径 |
从标记路径的文件开始返回结果列表；若为空，返回所有文件。如果当前FTP连接使用的用户主目录为/home/ftpuser，标记路径为/home/ftpuser/data/file.txt，则此处填写/data/file.txt。 |
|
文件返回上限 |
文件返回数量的上限（最高返回上限为50）。 |
|
是否递归搜索 |
是否递归搜索子目录中的文件。
|
|
参数 |
说明 |
|---|---|
|
路径 |
目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 |
|
文件名 |
需要获取的文件名。 |
|
参数 |
说明 |
|---|---|
|
路径 |
目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 |
|
文件名 |
需要拷贝的文件名。 |
|
新路径 |
目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 |
|
新文件名 |
拷贝后的新文件名。 |
|
覆写策略 |
是否覆写同名文件。
|
|
参数 |
说明 |
|---|---|
|
原路径 |
目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 |
|
新路径 |
目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 |
|
文件名 |
移动后的文件名。 |
|
覆写策略 |
是否覆写同名文件。
|
|
参数 |
说明 |
|---|---|
|
路径 |
目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 |
|
文件名 |
需要删除的文件名。 |
|
参数 |
说明 |
|---|---|
|
路径 |
目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 |
|
文件名 |
需要获取元数据的文件名。 |
|
参数 |
说明 |
|---|---|
|
压缩包路径 |
目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 |
|
解压路径 |
目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 |
|
文件名 |
需要提取的文件名。 |
|
覆写策略 |
是否覆写同名文件。
|
