PutSFTP

文档中心 › 组件索引 › PutSFTP

PutSFTP Processor

类型全限定名：cn.org.acal.lynxus.processors.standard.PutSFTP

所属 Bundle：cn.org.acal.lynxus:lynxus-standard-nar:2.11.8

描述

将 FlowFiles 发送到 SFTP 服务器

标签

remotecopyegressputsftparchivefiles

属性

下表中，加粗的属性为必填项；其余为可选项。表格同时标注默认值、是否支持表达式语言，以及是否为敏感属性（值会被加密）。

名称默认值可选值描述
Hostname远程系统的完全限定主机名或 IP 地址
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Port22远程系统正在侦听文件传输的端口
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Username用户名
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Password用户帐户的密码
敏感属性：是
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Private Key Path私钥文件的完全限定路径
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Private Key Passphrase私钥的密码
敏感属性：是
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Remote Path远程系统上从中拉取或推送文件的路径
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Create Directoryfalse
  • true
  • false
指定如果远程目录不存在，是否应创建该目录。
Disable Directory Listingfalse
  • true
  • false
如果设置为 'true'，在创建缺失目录之前不执行目录列表。默认情况下，此处理器在执行创建缺失目录之前会执行目录列表命令以查看目标目录是否存在。但是，在某些情况下您可能需要禁用目录列表，例如以下情况。目录列表可能因某些权限设置（例如 chmod 100）而失败。此外，如果在此处理器执行列表之后和目录创建请求完成之前，任何其他 SFTP 客户端创建了该目录，则会返回错误，因为目录已存在。
Batch Size500单个连接中发送的最大 FlowFile 数量
Connection Timeout30 sec创建连接时超时之前等待的时间量
Data Timeout30 sec在本地和远程系统之间传输文件时，该值指定允许在系统之间不传输任何数据的时间长度
Conflict ResolutionNONE
  • REPLACE — 远程文件被新文件替换，FlowFile 进入 success
  • IGNORE — 文件不被传输，FlowFile 进入 success
  • RENAME — 新文件在开头以递增编号重命名，FlowFile 进入 success
  • REJECT — 文件不被传输，FlowFile 进入 reject
  • FAIL — 文件不被传输，FlowFile 进入 failure
  • NONE — 传输前不检查冲突，FlowFile 进入 success 或 failure
确定如何处理文件名冲突问题
Reject Zero-Byte Filestrue
  • true
  • false
确定是否应拒绝零字节文件而不尝试传输
Dot Renametrue
  • true
  • false
如果为 true，发送文件的文件名将在前面加上'.'，文件完全发送后再重命名回原始名称。否则不进行重命名。如果设置了'临时文件名'属性，则忽略此属性。
Temporary Filename如果设置，发送文件的文件名在传输期间将等于指定的值，成功完成后将重命名为原始文件名。如果设置了此值，则忽略'点重命名'属性。
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Host Key File如果提供，给定的文件将用作主机密钥；否则，如果应用了 'Strict Host Key Checking' 属性（设置为 true），则使用 ~/.ssh 目录中的 'known_hosts' 和 'known_hosts2' 文件，否则不使用主机密钥文件。
Last Modified Time传输文件后分配给文件的最后修改时间。如果未设置，最后修改时间将不会更改。格式必须为 yyyy-MM-dd'T'HH:mm:ssZ。您也可以使用表达式语言如 ${file.lastModifiedTime}。如果值无效，处理器不会变为无效状态，但将无法更改文件的最后修改时间。
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Permissions传输文件后分配给文件的权限。格式必须为 UNIX rwxrwxrwx（用 - 表示拒绝的权限，如 rw-r--r--）或八进制数（如 644）。如果未设置，权限将不会更改。您也可以使用表达式语言如 ${file.permissions}。如果值无效，处理器不会变为无效状态，但将无法更改文件的权限。
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Remote Owner传输文件后设置的用户 ID 整数值。如果未设置，所有者将不会更改。您也可以使用表达式语言如 ${file.owner}。如果值无效，处理器不会变为无效状态，但将无法更改文件的所有者。
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Remote Group传输文件后设置的组 ID 整数值。如果未设置，组将不会更改。您也可以使用表达式语言如 ${file.group}。如果值无效，处理器不会变为无效状态，但将无法更改文件的组。
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Strict Host Key Checkingfalse
  • true
  • false
指示是否应严格执行主机密钥
Send Keep Alive On Timeouttrue
  • true
  • false
每 5 秒发送一条“保持活动”消息，最多发送 5 次，总超时时间为 25 秒。
Use Compressionfalse
  • true
  • false
指示传输文件时是否应使用 ZLIB 压缩
Proxy Configuration Service控制器服务 API：
ProxyConfigurationService
cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8		指定代理配置 Controller Service 来代理网络请求。
Algorithm NegotiationDEFAULT
  • DEFAULT — 基于标准设置的默认算法协商，以与 SSH 服务器保持通用兼容性
  • CUSTOM — 基于所定义设置的自定义算法协商
SSH算法协商配置策略
Ciphers Allowed允许的 SFTP 连接密码的逗号分隔列表。留空以允许所有。可用选项包括：3des-cbc, aes128-cbc, aes128-ctr, aes128-gcm@openssh.com, aes192-cbc, aes192-ctr, aes256-cbc, aes256-ctr, aes256-gcm@openssh.com, arcfour128, arcfour256, blowfish-cbc, chacha20-poly1305@openssh.com, none
支持表达式语言：是（仅使用环境/系统变量求值）
Key Algorithms Allowed允许的 SFTP 连接密钥算法的逗号分隔列表。留空以允许所有。可用选项包括：ecdsa-sha2-nistp256, ecdsa-sha2-nistp256-cert-v01@openssh.com, ecdsa-sha2-nistp384, ecdsa-sha2-nistp384-cert-v01@openssh.com, ecdsa-sha2-nistp521, ecdsa-sha2-nistp521-cert-v01@openssh.com, rsa-sha2-256, rsa-sha2-256-cert-v01@openssh.com, rsa-sha2-512, rsa-sha2-512-cert-v01@openssh.com, sk-ecdsa-sha2-nistp256@openssh.com, sk-ssh-ed25519@openssh.com, ssh-dss, ssh-dss-cert-v01@openssh.com, ssh-ed25519, ssh-ed25519-cert-v01@openssh.com, ssh-rsa, ssh-rsa-cert-v01@openssh.com
支持表达式语言：是（仅使用环境/系统变量求值）
Key Exchange Algorithms Allowed允许的 SFTP 连接密钥交换算法的逗号分隔列表。留空以允许所有。可用选项包括：curve25519-sha256, curve25519-sha256@libssh.org, curve448-sha512, diffie-hellman-group-exchange-sha1, diffie-hellman-group-exchange-sha256, diffie-hellman-group1-sha1, diffie-hellman-group14-sha1, diffie-hellman-group14-sha256, diffie-hellman-group15-sha512, diffie-hellman-group16-sha512, diffie-hellman-group17-sha512, diffie-hellman-group18-sha512, ecdh-sha2-nistp256, ecdh-sha2-nistp384, ecdh-sha2-nistp521, mlkem1024nistp384-sha384, mlkem768nistp256-sha256, mlkem768x25519-sha256, sntrup761x25519-sha512, sntrup761x25519-sha512@openssh.com
支持表达式语言：是（仅使用环境/系统变量求值）
Message Authentication Codes Allowed允许的 SFTP 连接消息认证码的逗号分隔列表。留空以允许所有。可用选项包括：hmac-md5, hmac-md5-96, hmac-sha1, hmac-sha1-96, hmac-sha1-etm@openssh.com, hmac-sha2-256, hmac-sha2-256-etm@openssh.com, hmac-sha2-512, hmac-sha2-512-etm@openssh.com
支持表达式语言：是（仅使用环境/系统变量求值）

关系 (Relationships)

名称描述自动终止
failure未能发送到远程系统的 FlowFiles； 故障通常会循环回到该处理器否
reject被目标系统拒绝的 FlowFiles否
success发送成功的FlowFiles将会被路由到成功否

状态管理

该组件不存储状态。

受限 (Restricted)

该组件不受限。

输入要求

该组件要求有传入连接。

另请参阅

© 2026 ACAL Organization. Licensed under Apache License 2.0.