claudiomastrapasqua/docker-nsq

docker-nsq

镜像概述

这是基于NSQ的定制Docker镜像，针对Docker Swarm模式环境优化，可与nsqlookupd组件配合使用，支持nsqd（消息处理 daemon）、nsqadmin（Web管理界面）等功能，便于在分布式集群中部署和管理消息队列。

核心功能

• 消息处理：接收、存储并向客户端分发消息；
• Web管理：通过nsqadmin提供集群管理、监控的Web界面；
• 集群支持：适配Docker Swarm模式，可实现高可用、可扩展的消息队列集群；
• 监控与日志：支持健康检查和日志查看，便于集群状态监控。

使用场景

• Docker Swarm环境下的分布式消息队列需求；
• 微服务架构中服务间的异步通信；
• 需要高吞吐量、低延迟的消息处理场景；
• 分布式系统中的事件驱动架构。

配置说明

获取镜像

通过以下命令拉取镜像：

bash
docker pull claudiomastrapasqua/docker-nsq

基础使用步骤

1. 部署nsqlookupd容器（必需，用于服务发现）：

bash
docker run --name <nsqlookupd_name> -p 4160:4160 -p 4161:4161 nsqio/nsq /nsqlookupd

2. 部署nsqd容器（消息处理 daemon）：

bash
docker run --name <nsqd_name> -p 4150:4150 -p 4151:4151 claudiomastrapasqua/docker-nsq /nsqd --broadcast-address=<name> --lookupd-tcp-address=tasks.<nsqlookup_name>:4160

3. 部署nsqadmin容器（Web管理界面）：

bash
docker run --name <name> -p 4171:4171 claudiomastrapasqua/docker-nsq /nsqadmin --lookupd-http-address=tasks.<nsqlookup_name>:4161

Docker Compose堆栈部署示例（3节点）

要求：Docker Engine 17.12.0+

yaml
version: "3.5"

services:  
  nsqlookup:
    image: nsqio/nsq
    networks:
      - nsq
    command: /nsqlookupd
    configs:
      - source: nsqlookup-healthcheck
        target: /nsqlookup-healthcheck
        mode: 0755
    healthcheck:
        test: ["CMD", "sh", "/nsqlookup-healthcheck"]
        interval: 30s
        timeout: 10s
        retries: 3
    deploy:
      mode: global
      placement:
        constraints:
          - node.role == manager

  nsqd:
    image: claudiomastrapasqua/docker-nsq
    networks:
      - nsq
    environment:
      RESOLVE_BROADCAST_ADDR: 1
    command: /nsqd --broadcast-address=nsqd --lookupd-tcp-address=tasks.nsqlookup:4160
    deploy:
      replicas: 3
      endpoint_mode: dnsrr
      placement:
        constraints:
          - node.role == worker
    depends_on:
      - nsqlookup

  nsqadmin:
    image: claudiomastrapasqua/docker-nsq
    hostname: nsqadmin
    ports:
      - "4171:4171"
    networks:
      - nsq
      - proxy
    environment:
      SWARM_CONTROLLER: 1
      NSQLOOKUP_SERVICE_NAME: "${STACK_NAME:-nsqtest}_nsqlookup"
      NSQ_SERVICE_NAME: "${STACK_NAME:-nsqtest}_nsqd"
    command: /nsqadmin --lookupd-http-address=tasks.nsqlookup:4161
    deploy:
      replicas: 1
      placement:
        constraints:
          - node.role == worker
    depends_on:
      - nsqlookup

configs:
  nsqlookup-healthcheck:
    file: "${STACK_HOME:-.}/scripts/nsqlookup-healthcheck.sh"

networks:
  nsq:
    attachable: true
  proxy:
    external: true

监控与日志

• 监控：通过nsqadmin访问http://<docker_host>:4171查看集群状态；
• 日志：查看容器日志：docker logs -f <container_name_or_id>；查看服务日志：docker service logs -f <service_name_or_id>。

支持

若有问题，请在https://github.com/kladiv/docker-nsq/issues%E6%8F%90%E4%BA%A4issue%E3%80%82