4.1 RabbitMQ 安装

4.1 RabbitMQ 安装

4.1 RabbitMQ 安装详解：构建可靠消息传递基石

4.1.1 安装前的准备

在开始安装 RabbitMQ 之前，我们需要了解一些关键的准备工作，确保安装过程顺利进行。

1. Erlang/OTP 环境：RabbitMQ 的基石

RabbitMQ 是使用 Erlang 语言开发的，因此 Erlang/OTP (Open Telecom Platform) 是 RabbitMQ 运行的先决条件。Erlang/OTP 提供了一个强大的并发和分布式环境，这正是 RabbitMQ 高效消息处理能力的基础。

检查 Erlang/OTP 是否已安装：

打开终端或命令提示符，输入以下命令：

erl -version
​

如果显示 Erlang 版本信息，则说明 Erlang/OTP 已安装。否则，需要先安装 Erlang/OTP。

2. 选择合适的 RabbitMQ 版本

RabbitMQ 官方会定期发布新版本，建议选择 稳定版本 进行安装。您可以在 RabbitMQ 官方网站 https://www.rabbitmq.com/ 的 "Download" 页面找到最新的稳定版本信息。

3. 确定安装方式

RabbitMQ 提供了多种安装方式，您可以根据您的操作系统和需求选择合适的安装方法：

• 软件包管理器 (Package Manager)： 适用于 Linux 发行版（如 Debian/Ubuntu, CentOS/RHEL），使用 apt, yum, dnf 等包管理器进行安装，简单快捷。

• 独立安装包 (Standalone Binary)： 适用于 Windows 和 macOS，下载安装包后直接运行安装程序。

• Docker 镜像 (Docker Image)： 适用于各种平台，通过 Docker 容器快速部署 RabbitMQ，方便快捷，易于管理。

• 云服务 (Cloud Service)： 各大云平台（如 AWS, Azure, GCP）都提供了托管的 RabbitMQ 服务，无需自行安装和维护，适合生产环境。

4. 硬件和软件要求

RabbitMQ 对硬件要求不高，但为了获得更好的性能，建议：

• 内存： 至少 1GB 内存，建议 2GB 或以上。

• 磁盘空间： 根据消息存储需求预留足够的磁盘空间。

• 操作系统： 支持多种操作系统，如 Linux, Windows, macOS。

4.1.2 基于不同操作系统的 RabbitMQ 安装实践

接下来，我们将分别介绍在不同操作系统下安装 RabbitMQ 的详细步骤，并提供相应的代码实践。

4.1.2.1 在 Debian/Ubuntu 上安装 RabbitMQ

Debian/Ubuntu 系统可以使用 apt 包管理器轻松安装 RabbitMQ。

步骤 1: 安装 Erlang/OTP

RabbitMQ 官方仓库通常会提供与 RabbitMQ 版本兼容的 Erlang/OTP 版本。

sudo apt-get update
sudo apt-get install erlang
​

步骤 2: 添加 RabbitMQ 官方 APT 仓库

为了安装最新版本的 RabbitMQ，我们需要添加 RabbitMQ 官方 APT 仓库。

sudo apt-get install apt-transport-https
echo "deb https://dl.bintray.com/rabbitmq/debian bionic main" | sudo tee /etc/apt/sources.list.d/rabbitmq.list
wget -O- https://dl.bintray.com/rabbitmq/rabbitmq-release-signing-key.asc | sudo apt-key add -
​

步骤 3: 安装 RabbitMQ Server

更新 APT 仓库并安装 RabbitMQ Server。

sudo apt-get update
sudo apt-get install rabbitmq-server
​

步骤 4: 启动 RabbitMQ Server

安装完成后，RabbitMQ Server 会自动启动。您可以使用以下命令检查 RabbitMQ Server 的状态：

sudo systemctl status rabbitmq-server
​

如果 RabbitMQ Server 没有自动启动，可以使用以下命令手动启动：

sudo systemctl start rabbitmq-server
​

步骤 5: 启用 RabbitMQ Management Plugin (可选但强烈推荐)

RabbitMQ Management Plugin 提供了一个 Web 管理界面，方便您监控 RabbitMQ Server 的状态、管理队列、交换机、用户等。

sudo rabbitmq-plugins enable rabbitmq_management
​

启用插件后，您可以通过浏览器访问 http://localhost:15672 (默认端口) 进入 RabbitMQ Management Web UI。默认用户名和密码为 guest/guest (生产环境请务必修改默认密码)。

代码实践 (Debian/Ubuntu 安装脚本):

#!/bin/bash
# Debian/Ubuntu RabbitMQ 安装脚本
echo "更新 APT 仓库..."
sudo apt-get update
echo "安装 Erlang/OTP..."
sudo apt-get install erlang
echo "添加 RabbitMQ 官方 APT 仓库..."
sudo apt-get install apt-transport-https
echo "deb https://dl.bintray.com/rabbitmq/debian bionic main" | sudo tee /etc/apt/sources.list.d/rabbitmq.list
wget -O- https://dl.bintray.com/rabbitmq/rabbitmq-release-signing-key.asc | sudo apt-key add -
echo "再次更新 APT 仓库..."
sudo apt-get update
echo "安装 RabbitMQ Server..."
sudo apt-get install rabbitmq-server
echo "启动 RabbitMQ Server..."
sudo systemctl start rabbitmq-server
echo "启用 RabbitMQ Management Plugin..."
sudo rabbitmq-plugins enable rabbitmq_management
echo "RabbitMQ 安装完成！"
echo "请访问 http://localhost:15672 (默认用户 guest/guest) 查看管理界面。"
​

4.1.2.2 在 CentOS/RHEL 上安装 RabbitMQ

CentOS/RHEL 系统可以使用 yum 或 dnf 包管理器安装 RabbitMQ。

步骤 1: 安装 Erlang/OTP

与 Debian/Ubuntu 类似，需要先安装 Erlang/OTP。

sudo yum update
sudo yum install erlang
​

步骤 2: 添加 RabbitMQ 官方 YUM 仓库

cat <<EOF > /etc/yum.repos.d/rabbitmq.repo
[rabbitmq-erlang]
name=rabbitmq-erlang
baseurl=https://packagecloud.io/rabbitmq/erlang/el/$(rpm -E %{rhel})/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/rabbitmq/erlang/gpgkey
[rabbitmq-server]
name=rabbitmq-server
baseurl=https://packagecloud.io/rabbitmq/rabbitmq-server/el/$(rpm -E %{rhel})/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/rabbitmq/rabbitmq-server/gpgkey
EOF
​

步骤 3: 安装 RabbitMQ Server

更新 YUM 仓库并安装 RabbitMQ Server。

sudo yum update
sudo yum install rabbitmq-server
​

步骤 4: 启动 RabbitMQ Server

sudo systemctl start rabbitmq-server
sudo systemctl enable rabbitmq-server # 设置开机自启动
​

步骤 5: 启用 RabbitMQ Management Plugin (可选但强烈推荐)

sudo rabbitmq-plugins enable rabbitmq_management
​

代码实践 (CentOS/RHEL 安装脚本):

#!/bin/bash
# CentOS/RHEL RabbitMQ 安装脚本
echo "更新 YUM 仓库..."
sudo yum update
echo "安装 Erlang/OTP..."
sudo yum install erlang
echo "添加 RabbitMQ 官方 YUM 仓库..."
cat <<EOF > /etc/yum.repos.d/rabbitmq.repo
[rabbitmq-erlang]
name=rabbitmq-erlang
baseurl=https://packagecloud.io/rabbitmq/erlang/el/$(rpm -E %{rhel})/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/rabbitmq/erlang/gpgkey
[rabbitmq-server]
name=rabbitmq-server
baseurl=https://packagecloud.io/rabbitmq/rabbitmq-server/el/$(rpm -E %{rhel})/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/rabbitmq/rabbitmq-server/gpgkey
EOF
echo "再次更新 YUM 仓库..."
sudo yum update
echo "安装 RabbitMQ Server..."
sudo yum install rabbitmq-server
echo "启动 RabbitMQ Server 并设置开机自启动..."
sudo systemctl start rabbitmq-server
sudo systemctl enable rabbitmq-server
echo "启用 RabbitMQ Management Plugin..."
sudo rabbitmq-plugins enable rabbitmq_management
echo "RabbitMQ 安装完成！"
echo "请访问 http://localhost:15672 (默认用户 guest/guest) 查看管理界面。"
​

4.1.2.3 在 Windows 上安装 RabbitMQ

在 Windows 上安装 RabbitMQ 相对简单，可以通过下载安装包进行安装。

步骤 1: 下载 Erlang/OTP Windows 安装包

访问 Erlang Solutions 官方网站 https://www.erlang-solutions.com/downloads/，下载与您的 Windows 版本 (32 位或 64 位) 对应的 Erlang/OTP Windows 安装包 (通常是 .exe 文件)。

步骤 2: 安装 Erlang/OTP

双击下载的 Erlang/OTP 安装包，按照安装向导的提示完成安装。

步骤 3: 下载 RabbitMQ Server Windows 安装包

访问 RabbitMQ 官方网站 https://www.rabbitmq.com/download.html，在 "Windows Installer" 部分下载 RabbitMQ Server Windows 安装包 (通常是 .exe 文件)。

步骤 4: 安装 RabbitMQ Server

双击下载的 RabbitMQ Server 安装包，按照安装向导的提示完成安装。安装过程中，安装程序会自动检测 Erlang/OTP 环境。

步骤 5: 启动 RabbitMQ Server

安装完成后，RabbitMQ Server 会自动作为 Windows 服务启动。您可以在 "服务" 管理器中找到 "RabbitMQ" 服务，并查看其状态。如果服务未启动，可以手动启动。

步骤 6: 启用 RabbitMQ Management Plugin (可选但强烈推荐)

打开命令提示符 (以管理员身份运行)，进入 RabbitMQ Server 的 sbin 目录 (通常位于 C:\Program Files\RabbitMQ Server\rabbitmq_server-版本号\sbin)，执行以下命令：

rabbitmq-plugins enable rabbitmq_management
​

代码实践 (Windows 安装步骤概括):

Windows 安装主要依赖图形界面，代码实践较少，主要是命令行操作启用插件。

REM Windows RabbitMQ 启用 Management Plugin (在 RabbitMQ Server sbin 目录下执行)
rabbitmq-plugins enable rabbitmq_management
​

4.1.2.4 使用 Docker 安装 RabbitMQ

Docker 是部署 RabbitMQ 的一种便捷方式，可以快速搭建 RabbitMQ 环境，并方便进行版本管理和隔离。

步骤 1: 安装 Docker (如果尚未安装)

请参考 Docker 官方文档 https://docs.docker.com/get-docker/ 安装适合您操作系统的 Docker 版本。

步骤 2: 拉取 RabbitMQ Docker 镜像

打开终端或命令提示符，执行以下命令拉取 RabbitMQ 官方 Docker 镜像。您可以选择不同的 Tag 来指定 RabbitMQ 版本，latest Tag 代表最新稳定版本。

docker pull rabbitmq:latest
​

步骤 3: 运行 RabbitMQ Docker 容器

使用以下命令运行 RabbitMQ Docker 容器。

docker run -d --name my-rabbit -p 5672:5672 -p 15672:15672 rabbitmq:latest
​

参数说明：

• -d: 后台运行容器。

• --name my-rabbit: 指定容器名称为 my-rabbit。

• -p 5672:5672: 将容器的 5672 端口 (AMQP 端口) 映射到宿主机的 5672 端口。

• -p 15672:15672: 将容器的 15672 端口 (Management Web UI 端口) 映射到宿主机的 15672 端口。

• rabbitmq:latest: 使用 rabbitmq:latest 镜像。

步骤 4: 访问 RabbitMQ Management Web UI

容器启动后，您可以通过浏览器访问 http://localhost:15672 进入 RabbitMQ Management Web UI。默认用户名和密码为 guest/guest。

代码实践 (Docker Compose 部署 RabbitMQ):

使用 Docker Compose 可以更方便地管理 RabbitMQ 容器。创建一个 docker-compose.yml 文件，内容如下：

version: '3.8'
services:
  rabbitmq:
    image: rabbitmq:latest
    ports:
      - "5672:5672"
      - "15672:15672"
    hostname: my-rabbit
​

然后在 docker-compose.yml 文件所在目录执行以下命令启动 RabbitMQ 容器：

docker-compose up -d
​

4.1.3 RabbitMQ 安装后的验证

安装 RabbitMQ 后，我们需要进行验证，确保 RabbitMQ Server 正常运行。

1. 检查 RabbitMQ Server 状态

• Linux (systemctl):

sudo systemctl status rabbitmq-server
​

• Windows (服务管理器): 查看 "RabbitMQ" 服务状态。

• Docker:

docker ps | grep rabbitmq
​

2. 访问 RabbitMQ Management Web UI

在浏览器中访问 http://localhost:15672，使用默认用户名 guest 和密码 guest 登录 (如果启用了 Management Plugin)。如果能够成功登录并看到 RabbitMQ 管理界面，则说明 RabbitMQ Server 运行正常。

3. 使用 rabbitmqctl 命令行工具

rabbitmqctl 是 RabbitMQ 提供的命令行管理工具。您可以使用 rabbitmqctl status 命令查看 RabbitMQ Server 的状态。

sudo rabbitmqctl status
​

如果输出类似以下信息，则说明 RabbitMQ Server 运行正常：

Status of node rabbit@主机名 ...
[{pid, ...},
 {running_applications,[{rabbit,"RabbitMQ","版本号"},
                         {mnesia, ...},
                         {os_mon, ...},
                         {rabbit_common, ...},
                         {stdlib, ...},
                         {kernel, ...}]}]
...
​

4.1.4 RabbitMQ 架构概览 (Mermaid 图)

为了更好地理解 RabbitMQ 的运行机制，我们使用 Mermaid 图绘制一个简单的 RabbitMQ 架构图。

图表解释：

• Client (生产者/消费者): 应用程序通过 AMQP 协议与 RabbitMQ Server 交互。

• Exchange (交换机): 接收生产者发送的消息，并根据路由规则将消息路由到一个或多个队列。

• Queue (队列): 存储消息，等待消费者消费。

• Consumer (消费者): 从队列中接收消息并进行处理。

• Binding (绑定): 定义交换机和队列之间的关系，以及消息的路由规则 (Routing Key)。

• Routing Key (路由键): 消息的属性，用于交换机根据绑定规则将消息路由到合适的队列。

• RabbitMQ Server: RabbitMQ 服务核心，包含 Node (节点)、Exchange、Queue、Binding、Routing Key 等组件。

• AMQP Protocol: Advanced Message Queuing Protocol，RabbitMQ 使用的标准消息队列协议。

• Management UI: RabbitMQ Management Web UI，用于监控和管理 RabbitMQ Server。

• Admin: 管理员通过 Management UI 管理 RabbitMQ Server。

4.1.5 安装过程中的常见问题及解决

在 RabbitMQ 安装过程中，可能会遇到一些常见问题，以下是一些常见问题及解决方法：

• Erlang/OTP 版本不兼容: RabbitMQ 版本与 Erlang/OTP 版本之间存在兼容性要求，请务必选择兼容的版本。查看 RabbitMQ 官方文档获取版本兼容性信息。

• 端口冲突: RabbitMQ 默认使用 5672 (AMQP) 和 15672 (Management UI) 端口，如果这些端口被其他程序占用，需要修改 RabbitMQ 的配置文件或者停止占用端口的程序。

• 防火墙限制: 如果 RabbitMQ Server 部署在防火墙后面，需要开放 5672 和 15672 端口 (以及其他需要的端口，如集群端口) 以允许客户端连接和访问 Management UI。

• 权限问题: 在 Linux 系统上安装 RabbitMQ 时，可能需要使用 sudo 命令以管理员权限执行安装命令。

• Docker 镜像拉取失败: 如果 Docker 镜像拉取失败，请检查网络连接是否正常，或者尝试更换 Docker 镜像源。

4.1.6 总结

下一步，我们将深入探讨 RabbitMQ 的核心概念，包括交换机、队列、绑定、路由等，以及 RabbitMQ 如何保障消息的可靠传递。