132.5. 端点选项


SSH 端点使用 URI 语法进行配置:

ssh:host:port
Copy to Clipboard Toggle word wrap

使用以下 路径和 查询参数

132.5.1. 路径参数(2 参数)

Expand
Name描述默认值类型

host (common)

必需 设置远程 SSH 服务器的主机名。

 

字符串

port (common)

设置远程 SSH 服务器的端口号。

22

int

132.5.2. 查询参数(39 参数)

Expand
Name描述默认值类型

failOnUnknownHost (common)

指定到未知主机的连接是否应该失败。只有在设置了 knownHosts 属性时,才会检查这个值。

false

布尔值

knownHostsResource (common)

设置 known_hosts 文件的资源路径。

 

字符串

timeout (common)

设置建立远程 SSH 服务器连接时要等待的超时时间(毫秒)。默认值为 30000 毫秒。

30000

long

pollCommand (consumer)

设置在每次轮询周期期间要发送到远程 SSH 服务器的命令字符串。只适用于用作消费者的 camel-ssh 组件,即 from (ssh://…​),您可能需要使用新行结束命令,且必须 URL 编码的 %0A。

 

字符串

sendEmptyMessageWhenIdle (consumer)

如果轮询使用者没有轮询任何文件,您可以启用此选项来发送空消息(无正文)。

false

布尔值

bridgeErrorHandler (consumer (advanced))

允许将消费者桥接到 Camel 路由错误处理程序,这意味着当 Camel 消费者试图获取传入的消息或类似信息时,会出现异常(如果可能),现在将被作为消息进行处理,并由路由 Error Handler 处理。重要:只有在第三方组件允许 Camel 抛出异常时,才能警报这一点。有些组件仅在内部处理,因此无法 bridgeErrorHandler。在其他情况下,我们可能会将 Camel 组件提高到第三方组件中的 hook,并使其可能用于将来的版本。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。

false

布尔值

exceptionHandler (consumer (advanced))

要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。

 

ExceptionHandler

exchangePattern (consumer (advanced))

在消费者创建交换时设置交换模式。

Enum 值:

  • InOnly
  • InOut
 

ExchangePattern

pollStrategy (consumer (advanced))

可插拔 org.apache.camel.PollingConsumerPollingStrategy 允许您提供自定义实施来控制在轮询操作期间通常会发生错误处理,然后再创建交换并在 Camel 中路由。

 

PollingConsumerPollStrategy

lazyStartProducer (producer (advanced))

生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。

false

布尔值

channelType (advanced)

设置要在命令执行过程中传递给频道的频道类型。默认为 exec。

exec

字符串

ClientBuilder (advanced)

生成者或消费者使用的 autowired ClientBuilder 实例,以创建新的 SshClient。

 

ClientBuilder

compressions (advanced)

是否要使用压缩,如果有。

 

字符串

shellPrompt (advanced)

在命令执行后读取响应时,将 shellPrompt 设置为被丢弃。

 

字符串

sleepForShellPrompt (advanced)

设置从 shell 提示符读取响应的睡眠周期(以毫秒为单位)。默认值为 100 毫秒。

100

long

backoffErrorThreshold (scheduler)

在 backoffMultipler 应该 kick-in 之前发生的后续错误轮询(因为某些错误)的数量。

 

int

backoffIdleThreshold (scheduler)

在 backoffMultipler 应该 kick-in 之前应该发生的后续空闲轮询数量。

 

int

backoffMultiplier (scheduler)

如果一行中有很多后续空闲/errors,则让调度的轮询消费者避退。然后,倍数是在下一次实际尝试再次发生前跳过的轮询数量。当使用这个选项时,还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。

 

int

delay (scheduler)

下一次轮询前的时间(毫秒)。

500

long

greedy (scheduler)

如果启用了 greedy,如果上一个运行轮询 1 或更多消息,则 ScheduledPollConsumer 将立即运行。

false

布尔值

initialDelay (scheduler)

第一次轮询开始前的毫秒。

1000

long

repeatCount (scheduler)

指定触发的最大数量。因此,如果您将其设置为 1,调度程序将只触发一次。如果您将其设置为 5,它将只触发五次。值为零或负数表示会永久触发。

0

long

runLoggingLevel (scheduler)

消费者在轮询时记录 start/complete log 行。这个选项允许您为其配置日志级别。

Enum 值:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

允许配置用于消费者的自定义/共享线程池。默认情况下,每个使用者都有自己的单线程线程池。

 

ScheduledExecutorService

scheduler (scheduler)

要使用 camel-spring 或 camel-quartz 组件的 cron 调度程序。使用值 spring 或 quartz 用于内置在调度程序中。

none

对象

schedulerProperties (scheduler)

在使用自定义调度程序或任何基于 Spring 的调度程序时配置附加属性。

 

Map

startScheduler (scheduler)

调度程序是否应自动启动。

true

布尔值

timeUnit (scheduler)

initialDelay 和 delay 选项的时间单位。

Enum 值:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • MINUTES
  • HOURS
  • DAYS

MILLISECONDS

TimeUnit

useFixedDelay (scheduler)

控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。

true

布尔值

certResource (security)

设置用于身份验证的证书的资源路径。将使用 ResourceHelperKeyPairProvider 来解析基于文件的证书,并依赖于 keyType 设置。

 

字符串

certResourcePassword (security)

如果 certResource 是加密密钥,则设置要在加载 certResource 中使用的密码。

 

字符串

密码 (安全)

以逗号分隔的允许/支持的密码列表(按首选顺序排列)。

 

字符串

KEX (安全性)

以逗号分隔的允许/支持的密钥交换算法列表,按首选顺序排列。

 

字符串

keyPairProvider (security)

设置使用证书连接到远程 SSH 服务器时要使用的 KeyPairProvider 引用。

 

KeyPairProvider

keytype (security)

设置在身份验证过程中传递给 KeyPairProvider 的密钥类型。KeyPairProvider.loadKey (…​)将传递这个值。在 Camel 3.0.0 / 2.25.0 中,默认情况下 Camel 将选择载入的第一个可用 KeyPair。在此之前,默认强制使用 'ssh-rsa' 的 KeyType。

 

字符串

MAC (安全性)

以逗号分隔的允许/支持的消息验证代码算法列表(按首选顺序排列)。MAC 算法用于数据完整性保护。

 

字符串

password (security)

设置用于连接远程 SSH 服务器的密码。需要 keyPairProvider 设置为 null。

 

字符串

签名 (安全性)

以逗号分隔的允许/支持的签名算法列表,按首选顺序排列。

 

字符串

用户名 (安全性)

设置用于登录远程 SSH 服务器的用户名。

 

字符串

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat