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 服务器

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

自定义客户端端口

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

启用 JetStream（流处理）

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

持久化 JetStream 数据

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

部署 NATS 集群

bash
# 启动第一个节点
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，内容如下：

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

# HTTP 监控端口
monitor_port: 8222

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

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

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

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