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