前言
RabbitMQ 是一款基于 Erlang 语言开发的开源消息代理软件，广泛应用于分布式系统中的异步消息传递。它支持多种消息协议（如 AMQP、MQTT、STOMP），提供灵活的路由策略和高可用性设计，是微服务架构中的重要基础设施组件。
在 Windows 环境下安装 RabbitMQ 时，新手往往会遇到 Erlang 版本兼容性、环境变量配置、管理插件启用等一系列问题。本文将手把手带你完成从依赖安装到验证可用的全流程，并解答常见的安装陷阱。
一、准备工作
1.1 系统要求
- 操作系统：Windows 7/8/10/11（64位推荐）
- 内存要求：至少 2GB 可用内存
- 权限要求：管理员权限（安装过程中必须以管理员身份运行）
- 依赖组件：64位 Erlang/OTP 运行环境
1.2 版本兼容性说明
RabbitMQ 对 Erlang 版本有严格要求，版本不匹配会导致服务启动失败。以下是官方最新兼容性矩阵（截至2026年）：
| 4.2.0 | 26.2 | 27.x | Erlang 28 部分支持 |
| 4.1.x | 26.2 | 27.x | 不支持 Erlang 28 |
| 4.0.x | 26.2 | 27.x | 4.0.4+ 支持 Erlang 27 |
| 3.13.x | 26 | 26.2.x | 稳定版本系列 |
| 3.12.x | 25 | 26.1.x | 企业常用版本 |
推荐组合：RabbitMQ 3.12.x + Erlang 25.x（最稳定，适用于生产环境）
二、安装 Erlang
2.1 下载 Erlang
2.2 安装 Erlang
- 重要提示：安装路径只能包含 ASCII 字符，严禁包含空格或中文
2.3 配置 Erlang 环境变量
右键点击 “此电脑” → “属性” → “高级系统设置” → “环境变量”
在 “系统变量” 区域进行以下操作：
（1）配置 ERLANG_HOME
- 点击 “新建”，变量名为 ERLANG_HOME
- 变量值为 Erlang 安装目录，例如：C:\\Program Files\\erl26.2
（2）配置 Path
- 找到 “Path” 变量，点击 “编辑”
- 点击 “新建”，添加：%ERLANG_HOME%\\bin
点击 “确定” 保存所有设置
2.4 验证 Erlang 安装
重要：必须关闭之前所有打开的命令提示符窗口，重新打开一个新的 CMD 或 PowerShell 窗口。
输入以下命令：
erl -version
如果显示 Erlang 版本信息（如 Erlang/OTP 26 [erts-14.0.2]），说明安装成功。
三、下载 RabbitMQ
四、安装 RabbitMQ
4.1 运行安装程序
右键点击下载的 RabbitMQ 安装包，选择**“以管理员身份运行”**。
4.2 安装过程
- 关键点：路径必须使用 ASCII 字符，避免空格和中文字符
4.3 安装完成
安装完成后，RabbitMQ 服务会自动启动并注册为 Windows 服务。
4.4 配置 RabbitMQ 环境变量
虽然不是强制要求，但配置环境变量可以方便后续命令行操作。
找到 RabbitMQ 安装路径下的 sbin 目录，例如：
C:\\Program Files\\RabbitMQ Server\\rabbitmq_server-3.12.x\\sbin
打开环境变量设置：
- 在 “系统变量” 中找到 “Path” 变量，点击 “编辑”
- 点击 “新建”，添加 sbin 目录路径
保存设置
4.5 验证 RabbitMQ 安装
关闭所有命令提示符窗口，以管理员身份重新打开新的 CMD 窗口。
输入以下命令：
rabbitmq-plugins
如果配置正确，应该显示插件管理的帮助信息。
五、验证服务状态
5.1 检查 Windows 服务
如果服务未运行，可以右键点击服务 → “启动”
5.2 使用命令行检查服务
在管理员权限的命令提示符中输入：
rabbitmqctl.bat status
正常情况下会显示 RabbitMQ 节点的详细信息。
六、启用 Web 管理界面
RabbitMQ 默认不启用管理界面，需要手动启用 rabbitmq_management 插件。
6.1 启用管理插件
以管理员身份打开命令提示符，输入：
rabbitmq-plugins enable rabbitmq_management
输出示例：
The following plugins have been configured:
rabbitmq_management
rabbitmq_management_agent
rabbitmq_web_dispatch
Applying plugin configuration to rabbit@localhost…
Plugin configuration unchanged.
6.2 访问管理界面
注意：guest 用户默认只能从本地（localhost）访问。如果需要远程访问，必须创建新用户。
6.3 管理界面概览
登录成功后，你将看到 RabbitMQ 的管理控制台，主要包含以下模块：
- Overview：总览信息，包括消息速率、队列状态、连接数等
- Connections：客户端连接列表
- Channels：通道管理
- Exchanges：交换机管理
- Queues：队列管理
- Admin：用户和权限管理
七、创建管理用户（推荐）
为了安全起见，建议创建新用户并禁用或限制 guest 用户。
7.1 创建新用户
在命令提示符中执行：
# 创建用户
rabbitmqctl.bat add_user admin your_strong_password
# 设置用户标签为管理员
rabbitmqctl.bat set_user_tags admin administrator
# 授予所有权限
rabbitmqctl.bat set_permissions -p / admin ".*" ".*" ".*"
7.2 使用新用户登录
八、常见问题排查
8.1 Erlang 环境未正确配置
错误现象：erlang not found 或服务启动失败
解决方法：
8.2 RabbitMQ 服务无法启动
可能原因：
- Erlang 版本不兼容
- 安装路径包含非 ASCII 字符
- 未以管理员权限安装
排查步骤：
8.3 管理界面无法访问
排查清单：
- 确认 rabbitmq_management 插件已启用：rabbitmq-plugins list | findstr management
- 检查防火墙是否放行 15672 端口
- 确认服务正在运行：rabbitmqctl.bat status
- 尝试使用 http://127.0.0.1:15672 而不是 localhost
8.4 远程访问被拒绝
问题：guest 用户只能从本地访问
解决方法：按照第七节创建新用户并设置相应权限。
8.5 命令行工具报错 “Authentication failed”
原因：Erlang cookie 文件位置不匹配
解决方法：
九、常用端口说明
| 5672 | AMQP 通信端口 | 客户端连接主端口 |
| 5671 | AMQP over TLS | 加密通信端口 |
| 15672 | Web 管理界面 | HTTP API 和 UI |
| 25672 | Erlang 分布式通信 | 集群节点间通信 |
| 61613 | STOMP 协议端口 | 需启用 stomp 插件 |
| 1883 | MQTT 协议端口 | 需启用 mqtt 插件 |
防火墙配置：生产环境需要根据实际使用的协议开放相应端口。
十、卸载 RabbitMQ
如需卸载 RabbitMQ，请按以下顺序操作：
总结
本文详细介绍了在 Windows 系统上安装 RabbitMQ 的完整流程，包括：
- Erlang 环境的下载、安装和环境变量配置
- RabbitMQ 服务器的安装和验证
- Web 管理界面的启用和访问
- 用户权限的配置
- 常见问题的排查方法
在整个安装过程中，请务必注意以下几点：
完成安装后，你可以通过 Web 管理界面（http://localhost:15672）方便地管理队列、交换机、用户和权限，为后续在分布式系统中使用消息队列功能打下坚实基础。
下一步建议学习 RabbitMQ 的核心概念（Exchange、Queue、Binding、Routing Key）以及与 Spring Boot 等框架的集成使用。
参考资料：
- RabbitMQ 官方文档：https://www.rabbitmq.com/docs
- Erlang 官方下载页面：https://www.erlang.org/downloads
- RabbitMQ 版本兼容性矩阵：https://www.rabbitmq.com/docs/which-erlang
