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
