核心功能
- 支持 FTPS (FTP over TLS/SSL) 和传统 FTP 文件传输协议
- 支持主动和被动模式,具备完善的防火墙兼容性
- 支持断点续传功能,适用于中断的上传和下载任务
- 提供高级身份验证,包括基于证书的客户端身份验证
- 支持连接池和临时文件处理,确保传输的可靠性
- 提供可选的缓存功能,确保仅下载新增或更新的文件
概述
每个 FTP 端口连接上传文件到指定的文件夹,并从远程 FTP 服务器上的一组文件夹下载。 在 知行之桥 工作流中到达 FTP 端口的文件被上传到上传目标文件夹,在下载目标文件夹中找到的文件被下载并输入到 知行之桥 工作流中。端口支持上传和下载过滤规则,仅发送和接收指定的文件名和/或文件扩展名。端口配置
本节包含所有可配置的端口属性。设置
主机配置
与建立到远程 FTP 主机的连接相关的设置。客户端验证
与向 FTP 服务器进行身份验证相关的设置。服务器验证
与验证 FTP 服务器身份相关的设置。上传
与文件上传到 FTP 服务器相关的设置。下载
与从 FTP 服务器下载相关的设置。缓存
与缓存及多次下载之间文件比对相关的设置。知行之桥会自动清理资源缓存。此过程在每次接收周期的后台运行,删除远程服务器上已不存在的文件对应的过期缓存条目。这使得缓存大小始终保持在可管理范围内,无需任何手动操作。
默认情况下,文件保留 30 天,但您可以在高级选项卡的其他设置字段中使用 ResourceCacheRetentionDays 设置来调整保留时间以适应您的环境。例如,ResourceCacheRetentionDays=15 表示文件保留 15 天后将被删除。
TEST.TXT 和 test.txt。高级设置
TLS 客户端认证
需要双向 TLS 身份验证时与客户端身份验证相关的设置。服务器命令
高级设置
先前类别中未包含的设置。代理设置
这是一组用于识别连接所经代理并对其进行身份验证的设置。默认情况下,本节使用 安全设置 页面的 代理设置 部分中的全局设置。清除此复选框可为您的端口提供特定的设置。
| 设置 | 描述 |
|---|---|
| 代理类型 | 基于代理的防火墙使用的协议。 |
| 代理主机 | 基于代理的防火墙的名称或 IP 地址。 |
| 代理端口 | 基于代理的防火墙的 TCP 端口。 |
| 代理用户 | 用于通过基于代理的防火墙进行身份验证的用户名。 |
| 代理密码 | 用于对基于代理的防火墙进行身份验证的密码。 |
| 身份验证方案 | 保留默认值 None 或选择以下身份验证方案之一:Basic、Digest、Proprietary 或 NTLM。 |
消息
消息设置确定端口如何搜索消息并在处理后管理它们。
| 设置 | 描述 |
|---|---|
| 保存到已发送文件夹 | 选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。 |
| 已发送文件夹方案 | 端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口,使用子文件夹可以帮助保持文件有序并提高性能。 |
日志
用于管理日志创建和存储的设置。
| 设置 | 描述 |
|---|---|
| 日志级别 | 指定要记录在端口日志目录中的信息类型:
|
| 日志文件夹结构 | 指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口,使用子文件夹有助于保持日志的有序性并提高性能。 |
| 保留消息副本 | 指示端口在日志目录中保存最新消息副本的切换。请注意,端口每个子文件夹只保留一个消息,并且端口在再次运行时会覆盖以前保存的消息。 |
其他设置
特殊设置适用于特定用例。
| 设置 | 描述 |
|---|---|
| 其他设置 | 允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。 |
自动化
自动化设置
与端口自动处理文件相关的设置。性能
与端口资源分配相关的设置。
| 设置 | 描述 |
|---|---|
| 最大工作线程数 | 此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。 |
| 最大文件数 | 分配给端口的每个线程发送的最大文件数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。 |
告警选项卡
SLA 选项卡
建立一个连接
连接到远程 FTP 服务器需要以下设置:- 远程主机
- TLS 类型
- 远程主机端口
- 用户名
- 密码
上传文件
FTP 端口从事务选项卡上传文件。如果端口中启用了上传自动化功能,文件将自动上传到 FTP 服务器。 远程目录应设置为远程 FTP 服务器上应上传文件的文件夹。登录到服务器后,应用程序会将目录更改到指定的文件夹。可以在高级选项卡中设置临时上传扩展名、前缀或路径,以确保文件在远程目录文件夹中结束之前已被完全传输。 如果有任何文件无法上传,端口会在重试间隔分钟后尝试发送它们。此过程一直持续,直到达到最大重试次数设置,之后端口将引发错误,文件将不再自动发送。下载文件
下载的文件显示在端口的事务选项卡中,或者传递给工作流中的下一个端口。如果端口中启用了下载自动化功能,文件将自动从 FTP 服务器上下载,并且可以通过单击事务选项卡中的接收文件按钮手动下载。 远程目录应设置为远程 FTP 服务器上的文件夹,文件应从该文件夹下载。登录到服务器后,应用程序将目录更改到指定的文件夹。文件掩码属性过滤文件,以便只从服务器下载与全局模式匹配的文件名。可以在高级选项卡中设置临时下载扩展名或前缀,以确保文件在事务选项卡中结束之前已被完全传输。 **删除文件(下载后)**设置可用于在成功下载文件后删除远程服务器上的文件。 完成配置后,文件将会根据自动下载的配置下载,或者在事务选项卡上手动点击接收文件按钮。子目录消息头
如果递归被选择,FTP 端口从远程目录接收文件时:- 收到的文件消息将在其元数据中包含子目录消息头。
- 这个消息头包含子目录,其相对于配置的远程目录。
- 这个子目录消息头可以被其它支持该功能的发送端口所识别和支持。
- 文件将被放置在子目录(相对于 FTP 端口远程目录设置)中,该子目录在子目录消息头中指定。
- 如果有权限,子目录会被自动创建。