Windows 系统安装 RabbitMQ 完整教程(含 Erlang 依赖与管理插件)
RabbitMQ 是一款开源的消息中间件,基于 AMQP 协议,常用于解耦系统、异步任务处理、流量削峰等场景。很多开发者在本地 Windows 环境做测试或学习时,都需要先把它装起来。下面这套步骤专门针对 Windows 小白和进阶用户整理,从环境准备到服务启动、网页管理界面开启,全部按实际操作顺序写清楚,跟着做就能跑通。
一、安装前必须知道的两件事
RabbitMQ 本身不直接跑在 Windows 上,它依赖 Erlang 运行时。所以安装顺序固定:先装 Erlang,再装 RabbitMQ。版本要对应,否则服务起不来。
推荐组合(稳定且兼容性好):
- Erlang/OTP 26.x 或 25.x(64 位)
- RabbitMQ 3.12.x 或 3.13.x(Windows 安装包)
下载地址去官网找最新稳定版即可。下载时选 Windows 64-bit 安装包(.exe)。
电脑要求:
- 系统:Windows 10 / 11 或 Windows Server 2016 及以上
- 内存建议 4GB 以上(本地测试够用)
- 管理员权限:安装和配置时右键“以管理员身份运行”
二、第一步:安装 Erlang
- 双击下载好的 Erlang 安装包(文件名类似 otp_win64_26.2.5.exe)。
- 一路点 Next,安装路径建议保持默认(C:\Program Files\Erlang OTP),不要改到中文路径或带空格的奇怪目录。
- 安装过程会自动注册环境变量,装完后打开命令提示符(Win + R 输入 cmd)输入:
erl如果弹出 Erlang 的交互界面(显示版本号),说明安装成功。输入
halt().然后回车退出。
如果输入 erl 提示“不是内部或外部命令”,说明环境变量没生效。手动添加:
- 右键“此电脑” → 属性 → 高级系统设置 → 环境变量
- 在系统变量 Path 里新增 Erlang 的 bin 目录,例如
C:\Program Files\Erlang OTP\bin - 确定后重新打开 cmd 再试。
三、第二步:安装 RabbitMQ
- 双击 RabbitMQ 的 Windows 安装包(文件名类似 rabbitmq-server-3.13.0.exe)。
- 同样建议默认路径安装(C:\Program Files\RabbitMQ Server)。
- 安装过程中会提示是否安装服务,勾选“Install RabbitMQ Service”和“Start the service after installation”,方便开机自启。
- 安装完成后,RabbitMQ 会作为 Windows 服务自动启动。
验证服务是否正常:
- 按 Win + R,输入
services.msc打开服务管理。 - 找到 “RabbitMQ” 服务,状态应该是“正在运行”。如果没有,右键启动即可。
也可以用命令行检查: 打开“RabbitMQ Command Prompt (sbin dir)”快捷方式(开始菜单里搜 rabbitmq 能找到),或者直接在管理员 cmd 里进入安装目录的 sbin 文件夹,执行:
rabbitmqctl status
能看到一堆节点信息就说明服务正常。
四、第三步:开启网页管理界面(强烈推荐)
默认安装完后,RabbitMQ 只有命令行,没有可视化界面。开启管理插件后,可以用浏览器看队列、连接、交换机,调试特别方便。
在管理员权限的命令提示符中执行(进入 sbin 目录后):
rabbitmq-plugins enable rabbitmq_management
执行成功会提示插件已启用。然后重启服务让插件生效:
net stop RabbitMQ
net start RabbitMQ
或者在服务管理界面重启。
访问地址:
浏览器打开 http://localhost:15672
默认账号密码都是 guest。登录后就能看到仪表盘。
注意:guest 用户默认只允许本机(localhost)访问。如果要从其他电脑连过来,需要新建用户并授权,或者修改配置文件。本地测试直接用 guest 就行。
五、常见问题与快速排查
-
服务启动失败,日志里报 Erlang 版本不对
解决:卸载当前 Erlang,换成与 RabbitMQ 官方推荐匹配的版本,重新安装。 -
端口被占用(默认 5672 是 AMQP 端口,15672 是管理端口)
解决:用netstat -ano | findstr 5672查占用进程,关掉冲突程序,或修改 RabbitMQ 配置文件里的端口。 -
命令行提示 rabbitmqctl 找不到
解决:把 RabbitMQ 的 sbin 目录加到系统 Path,例如C:\Program Files\RabbitMQ Server\rabbitmq_server-3.13.0\sbin,然后重新打开 cmd。 -
管理界面打不开
先确认插件是否启用成功,再检查防火墙是否拦截了 15672 端口,临时关掉防火墙测试。 -
开机不自动启动
在服务管理里把 RabbitMQ 服务的启动类型改成“自动”。
六、安装后建议做的几件事
- 创建自己的管理员用户(生产环境不要用 guest):
rabbitmqctl add_user myadmin mypassword rabbitmqctl set_user_tags myadmin administrator rabbitmqctl set_permissions -p / myadmin ".*" ".*" ".*" - 本地开发时,建议用客户端库(如 Python 的 pika、Java 的 amqp-client、.NET 的 RabbitMQ.Client)写个简单生产者消费者验证连通性。
- 数据目录默认在用户目录下的 .erlang.cookie 和 AppData 里,如果要迁移或备份,注意这些文件。
- 想更省事可以用 Chocolatey 或 Scoop 包管理器一键装,但手动安装更清楚每一步发生了什么,出问题也好定位。
按上面顺序做完,RabbitMQ 在 Windows 上就已经能正常收发消息了。整个过程最容易踩坑的地方就是 Erlang 版本不匹配和环境变量没配好,把这两点处理好,后面基本一帆风顺。安装完成后先用管理界面创建几个测试队列练练手,熟悉交换机、绑定、路由键这些核心概念,后面接真实项目会轻松很多。

还没有评论,来说两句吧...