Windows/Linux 通用教程：RabbitMQ 安装部署与 Web 管理界面快速上手

RabbitMQ 作为一款开源的消息代理软件，基于 AMQP 协议实现，凭借其高可靠性、易扩展性和灵活的路由机制，被广泛应用于分布式系统的消息传递场景中。无论是 Windows 开发环境还是 Linux 生产服务器，掌握 RabbitMQ 的安装部署与基础使用都是后端开发者的必备技能。本文将提供跨系统的通用教程，带你从零开始完成 RabbitMQ 的环境搭建，并快速上手 Web 管理界面。

一、前置知识：RabbitMQ 与 Erlang 的依赖关系

RabbitMQ 是基于 Erlang 语言开发的，因此必须先安装对应版本的 Erlang 环境，否则 RabbitMQ 无法启动。两者的版本兼容性至关重要，推荐通过 RabbitMQ 官方提供的版本对照表选择匹配的组合，避免出现启动异常。

  官方版本对照表查询地址：[https://www.rabbitmq.com/which-erlang.html](https://www.rabbitmq.com/which-erlang.html)（建议收藏，确保版本匹配）

二、跨系统安装：Windows 与 Linux 分步实现

本节将分别针对 Windows 10/11 系统和 CentOS 7/8 系统（Linux 主流服务器版本）提供详细的安装步骤，其他 Linux 发行版（如 Ubuntu）可参考类似逻辑调整命令。

2.1 通用前置：下载对应版本的安装包

• Erlang 下载：官方下载地址 https://www.erlang.org/downloads，根据系统选择对应的安装包（Windows 选 .exe，Linux 选 .rpm 或 .tar.gz）。

• RabbitMQ 下载：官方下载地址 https://www.rabbitmq.com/download.html，同样区分系统版本。

2.2 Windows 系统安装步骤

步骤 1：安装 Erlang 并配置环境变量

1. 双击下载的 Erlang 安装包（如 otp_win64_26.0.exe），按照向导完成安装，建议安装路径选择简单路径（如 D:\Erlang\OTP）。

2. 配置环境变量：

   • 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”。

   • 在“系统变量”中新建变量，变量名 ERLANG_HOME，变量值为 Erlang 安装路径（如 D:\Erlang\OTP）。

   • 编辑“系统变量”中的“Path”，添加 %ERLANG_HOME%\bin，点击确定保存。

3. 验证 Erlang 安装：打开命令提示符（CMD），输入 erl -version，若显示 Erlang 版本信息（如 Erlang/OTP 26 (erts-14.0)），则安装成功。

步骤 2：安装 RabbitMQ 并启动服务

1. 双击 RabbitMQ 安装包（如 rabbitmq-server-3.12.0.exe），默认安装即可（若需修改路径，确保路径无中文和空格）。

2. 启动 RabbitMQ 服务：

   • 方式一：通过服务管理启动。按下 Win+R 输入 services.msc，找到“RabbitMQ”服务，右键“启动”，并设置“启动类型”为“自动”（避免重启后需手动启动）。

   • 方式二：通过命令行启动。以管理员身份打开 CMD，输入命令：

   rabbitmq-service start（启动服务）

   rabbitmq-service stop（停止服务）

   rabbitmq-service restart（重启服务）

2.3 Linux 系统（CentOS）安装步骤

步骤 1：安装 Erlang 环境

推荐使用 RPM 包安装，避免编译源码的复杂操作：

1. 上传下载的 Erlang RPM 包到服务器（如 otp_el8_26.0-1.el8.x86_64.rpm），通过 SSH 连接服务器。

2. 执行安装命令：

rpm -ivh otp_el8_26.0-1.el8.x86_64.rpm
若出现依赖缺失，可先执行 yum install -y libstdc++ glibc-devel 安装依赖。

3. 验证安装：输入 erl -version，显示版本信息即为成功。

步骤 2：安装 RabbitMQ 并配置服务

1. 安装 RabbitMQ RPM 包：

rpm -ivh rabbitmq-server-3.12.0-1.el8.noarch.rpm

2. 设置 RabbitMQ 服务开机自启并启动：

systemctl enable rabbitmq-server（设置开机自启）

systemctl start rabbitmq-server（启动服务）

3. 验证服务状态：

systemctl status rabbitmq-server
若显示“active (running)”，则服务启动成功。

三、关键配置：启用 Web 管理界面与用户授权

RabbitMQ 默认未启用 Web 管理界面，需通过命令手动开启，同时为了安全访问，需要创建管理员用户（默认的 guest 用户仅允许本地访问）。

3.1 启用 Web 管理插件

Windows 和 Linux 系统的命令一致，仅执行方式略有差异：

• Windows：以管理员身份打开 CMD，输入命令：

rabbitmq-plugins enable rabbitmq_management
执行成功后，重启 RabbitMQ 服务：rabbitmq-service restart

• Linux：直接在 SSH 终端输入命令：

rabbitmq-plugins enable rabbitmq_management
重启服务：systemctl restart rabbitmq-server

3.2 创建管理员用户并授权

为了实现远程访问 Web 界面，需创建新的管理员用户，执行以下系列命令（Windows 用 CMD 管理员，Linux 用 SSH 终端）：

1. 创建用户（用户名自定义，如 admin，密码自定义，如 Admin@123）：

rabbitmqctl add_user admin Admin@123

2. 设置用户为管理员角色：

rabbitmqctl set_user_tags admin administrator
RabbitMQ 有四种角色：administrator（管理员）、monitoring（监控者）、policymaker（策略制定者）、management（普通管理者），此处选择 administrator 以获得完整权限。

3. 授予用户所有资源的权限（允许访问所有虚拟主机）：

rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"
参数说明：-p 指定虚拟主机（/ 为默认虚拟主机），后面三个 “.*” 分别表示配置权限、写权限、读权限。

4. （可选）删除默认的 guest 用户（增强安全性）：

rabbitmqctl delete_user guest

四、Web 管理界面快速上手

启用 Web 管理插件并配置用户后，即可通过浏览器访问管理界面，进行队列创建、交换机配置、消息发送等操作，这是 RabbitMQ 最常用的操作方式。

4.1 访问 Web 界面

• 本地访问：打开浏览器，输入地址 http://localhost:15672（15672 是 RabbitMQ Web 管理界面的默认端口）。

• 远程访问（Linux 服务器）：确保服务器开放 15672 端口（RabbitMQ 通信端口 5672 也需开放，用于程序连接），然后通过服务器 IP 访问：http://服务器IP:15672。

Linux 开放端口命令（CentOS 7/8）：

firewall-cmd --zone=public --add-port=15672/tcp --permanent
firewall-cmd --zone=public --add-port=5672/tcp --permanent
firewall-cmd --reload

• 登录：输入创建的管理员用户名（如 admin）和密码（如 Admin@123），点击“Login”进入界面。

4.2 核心功能模块操作

1. 概览页（Overview）

登录后首先进入概览页，展示 RabbitMQ 的核心信息：

• Nodes：当前 RabbitMQ 节点状态（Running 为正常）。

• Connections：客户端连接数。

• Channels：信道数（程序通过信道与 RabbitMQ 通信，而非直接连接）。

• Exchanges/Queues：交换机和队列的数量。

• Messages：消息总数（可查看就绪、未确认等状态的消息数）。

2. 队列管理（Queues）

队列是 RabbitMQ 存储消息的核心组件，常用操作如下：

1. 创建队列：点击“Queues”→“Add a new queue”，输入队列名称（如 test_queue），其他参数默认（如需持久化，勾选“Durable”），点击“Add queue”。

2. 发送消息：选中创建的队列，点击“Publish message”，在“Payload”中输入消息内容（如“Hello RabbitMQ”），点击“Publish message”发送。

3. 接收消息：点击队列的“Get messages”，勾选“Auto ack”（自动确认），点击“Get message(s)”，即可查看接收的消息内容。

4. 删除队列：选中队列，点击“Delete”即可（生产环境需谨慎操作）。

3. 交换机管理（Exchanges）

交换机负责将消息路由到队列，需绑定队列才能生效，常用操作：

1. 创建交换机：点击“Exchanges”→“Add a new exchange”，输入交换机名称（如 test_exchange），选择交换机类型（如 Direct，直接路由），勾选“Durable”，点击“Add exchange”。

2. 绑定队列：选中创建的交换机，在“Bindings”区域输入“To queue”（选择已创建的 test_queue），输入“Routing key”（如 test_key），点击“Bind”。

3. 通过交换机发送消息：点击交换机的“Publish message”，输入“Routing key”（需与绑定的一致，如 test_key）和消息内容，发送后消息会通过交换机路由到绑定的队列。

4. 用户与权限管理（Admin）

在“Admin”页面可管理用户、虚拟主机和权限：

• 用户管理：可添加、编辑、删除用户，修改用户密码和角色。

• 虚拟主机（Virtual Hosts）：默认虚拟主机为 /，可创建新的虚拟主机实现资源隔离，创建后需为用户分配该虚拟主机的权限。

• 权限配置：为用户分配指定虚拟主机的配置、读写权限。

五、常见问题与解决方案

1. Erlang 版本不匹配导致 RabbitMQ 启动失败
   解决方案：严格按照官方版本对照表选择 Erlang 和 RabbitMQ 版本，卸载当前版本后重新安装匹配的组合。

2. Web 界面无法访问（Linux 系统）
   排查点：① 确认 RabbitMQ 服务正常运行；② 确认 15672 端口已开放；③ 确认 Web 插件已启用；④ 尝试重启 RabbitMQ 服务。

3. 远程连接时 guest 用户登录失败
   原因：guest 用户默认仅允许本地访问。解决方案：使用自定义的管理员用户登录（如本文创建的 admin 用户）。

4. Windows 系统中 RabbitMQ 服务启动后立即停止
   排查点：① Erlang 环境变量配置是否正确；② Erlang 与 RabbitMQ 版本是否匹配；③ 查看日志（路径：C:\Users\Administrator\AppData\Roaming\RabbitMQ\log）定位具体错误。

六、总结

本文覆盖了 RabbitMQ 在 Windows 和 Linux 系统下的完整安装部署流程，核心在于确保 Erlang 与 RabbitMQ 的版本匹配，以及正确启用 Web 管理插件和配置用户权限。Web 管理界面提供了直观的操作方式，通过队列、交换机的基础操作，即可快速理解 RabbitMQ 的消息传递机制。后续可进一步学习 RabbitMQ 的高级特性，如消息持久化、死信队列、延迟队列等，以满足分布式系统的复杂需求。

如果在操作过程中遇到问题，可通过 RabbitMQ 官方文档或日志信息进一步排查，祝大家使用顺利！