第4章 RabbitMQ部署与配置

第1章：RabbitMQ部署与配置：Erlang环境安装、集群部署、镜像队列、插件管理、管理界面使用

各位同学，咱们今天聊点实在的。RabbitMQ 这东西，我在边缘计算项目里用了好几年了。说实话，刚开始我也踩过不少坑，尤其是 Erlang 环境那块，折腾得我够呛。今天我把这些经验都摊开来，咱们一步步搞定它。

1.1 Erlang环境安装——RabbitMQ的基石

RabbitMQ 是用 Erlang 写的，所以你得先装 Erlang。这就像盖房子要先打地基，地基不稳，后面全白搭。

为什么非得用 Erlang？ 说白了，Erlang 天生就是为高并发、分布式场景设计的。RabbitMQ 选它，看中的就是它的容错能力和热更新特性。我在项目中遇到过，Erlang 版本不匹配导致 RabbitMQ 启动失败的情况，那叫一个头疼。

⚠️ 版本匹配很重要

RabbitMQ 和 Erlang 有严格的版本对应关系。别随便装个最新版 Erlang 就完事了。去 RabbitMQ 官网查一下版本兼容矩阵，这是第一步。

安装步骤其实不复杂，我习惯用源码编译或者包管理器。咱们以 CentOS 7 为例：

# 安装依赖
yum install -y gcc glibc-devel make ncurses-devel openssl-devel xmlto perl wget

# 下载 Erlang（以 24.3 版本为例）
wget https://github.com/erlang/otp/releases/download/OTP-24.3/otp_src_24.3.tar.gz
tar -zxvf otp_src_24.3.tar.gz
cd otp_src_24.3

# 编译安装
./configure --prefix=/usr/local/erlang
make && make install

# 配置环境变量
echo 'export PATH=$PATH:/usr/local/erlang/bin' >> /etc/profile
source /etc/profile

# 验证安装
erl -version

装完之后，用 erl -version 检查一下。如果看到版本号，恭喜你，第一步走通了。

💡 我的小习惯

我个人习惯把 Erlang 装在 /usr/local/erlang 下，而不是用系统默认路径。这样方便管理，升级也简单。你想想看，万一以后要换版本，直接改个软链接就行了。

1.2 RabbitMQ安装与启动

Erlang 装好了，接下来装 RabbitMQ 本身。我建议用官方提供的包，省心。

# 下载 RabbitMQ（以 3.10.7 版本为例）
wget https://github.com/rabbitmq/rabbitmq-server/releases/download/v3.10.7/rabbitmq-server-generic-unix-3.10.7.tar.xz
tar -xf rabbitmq-server-generic-unix-3.10.7.tar.xz
mv rabbitmq_server-3.10.7 /usr/local/rabbitmq

# 启动服务
/usr/local/rabbitmq/sbin/rabbitmq-server -detached

# 查看状态
/usr/local/rabbitmq/sbin/rabbitmqctl status

启动后，用 rabbitmqctl status 看看。如果看到 running_applications 列表里有 rabbit 相关的内容，说明跑起来了。

重要提醒： 第一次启动时，RabbitMQ 会创建一些默认用户和虚拟主机。默认的 guest 用户只能在 localhost 登录，远程访问需要新建用户。我曾经因为这个被坑过，远程连不上，查了半天才发现是权限问题。

1.3 集群部署——让消息队列不再单点

单机 RabbitMQ 在边缘场景下风险太大。一台设备挂了，整个消息通道就断了。所以咱们得搞集群。

集群部署的核心思路：多个节点组成一个逻辑整体，消息可以在节点间流转。我习惯用三节点集群，既保证高可用，又不会太复杂。

准备工作：

三台机器，IP 分别为 192.168.1.10、192.168.1.11、192.168.1.12
每台机器都装好 Erlang 和 RabbitMQ
确保节点间网络互通，防火墙放行 4369、5672、15672、25672 端口

集群搭建的关键是 Erlang Cookie 一致。这个 Cookie 相当于节点间的“通行证”，必须一模一样。

# 在节点1上查看 Cookie
cat /var/lib/rabbitmq/.erlang.cookie

# 把这个 Cookie 复制到节点2和节点3的相同位置
# 然后重启 RabbitMQ 服务

# 在节点2上加入集群
rabbitmqctl stop_app
rabbitmqctl reset
rabbitmqctl join_cluster rabbit@node1
rabbitmqctl start_app

# 节点3同理
rabbitmqctl stop_app
rabbitmqctl reset
rabbitmqctl join_cluster rabbit@node1
rabbitmqctl start_app

# 查看集群状态
rabbitmqctl cluster_status

💡 避坑指南

我曾经在加入集群时忘了执行 rabbitmqctl reset，结果节点一直报错。记住，加入集群前一定要 reset，把节点状态清干净。另外，节点的主机名要能互相解析，最好配好 /etc/hosts。

1.4 镜像队列——数据不丢的保障

普通队列在集群中默认只存在于一个节点上。如果那个节点挂了，队列里的消息就丢了。镜像队列就是解决这个问题的——把队列复制到多个节点上。

配置镜像队列有两种方式：

策略方式： 通过 rabbitmqctl 或管理界面设置策略，匹配队列名称自动镜像
代码方式： 在客户端声明队列时指定参数

我推荐用策略方式，灵活且易于管理。举个例子：

# 设置镜像策略，匹配所有以 "ha." 开头的队列
rabbitmqctl set_policy ha-all "^ha\." '{"ha-mode":"all","ha-sync-mode":"automatic"}'

# 参数说明：
# ha-mode: all 表示镜像到所有节点
# ha-sync-mode: automatic 表示自动同步

设置好之后，你往 ha.test 这个队列发消息，消息会自动复制到集群里的每个节点。任何一个节点挂了，其他节点还能继续服务。

注意： 镜像队列会带来性能开销。每个消息都要复制到多个节点，写入延迟会上升。在边缘场景下，如果对延迟敏感，可以只镜像到两个节点，而不是全部节点。我一般用 ha-mode: exactly 配合 ha-params: 2，既保证高可用，又控制性能损耗。

1.5 插件管理——扩展RabbitMQ的能力

RabbitMQ 的插件生态很丰富。常用的有管理界面插件、延迟消息插件、消息追踪插件等。插件管理用 rabbitmq-plugins 命令。

# 查看已安装的插件
rabbitmq-plugins list

# 启用管理界面插件
rabbitmq-plugins enable rabbitmq_management

# 启用延迟消息插件
rabbitmq-plugins enable rabbitmq_delayed_message_exchange

# 重启 RabbitMQ 使插件生效
rabbitmqctl stop
rabbitmq-server -detached

启用管理界面插件后，浏览器访问 http://你的IP:15672，就能看到 Web 管理界面了。默认用户名密码是 guest/guest，但只能本地登录。远程访问需要新建用户：

rabbitmqctl add_user admin your_password
rabbitmqctl set_user_tags admin administrator
rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"

💡 我的经验

延迟消息插件在边缘计算场景下特别有用。比如设备上报数据后，你想延迟一段时间再处理，或者做定时任务。这个插件不是默认自带的，需要单独下载安装。记得去 RabbitMQ 官网下载对应版本的插件包。

1.6 管理界面使用——可视化操作

管理界面是 RabbitMQ 的“仪表盘”。我个人习惯先通过命令行搞定基础配置，然后用界面做日常监控和调试。

界面核心功能：

Overview： 查看集群整体状态，节点数、队列数、消息速率等
Connections： 查看当前连接，包括生产者、消费者
Channels： 查看通道详情，每个连接可以有多个通道
Exchanges： 管理交换机，创建、删除、绑定队列
Queues： 管理队列，查看消息数、消费者数、是否镜像
Admin： 管理用户、虚拟主机、权限

我最常用的是 Queues 页面。点进去能看到每个队列的实时消息数、入队速率、出队速率。如果某个队列消息堆积严重，一眼就能看出来。

调试小技巧： 在 Queues 页面，点击某个队列，然后点 "Get messages" 可以手动拉取消息查看内容。这在调试时特别有用，能快速确认消息格式对不对。

总结

好了，这一章的内容就这些。咱们从 Erlang 环境安装开始，到 RabbitMQ 单机部署，再到集群搭建、镜像队列配置、插件管理，最后看了管理界面的基本用法。每一步都是我在实际项目中反复验证过的。

下一章咱们会深入消息模型，聊聊交换机、队列、绑定这些核心概念。到时候我会结合边缘计算的典型场景，给大家讲清楚怎么设计消息路由。

记住，搭建只是开始，用好才是关键。有问题随时交流。