Windows安装RabbitMQ保姆级教程

下面是 Windows 下安装 RabbitMQ 的**保姆级、零翻车教程**，包含：Erlang 安装 → RabbitMQ 安装 → 环境变量 → 启用管理界面 → 开机自启 → 常见报错处理。 --- ## 一、先看版本匹配（必看！） RabbitMQ 依赖 Erlang，**版本必须对应**。 - RabbitMQ 3.12.x → Erlang 25.3+ - RabbitMQ 3.13.x → Erlang 26.0.2+ 官方兼容矩阵：https://www.rabbitmq.com/which-erlang.html 本文以 **RabbitMQ 3.13.7 + Erlang 26.2.5** 为例（2026年稳定版）。 --- ## 二、安装 Erlang（必须第一步） ### 1. 下载 Erlang 官网：https://github.com/rabbitmq/erlang-windows-installer/releases 下载：**otp_win64_26.2.5.exe**（64位） ### 2. 安装（全程管理员） 1. 右键 → **以管理员身份运行** 2. 一路 Next，**安装路径建议默认**：   ```   C:\Program Files\erl-26.2.5   ``` 3. 完成，**不要改路径、不要中文、不要空格**。 ### 3. 配置 Erlang 环境变量 1. 右键“此电脑”→ 属性 → 高级系统设置 → 环境变量 2. 系统变量 → 新建：   - 变量名：`ERLANG_HOME`   - 变量值：`C:\Program Files\erl-26.2.5` 3. 编辑系统变量 **Path** → 新建：   ```   %ERLANG_HOME%\bin   ``` 4. 全部确定。 ### 4. 验证 Erlang **新开一个管理员 CMD**，输入： ```bash erl -version ``` 出现版本号即成功。 --- ## 三、安装 RabbitMQ ### 1. 下载 RabbitMQ 官网：https://www.rabbitmq.com/download.html 下载：**rabbitmq-server-3.13.7.exe**（Windows 64-bit） ### 2. 安装（管理员） 1. 右键 → **以管理员身份运行** 2. 一路 Next，**安装路径建议默认**：   ```   C:\Program Files\RabbitMQ Server\rabbitmq_server-3.13.7   ``` 3. 安装完成后，**自动注册为 Windows 服务并启动**。 ### 3. 配置 RabbitMQ 环境变量 1. 找到 sbin 目录（默认）：   ```   C:\Program Files\RabbitMQ Server\rabbitmq_server-3.13.7\sbin   ``` 2. 系统变量 Path → 新建，把上面路径粘进去。 3. 确定，**重启 CMD**。 ### 4. 验证 RabbitMQ 新开 CMD，输入： ```bash rabbitmq-plugins ``` 出现帮助信息即成功。 --- ## 四、启用 Web 管理界面（必做） ### 1. 启用插件（管理员 CMD） ```bash rabbitmq-plugins enable rabbitmq_management ``` 输出类似 `Plugin configuration unchanged` 即可。 ### 2. 重启 RabbitMQ 服务 ```bash net stop RabbitMQ net start RabbitMQ ``` ### 3. 访问管理界面 浏览器打开： ``` http://localhost:15672 ``` 默认账号密码：**guest / guest** （只能本地访问，后面教你创建远程管理员账号） --- ## 五、创建远程管理员账号（生产必做） guest 只能本地登录，**新建 admin 用户**： ```bash # 1. 创建用户 rabbitmqctl add_user admin 123456 # 2. 设为管理员 rabbitmqctl set_user_tags admin administrator # 3. 授权所有权限 rabbitmqctl set_permissions -p / admin ".*" ".*" ".*" ``` 现在可用 **admin/123456** 远程登录。 --- ## 六、开机自启（默认已配置） 1. Win+R → 输入 `services.msc` 2. 找到 **RabbitMQ** → 右键 → 属性 3. 启动类型：**自动** → 确定。 --- ## 七、常用命令（直接复制） ```bash # 启动/停止/重启 net start RabbitMQ net stop RabbitMQ rabbitmqctl restart # 查看状态 rabbitmqctl status # 查看用户 rabbitmqctl list_users # 查看队列 rabbitmqctl list_queues ``` --- ## 八、常见报错&解决（90%人踩坑） ### 1. 启动报错：**Unable to start Erlang** - 原因：Erlang 未安装、未配置环境变量、版本不匹配 - 解决：重装 Erlang → 配置 ERLANG_HOME → 重启电脑 ### 2. 服务启动但 **15672 打不开** - 原因：管理插件未启用、防火墙拦截 - 解决：  ```bash  rabbitmq-plugins enable rabbitmq_management  net stop RabbitMQ && net start RabbitMQ  ```  关闭防火墙或放行 15672、5672 端口。 ### 3. **guest 账号远程登录失败** - 原因：guest 仅限本地 - 解决：按第五节创建 admin 用户。 --- ## 九、安装成功检查清单 1. Erlang：`erl -version` 有版本号 2. RabbitMQ 服务：services.msc 中状态为“正在运行” 3. 管理界面：http://localhost:15672 可登录 4. 环境变量：Path 包含 Erlang bin 和 RabbitMQ sbin