注意点：

> RabbitMQ 对 Erlang 版本有严格兼容性要求（可参考[官方兼容表](https://www.rabbitmq.com/which-erlang.html)）。推荐通过 Erlang Solutions 仓库安装适配版本
>

## Windows安装
### 1. 安装前准备
+ **系统要求**：Windows 7/8/10/11(64位)，推荐Windows 10+ 
+ **必备依赖**：**Erlang**（RabbitMQ基于Erlang开发，版本必须匹配）
+ **下载链接**：
 - Erlang: [https://www.erlang.org/downloads](https://www.erlang.org/downloads)
 - RabbitMQ: [https://www.rabbitmq.com/download.html](https://www.rabbitmq.com/download.html)

### 2. 安装Erlang
1. 下载对应系统的Erlang安装包（如`otp_win64_24.1.7.exe`）
2. 右键以**管理员身份运行**安装程序，一路点击"Next"（建议默认路径）
3. 配置环境变量：
 - 右键"此电脑"→属性→高级系统设置→环境变量
 - 在系统变量中找到"Path"→编辑→新建→添加`C:\Program Files\erl{version}\bin`
4. 验证安装：打开命令提示符(Win+R→`cmd`)，输入`erl -version`，显示版本信息即成功

### 3. 安装RabbitMQ
1. 下载Windows安装包（`.exe`或`.zip`），推荐`.exe`安装方式 
2. 以管理员身份运行安装程序，按提示完成（推荐默认路径）
3. 安装完成后，RabbitMQ会自动注册为Windows服务并启动 
4. **可选**：配置环境变量，将`C:\Program Files\RabbitMQ Server\rabbitmq_server-{版本}\sbin`添加到Path

### 4. 启用管理界面
1. 打开命令提示符（管理员身份），输入：

```plain
rabbitmq-plugins enable rabbitmq_management
```

输出显示"started 3 plugins"表示成功 

2. 重启RabbitMQ服务：

```plain
net stop RabbitMQ
net start RabbitMQ
```

或通过服务管理器（Win+R→`services.msc`）重启 

3. 浏览器访问`http://localhost:15672`，使用默认账号`guest/guest`登录

### 5. 验证安装
+ 通过服务管理器确认RabbitMQ服务状态为"正在运行" 
+ 命令行执行`rabbitmqctl status`查看节点状态 
+ 管理界面查看队列、交换机等组件是否正常

### 常见问题及解决方案
| 问题 | 解决方案 |
| --- | --- |
| **服务启动失败** | 检查Erlang和RabbitMQ版本兼容性，参考官方版本矩阵 |
| **管理界面无法访问** | 检查防火墙是否开放15672端口，重启服务 |
| **命令行找不到erl/rabbitmqctl** | 确认环境变量配置正确，重启命令提示符 |
| **中文路径错误** | 重新安装到纯英文路径（如`C:\Program Files\`） |


## macOS安装
### 1. Homebrew安装方式（推荐）
**步骤1：安装Homebrew**（如已安装，跳过）

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

验证：`brew --version` 

![](https://developer.qcloudimg.com/http-save/yehe-5673264/5a8c759367e9c34260a53efc82cfefe8.png)

**步骤2：安装RabbitMQ**

```bash
brew update # 更新Homebrew
brew install rabbitmq # 自动安装依赖的Erlang
```

安装完成后，RabbitMQ相关命令位于：

+ Intel Mac: `/usr/local/opt/rabbitmq/sbin`
+ Apple Silicon: `/opt/homebrew/opt/rabbitmq/sbin`

**步骤3：启动服务**

```bash
# 后台启动（开机自启）
brew services start rabbitmq

# 临时启动（关闭终端即停止）
rabbitmq-server
```

验证状态：`brew services list` 

**步骤4：启用管理界面**

```bash
rabbitmq-plugins enable rabbitmq_management
```

浏览器访问：`http://localhost:15672`，使用`guest/guest`登录 

![](https://developer.qcloudimg.com/http-save/yehe-5673264/a4888c386febd86ef9f26cc6f10b40d2.png)

### 2. Docker安装方式（轻量不污染系统）
```bash
# 安装Docker Desktop for Mac（官网下载）

# 运行RabbitMQ容器
docker run -d --hostname my-rabbit --name rabbitmq \
 -p 5672:5672 -p 15672:15672 \
 rabbitmq:management
```

访问：`http://localhost:15672` 

### 3. 配置与验证
**添加环境变量**（可选，方便命令行使用）：

```bash
# Intel Mac
echo 'export PATH=$PATH:/usr/local/opt/rabbitmq/sbin' >> ~/.zshrc

# Apple Silicon
echo 'export PATH=$PATH:/opt/homebrew/opt/rabbitmq/sbin' >> ~/.zshrc

source ~/.zshrc # 立即生效
```

**验证安装**：

+ 检查端口：`lsof -i :5672`（有进程监听表示服务运行）
+ 管理界面访问：`http://localhost:15672` 
+ 命令行验证：`rabbitmqctl status`

## Ubuntu安装
### 1. 安装依赖
```bash
#更新 Ubuntu 的包列表，确保依赖库最新
sudo apt update && sudo apt upgrade -y
# 安装 erlang
sudo apt-get install erlang-nox

# 查看relang语言版本，成功执行则说明relang安装成功
erl 
或
erl -version # 输出类似 "Erlang (SMP,ASYNC_THREADS) (BEAM) emulator version X.Y.Z" 即成功

```

**验证Erlang**：`erl -version`（显示版本信息即成功）

### 2. 安装RabbitMQ
```bash
# 添加公钥
wget -O- https://www.rabbitmq.com/rabbitmq-release-signing-key.asc | sudo apt-key add -
# 更新软件包（可选）
sudo apt-get update
# 安装
# 安装成功自动启动
sudo apt-get install rabbitmq-server 

```

**注意**：Ubuntu会自动安装与RabbitMQ兼容的Erlang版本 

### 3. 服务管理与配置
**启动服务**：

```bash
sudo systemctl start rabbitmq-server # 启动服务
sudo systemctl enable rabbitmq-server # 设置开机自启
sudo systemctl status rabbitmq-server # 检查服务状态
```

![](https://developer.qcloudimg.com/http-save/yehe-5673264/ace8a8b533099095200d6a5d71224e0d.png)

**启用管理界面**：

```bash
sudo rabbitmq-plugins enable rabbitmq_management
```

**添加管理员用户**（远程访问必须）：

```bash
sudo rabbitmqctl add_user admin password # 创建用户
sudo rabbitmqctl set_user_tags admin administrator # 设置为管理员角色
sudo rabbitmqctl set_permissions -p / admin ".*" ".*" ".*" # 设置权限
# 查看用户
sudo rabbitmqctl list_users
# 修改用户密码
sudo rabbitmqctl change_password username newpassword
```

**开放防火墙端口**（如启用ufw）：

```bash
sudo ufw allow 5672/tcp # AMQP协议端口
sudo ufw allow 15672/tcp # 管理界面端口
```

### 4. 验证与使用
**访问管理界面**：

+ 本地：`http://localhost:15672`
+ 远程：`http://服务器IP:15672`（使用创建的admin用户登录）

**命令行管理**：

```bash
rabbitmqctl status # 查看服务器状态
rabbitmqctl list_queues # 列出所有队列
```

## Docker安装（跨平台方案）
### 1. 安装Docker
+ **Linux**：`sudo apt install docker.io; sudo systemctl enable docker`
+ **macOS/Windows**：下载Docker Desktop（官网）安装并启动

### 2. 运行RabbitMQ容器（推荐方式）
```bash
# 拉取带管理界面的官方镜像
docker pull rabbitmq:management

# 启动容器（推荐配置）
docker run -d \
 --name rabbitmq \
 --hostname rabbitmq-server \
 -p 5672:5672 \ # AMQP协议端口
 -p 15672:15672 \ # 管理界面端口
 -v /data/rabbitmq/data:/var/lib/rabbitmq \ # 数据持久化
 -v /data/rabbitmq/plugins:/plugins \ # 插件目录
 -e RABBITMQ_DEFAULT_USER=admin \ # 设置默认用户
 -e RABBITMQ_DEFAULT_PASS=password \ # 设置默认密码
 rabbitmq:management
```

### 3. 使用Docker Compose（推荐生产环境）
创建`docker-compose.yml`文件：

```yaml
version: '3'
services:
 rabbitmq:
 image: rabbitmq:management
 container_name: rabbitmq
 ports:
 - "5672:5672"
 - "15672:15672"
 volumes:
 - ./data/rabbitmq/data:/var/lib/rabbitmq
 - ./data/rabbitmq/plugins:/plugins
 environment:
 - RABBITMQ_DEFAULT_USER=admin
 - RABBITMQ_DEFAULT_PASS=password
 restart: always # 容器崩溃自动重启
```

启动：`docker-compose up -d` 

### 4. 验证与管理
**访问管理界面**：`http://localhost:15672`，使用设置的用户名密码登录 

**进入容器**：

```bash
docker exec -it rabbitmq /bin/bash # 进入容器命令行
```

**常用Docker命令**：

```bash
docker ps # 查看运行中的容器
docker logs rabbitmq # 查看日志
docker restart rabbitmq # 重启服务
```

## 安装方式对比
| 安装方式 | 优势 | 适用场景 |
| --- | --- | --- |
| **Windows安装** | 图形界面友好，服务管理方便 | Windows开发环境 |
| **macOS Homebrew** | 一键安装依赖，管理便捷 | macOS开发环境 |
| **Ubuntu包管理** | 系统集成度高，适合服务器 | Linux生产环境 |
| **Docker部署** | 跨平台、轻量、隔离性好、便于迁移 | 开发测试、多环境部署、云原生 |


## 总结与下一步
以上介绍了RabbitMQ在四大平台的详细安装步骤。无论选择哪种方式，都需要注意：

1. **版本兼容性**：确保Erlang与RabbitMQ版本匹配（Docker方式可忽略）
2. **管理界面**：生产环境务必创建专用管理员用户，禁用默认guest账号
3. **持久化**：生产环境建议配置数据持久化（Docker挂载卷或本地目录）

下一步建议：

+ 学习RabbitMQ基本概念（交换机、队列、绑定）
+ 尝试使用官方提供的各种客户端（Python/Java/JavaScript等）进行消息收发
+ 了解集群部署方案，提升系统高可用性

_注：本文安装步骤基于2025年11月最新版本，具体细节可能随版本更新略有调整，建议参考RabbitMQ官方文档获取最准确信息。_

RabbitMQ 对 Erlang 版本有严格兼容性要求（可参考官方兼容表）。推荐通过 Erlang Solutions 仓库安装适配版本

【微服务中间件】RabbitMQ 多平台安装搭建实践指南（Windows_macOS_Ubuntu_Docker 全场景）

本文详细介绍RabbitMQ在Windows、macOS、Ubuntu、Docker四大环境的安装、配置与验证流程，各环境均涵盖依赖准备、分步操作、管理界面启用等关键步骤，补充版本兼容、问题排查等实用细节。无论开发人员、运维者还是云原生用户，都能通过对应方案快速搭建环境，步骤兼顾“易操作、高可用”，适配开发测试与生产需求。

先锋会员

后端

运维

架构设计

RabbitMQ安装指南：Windows需先安装兼容的Erlang版本，通过官方安装包配置环境变量；macOS推荐Homebrew一键安装；Ubuntu使用apt安装并配置防火墙；Docker方式适合跨平台部署。所有平台安装后需启用管理插件，创建管理员账号，确保服务正常运行。注意版本兼容性，生产环境建议配置数据持久化。

访问管理

服务器

云原生

防火墙

Windows

容器

Docker

Python

Ubuntu

Erlang

Linux

Java

AI驱动 智领未来

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

【微服务中间件】RabbitMQ 多平台安装搭建实践指南（Windows_macOS_Ubuntu_Docker 全场景）-腾讯云开发者社区-腾讯云

【微服务中间件】RabbitMQ 多平台安装搭建实践指南（Windows_macOS_Ubuntu_Docker 全场景）

【微服务中间件】RabbitMQ 多平台安装搭建实践指南（Windows_macOS_Ubuntu_Docker 全场景）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐