rabitmq windows 安装

老刘

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

  1. 双击下载好的 Erlang 安装包(文件名类似 otp_win64_26.2.5.exe)。
  2. 一路点 Next,安装路径建议保持默认(C:\Program Files\Erlang OTP),不要改到中文路径或带空格的奇怪目录。
  3. 安装过程会自动注册环境变量,装完后打开命令提示符(Win + R 输入 cmd)输入:
    erl

    如果弹出 Erlang 的交互界面(显示版本号),说明安装成功。输入 halt(). 然后回车退出。

如果输入 erl 提示“不是内部或外部命令”,说明环境变量没生效。手动添加:

  • 右键“此电脑” → 属性 → 高级系统设置 → 环境变量
  • 在系统变量 Path 里新增 Erlang 的 bin 目录,例如 C:\Program Files\Erlang OTP\bin
  • 确定后重新打开 cmd 再试。

三、第二步:安装 RabbitMQ

  1. 双击 RabbitMQ 的 Windows 安装包(文件名类似 rabbitmq-server-3.13.0.exe)。
  2. 同样建议默认路径安装(C:\Program Files\RabbitMQ Server)。
  3. 安装过程中会提示是否安装服务,勾选“Install RabbitMQ Service”和“Start the service after installation”,方便开机自启。
  4. 安装完成后,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 就行。

五、常见问题与快速排查

  1. 服务启动失败,日志里报 Erlang 版本不对
    解决:卸载当前 Erlang,换成与 RabbitMQ 官方推荐匹配的版本,重新安装。

  2. 端口被占用(默认 5672 是 AMQP 端口,15672 是管理端口)
    解决:用 netstat -ano | findstr 5672 查占用进程,关掉冲突程序,或修改 RabbitMQ 配置文件里的端口。

  3. 命令行提示 rabbitmqctl 找不到
    解决:把 RabbitMQ 的 sbin 目录加到系统 Path,例如 C:\Program Files\RabbitMQ Server\rabbitmq_server-3.13.0\sbin,然后重新打开 cmd。

  4. 管理界面打不开
    先确认插件是否启用成功,再检查防火墙是否拦截了 15672 端口,临时关掉防火墙测试。

  5. 开机不自动启动
    在服务管理里把 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 版本不匹配和环境变量没配好,把这两点处理好,后面基本一帆风顺。安装完成后先用管理界面创建几个测试队列练练手,熟悉交换机、绑定、路由键这些核心概念,后面接真实项目会轻松很多。

文章版权声明:文章内容均来源于各大短视频平台搜集以及修改和删减新增,如有侵权或者违规,请联系站长进行删除,如需转载或复制请以超链接形式并注明出处。

发表评论

快捷回复: 表情:
AddoilApplauseBadlaughBombCoffeeFabulousFacepalmFecesFrownHeyhaInsidiousKeepFightingNoProbPigHeadShockedSinistersmileSlapSocialSweatTolaughWatermelonWittyWowYeahYellowdog
验证码
评论列表 (暂无评论,2人围观)

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

目录[+]