配置 FTP 适配器

项目
07/21/2023

准备阶段

FTP 适配器支持从安全 FTP 服务器读取和写入数据。该适配器提供了对使用安全套接字层 (SSL)/传输层安全性 (TLS) 从 FTP 服务器传输文件的支持。
FTP 适配器支持从只读文件位置下载文件。
FTP 适配器还支持 ASCII 模式的原子文件传输。

请参阅 FTP 适配器的最佳做法和建议。

配置接收位置

可以在 BizTalk Server 管理控制台中设置 FTP 接收位置适配器属性。如果未在接收位置设置属性，则使用 BizTalk Server 管理控制台中的默认接收处理程序值。

注意

在完成以下过程之前，必须已添加接收端口。请参阅如何创建接收端口。

在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”和“应用程序”，然后展开要在其中创建接收位置的应用程序。

在左窗格中，单击“ 接收端口” 节点。在右窗格中，右键单击与现有接收位置关联的接收端口或要与新接收位置关联的接收端口，然后单击“ 属性”。
在“ 接收端口属性 ”对话框的左窗格中，选择“ 接收位置”。在右窗格中，双击现有接收位置，或单击“ 新建 ”创建新的接收位置。
在“接收位置属性”对话框的“类型”旁边的“传输”部分中，从下拉列表中选择“FTP”，然后单击“配置”。

在 “FTP 传输属性”中，执行以下操作：

批处理

使用此选项	要执行此操作
最大文件数	指定每个 BizTalk Server 批的最大文件数。零 (0) 表示没有限制。默认值： 0
最大大小	指定每个 BizTalk Server 批的最大字节数。零 (0) 表示没有限制。默认值： 0

防火墙

使用此选项	要执行此操作
Address	指定防火墙的地址，DNS 名称或 IP 地址。
模式	指定适配器连接到 FTP 服务器的模式。有效值：被动和主动在主动模式中，FTP 服务器连接到由 FTP 适配器打开的端口。在被动模式中，FTP 适配器连接到由 FTP 服务器打开的端口。如果使用内部 IP 并连接到外部 IP，则活动模式可能不起作用。在这种情况下，需要将被动模式或主动模式与支持 FTP 的应用程序层网关 (ALG) 配合使用。默认值：积极
密码	指定防火墙的密码。
端口	指定防火墙的端口。有效值： 1 到 65535（含）默认值： 21
类型	指定部署的防火墙的类型。有效值：无、袜子 4 和袜子 5 默认值：没有
用户	指定防火墙的用户名。

FTP

使用此选项	要执行此操作
帐户	指定 FTP 服务器的帐户名。此选项已弃用，不建议使用此属性。
获取后	指定在 GET 文件后要运行的 FTP 命令。用分号 (;) 分隔命令。
获取之前	指定在 GET 文件前要运行的 FTP 命令。用分号 (;) 分隔命令。注意：在文件 GET 之前不支持 QUIT 命令。
错误阈值	指定在禁用位置之前BizTalk Server可能遇到的错误数。默认值： 10
文件掩码	指定传输文件时使用的文件掩码筛选器。
文件夹	指定 FTP 服务器上的轮询位置。
FTP 服务器类型	从 2016 BizTalk Server 开始新增功能。使用此属性可选择不需要 SYST 命令的 FTP 服务器。选项包括“无”、“AIX”、“检测”、“GXS”、“MVS”、“OS400”和“其他”。如果设置为 “无”，则使用 SYST 命令。如果 OS 类型不适合任何指定的类别，则使用其他类型。默认值：没有
日志	指定要输出到的日志文件的完整路径（包括文件名）。使用此文件诊断通过 FTP 发送或接收文件时的错误情况。
最大文件大小	指定可下载文件的最大大小 (MB)。零 (0) 表示对文件大小没有限制。默认值： 100
密码	指定登录 FTP 服务器所用的用户密码。
端口	指定此 FTP 服务器的端口地址。默认值： 21
表示形式	选择 FTP 接收数据的方式。有效值： binary 或 ASCII 默认值： binary
Server	指定 FTP 服务器的服务器名称或 IP 地址。注意：发送端口或接收位置的 URI 不能超过 256 个字符。
SSO 关联	指定企业单一登录关联应用程序。
使用名称列表 (NLST)	指定适配器如何列出文件。若要访问文件名称，而不是系统定义的文件列表，请将此值设置为“是”。默认值：不
用户名	指定登录 FTP 服务器所用的用户名。

轮询

使用此选项	要执行此操作
下载后删除	指定下载后适配器是否从 FTP 服务器中删除文件。默认值：是注意：
启用时间戳比较	指定适配器是否根据其修改后的时间戳再次下载文件。如果适配器对 FTP 服务器没有删除权限，则 MDTM (修改时间) 命令允许适配器知道自上次下载以来是否已修改过文件。根据此属性的值，将再次下载文件。默认值：否注意：如果 FTP 服务器不支持 MDTM，请设置 “重新下载间隔” 属性。注意：仅当 “下载后删除” 设置为“否”时，此属性才适用。
间隔	指定轮询此位置的时间间隔。若要连续轮询，请将此值设置为零 (0) 。默认值： 60
重新下载间隔	指定适配器再次下载文件的间隔。仅当 “下载后删除” 和 “启用时间戳比较” 都设置为“否”时，此属性才适用。默认值： -1 -1 指示适配器不会再次下载文件。 0 表示适配器将在每个轮询周期中下载该文件。
单位	指定 “间隔” 和 “重新加载间隔 ”属性的单位类型。有效值：秒、分钟、小时和天默认值：秒

SSL

使用此选项	要执行此操作
客户端证书哈希	指定安全套接字层 (SSL) 协商中必须使用的客户端证书的 SHA1 哈希。基于此哈希，从运行 BizTalk 主机实例的用户帐户的个人存储中提取客户端证书。
FTPS 连接模式	指定到 FTPS 服务器的 SSL 连接模式。有效值：隐式或显式默认值：明确
使用数据保护	如果适配器在从 FTPS 服务器发送和接收数据文件时必须使用 SSL 加密，则将此值指定为“是”。如果适配器发送和接收纯文本的数据文件，则将此指定为“否”。注意：仅当 “使用 SSL ”属性设置为“是”时，此属性才适用。有效值：是或否默认值：是的
使用 SSL	指定 FTP 适配器是否必须使用 SSL 与 FTPS 服务器通信。有效值：是或否默认值：不

优化参数

使用此选项	要执行此操作
接收数据超时	指定接收调用将中止之前的时间（以毫秒为单位）。使用此属性可防止服务器速度缓慢导致接收位置停止响应。默认值： 90000
临时文件夹	指定临时文件夹的位置。可以使用此位置确保能够从传输失败中恢复。

单击“确定”以保存设置。
在“ 接收位置属性 ”对话框中，输入相应的值以完成接收位置的配置，然后单击“ 确定 ”保存设置。有关“接收位置属性” 对话框的信息，请参阅如何创建接收位置。

注意

不要将多个 FTP 接收位置配置为轮询同一 FTP URL。如果多个 FTP 接收位置同时轮询同一 URL，则每个接收位置都可以接收该文件的副本，而这将会导致数据重复。由于 FTP 协议在从目标 URL 中读取文件时无法将其锁定，因此会发生这种情况。

若要为 FTP 接收适配器提供高可用性，应将 FTP 接收适配器配置为在群集 BizTalk 主机实例中运行。请参阅在群集主机中运行适配器处理程序的注意事项。

配置发送端口

可以在 BizTalk Server 管理控制台中设置 FTP 发送端口适配器属性。如果未为发送端口设置属性，则使用 BizTalk Server 管理控制台中的默认发送处理程序值。

在BizTalk Server管理控制台中，创建新的发送端口或双击现有发送端口进行修改。请参阅如何创建发送端口。配置所有发送端口选项，并在“常规”页的“传输”部分中，为“类型”选项指定 FTP。
在“常规”页的“传输”部分中，单击“类型”旁边的“配置”按钮。

在 FTP 传输属性中，执行以下操作：

防火墙

使用此选项	要执行此操作
Address	指定防火墙的地址（DNS 名称或 IP 地址）。
模式	选择适配器连接到 FTP 服务器的模式。有效值：被动和主动在主动模式中，FTP 服务器连接到由 FTP 适配器打开的端口。在被动模式中，FTP 适配器连接到由 FTP 服务器打开的端口。如果使用内部 IP 并连接到外部 IP，则活动模式可能无法工作。在这种情况下，需要将被动模式或主动模式与具有 FTP 支持的应用程序层网关 (ALG) 配合使用。默认值：积极
密码	指定防火墙的密码。
端口	指定防火墙的端口。有效值： 1 到 65535（含）默认值： 21
类型	选择部署的防火墙的类型。有效值：袜子 4，袜子 5，无默认值：没有
用户	指定防火墙的用户名。

FTP

使用此选项	要执行此操作
帐户	可选。指定 FTP 服务器的帐户名。不赞成使用此选项，建议不要使用此属性。
Put 后	指定在 PUT 文件后要运行的 FTP 命令。用分号 (;) 分隔命令。
分配存储	指定是否为旧式主机系统分配存储空间。此属性可以向后兼容。有效值：否和是默认值：不
Put 前	指定在 PUT 文件之前要运行的 FTP 命令，例如，用于在 FTP 服务器上更改默认值的命令。用分号 (;) 分隔命令。不需要 open 命令。注意：在文件 PUT 之前不支持 QUIT 命令。
文件夹	指定将文件移至 FTP 服务器上的位置。
FTP 服务器类型	从 2016 BizTalk Server 开始新增功能。使用此属性可选择不需要 SYST 命令的 FTP 服务器。选项包括“无”、“AIX”、“检测”、“GXS”、“MVS”、“OS400”和“其他”。如果设置为 “无”，则使用 SYST 命令。如果 OS 类型不适合任何指定的类别，则使用其他类型。默认值：没有
日志	指定要输出到的日志文件的完整路径（包括文件名）。此文件用于在通过 FTP 适配器发送或接收文件时诊断错误情况。
密码	指定登录 FTP 服务器所用的密码。
端口	指定 FTP 服务器的端口地址。默认值： 21
表示形式	选择 FTP 适配器如何发送数据，“二进制”还是“ASCII”。有效值： binary 或 ASCII 默认值： binary
Server	指定 FTP 服务器的服务器名称或 IP 地址。
SSO 关联	指定企业单一登录关联应用程序。
目标文件名	指定文件的替换名称。保留默认名称可保证发送的每条消息的唯一消息名称。默认值： %MessageID%.xml
用户名	指定登录 FTP 服务器所用的用户名。

SSL

使用此选项	要执行此操作
客户端证书哈希	指定安全套接字层 (SSL) 协商中必须使用的客户端证书的 SHA1 哈希。基于此哈希，从运行 BizTalk 主机实例的用户帐户的个人存储中提取客户端证书。
FTPS 连接模式	指定到 FTPS 服务器的 SSL 连接模式。有效值：隐式或显式默认值：明确
使用数据保护	如果适配器在从 FTPS 服务器发送和接收数据文件时必须使用 SSL 加密，则将此值指定为“是”。如果适配器发送和接收纯文本的数据文件，则将此指定为“否”。注意：仅当 “使用 SSL ”属性设置为“是”时，此属性才适用。有效值：是或否默认值：是的
使用 SSL	指定 FTP 适配器是否必须使用 SSL 与 FTPS 服务器通信。有效值：是或否默认值：不

优化参数

使用此选项	要执行此操作
连接限制	指定服务器允许的并行打开的最大 FTP 连接数。 0 表示无限制。默认值： 0 注意：此属性替换早期版本的 BizTalk Server 中用于控制连接限制的注册表项。 BizTalk Server忽略用于控制连接限制的注册表项。
临时文件夹	指定 FTP 服务器上的临时文件夹的位置。在此处第一次上载文件，然后将其移动到目标 FTP 文件夹。如果传输失败，适配器将以 ASCII 传输模式重新开始文件上载，并以二进制传输模式恢复。注意：如果临时位置与 FTP 服务器上的相关位置之间的文件传输是原子的，则文件上传也是原子的。

再次单击“确定”和“确定”以保存设置。

FTP 适配器所需的 FTP 命令

FTP 适配器受 FTP 协议的限制，并需要某些 FTP 命令在源或目标 FTP 服务器上可用。

FTP 适配器作为 FTP 客户端运行，并可能要求 FTP 服务器上提供以下命令才能正常工作：

命令	接收时需要	Send 必需
SYST	✔ 可选，从 2016 BizTalk Server开始	✔ 可选，从 2016 BizTalk Server开始
存储		✔
RETR	✔
USER	✔	✔
PASS	✔	✔
CWD	✔	✔
QUIT	✔	✔
端口	✔	✔
PASV	✔	✔
ABOR	✔	✔
TYPE	✔	✔
RNFR	✔	✔
RNTO	✔	✔
DELE	✔	✔
PWD	✔	✔
列表	✔	✔
NLST	✔	✔
NOOP	✔	✔
APPE		✔
ALLO	✔	✔
MDTM	✔
AUTH TLS	✔	✔
PBSZ	✔	✔
PROT	✔	✔

有关这些 FTP 命令的详细信息，请参阅：