NATS (arm32v7) 镜像文档

1. 镜像概述

1.1 概述

arm32v7/nats 镜像是 NATS 消息系统服务器的官方 arm32v7 架构构建版本。NATS 是一个高性能、轻量级的云原生消息系统，旨在为分布式系统提供低延迟、高吞吐量的通信能力。该镜像基于官方 nats 镜像构建，专门针对 32 位 ARM 架构设备（如树莓派等嵌入式系统）优化。

1.2 主要用途

• 作为 NATS 消息系统的服务端运行载体，提供消息发布/订阅、请求/响应、队列订阅等核心通信模式。
• 支持构建分布式集群，实现消息路由与数据复制。
• 集成 JetStream 功能，提供持久化消息、流处理和消息回溯能力。

2. 核心功能与特性

2.1 核心功能

• 高性能消息传递：低延迟、高吞吐量，支持每秒数百万条消息处理。
• 多通信模式：支持发布/订阅（Pub/Sub）、请求/响应（Request/Reply）、队列订阅（Queue Groups）。
• 集群支持：通过路由端口实现多节点集群部署，提供高可用性和水平扩展。
• JetStream 功能：启用后支持消息持久化、流存储、消费者组、消息重放等高级特性。
• 轻量级设计：镜像体积小，资源占用低，适合边缘设备和嵌入式环境。

2.2 关键特性

• 原生多端口设计：4222（客户端通信）、8222（HTTP 管理）、6222（集群路由）。
• 灵活配置：支持命令行参数、配置文件两种配置方式，参数可动态覆盖。
• 安全认证：支持用户密码、令牌、TLS 加密等多种认证机制。
• 跨平台兼容：针对 arm32v7 架构优化，兼容树莓派等嵌入式设备。

3. 使用场景

3.1 适用范围

• 微服务通信：作为微服务架构中的消息总线，实现服务间松耦合通信。
• 实时数据流：物联网（IoT）设备数据采集、实时监控告警、日志聚合。
• 分布式系统协调：服务发现、配置同步、分布式锁。
• 边缘计算：在资源受限的边缘设备（如 arm32v7 架构嵌入式设备）中部署轻量级消息节点。

4. 支持的标签与 Dockerfile 链接

4.1 简单标签（Simple Tags）

• 2.12.1-alpine3.22, 2.12-alpine3.22, 2-alpine3.22, alpine3.22, 2.12.1-alpine, 2.12-alpine, 2-alpine, alpine
  Dockerfile

• 2.12.1-scratch, 2.12-scratch, 2-scratch, scratch, 2.12.1-linux, 2.12-linux, 2-linux, linux
  Dockerfile

• 2.11.10-alpine3.22, 2.11-alpine3.22, 2.11.10-alpine, 2.11-alpine
  Dockerfile

• 2.11.10-scratch, 2.11-scratch, 2.11.10-linux, 2.11-linux
  Dockerfile

• 2.10.29-alpine3.22, 2.10-alpine3.22, 2.10.29-alpine, 2.10-alpine
  Dockerfile

• 2.10.29-scratch, 2.10-scratch, 2.10.29-linux, 2.10-linux
  Dockerfile

4.2 共享标签（Shared Tags）

• 2.12.1, 2.12, 2, latest
  对应镜像：2.12.1-scratch
  Dockerfile

• 2.11.10, 2.11
  对应镜像：2.11.10-scratch
  Dockerfile

• 2.10.29, 2.10
  对应镜像：2.10.29-scratch
  Dockerfile

5. 使用方法与配置说明

5.1 基本使用

通过 docker run 命令启动 NATS 服务器，默认暴露 3 个端口：

• 4222：客户端通信端口
• 8222：HTTP 管理端口（信息查询）
• 6222：集群路由端口

示例：启动基础 NATS 服务

docker run -d --name nats-server \
  -p 4222:4222 \  # 客户端端口
  -p 8222:8222 \  # 管理端口
  -p 6222:6222 \  # 路由端口
  arm32v7/nats

自定义客户端端口
若需修改 NATS 服务监听的客户端端口（如 4444），需同时调整容器端口映射：

docker run -d --name nats-custom-port \
  -p 5555:4444 \  # 宿主机5555端口映射到容器4444端口
  arm32v7/nats -p 4444  # NATS服务监听容器内4444端口

5.2 集群部署

NATS 支持多节点集群，通过路由端口实现节点间通信。以下示例部署两个节点组成集群：

启动主节点

docker run -d --name nats-main \
  -p 4222:4222 -p 6222:6222 -p 8222:8222 \
  arm32v7/nats

启动从节点并加入集群
通过 --routes 参数指定主节点路由地址（默认路由用户 ruser，密码 T0pS3cr3t）：

docker run -d --name nats-replica \
  -p 4223:4222 -p 6223:6222 -p 8223:8222 \
  --link nats-main \  # 链接主节点容器
  arm32v7/nats -c /etc/nats/nats-server.conf \
  --routes=nats-route://ruser:T0pS3cr3t@nats-main:6222

验证集群状态：访问从节点管理端口 http://localhost:8223/routez，查看路由连接信息。

5.3 启用 JetStream

JetStream 提供消息持久化和流处理能力，需通过 -js 标志启用，建议配合数据卷持久化数据：

docker run -d --name nats-jetstream \
  -p 4222:4222 \
  -v nats-data:/data \  # 数据卷挂载（需提前创建：docker volume create nats-data）
  arm32v7/nats -js -sd /data  # -sd 指定数据存储目录（容器内路径）

5.4 配置文件

NATS 支持通过配置文件定义服务参数，容器默认配置文件路径为 /etc/nats/nats-server.conf，内容如下：

# 客户端端口（默认4222）
port: 4222

# HTTP管理端口
monitor_port: 8222

# 集群配置
cluster {
  name: "my_cluster"  # 集群名称
  port: 6222          # 路由端口
  authorization {
    user: ruser       # 路由认证用户
    password: T0pS3cr3t  # 路由认证密码
    timeout: 2        # 认证超时（秒）
  }
  routes = []  # 初始路由列表（动态添加通过--routes参数）
}

使用自定义配置文件
通过 -v 挂载本地配置文件替换默认配置：

docker run -d --name nats-custom-config \
  -v ./my-nats.conf:/etc/nats/nats-server.conf \  # 挂载本地配置文件
  arm32v7/nats -c /etc/nats/nats-server.conf

5.5 命令行参数

NATS 服务支持通过命令行参数覆盖配置文件，常用参数如下：

6. 镜像变体

arm32v7/nats 提供多种标签变体，适配不同场景需求：

6.1 arm32v7/nats:<version>（默认变体）

基于 scratch 基础镜像（空镜像）构建，仅包含 NATS 二进制文件，体积最小（约10-20MB），适合生产环境。

6.2 arm32v7/nats:<version>-alpine

基于 alpine 基础镜像构建，包含 Alpine Linux 系统工具（如sh、ls），体积较小（约15-30MB），适合需要基础系统工具的调试场景。

7. 许可证信息

• 软件许可证：NATS 服务器遵循 Apache License 2.0。
• 镜像依赖：基础镜像（如 alpine）可能包含其他开源软件，其许可证信息可参考 Docker 官方镜像文档。

镜像使用需遵守所有包含软件的许可证条款。

维护者：NATS Project
问题反馈：nats-docker GitHub Issues
支持架构：amd64, arm32v6, arm32v7, arm64v8, ppc64le, s390x, windows-amd64