插件安装与管理

RabbitMQ 通过插件机制扩展核心功能，如延迟消息、消息追踪、联邦集群等。

插件目录结构

插件文件存放在 RabbitMQ 安装目录下的 plugins 目录中。

# 查看插件目录（Linux）
ls /usr/lib/rabbitmq/plugins/

# 查看插件目录（Windows）
dir "C:\Program Files\RabbitMQ\plugins\"

# 常见插件文件
rabbitmq_delayed_message_exchange-3.10.2.ez
rabbitmq_shovel-3.10.2.ez
rabbitmq_management-3.10.2.ez
rabbitmq_tracing-3.10.2.ez

插件文件格式为 .ez（Erlang 打包格式），包含插件的 BEAM 文件和元数据。

插件管理命令

rabbitmq-plugins 是 RabbitMQ 提供的插件管理命令行工具。

# 查看所有插件列表
rabbitmq-plugins list

# 查看已启用的插件
rabbitmq-plugins list | grep "^E"

# 启用插件
rabbitmq-plugins enable rabbitmq_management
rabbitmq-plugins enable rabbitmq_delayed_message_exchange

# 禁用插件
rabbitmq-plugins disable rabbitmq_tracing

# 启用插件并忽略依赖警告
rabbitmq-plugins enable --offline rabbitmq_federation

# 查看所有插件及其依赖
rabbitmq-plugins list --expert

输出格式说明：

E* 表示已启用且正在运行
E   表示已启用但未运行（需重启）
_   表示未启用

启用/禁用插件后需重启 RabbitMQ 服务生效，除非使用 --online 参数热加载。

在线启用插件

RabbitMQ 3.8+ 支持在线启用插件，无需重启服务。

# 在线启用插件（无需重启）
rabbitmq-plugins enable --online rabbitmq_management

# 验证插件状态
rabbitmqctl eval 'rabbit_plugins:running_plugins().'

# 查看运行中的插件
rabbitmqctl status | grep -A 20 "Plugins"

在线启用限制：

• 部分插件不支持在线启用（如底层协议插件）
• 在线启用失败需回滚并重启服务

插件依赖管理

插件之间存在依赖关系，启用时会自动处理依赖。

# 查看插件依赖
rabbitmq-plugins list rabbitmq_shovel

# 输出示例
# Package: rabbitmq_shovel-3.10.2
# Depends: rabbitmq_management_agent, ranch, stdlib

# 启用插件时自动安装依赖
rabbitmq-plugins enable rabbitmq_shovel

# 查看已启用插件及其依赖
rabbitmq-plugins list | grep "^E"

常见依赖关系：

插件配置

部分插件需要通过配置文件调整默认行为。

# 编辑 RabbitMQ 配置文件
# Linux: /etc/rabbitmq/rabbitmq.conf
# Windows: %APPDATA%\RabbitMQ\rabbitmq.conf

# 管理插件端口配置
management.tcp.port = 15672
management.tcp.ip = 0.0.0.0

# 延迟插件最大延迟（毫秒）
delayed_message.max_delay = 86400000

配置生效方式：

# 重新加载配置（无需重启）
rabbitmqctl eval 'application:stop(rabbit), application:start(rabbit).'

常见问题排查

# 插件启用失败排查
# 1. 检查插件文件是否存在
ls /usr/lib/rabbitmq/plugins/ | grep delayed

# 2. 检查插件版本是否匹配 RabbitMQ 版本
rabbitmqctl status | grep "RabbitMQ"

# 3. 查看插件加载日志
tail -f /var/log/rabbitmq/rabbit@*.log | grep plugin

# 4. 清理插件缓存（极端情况）
rm -rf /var/lib/rabbitmq/mnesia/rabbit@*/plugins/
rabbitmq-plugins enable rabbitmq_management

插件版本必须与 RabbitMQ 主版本匹配，否则会导致启动失败。

注意事项

1. 启用插件后必须重启 RabbitMQ 服务（除非使用 --online）
2. 插件文件权限需与 RabbitMQ 运行用户一致
3. 插件之间存在依赖关系，启用时会自动处理依赖
4. 禁用核心插件可能导致 RabbitMQ 无法启动

要点总结

• 插件文件存放在 plugins 目录，格式为 .ez
• rabbitmq-plugins enable/disable 用于启用/禁用插件
• --online 参数支持热加载插件，无需重启服务
• 插件之间存在依赖关系，启用时自动处理
• 插件版本必须与 RabbitMQ 主版本匹配