arm64v8/nats 镜像文档

镜像概述和主要用途

arm64v8/nats 是 NATS 消息系统服务器的 Docker 镜像，专为 arm64v8 架构优化。NATS 是一个开源、高性能的云原生消息系统，旨在提供简单、 secure 和可扩展的异步通信能力。该镜像包含 NATS 服务器二进制文件，支持多种部署模式，适用于构建微服务架构、实时数据传输和分布式系统。

核心功能和特性

• 高性能低延迟：优化的消息路由机制，支持高吞吐量和低延迟通信。
• JetStream 支持：内置流处理引擎，提供消息持久化、重播和消费者组功能。
• 集群能力：通过路由端口（6222）支持多服务器集群部署，实现高可用和负载均衡。
• HTTP 监控：内置 HTTP 管理端口（8222），提供服务器状态和指标查询。
• 轻量级设计：基于 Alpine 或 scratch 基础镜像，镜像体积小，资源占用低。
• 灵活配置：支持命令行参数和配置文件自定义，满足不同场景需求。

使用场景和适用范围

• 微服务通信：作为微服务架构中的消息代理，实现服务间解耦和异步通信。
• 实时数据传输：适用于物联网（IoT）、实时分析等需要低延迟数据流转的场景。
• 分布式系统协调：支持集群模式，用于构建高可用的分布式系统。
• 流数据处理：通过 JetStream 功能处理持久化流数据，支持消息重播和事件溯源。
• 边缘计算：轻量级特性使其适合资源受限的边缘设备部署（arm64v8 架构优化）。

快速参考

维护者

NATS Project

获取帮助

• Docker 社区 Slack
• Server Fault
• Unix & Linux Stack Exchange
• Stack Overflow

支持的标签及对应 Dockerfile 链接

简单标签（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
• 2.12.1-scratch, 2.12-scratch, 2-scratch, scratch, 2.12.1-linux, 2.12-linux, 2-linux, linux
• 2.11.10-alpine3.22, 2.11-alpine3.22, 2.11.10-alpine, 2.11-alpine
• 2.11.10-scratch, 2.11-scratch, 2.11.10-linux, 2.11-linux
• 2.10.29-alpine3.22, 2.10-alpine3.22, 2.10.29-alpine, 2.10-alpine
• 2.10.29-scratch, 2.10-scratch, 2.10.29-linux, 2.10-linux

共享标签（Shared Tags）

• 2.12.1, 2.12, 2, latest：基于 2.12.1-scratch
• 2.11.10, 2.11：基于 2.11.10-scratch
• 2.10.29, 2.10：基于 2.10.29-scratch

使用方法和配置说明

基本使用示例

启动单节点 NATS 服务器

# 启动 NATS 服务器并映射默认端口
# 4222: 客户端连接端口
# 8222: HTTP 监控端口
# 6222: 集群路由端口
docker run -d --name nats-main \
  -p 4222:4222 \
  -p 6222:6222 \
  -p 8222:8222 \
  arm64v8/nats

自定义客户端端口

# 将容器内 4444 端口映射到主机 5555 端口
docker run -p 5555:4444 arm64v8/nats -p 4444

启用 JetStream（流处理）

# 启用 JetStream 功能
docker run -d --name nats-js \
  -p 4222:4222 \
  arm64v8/nats -js

持久化 JetStream 数据

# 使用 Docker 卷持久化 JetStream 数据
docker run -d --name nats-js-persistent \
  -p 4222:4222 \
  -v nats-data:/data \
  arm64v8/nats -js -sd /data

部署 NATS 集群

# 启动第一个节点
docker run -d --name nats-1 \
  -p 4222:4222 -p 6222:6222 -p 8222:8222 \
  arm64v8/nats -c /etc/nats/nats-server.conf

# 启动第二个节点并加入集群（通过 --link 连接到第一个节点）
docker run -d --name nats-2 \
  -p 4223:4222 -p 6223:6222 -p 8223:8222 \
  --link nats-1 \
  arm64v8/nats -c /etc/nats/nats-server.conf \
  --routes=nats-route://ruser:T0pS3cr3t@nats-1:6222

默认配置文件

容器内默认配置文件路径为 /etc/nats/nats-server.conf，内容如下：

# 客户端端口（所有接口）
port: 4222

# HTTP 监控端口
monitor_port: 8222

# 集群配置
cluster {
  # 集群名称
  name: "my_cluster"

  # 路由端口（所有接口）
  port: 6222

  # 路由认证
  authorization {
    user: ruser
    password: T0pS3cr3t
    timeout: 2
  }

  # 路由列表（默认空，需通过命令行 --routes 参数指定）
  routes = []
}

命令行选项

NATS 服务器支持以下核心命令行参数（完整列表可通过 docker run arm64v8/nats -h 查看）：

服务器基本选项

• -a, --addr <host>: 绑定主机地址（默认：0.0.0.0）
• -p, --port <port>: 客户端端口（默认：4222）
• -m, --http_port <port>: HTTP 监控端口（默认：8222）
• -c, --config <file>: 指定配置文件路径
• -n, --name <name>: 服务器名称（默认自动生成）

JetStream 选项

• -js, --jetstream: 启用 JetStream 功能
• -sd, --store_dir <dir>: JetStream 数据存储目录

集群选项

• --routes <rurl>: 集群路由地址（格式：nats-route://user:pass@host:port）
• --cluster_name <name>: 集群名称（默认：my_cluster）

安全选项

• --user <user>: 客户端连接用户名
• --pass <password>: 客户端连接密码
• --auth <token>: 客户端连接令牌

镜像变体说明

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

基于 scratch 基础镜像构建，仅包含 NATS 服务器二进制文件，体积最小（~10MB），适合生产环境。默认标签（如 latest、2.12）均为此变体。

arm64v8/nats:<version>-alpine

基于 Alpine Linux 构建，包含基础系统工具，体积较小（~15MB），适合需要基础依赖（如 sh）的场景。

许可证信息

镜像中 NATS 服务器的许可协议参见 NATS 项目许可证。
Docker 镜像可能包含其他软件（如基础镜像组件），其许可协议需参考对应上游项目。