用户级资源限制

概述

与虚拟主机（vhost）资源限制类似，您可以限制特定用户可以打开的连接数和通道数。

在应用程序不可信或无法进行详细监控的环境中（例如将 RabbitMQ 集群作为服务提供时），这些限制可用作防护措施。

这些限制可以通过 CLI 工具或 HTTP API 进行配置。

最大连接数

要限制用户可以打开的连接数，请将 max-connections 限制设置为一个正整数

使用 rabbitmqctl (bash)

rabbitmqctl set_user_limits user1 '{"max-connections": 10}'

使用 rabbitmqadmin (bash)

rabbitmqadmin user_limits declare --user user1 --name max-connections --value 10

使用 rabbitmqctl (PowerShell)

rabbitmqctl.bat set_user_limits user1 "{""max-connections"": 10}"

使用 rabbitmqadmin (PowerShell)

rabbitmqadmin.exe user_limits declare --user user1 --name max-connections --value 10

HTTP API

使用 PUT /api/user-limits/{username}/{limit} 端点，并附带如下请求体

{"value": 20}

以下是使用 curl 的示例

curl -v -u guest:guest -X PUT https://:15672/api/user-limits/user1/max-connections \
                       -H "content-type: application/json" \
                       -d @- <<EOF
{
  "value": 20
}
EOF

最大通道数

要限制用户总共可以打开的通道数，请将 max-channels 限制设置为一个正整数

使用 rabbitmqctl (bash)

rabbitmqctl set_user_limits guest '{"max-connections": 10, "max-channels": 20}'

使用 rabbitmqadmin (bash)

rabbitmqadmin user_limits declare --user guest --name max-channels --value 20

使用 rabbitmqctl (PowerShell)

rabbitmqctl.bat set_user_limits guest "{""max-connections"": 10, ""max-channels"": 20}"

使用 rabbitmqadmin (PowerShell)

rabbitmqadmin.exe user_limits declare --user guest --name max-channels --value 20

HTTP API

使用 PUT /api/user-limits/{username}/{limit} 端点，并附带如下请求体

{"value": 20}

以下是使用 curl 为用户 user1 设置限制的示例

curl -v -u guest:guest -X PUT https://:15672/api/user-limits/user1/max-channels \
                       -H "content-type: application/json" \
                       -d @- <<EOF
{
  "value": 20
}
EOF

该限制适用于用户打开的所有连接中的通道总数。因此，它必须大于或等于上述的最大连接数限制。

列出用户限制

要列出特定用户的限制

使用 rabbitmqctl (bash)

rabbitmqctl list_user_limits user1

使用 rabbitmqadmin (bash)

rabbitmqadmin user_limits list --user user1

使用 rabbitmqctl (PowerShell)

rabbitmqctl.bat list_user_limits user1

使用 rabbitmqadmin (PowerShell)

rabbitmqadmin.exe user_limits list --user user1

HTTP API

curl -u guest:guest -X GET https://:15672/api/user-limits/user1

清除用户限制

要清除用户的限制，请使用 CLI 工具或 HTTP API。

使用 rabbitmqctl (bash)

# clears the maximum number of connections limit
rabbitmqctl clear_user_limits user1 'max-connections'

# clears the maximum number of channels limit
rabbitmqctl clear_user_limits user1 'max-channels'

# clears all limits in a single operation
rabbitmqctl clear_user_limits user1 all

使用 rabbitmqadmin (bash)

# clears the maximum number of connections limit
rabbitmqadmin user_limits delete --user user1 --name max-connections

# clears the maximum number of channels limit
rabbitmqadmin user_limits delete --user user1 --name max-channels

使用 rabbitmqctl (PowerShell)

# clears the maximum number of connections limit
rabbitmqctl.bat clear_user_limits user1 "max-connections"

# clears the maximum number of channels limit
rabbitmqctl.bat clear_user_limits user1 "max-channels"

# clears all limits in a single operation
rabbitmqctl.bat clear_user_limits user1 all

使用 rabbitmqadmin (PowerShell)

# clears the maximum number of connections limit
rabbitmqadmin.exe user_limits delete --user user1 --name max-connections

# clears the maximum number of channels limit
rabbitmqadmin.exe user_limits delete --user user1 --name max-channels

HTTP API

使用 DELETE /api/user-limits/{username}/{limit} 端点，且无需请求体。

以下是使用 curl 清除用户 user1 所有限制的示例

curl -v -u guest:guest -X DELETE https://:15672/api/user-limits/user1/max-channels

curl -v -u guest:guest -X DELETE https://:15672/api/user-limits/user1/max-connections