Windows 系统安装 RabbitMQ 完整指南

前言

RabbitMQ 是一款基于 Erlang 语言开发的开源消息代理软件，广泛应用于分布式系统中的异步消息传递。它支持多种消息协议（如 AMQP、MQTT、STOMP），提供灵活的路由策略和高可用性设计，是微服务架构中的重要基础设施组件。

在 Windows 环境下安装 RabbitMQ 时，新手往往会遇到 Erlang 版本兼容性、环境变量配置、管理插件启用等一系列问题。本文将手把手带你完成从依赖安装到验证可用的全流程，并解答常见的安装陷阱。

一、准备工作

1.1 系统要求

操作系统：Windows 7/8/10/11（64 位推荐）
内存要求：至少 2GB 可用内存
权限要求：管理员权限（安装过程中必须以管理员身份运行）
依赖组件：64 位 Erlang/OTP 运行环境

1.2 版本兼容性说明

RabbitMQ 对 Erlang 版本有严格要求，版本不匹配会导致服务启动失败。以下是官方最新兼容性矩阵（截至当前）：

RabbitMQ 版本	最低要求 Erlang/OTP	最高支持 Erlang/OTP	备注
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

访问 Erlang 官网：https://www.erlang.org/downloads
点击'Download Windows installer'下载安装包

2.2 安装 Erlang

右键点击下载的安装包，选择**'以管理员身份运行'**
点击'Next'开始安装
选择安装路径（建议使用默认路径：C:\Program Files\erl{version}）
- 重要提示：安装路径只能包含 ASCII 字符，严禁包含空格或中文
点击'Install'开始安装
如果系统提示缺少 Visual C++ 组件，按提示安装即可

2.3 配置 Erlang 环境变量

右键点击'此电脑' → '属性' → '高级系统设置' → '环境变量'
在'系统变量'区域进行以下操作：（1）配置 ERLANG_HOME（2）配置 Path
- 点击'新建'，变量名为 ERLANG_HOME
- 变量值为 Erlang 安装目录，例如：C:\Program Files\erl26.2

找到'Path'变量，点击'编辑'
点击'新建'，添加：%ERLANG_HOME%\bin

点击'确定'保存所有设置

2.4 验证 Erlang 安装

重要：必须关闭之前所有打开的命令提示符窗口，重新打开一个新的 CMD 或 PowerShell 窗口。

输入以下命令：

erl -version

如果显示 Erlang 版本信息（如 Erlang/OTP 26 [erts-14.0.2]），说明安装成功。

三、下载 RabbitMQ

访问 RabbitMQ 官网：https://www.rabbitmq.com/download.html
找到'Windows'部分，点击'Windows Installer'
在跳转的页面中找到'Direct Downloads'区域
点击下载 rabbitmq-server-{version}.exe（建议下载 3.12.x 或 4.0.x 稳定版本）

四、安装 RabbitMQ

4.1 运行安装程序

右键点击下载的 RabbitMQ 安装包，选择**'以管理员身份运行'**。

4.2 安装过程

点击'Next'开始安装向导
选择安装路径（建议使用默认路径：C:\Program Files\RabbitMQ Server）
- 关键点：路径必须使用 ASCII 字符，避免空格和中文字符
点击'Install'开始安装

4.3 安装完成

安装完成后，RabbitMQ 服务会自动启动并注册为 Windows 服务。

4.4 配置 RabbitMQ 环境变量

虽然不是强制要求，但配置环境变量可以方便后续命令行操作。

打开环境变量设置：
- 在'系统变量'中找到'Path'变量，点击'编辑'
- 点击'新建'，添加 sbin 目录路径
保存设置

找到 RabbitMQ 安装路径下的 sbin 目录，例如：

C:\Program Files\RabbitMQ Server\rabbitmq_server-3.12.x\sbin

4.5 验证 RabbitMQ 安装

关闭所有命令提示符窗口，以管理员身份重新打开新的 CMD 窗口。

输入以下命令：

rabbitmq-plugins

如果配置正确，应该显示插件管理的帮助信息。

五、验证服务状态

5.1 检查 Windows 服务

按 Win + R 打开运行对话框
输入 services.msc 并回车
在服务列表中找到'RabbitMQ'服务
确认服务状态为'正在运行'

如果服务未运行，可以右键点击服务 → '启动'

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 访问管理界面

打开浏览器，访问：http://localhost:15672
默认用户名和密码均为：guest / guest

注意：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 使用新用户登录

退出当前 guest 用户会话
使用新创建的 admin 用户登录管理界面

八、常见问题排查

8.1 Erlang 环境未正确配置

错误现象：erlang not found 或服务启动失败

解决方法：

确认 Erlang 已安装：erl -version
检查 ERLANG_HOME 环境变量是否正确
检查 Path 中是否包含 %ERLANG_HOME%\bin
重启命令提示符窗口使环境变量生效
确认 Erlang 版本与 RabbitMQ 版本兼容（参考版本兼容性矩阵）

8.2 RabbitMQ 服务无法启动

可能原因：

Erlang 版本不兼容
安装路径包含非 ASCII 字符
未以管理员权限安装

排查步骤：

查看 Windows 事件查看器中的应用程序日志
检查 RabbitMQ 日志文件位置：%APPDATA%\RabbitMQ\log
确认是否只安装了一个 Erlang 版本（多版本共存会导致冲突）

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 文件位置不匹配

解决方法：

如果使用非管理员账户安装 RabbitMQ，需要手动复制 .erlang.cookie 文件
从 %SystemRoot%\system32\config\systemprofile\.erlang.cookie 复制到 %HOMEDRIVE%%HOMEPATH%\.erlang.cookie
或者以管理员身份重新安装 RabbitMQ

九、常用端口说明

端口	用途	说明
5672	AMQP 通信端口	客户端连接主端口
5671	AMQP over TLS	加密通信端口
15672	Web 管理界面	HTTP API 和 UI
25672	Erlang 分布式通信	集群节点间通信
61613	STOMP 协议端口	需启用 stomp 插件
1883	MQTT 协议端口	需启用 mqtt 插件

防火墙配置：生产环境需要根据实际使用的协议开放相应端口。

十、卸载 RabbitMQ

如需卸载 RabbitMQ，请按以下顺序操作：

停止 RabbitMQ 服务
通过'控制面板' → '程序和功能'卸载 RabbitMQ
删除环境变量中的 RabbitMQ 配置
删除残留数据目录：%APPDATA%\RabbitMQ
（可选）卸载 Erlang

总结

本文详细介绍了在 Windows 系统上安装 RabbitMQ 的完整流程，包括：

Erlang 环境的下载、安装和环境变量配置
RabbitMQ 服务器的安装和验证
Web 管理界面的启用和访问
用户权限的配置
常见问题的排查方法

在整个安装过程中，请务必注意以下几点：

必须以管理员权限运行所有安装程序
严格遵循版本兼容性要求，确保 Erlang 和 RabbitMQ 版本匹配
安装路径避免空格和中文字符，使用纯 ASCII 路径
环境变量配置后要重启命令提示符窗口
生产环境建议创建专用管理用户，不要使用默认的 guest 账户

完成安装后，你可以通过 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

前言

一、准备工作

1.1 系统要求

操作系统：Windows 7/8/10/11（64 位推荐）
内存要求：至少 2GB 可用内存
权限要求：管理员权限（安装过程中必须以管理员身份运行）
依赖组件：64 位 Erlang/OTP 运行环境

1.2 版本兼容性说明

RabbitMQ 对 Erlang 版本有严格要求，版本不匹配会导致服务启动失败。以下是官方最新兼容性矩阵（截至当前）：

RabbitMQ 版本	最低要求 Erlang/OTP	最高支持 Erlang/OTP	备注
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

访问 Erlang 官网：https://www.erlang.org/downloads
点击'Download Windows installer'下载安装包

2.2 安装 Erlang

右键点击下载的安装包，选择**'以管理员身份运行'**
点击'Next'开始安装
选择安装路径（建议使用默认路径：C:\Program Files\erl{version}）
- 重要提示：安装路径只能包含 ASCII 字符，严禁包含空格或中文
点击'Install'开始安装
如果系统提示缺少 Visual C++ 组件，按提示安装即可

2.3 配置 Erlang 环境变量

右键点击'此电脑' → '属性' → '高级系统设置' → '环境变量'
在'系统变量'区域进行以下操作：（1）配置 ERLANG_HOME（2）配置 Path
- 点击'新建'，变量名为 ERLANG_HOME
- 变量值为 Erlang 安装目录，例如：C:\Program Files\erl26.2

找到'Path'变量，点击'编辑'
点击'新建'，添加：%ERLANG_HOME%\bin

点击'确定'保存所有设置

2.4 验证 Erlang 安装

重要：必须关闭之前所有打开的命令提示符窗口，重新打开一个新的 CMD 或 PowerShell 窗口。

输入以下命令：

erl -version

如果显示 Erlang 版本信息（如 Erlang/OTP 26 [erts-14.0.2]），说明安装成功。

三、下载 RabbitMQ

访问 RabbitMQ 官网：https://www.rabbitmq.com/download.html
找到'Windows'部分，点击'Windows Installer'
在跳转的页面中找到'Direct Downloads'区域
点击下载 rabbitmq-server-{version}.exe（建议下载 3.12.x 或 4.0.x 稳定版本）

四、安装 RabbitMQ

4.1 运行安装程序

右键点击下载的 RabbitMQ 安装包，选择**'以管理员身份运行'**。

4.2 安装过程

点击'Next'开始安装向导
选择安装路径（建议使用默认路径：C:\Program Files\RabbitMQ Server）
- 关键点：路径必须使用 ASCII 字符，避免空格和中文字符
点击'Install'开始安装

4.3 安装完成

安装完成后，RabbitMQ 服务会自动启动并注册为 Windows 服务。

4.4 配置 RabbitMQ 环境变量

虽然不是强制要求，但配置环境变量可以方便后续命令行操作。

打开环境变量设置：
- 在'系统变量'中找到'Path'变量，点击'编辑'
- 点击'新建'，添加 sbin 目录路径
保存设置

找到 RabbitMQ 安装路径下的 sbin 目录，例如：

C:\Program Files\RabbitMQ Server\rabbitmq_server-3.12.x\sbin

4.5 验证 RabbitMQ 安装

关闭所有命令提示符窗口，以管理员身份重新打开新的 CMD 窗口。

输入以下命令：

rabbitmq-plugins

如果配置正确，应该显示插件管理的帮助信息。

五、验证服务状态

5.1 检查 Windows 服务

按 Win + R 打开运行对话框
输入 services.msc 并回车
在服务列表中找到'RabbitMQ'服务
确认服务状态为'正在运行'

如果服务未运行，可以右键点击服务 → '启动'

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 访问管理界面

打开浏览器，访问：http://localhost:15672
默认用户名和密码均为：guest / guest

注意：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 使用新用户登录

退出当前 guest 用户会话
使用新创建的 admin 用户登录管理界面

八、常见问题排查

8.1 Erlang 环境未正确配置

错误现象：erlang not found 或服务启动失败

解决方法：

确认 Erlang 已安装：erl -version
检查 ERLANG_HOME 环境变量是否正确
检查 Path 中是否包含 %ERLANG_HOME%\bin
重启命令提示符窗口使环境变量生效
确认 Erlang 版本与 RabbitMQ 版本兼容（参考版本兼容性矩阵）

8.2 RabbitMQ 服务无法启动

可能原因：

Erlang 版本不兼容
安装路径包含非 ASCII 字符
未以管理员权限安装

排查步骤：

查看 Windows 事件查看器中的应用程序日志
检查 RabbitMQ 日志文件位置：%APPDATA%\RabbitMQ\log
确认是否只安装了一个 Erlang 版本（多版本共存会导致冲突）

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 文件位置不匹配

解决方法：

如果使用非管理员账户安装 RabbitMQ，需要手动复制 .erlang.cookie 文件
从 %SystemRoot%\system32\config\systemprofile\.erlang.cookie 复制到 %HOMEDRIVE%%HOMEPATH%\.erlang.cookie
或者以管理员身份重新安装 RabbitMQ

九、常用端口说明

端口	用途	说明
5672	AMQP 通信端口	客户端连接主端口
5671	AMQP over TLS	加密通信端口
15672	Web 管理界面	HTTP API 和 UI
25672	Erlang 分布式通信	集群节点间通信
61613	STOMP 协议端口	需启用 stomp 插件
1883	MQTT 协议端口	需启用 mqtt 插件

防火墙配置：生产环境需要根据实际使用的协议开放相应端口。

十、卸载 RabbitMQ

如需卸载 RabbitMQ，请按以下顺序操作：

停止 RabbitMQ 服务
通过'控制面板' → '程序和功能'卸载 RabbitMQ
删除环境变量中的 RabbitMQ 配置
删除残留数据目录：%APPDATA%\RabbitMQ
（可选）卸载 Erlang

总结

本文详细介绍了在 Windows 系统上安装 RabbitMQ 的完整流程，包括：

Erlang 环境的下载、安装和环境变量配置
RabbitMQ 服务器的安装和验证
Web 管理界面的启用和访问
用户权限的配置
常见问题的排查方法

在整个安装过程中，请务必注意以下几点：

必须以管理员权限运行所有安装程序
严格遵循版本兼容性要求，确保 Erlang 和 RabbitMQ 版本匹配
安装路径避免空格和中文字符，使用纯 ASCII 路径
环境变量配置后要重启命令提示符窗口
生产环境建议创建专用管理用户，不要使用默认的 guest 账户

下一步建议学习 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

Windows 系统安装 RabbitMQ 完整指南

前言

一、准备工作

1.1 系统要求

1.2 版本兼容性说明

二、安装 Erlang

2.1 下载 Erlang

2.2 安装 Erlang

2.3 配置 Erlang 环境变量

2.4 验证 Erlang 安装

三、下载 RabbitMQ

四、安装 RabbitMQ

4.1 运行安装程序

4.2 安装过程

4.3 安装完成

4.4 配置 RabbitMQ 环境变量

4.5 验证 RabbitMQ 安装

五、验证服务状态

5.1 检查 Windows 服务

5.2 使用命令行检查服务

六、启用 Web 管理界面

6.1 启用管理插件

6.2 访问管理界面

6.3 管理界面概览

七、创建管理用户（推荐）

7.1 创建新用户

7.2 使用新用户登录

八、常见问题排查

8.1 Erlang 环境未正确配置

8.2 RabbitMQ 服务无法启动

8.3 管理界面无法访问

8.4 远程访问被拒绝

8.5 命令行工具报错'Authentication failed'

九、常用端口说明

十、卸载 RabbitMQ

总结

Windows 系统安装 RabbitMQ 完整指南

前言

一、准备工作

1.1 系统要求

1.2 版本兼容性说明

二、安装 Erlang

2.1 下载 Erlang

2.2 安装 Erlang

2.3 配置 Erlang 环境变量

2.4 验证 Erlang 安装

三、下载 RabbitMQ

四、安装 RabbitMQ

4.1 运行安装程序

4.2 安装过程

4.3 安装完成

4.4 配置 RabbitMQ 环境变量

4.5 验证 RabbitMQ 安装

五、验证服务状态

5.1 检查 Windows 服务

5.2 使用命令行检查服务

六、启用 Web 管理界面

6.1 启用管理插件

6.2 访问管理界面

6.3 管理界面概览

七、创建管理用户（推荐）

7.1 创建新用户

7.2 使用新用户登录

八、常见问题排查

8.1 Erlang 环境未正确配置

8.2 RabbitMQ 服务无法启动

8.3 管理界面无法访问

8.4 远程访问被拒绝

8.5 命令行工具报错'Authentication failed'

九、常用端口说明

十、卸载 RabbitMQ

总结

更多推荐文章

相关免费在线工具

更多推荐文章

相关免费在线工具