URI 查询参数

概述

本页是 URI 规范 和 TLS 指南的非正式补充，记录了官方支持的客户端如何解析 URI 参数。目前只有 Erlang 客户端这样做。

Federation 和 Shovel 插件使用 URI 指定与其他代理的连接，并且它们是通过 Erlang 客户端实现的，因此它们接受此处为其描述的所有参数。

基础知识

查询参数以通常的方式添加到 URI。任何参数都可以省略。当参数被省略时，客户端将使用合理的默认值。

示例 A

一个禁用 TLS 的示例连接 URI

amqp://myhost?heartbeat=5&connection_timeout=10000

这指定了到主机 myhost 的（未加密）网络连接。心跳间隔设置为 5 秒，连接超时设置为 10 秒（10000 毫秒）。其他参数设置为其默认值。

示例 B

在以下示例 URI 中，TLS 和连接客户端侧的 TLS 对等方验证 已启用

amqps://myhost?cacertfile=/path/to/ca_certificate.pem
  &certfile=/path/to/client_certificate.pem
  &keyfile=/path/to/client_key.pem
  &verify=verify_peer
  &server_name_indication=myhost

示例 C

在以下示例 URI 中，TLS 已启用，但连接客户端侧的 TLS 对等方验证 已禁用

amqps://myhost?cacertfile=/path/to/ca_certificate.pem
  &certfile=/path/to/client_certificate.pem
  &keyfile=/path/to/client_key.pem
  &verify=verify_none
  &server_name_indication=myhost

TLS 参数

这指定了到主机 myhost 的加密网络连接。提供了证书文件的绝对路径。verify_peer 确保验证证书链的信任，server_name_indication 将服务器证书中的 CN 值与主机名 myhost 进行验证。

参数名称	描述
cacertfile certfile keyfile	用于向服务器提供客户端 SSL 证书的文件路径。仅用于 amqps 方案。
verify server_name_indication	仅用于 amqps 方案，并用于配置服务器 x509 (TLS) 证书的验证。注意：强烈建议同时使用这两个值。有关 RabbitMQ 中 TLS 支持的更多信息，请参阅 TLS 指南，特别是 Erlang 客户端部分。
auth_mechanism	在与服务器协商机制时要考虑的 SASL 认证机制。此参数可以指定多次，例如 ?auth_mechanism=plain&auth_mechanism=amqplain，以指定多个机制。
heartbeat	与服务器协商的心跳超时值（秒，整数）。
connection_timeout	在放弃之前，等待与服务器建立 TCP 连接的时间（毫秒，整数）。
channel_max	允许在此连接上的通道的最大数量。

也可以使用 advanced.config 中的 amqp_client.ssl_options 配置键全局指定 TLS 选项，如下所示：

{amqp_client, [
    {ssl_options, [
        {cacertfile, "path-to-ca-certificate"},
        {certfile, "path-to-certificate"},
        {keyfile, "path-to-keyfile"},
        {verify, verify_peer}
    ]}
]}.

这些选项将与 URI 中的 TLS 参数合并（后者将优先），并影响节点上的所有出站 RabbitMQ Erlang 客户端连接，包括内部使用该客户端的插件（Federation、Shovel 等）。有关详细信息，请参阅 TLS 指南。