跳转到主要内容
S3 端口可与 Amazon S3 (Simple Storage Service) 以及其他类似 S3 的服务(例如 Google Storage 和 Wasabi)集成。

核心功能

  • 集成 Amazon S3 及 S3 兼容服务(Google Storage、Wasabi),支持 IAM 角色和访问密钥身份验证
  • 基于桶组织文件,支持双向传输和基于前缀的虚拟文件夹
  • 支持客户端和服务器端加密选项以及可配置访问策略
  • 可选缓存,确保只下载新的或已更新的文件

概述

每个 S3 端口都可以自动上传到单个 S3 桶并从中下载。 开始之前,你需要一个具有相应凭据的 Amazon 账户(或所用 S3 类服务的账户凭据)。请指定桶中的上传和下载路径。端口支持按文件名设置下载过滤器。

端口配置

本节包含所有可配置的端口属性。

设置选项卡

主机配置

_与远程连接目标相关的设置。

账户设置

与有权访问已配置桶名称的账户相关的设置。

TLS 设置

与 S3 服务器 TLS 协商相关的设置。

上传

与指定桶中文件上传路径相关的设置。

下载

与指定桶中文件下载路径相关的设置。

缓存

与多次下载之间缓存和比较文件相关的设置。

知行之桥会自动清理资源缓存。此过程在每次接收周期的后台运行,删除远程服务器上已不存在的文件对应的过期缓存条目。这使得缓存大小始终保持在可管理范围内,无需任何手动操作。

默认情况下,文件保留 30 天,但您可以在高级选项卡的其他设置字段中使用 ResourceCacheRetentionDays 设置来调整保留时间以适应您的环境。例如,ResourceCacheRetentionDays=15 表示文件保留 15 天后将被删除。

启用缓存时,文件名不区分大小写。例如,端口无法区分 TEST.TXT 和 test.txt。

高级选项卡

高级设置

不属于前述类别的设置。

代理设置

这是一组用于识别连接所经代理并对其进行身份验证的设置。默认情况下,本节使用 安全设置 页面的 代理设置 部分中的全局设置。清除此复选框可为您的端口提供特定的设置。

设置描述
代理类型基于代理的防火墙使用的协议。
代理主机基于代理的防火墙的名称或 IP 地址。
代理端口基于代理的防火墙的 TCP 端口。
代理用户用于通过基于代理的防火墙进行身份验证的用户名。
代理密码用于对基于代理的防火墙进行身份验证的密码。
身份验证方案保留默认值 None 或选择以下身份验证方案之一:Basic、Digest、Proprietary 或 NTLM。

消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置描述
保存到已发送文件夹选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口,使用子文件夹可以帮助保持文件有序并提高性能。

日志

用于管理日志创建和存储的设置。

设置描述
日志级别指定要记录在端口日志目录中的信息类型:
  • None - 不创建任何日志。
  • Error - 仅当端口遇到错误时才创建日志。
  • Warning - 仅当端口发出警告时才创建日志。
  • Info - 记录工作流的一般信息,包括任何错误和警告(如果适用)。
  • Debug - 记录成功和失败工作流的详细调试信息。
  • Trace - 记录成功和失败工作流的详细跟踪信息。
请注意:Debug 和 Trace 级别的日志可能会记录敏感信息,包括消息内容和 SSL 证书。尽管连接属性(例如密码)被屏蔽了,但在与您的组织外部共享它们之前,请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口,使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本指示端口在日志目录中保存最新消息副本的切换。请注意,端口每个子文件夹只保留一个消息,并且端口在再次运行时会覆盖以前保存的消息。

其他设置

特殊设置适用于特定用例。

设置描述
其他设置允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

自动化选项卡

自动化设置

与端口自动处理文件相关的设置。

性能

与端口资源分配相关的设置。

设置描述
最大工作线程数此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。
最大文件数分配给端口的每个线程发送的最大文件数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。

告警选项卡

SLA 选项卡

建立连接

建立 S3 连接的要求很简单:
  • Amazon 账户凭据(或其他类似 S3 的账户凭据)
    • Access Key
    • Secret Key
  • 上述账户可访问的桶
对于 Amazon S3,请使用此链接从 Amazon 获取 Access Key 和 Secret Key 信息。 可选:你可以在 TLS 设置部分启用 TLS 选项,以使用 TLS 保护与 S3 服务器的连接。

上传

上传到远程文件夹

设置页面上传部分中的 Prefix 设置指定文件上传到的桶路径。这允许将同一桶中的文件按逻辑分隔到虚拟文件夹中。
S3 服务器不维护真实的文件夹结构,知行之桥 使用应用程序逻辑来呈现伪文件夹结构。Prefix 中的斜杠(/、\\)会被解释为表示文件夹层级。这样即可基于路径中的斜杠上传到桶中的“子文件夹”或从中下载。

自动上传

S3 端口支持通过自动化选项卡自动上传。启用上传自动化后,到达端口交易选项卡的文件会自动上传到指定 Prefix 下的指定 Bucket Name。 如果文件上传失败,应用程序会在重试间隔结束后尝试再次发送。此过程会持续到达到最大次数,之后端口会引发错误。

下载

从远程文件夹下载

设置页面下载部分中的 Prefix 设置指定要从中下载文件的桶路径。这允许将同一桶中的文件按逻辑分隔到虚拟文件夹中。 File Filter 设置提供了一种只下载指定路径中特定文件名的方法。
S3 服务器不维护真实的文件夹结构,知行之桥 使用应用程序逻辑来呈现伪文件夹结构。Prefix 中的斜杠(/、\\)会被解释为表示文件夹层级。这样即可基于路径中的斜杠上传到桶中的“子文件夹”或从中下载。

自动下载

S3 端口支持通过自动化选项卡自动下载。启用下载自动化后,端口会根据指定的下载间隔自动轮询远程桶。

宏

示例