# 配置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连接 1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)。 2. 在左侧导航栏选择"连接器"，在连接器页面单击"新建连接"。 3. 选择"FTP"连接器。 4. 在弹窗中配置连接器信息，完成后单击"确定"。 | 参数 | 说明 | |:---|:---| | 连接名称 | 填写连接器实例名称。 | | 协议 | 选择FTP连接所使用的协议，当前支持选择"FTP"和"SFTP"。 | | 主机IP | FTP服务器的IP地址。 | | 端口 | FTP协议中，默认使用TCP端口中的20和21两个端口，其中20端口用于传输数据，21端口用于传输控制信息（命令）。 | | 用户名 | FTP用户名。 | | 认证方式 | 当协议选择"SFTP"时需要配置。 选择SFTP的认证方式。 - 密码认证 - 公钥认证 | | 私钥 | 当协议选择"SFTP"时，且认证方式选择"公钥认证"需要配置。 输入完整的私钥内容（以 -----BEGIN 开头）。 | | 私钥口令 | 当协议选择"SFTP"时，且认证方式选择"公钥认证"需要配置。 输入私钥口令。 | | 密码 | FTP用户密码。 | | 开启被动模式 | 当协议选择"FTP"时需要配置。 是否开启被动模式。 被动模式用于解决因防火墙或路由器导致的FTP连接失败问题（服务器需支持被动模式）。 | | 描述 | 填写连接器的描述信息，用于识别不同的连接器。 | #### 支持的动作 - 写入文件 - 获取目录列表 - 获取文件内容 - 拷贝文件 - 移动文件 - 删除文件 - 获取文件元数据 - 提取文件 #### 配置参数 表1写入文件 | 参数 | 说明 | |:---|:---| | 路径 | 目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 | | 文件名 | 填写需要写入的文件名。 | | 写入内容 | 填写需要写入的内容。 | | 写入策略 | 选择需要写入的策略。 - 覆写：覆盖同名文件内容。 - 追加：在同名文件末尾追加内容。 - 备份：备份同名文件，后缀为执行时间。 | 表2获取目录列表 | 参数 | 说明 | |:---|:---| | 路径 | 目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 | | 标记路径 | 从标记路径的文件开始返回结果列表；若为空，返回所有文件。如果当前FTP连接使用的用户主目录为/home/ftpuser，标记路径为/home/ftpuser/data/file.txt，则此处填写/data/file.txt。 | | 文件返回上限 | 文件返回数量的上限（最高返回上限为50）。 | | 是否递归搜索 | 是否递归搜索子目录中的文件。 - 是 - 否 | 表3获取文件内容 | 参数 | 说明 | |:---|:---| | 路径 | 目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 | | 文件名 | 需要获取的文件名。 | 表4拷贝文件 | 参数 | 说明 | |:---|:---| | 路径 | 目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 | | 文件名 | 需要拷贝的文件名。 | | 新路径 | 目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 | | 新文件名 | 拷贝后的新文件名。 | | 覆写策略 | 是否覆写同名文件。 - 覆写 - 非覆写 | 表5移动文件 | 参数 | 说明 | |:---|:---| | 原路径 | 目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 | | 新路径 | 目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 | | 文件名 | 移动后的文件名。 | | 覆写策略 | 是否覆写同名文件。 - 覆写 - 非覆写 | 表6删除文件 | 参数 | 说明 | |:---|:---| | 路径 | 目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 | | 文件名 | 需要删除的文件名。 | 表7获取文件元数据 | 参数 | 说明 | |:---|:---| | 路径 | 目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 | | 文件名 | 需要获取元数据的文件名。 | 表8提取文件 | 参数 | 说明 | |:---|:---| | 压缩包路径 | 目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 | | 解压路径 | 目录的相对路径。如果当前FTP连接使用的用户主目录为/home/ftpuser，目录路径为/home/ftpuser/data，则此处填写/data。 | | 文件名 | 需要提取的文件名。 | | 覆写策略 | 是否覆写同名文件。 - 覆写 - 非覆写 |