SFTP
Secure File Transfer 协议(SFTP)是 FTP 的安全版本,通过安全外壳(SSH)数据流处理数据访问和数据传输。
作为 2026 年 3 月推出的连接器命名空间更新的一部分,对于新创建的项目,SFTP V1 和 SFTP V2 连接器现已分别更名为 SFTP V3 和 SFTP V4。 这些更新版本符合平台范围内引入的新命名空间规范。
现有账户和项目将继续显示并使用 SFTP V1 和 SFTP V2 ,以保持向后兼容性。 此变更不会影响现有的集成,且无需对当前已配置的账户或项目进行任何更改。
对于新创建的项目,仅提供更新后的连接器版本:SFTP V3 和 SFTP V4。
- 在工作流和流程服务中为 SFTP 连接器创建独立账户。 此外,SFTP V1 账户和 SFTP V2 账户的名称必须唯一。
- 您可以使用此连接器的专用链接从您的专用 VPC 建立连接。
- 在“部署到任何地方”集成中,SFTP 连接器不支持公钥身份验证。
工作流程操作
上传文件:上传 SFTP 服务器上的特定文件。
下载文件:从 SFTP 服务器下载特定文件。
附加文件:将特定本地文件追加到 SFTP 服务器上的现有文件。
删除目录:从 SFTP 服务器上删除指定目录。
创建目录:在 SFTP 服务器的指定位置创建目录。
获取文件和文件夹列表:从 SFTP 服务器上的指定目录读取文件和文件夹列表。
删除文件:从 SFTP 服务器上删除特定文件。
创建符号链接:创建特定文件的符号链接。
重命名文件或文件夹:重命名 FTP 服务器上的特定文件或文件夹。
更改所有权:更改特定文件或文件夹的所有权。
更改文件或文件夹权限:更改特定文件或文件夹的权限。
更改组所有权:更改特定文件或文件夹的组权限。
流程服务行动
cd:更改远程 SFTP 服务器上的工作目录。
chgrp:更改一个或多个远程文件的组所有权。
chmod:更改一个或多个远程文件的权限。
chown更改一个或多个远程文件的所有用户。
获取:从远程 SFTP 服务器读取特定文件。
ls:列出指定远程目录中的文件,包括权限和所有权等详细信息。 如果没有指定目录,则会列出当前远程目录下的文件。
mkdir:创建一个新的远程目录
放:将文件传输到远程 SFTP 服务器。
pwd:显示 SFTP 服务器中的远程工作目录。
重命名:重命名远程 SFTP 服务器上的文件或目录。
rm:删除 SFTP 服务器上的一个或多个远程文件。
rmdir:删除 SFTP 服务器上的一个或多个远程目录。
符号链接在特定文件的旧路径和新路径之间创建符号链接。
常见问题
如何为 SFTP 连接器创建账户?
要在 webMethods Integration :
- 将任何 SFTP 操作拖到画布上,然后双击该操作。
- 点击连接到 SFTP 服务器字段旁边的 "+"。 添加账户 "窗口将显示账户配置字段:
- 账户名称 :SFTP 账户名称。
- 主机 :SFTP 服务器的主机或 IP 地址。
- 端口 :要连接的端口号。
使用创建连接 :要用于建立连接的登录类型。
如果选择登录凭证作为登录类型,出现的字段将在此处列出:
- 用户名 :指定 SFTP 服务器的用户名。
- 密码 :输入与指定 SFTP 服务器用户名相关联的密码。
- 算法密钥 :指定密钥,以明确覆盖用于连接的默认传输层算法密钥。
- 服务器主机密钥 :指定主机密钥,以显式覆盖用于连接的默认传输层服务器主机密钥。
- 密码 :指定密码,以明确覆盖连接使用的默认传输层密码。
- Hmacs :指定 (H)MAC 算法,以明确覆盖用于连接的默认传输层 (H)MAC。
- 压缩 :指定压缩算法,以明确覆盖用于连接的默认传输层压缩算法。
- 就绪超时 :指定建立安全 SSH 连接的时间(毫秒)。 默认值为 20000 毫秒(20 秒)。
- 重试 :指定重试建立安全 SSH 连接的最大次数。 该字段的默认值为 2。
- 重试系数 :指定用于计算重试间隔时间的时间系数。 该字段的默认值为 2。
- 重试最小超时 :指定希望服务器在两次重试之间等待的时间(毫秒)。 该字段的默认值为 2000(2 秒)。
- 保持在线间隔 :指定向服务器发送 SSH 级 keepalive 数据包的频率(以毫秒为单位)。 如果要禁用此选项并无限期保持会话,请在此字段中指定 "0"。 该字段的默认值为 0。 例如,如果将该字段的值设置为 3000,则表示服务器每 3 秒接收一次 keep-alive 数据包。
- Keep Alive Count Max(保持在线计数最大值 ):指定在停止连接会话之前,可以向服务器发送多少个连续未应答的 SSH 级保持在线数据包。 该字段的默认值为 3。 不过,该字段可以与 " 保持在线间隔 "字段一起使用。 例如,如果 Keep Alive Interval 设置为 2000(2 秒), Keep Alive Count Max 设置为 3,则服务器每 2 秒接收一次 keep-alive 数据包,最多 3 次,以维持连接。 如果数据包连续三次未应答,连接会话就会中断。
如果选择 SSH 密钥作为登录类型,出现的字段将在此处列出:
- 用户名 :指定 SFTP 服务器的用户名。
- SSH 密钥 :提供与指定用户名关联的 SSH 密钥的路径。
- 密码 :提供与指定用户名关联的 SSH 密钥的口令。
- 算法密钥 :指定密钥,以明确覆盖用于连接的默认传输层算法密钥。
- 服务器主机密钥 :指定主机密钥,以显式覆盖用于连接的默认传输层服务器主机密钥。
- 密码 :指定密码,以明确覆盖连接使用的默认传输层密码。
- Hmacs :指定 (H)MAC 算法,以明确覆盖用于连接的默认传输层 (H)MAC。
- 压缩 :指定压缩算法,以明确覆盖用于连接的默认传输层压缩算法。
就绪超时 :指定建立安全 SSH 连接的时间(毫秒)。 默认值为 20000 毫秒(20 秒)。
- 重试 :指定重试建立安全 SSH 连接的最大次数。 该字段的默认值为 2。
- 重试系数 :指定用于计算重试间隔时间的时间系数。 该字段的默认值为 2。
- 重试最小超时 :指定希望服务器在两次重试之间等待的时间(毫秒)。 该字段的默认值为 2000(2 秒)。
- 保持在线间隔 :指定向 SSH 服务器发送 SSH 级保持更新数据包的频率(以毫秒为单位)。 如果要禁用此选项并无限期保持会话,请在此字段中指定 "0"。 该字段的默认值为 0。 例如,如果将该字段的值设置为 3000,则表示服务器每 3 秒接收一次 keep-alive 数据包。
- Keep Alive Count Max(保持在线计数最大值 ):指定在断开连接前可向服务器发送多少个连续未应答的 SSH 级保持在线数据包。 该字段的默认值为 3。 不过,该字段可以与 " 保持在线间隔 "字段一起使用。 例如,如果 Keep Alive Interval 字段设置为 2000(2 秒), Keep Alive Count Max 字段设置为 3,则表示每 2 秒(最多 3 次)服务器会接收保持连接活动的数据包以保持连接活动。 如果数据包连续三次未应答,连接将自动中断。
然后点击保存。 为 SFTP 连接器创建账户。
为什么 Flow 服务执行失败时出现 SFTP 帐户错误?主机密钥已更改?
如果在创建 SFTP 账户后更改了主机密钥,请手动更新账户以获取最新的主机密钥,避免交易失败。
工作流程 SFTP 连接器的下载文件 ( v6 ) 操作下有哪些不同的下载方式?
SFTP 连接器中的下载文件 ( v6 ) 操作可从远程 SFTP 服务器下载特定文件。 此处列出了该行动下可用的方法:
FastGet
FastGet 方法用于从远程服务器传输大文件。 它侧重于批量传输文件块而不是整个文件,以实现更快的吞吐量。
选择 FastGet 作为下载方式时,屏幕上会出现以下字段:
- ChunkSize :指定工作流 SFTP 连接器和远程 SFTP 服务器之间数据传输的批量大小(以字节为单位)。 默认值为 4096 字节。
- 并发性 :该字段指定允许同时进行的批量传输次数。 该字段的默认值为 1。
注意: 如果为 "分块大小"、"并发性 "和 "工作流运行时间 "字段配置的值不足以完成文件下载,工作流可能会出现超时错误。 如果文件为 800 MB,且分块大小、并发性和工作流运行时间分别设置为 4096、1 和 3 分钟,则下载可能在完成前超时。获取
获取方法用于转到相关目录,并使用 SFTP 协议将指定文件从远程服务器传输到本地系统。
其他信息
| SFTP V1 | 详细信息 |
|---|---|
| 首选密钥交换算法 |
|