Windows 系统安装 RabbitMQ 完整指南

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

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

2.4 验证 Erlang 安装

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

输入以下命令：

erl -version

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

三、下载 RabbitMQ

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

四、安装 RabbitMQ

4.1 运行安装程序

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

4.2 安装过程

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

4.3 安装完成

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

4.4 配置 RabbitMQ 环境变量

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

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

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

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

4.5 验证 RabbitMQ 安装

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

输入以下命令：

rabbitmq-plugins

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

五、验证服务状态

5.1 检查 Windows 服务

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

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

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

1. 打开浏览器，访问：http://localhost:15672
2. 默认用户名和密码均为：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 使用新用户登录

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

八、常见问题排查

8.1 Erlang 环境未正确配置

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

解决方法：

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

8.2 RabbitMQ 服务无法启动

可能原因：

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

排查步骤：

1. 查看 Windows 事件查看器中的应用程序日志
2. 检查 RabbitMQ 日志文件位置：%APPDATA%\RabbitMQ\log
3. 确认是否只安装了一个 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 文件位置不匹配

解决方法：

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

九、常用端口说明

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

十、卸载 RabbitMQ

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

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

总结

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

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

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

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