noenv/nats

docker-nats

镜像概述

docker-nats是NATS消息系统的Docker化部署版本。NATS是一个开源、轻量级、高性能的分布式消息系统，专注于简单性和可靠性，适用于构建现代分布式系统中的实时通信层。该镜像提供了便捷的NATS服务器部署方式，支持快速集成到容器化环境中。

核心功能与特性

• 轻量级架构：极小的资源占用，适合边缘设备和资源受限环境
• 高性能：低延迟消息传递，支持高吞吐量场景
• 多通信模式：支持发布/订阅（Pub/Sub）、请求/回复（Request/Reply）、队列订阅（Queue Subscribe）等
• 可扩展性：支持集群模式，轻松实现水平扩展
• 高可用性：支持容错配置，确保消息系统稳定运行
• 简单配置：提供灵活的配置方式，支持命令行参数、配置文件和环境变量

使用场景与适用范围

• 微服务架构中的服务间通信
• 实时数据流处理与分发
• 分布式系统的协调与同步
• 物联网（IoT）设备间的消息传递
• 实时监控与日志收集
• 高并发场景下的异步任务处理

使用方法与配置说明

基本部署（Docker Run）

bash
# 启动基础NATS服务器
docker run -d -p 4222:4222 --name nats-server docker.xuanyuan.run/noenv/nats

自定义配置部署

通过挂载配置文件自定义NATS服务器参数：

bash
# 准备nats.conf配置文件
cat > nats.conf << EOF
port: 4222
http_port: 8222
log_file: "/var/log/nats/nats.log"
EOF

# 启动容器并挂载配置文件
docker run -d -p 4222:4222 -p 8222:8222 \
  -v $(pwd)/nats.conf:/etc/nats/nats.conf \
  -v $(pwd)/logs:/var/log/nats \
  --name nats-server docker.xuanyuan.run/noenv/nats -c /etc/nats/nats.conf

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  nats:
    image: docker.xuanyuan.run/noenv/nats
    container_name: nats-server
    ports:
      - "4222:4222"  # 客户端通信端口
      - "8222:8222"  # 监控端口
    volumes:
      - ./nats.conf:/etc/nats/nats.conf
      - ./logs:/var/log/nats
    command: -c /etc/nats/nats.conf
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

核心配置参数

环境变量配置

集群部署示例

bash
# 节点1
docker run -d -p 4222:4222 -p 6222:6222 --name nats-node1 noenv/nats \
  --cluster nats://0.0.0.0:6222 \
  --routes nats://nats-node2:6222,nats://nats-node3:6222

# 节点2
docker run -d -p 4223:4222 -p 6223:6222 --name nats-node2 noenv/nats \
  --cluster nats://0.0.0.0:6222 \
  --routes nats://nats-node1:6222,nats://nats-node3:6222

# 节点3
docker run -d -p 4224:4222 -p 6224:6222 --name nats-node3 noenv/nats \
  --cluster nats://0.0.0.0:6222 \
  --routes nats://nats-node1:6222,nats://nats-node2:6222