Ubuntu 上安装与启用 RabbitMQ 插件
一 前置条件
- 确保已安装 Erlang 与 RabbitMQ Server，并确认服务处于运行状态。常见做法：
- 安装组件：sudo apt-get update && sudo apt-get install -y erlang-nox rabbitmq-server
- 启动与开机自启：sudo systemctl start rabbitmq-server && sudo systemctl enable rabbitmq-server
- 查看状态：sudo systemctl status rabbitmq-server 或 sudo rabbitmqctl status
- 以上准备完成后，即可进行插件安装与启用。
二 内置插件启用步骤
- 查看插件列表：rabbitmq-plugins list（方括号中带 E/e 表示已启用）
- 启用管理插件（常用）：sudo rabbitmq-plugins enable rabbitmq_management
- 启用后可访问管理控制台：http://服务器IP或域名:15672
- 常用内置插件示例：
- MQTT：sudo rabbitmq-plugins enable rabbitmq_mqtt
- Web MQTT：sudo rabbitmq-plugins enable rabbitmq_web_mqtt
- 提示：启用插件后若端口未放行，请同步配置防火墙/云安全组放行对应端口。
三 外部插件的离线安装（以延迟交换机为例）
- 下载插件：从官方社区插件页面获取与当前 RabbitMQ 版本匹配的 .ez 文件，例如 rabbitmq_delayed_message_exchange-3.9.0.ez
- 放置插件：将文件复制到插件目录（路径因安装方式/版本不同，常见为）
- /usr/lib/rabbitmq/lib/rabbitmq_server-{version}/plugins
- 启用插件：rabbitmq-plugins enable rabbitmq_delayed_message_exchange
- 验证与重启：rabbitmq-plugins list 查看是否已启用（E/e），必要时重启服务：sudo systemctl restart rabbitmq-server。
四 常见问题与排查
- 访问管理界面失败：
- 插件未启用：执行 sudo rabbitmq-plugins enable rabbitmq_management
- 端口未放行：确保防火墙/云安全组开放 15672
- 默认账户限制：默认 guest/guest 仅允许本机访问，远程访问请创建新用户并赋权（见下节）
- 插件启用失败或版本不匹配：确认插件与当前 RabbitMQ 版本兼容，必要时更换对应版本的 .ez 文件。
五 用户与权限配置（便于远程管理）
- 新建管理员用户：sudo rabbitmqctl add_user admin StrongPass!
- 设置角色：sudo rabbitmqctl set_user_tags admin administrator
- 授予默认 vhost 全部权限：sudo rabbitmqctl set_permissions -p / admin “." ".” “.*”
- 建议：出于安全考虑，生产环境不要依赖 guest 远程登录，使用自建管理员账户。
