安装与连接

启动 RabbitMQ,安装 Node.js 客户端,并验证连接。

🎯 引言

启动 RabbitMQ,安装 Node.js 客户端,并验证连接。


🧱 服务端与客户端

RabbitMQ 服务端接收和保存消息,需要持续运行;客户端库让业务程序连接服务端。本课程使用 Docker 启动服务,用 amqplib 编写 Node.js 程序。

Docker 用容器运行服务,容器可以理解为独立的程序运行环境。先安装并启动 Docker,基础操作可参照 Docker 课程。本课程固定使用 Node.js 22.9.0、RabbitMQ 4.1.4-management、amqplib 0.10.8,作为可复现的练习组合,不表示最新版本。


🛠 启动服务端

docker run -d --name rabbitmq-course --hostname rabbitmq-course \
    -p 127.0.0.1:5672:5672 \
    -p 127.0.0.1:15672:15672 \
    -e RABBITMQ_DEFAULT_USER=learner \
    -e RABBITMQ_DEFAULT_PASS=learn-local-only \
    -v rabbitmq-course-data:/var/lib/rabbitmq \
    rabbitmq:4.1.4-management

5672 供程序连接,15672 供浏览器打开管理页面;绑定 127.0.0.1 表示只供本机访问。management 镜像包含管理界面。账号用于本地练习,数据卷 rabbitmq-course-data 保存容器的数据,后面用来验证重启。

同名容器已存在时,用 docker start rabbitmq-course 启动,不重复创建。检查就绪状态:

docker exec rabbitmq-course rabbitmq-diagnostics -q ping

出现 Ping succeeded 后继续。刚启动检查失败时,等待几秒再试。


📦 准备练习目录

下面安装使用 Node.js 22.9.0、amqplib 0.10.8:

mkdir rabbitmq-payment
cd rabbitmq-payment
npm init -y
npm install --save-exact amqplib@0.10.8

后续所有文件放在这个目录,终端也在这里执行。也可以下载完整示例包,解压后在其中执行相同安装命令。

创建连接配置,后续文件共同引用:

config.mjs
export const rabbitmqUrl = process.env.RABBITMQ_URL ?? 'amqp://learner:learn-local-only@localhost:5672';

amqp:// 指定客户端使用的消息通信协议,后面依次是账号、密码、地址和端口。AMQP 是程序与 RabbitMQ 交换消息的通信约定,本课程客户端使用 AMQP 0-9-1。环境变量 RABBITMQ_URL 可覆盖默认地址。

创建检查入口:

check.mjs
import amqp from 'amqplib';
import { rabbitmqUrl } from './config.mjs';

const connection = await amqp.connect(rabbitmqUrl);
console.log('连接成功');
await connection.close();

运行:

node check.mjs

出现“连接成功”后程序退出。连接是程序与 RabbitMQ 之间的网络会话,用完后关闭;持续接收消息的程序则需要保持连接。


❓ 知识问答

Q1:连接失败先检查什么?

先运行服务健康检查,再核对地址、5672 端口与账号。15672 是管理页面端口,不能用于此连接。

Q2:为什么修改账号环境变量后登录仍失败?

默认账号在空数据目录首次启动时创建,已有数据卷不会因此重建账号。使用原账号或在管理端修改用户。

Q3:后续每篇都要安装吗?

不需要,所有章节共用这个练习目录和客户端依赖。


🧪 小练习

执行 docker stop rabbitmq-course 后运行检查程序,观察连接失败;再启动容器,健康检查通过后验证连接恢复。


🎉 服务端与客户端已经连接,可以开始传递消息了!