配置 FTP 适配器

2025-06-05

在您开始之前

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

防火墙

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

FTP

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

投票

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

SSL

用这个	要执行的操作
客户端证书哈希	指定必须在安全套接字层（SSL）协商中使用的客户端证书的 SHA1 哈希。基于此哈希，从运行 BizTalk 主机实例的用户帐户的个人存储中选取客户端证书。
FTPS 连接模式	指定与 FTPS 服务器建立的 SSL 连接的模式。有效值：隐式或显式默认值：明确
使用数据保护	如果适配器在从 FTPS 服务器发送和接收数据文件时必须使用 SSL 加密，则将其指定为“是”。将此指定为 No，以便适配器以纯文本形式发送和接收数据文件。注意：仅当 Use 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 传输属性中，执行以下作：

防火墙

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

FTP

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

SSL

用这个	要执行的操作
客户端证书哈希	指定必须在安全套接字层（SSL）协商中使用的客户端证书的 SHA1 哈希。基于此哈希，从运行 BizTalk 主机实例的用户帐户的个人存储中选取客户端证书。
FTPS 连接模式	指定与 FTPS 服务器建立的 SSL 连接的模式。有效值：隐式或显式默认值：明确
使用数据保护	如果适配器在从 FTPS 服务器发送和接收数据文件时必须使用 SSL 加密，则将其指定为“是”。将此指定为 No，以便适配器以纯文本形式发送和接收数据文件。注意：仅当 Use 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 服务器上提供以下命令才能正常工作：

指令	接收过程中所需的要求	发送必需
SYST	✔ 可选，从 BizTalk Server 2016 开始	✔ 可选，从 BizTalk Server 2016 开始
商店		✔
RETR	✔
用户	✔	✔
通过	✔	✔
CWD	✔	✔
退出	✔	✔
港口	✔	✔
PASV	✔	✔
ABOR	✔	✔
类型	✔	✔
RNFR	✔	✔
RNTO	✔	✔
DELE	✔	✔
PWD	✔	✔
列表	✔	✔
NLST	✔	✔
NOOP	✔	✔
APPE		✔
异基因	✔	✔
MDTM	✔
身份验证 TLS	✔	✔
PBSZ	✔	✔
PROT	✔	✔

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