nsqio/nsq

NSQ Docker镜像文档

镜像概述

NSQ是一个实时分布式消息平台，设计用于大规模运行，能够处理每天数十亿消息。本镜像为NSQ的官方Docker镜像，提供便捷部署方式，支持分布式和去中心化拓扑结构，无单点故障，确保系统容错性、高可用性及可靠消息传递。

核心功能与特性

• 分布式架构：采用去中心化设计，无单点故障，支持节点动态扩展
• 高吞吐量：专为大规模消息处理优化，可支撑每天数十亿消息流量
• 可靠消息传递：提供消息持久化和重传机制，确保消息可靠投递
• 容错与高可用：节点故障自动恢复，保障服务持续可用
• 实时处理：低延迟消息传递，满足实时数据处理需求

使用场景

• 分布式系统中的跨服务消息通信
• 实时日志收集与处理
• 高并发场景下的任务队列
• 微服务架构中的事件驱动通信
• 需要高可靠性和可扩展性的消息中间件应用

使用方法与配置说明

基本组件启动

1. 启动nsqlookupd（服务发现节点）

bash
docker run -d --name nsqlookupd -p 4160:4160 -p 4161:4161 docker.xuanyuan.run/nsqio/nsq /nsqlookupd

• 4160端口：TCP协议，供nsqd节点连接
• 4161端口：HTTP协议，提供查询和管理接口

2. 启动nsqd（消息队列节点）

bash
docker run -d --name nsqd -p 4150:4150 -p 4151:4151 docker.xuanyuan.run/nsqio/nsq /nsqd \
  --lookupd-tcp-address=<nsqlookupd-ip>:4160 \
  --broadcast-address=<当前主机IP>

• 替换<nsqlookupd-ip>为nsqlookupd容器的IP或主机地址
• 替换<当前主机IP>为当前主机可被其他节点访问的IP
• 4150端口：TCP协议，供生产者和消费者连接
• 4151端口：HTTP协议，提供消息发布和管理接口

3. 启动nsqadmin（管理界面）

bash
docker run -d --name nsqadmin -p 4171:4171 docker.xuanyuan.run/nsqio/nsq /nsqadmin \
  --lookupd-http-address=<nsqlookupd-ip>:4161

• 访问http://<主机IP>:4171即可打开管理界面

配置参数

各组件支持通过命令行参数或环境变量进行配置，常用参数包括：

• --lookupd-tcp-address：nsqlookupd的TCP地址（nsqd使用）
• --lookupd-http-address：nsqlookupd的HTTP地址（nsqadmin使用）
• --broadcast-address：节点广播地址（供其他节点发现）
• --max-message-size：最大消息大小（默认5MB）
• --data-path：消息持久化存储路径

相关资源

• 源代码：https://github.com/nsqio/nsq
• 问题反馈：https://github.com/nsqio/nsq/issues
• 邮件列表：https://groups.google.com/d/forum/nsq-users
• IRC：#nsq on freenode
• 官方文档：[***]
• Docker部署文档：NSQ Docker文档
• *******：@nsqio