RabbitMQ 是一个开源的消息队列系统,广泛用于构建分布式和异步应用。它实现了高级消息队列协议(AMQP),并支持多种编程语言,具有高可用性、可扩展性和可靠性。本教程将详细介绍如何部署 RabbitMQ 并通过示例展示其基本使用方法。
一、RabbitMQ 简介
1.1 什么是 RabbitMQ?
RabbitMQ 是基于 Erlang 编写的开源消息中间件,主要用于实现应用程序之间的解耦和异步通信。它可以作为消息代理(Message Broker)或消息队列服务(Message Queue Service)来使用。
1.2 核心概念
- 生产者(Producer):发送消息的应用程序。
- 消费者(Consumer):接收消息的应用程序。
- 队列(Queue):存储消息的缓冲区。
- 交换机(Exchange):决定如何路由消息到队列。
- 绑定(Binding):交换机和队列之间的关系。
- 虚拟主机(Virtual Host):隔离不同的用户环境,类似命名空间。
二、RabbitMQ 安装部署
2.1 系统要求
- 操作系统:Linux(推荐)、macOS 或 Windows
- Erlang 运行时(RabbitMQ 基于 Erlang 开发)
- 可选:Docker(便于快速部署)
2.2 安装方式选择
我们以 Linux(Ubuntu)为例进行安装。
方法一:使用 apt 安装(适用于 Ubuntu/Debian)
# 添加 RabbitMQ 的官方仓库
sudo apt update
sudo apt install curl gnupg -y
curl -fsSL https://github.com/rabbitmq/signing-keys/releases/download/2021/rabbitmq-release-signing-key.asc | sudo gpg --dearmor | sudo tee /usr/share/keyrings/rabbitmq-archive-keyring.gpg > /dev/null
echo "deb [signed-by=/usr/share/keyrings/rabbitmq-archive-keyring.gpg] https://packagecloud.io/rabbitmq/rabbitmq-server/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/rabbitmq.list
# 更新包列表并安装 RabbitMQ
sudo apt update
sudo apt install rabbitmq-server -y
# 启动 RabbitMQ 服务
sudo systemctl enable rabbitmq-server
sudo systemctl start rabbitmq-server
方法二:使用 Docker 安装
docker run -d \
--hostname my-rabbit \
--name some-rabbit \
-p 5672:5672 \
-p 15672:15672 \
rabbitmq:3-management
说明:
5672
:AMQP 协议端口15672
:管理插件 Web UI 端口rabbitmq:3-management
:包含管理插件的镜像
三、启用管理插件
rabbitmq-plugins enable rabbitmq_management
访问管理界面:
http://<your-server-ip>:15672/
默认用户名和密码为:
- 用户名:guest
- 密码:guest
注意:默认用户只能在本地访问,如需远程访问,请创建新用户。
四、用户和权限管理
4.1 创建用户
rabbitmqctl add_user myuser mypassword
4.2 设置用户角色
rabbitmqctl set_user_tags myuser administrator
4.3 设置权限(例如给虚拟主机 /
赋予权限)
rabbitmqctl set_permissions -p / myuser ".*" ".*" ".*"
五、基本使用示例(Python)
我们将使用 Python 和 pika
库演示 RabbitMQ 的基本使用。
5.1 安装 pika
pip install pika
5.2 发送消息(生产者)
import pika
# 连接 RabbitMQ 服务器
connection = pika.BlockingConnection(pika.ConnectionParameters('localhost'))
channel = connection.channel()
# 声明一个队列(如果不存在则创建)
channel.queue_declare(queue='hello')
# 发送消息
channel.basic_publish(
exchange='',
routing_key='hello',
body='Hello World!'
)
print(" [x] Sent 'Hello World!'")
# 关闭连接
connection.close()
5.3 接收消息(消费者)
import pika
def callback(ch, method, properties, body):
print(f" [x] Received {body}")
# 连接 RabbitMQ 服务器
connection = pika.BlockingConnection(pika.ConnectionParameters('localhost'))
channel = connection.channel()
# 声明队列
channel.queue_declare(queue='hello')
# 注册回调函数并消费消息
channel.basic_consume(
queue='hello',
on_message_callback=callback,
auto_ack=True
)
print(' [*] Waiting for messages. To exit press CTRL+C')
channel.start_consuming()
六、常见交换机类型及使用
6.1 Direct Exchange(直连交换机)
根据 routing_key
完全匹配路由。
channel.exchange_declare(exchange='direct_logs', exchange_type='direct')
severity = 'error'
channel.basic_publish(
exchange='direct_logs',
routing_key=severity,
body=message
)
6.2 Fanout Exchange(广播交换机)
将消息发送给所有绑定的队列。
channel.exchange_declare(exchange='logs', exchange_type='fanout')
channel.basic_publish(
exchange='logs',
routing_key='',
body=message
)
6.3 Topic Exchange(主题交换机)
根据通配符匹配 routing_key
。
channel.exchange_declare(exchange='topic_logs', exchange_type='topic')
routing_key = 'kern.critical'
channel.basic_publish(
exchange='topic_logs',
routing_key=routing_key,
body=message
)
七、高可用部署(集群模式)
7.1 准备多台服务器
假设我们有三台服务器:
- node1: 192.168.1.10
- node2: 192.168.1.11
- node3: 192.168.1.12
确保每台服务器上 RabbitMQ 已启动,并配置相同的 Erlang Cookie(位于 /var/lib/rabbitmq/.erlang.cookie
)。
7.2 加入集群
在 node2 上执行:
rabbitmqctl stop_app
rabbitmqctl join_cluster rabbit@node1
rabbitmqctl start_app
在 node3 上执行:
rabbitmqctl stop_app
rabbitmqctl join_cluster rabbit@node1
rabbitmqctl start_app
7.3 设置镜像队列(提高可用性)
rabbitmqctl set_policy ha-all "^ha\." '{"ha-mode":"all"}'
八、监控与维护
8.1 使用管理界面
访问 http://<ip>:15672
查看队列、连接、节点状态等信息。
8.2 使用命令行工具
rabbitmqctl list_queues # 查看队列
rabbitmqctl list_exchanges # 查看交换机
rabbitmqctl list_bindings # 查看绑定关系
rabbitmqctl cluster_status # 查看集群状态
九、总结
RabbitMQ 是一个功能强大且灵活的消息中间件,适合用于构建高性能、高可靠性的异步通信系统。通过本文,你已经掌握了 RabbitMQ 的基本部署、用户管理、消息发送与消费、常见交换机类型以及集群部署等核心内容。
如果你喜欢这篇博客,请点赞、收藏并分享!如有问题欢迎留言交流。