Debian 上 RabbitMQ 插件的安装与管理
一 准备与环境检查
- 确保已安装 RabbitMQ 服务器 与 Erlang，并将服务设为开机自启：
- 安装：sudo apt update && sudo apt install -y rabbitmq-server erlang-nox
- 启停与自启：sudo systemctl start|stop|restart|enable rabbitmq-server
- 版本匹配要点：RabbitMQ 与 Erlang/OTP 需版本匹配（如 4.0.0+ 支持 Erlang 27.x，3.12.0+ 支持 Erlang 26.x）。如需新版本，建议使用 RabbitMQ 官方 APT 仓库 安装，避免系统仓库版本过旧。
二 插件管理常用命令
- 列出插件与状态：rabbitmq-plugins list（标识说明：[E] 显式启用，[e] 隐式启用，[ ] 未启用）
- 启用插件：rabbitmq-plugins enable <插件名>（如：rabbitmq_management）
- 禁用插件：rabbitmq-plugins disable <插件名>
- 说明：启用某些插件会触发依赖插件一并启用；部分变更可能需要重启节点（见下一节）。
三 常用插件与启用示例
- Web 管理界面（强烈推荐）
- 启用：sudo rabbitmq-plugins enable rabbitmq_management
- 访问：http://<服务器IP>:15672
- 默认凭据：guest/guest，但从 3.3.0 起仅允许 localhost 登录；远程访问请创建新用户并赋权。
- 消息追踪（Tracing）
- 启用：sudo rabbitmq-plugins enable rabbitmq_tracing
- 用途：在管理界面中开启/查看消息轨迹，便于排障。
- 延迟交换机（社区插件）
- 步骤：
- 从官方社区插件页面下载与当前 RabbitMQ 版本匹配的 .ez 插件包（如 rabbitmq_delayed_message_exchange-.ez）
- 将插件复制到节点插件目录（路径因安装方式/版本不同，常见如：/usr/lib/rabbitmq/lib/rabbitmq_server-/plugins）
- 启用：rabbitmq-plugins enable rabbitmq_delayed_message_exchange
- 在管理界面或声明 exchange 时使用类型 x-delayed-message。
四 启用后的服务与网络配置
- 重启生效：部分插件（如管理插件）启用后建议重启以完成依赖组件启动：sudo systemctl restart rabbitmq-server
- 访问与端口：
- 管理界面：15672/tcp
- AMQP：5672/tcp
- 防火墙放行示例（UFW）：sudo ufw allow 5672/tcp；sudo ufw allow 15672/tcp
- 远程登录安全：
- 新建管理员用户并赋权（示例：admin/admin123）
- sudo rabbitmqctl add_user admin admin123
- sudo rabbitmqctl set_user_tags admin administrator
- sudo rabbitmqctl set_permissions -p / admin “." ".” “.*”
- 生产环境建议禁用或删除默认 guest 用户，避免被滥用。
五 故障排查与验证
- 节点与插件状态诊断：
- 节点存活：sudo rabbitmq-diagnostics ping（应返回 “ping succeeded”）
- 节点状态：sudo rabbitmq-diagnostics status
- 集群状态：sudo rabbitmq-diagnostics cluster_status
- 生成报告：sudo rabbitmqctl report
- 查看日志：tail -f /var/log/rabbitmq/rabbit@.log
- 常见排障要点：
- 插件未生效：确认已启用并重启节点；检查插件目录权限与版本匹配
- 端口不通：确认服务监听与防火墙放行（5672/15672）
- 无法远程登录：确认使用非 guest 用户且已赋权，且未被 loopback_users 限制。
