winamd64/nats

NATS Docker镜像（windows-amd64）技术文档

镜像概述

主要用途

NATS是一个开源、高性能的云原生消息系统。本Docker镜像是NATS服务器（nats-server）的容器化版本，专为windows-amd64架构构建，提供轻量级、可移植的消息传递服务部署方案。

核心功能与特性

• 高性能：专为云原生环境优化，低延迟、高吞吐量的消息传递能力。
• 多端口支持：
  • 4222：客户端连接端口，用于消息发布/订阅。
  • 8222：HTTP管理端口，提供服务器状态与监控信息。
  • 6222：集群路由端口，支持多服务器组建集群。
• JetStream支持：内置流处理引擎，提供持久化消息存储、消息重放、消费者组等高级功能。
• 集群能力：支持通过路由协议组建分布式集群，提升可用性与扩展性。
• 灵活配置：支持命令行参数、配置文件两种配置方式，适配不同场景需求。
• 轻量级：基于Windows Server Core或Nano Server基础镜像，镜像体积小，资源占用低。

支持的标签

Simple Tags

• https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.12.x/windowsservercore-ltsc2022/Dockerfile
• https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.12.x/nanoserver-ltsc2022/Dockerfile
• https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.11.x/windowsservercore-ltsc2022/Dockerfile
• https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.11.x/nanoserver-ltsc2022/Dockerfile
• https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.10.x/windowsservercore-ltsc2022/Dockerfile
• https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.10.x/nanoserver-ltsc2022/Dockerfile

Shared Tags

• 2.12.1, 2.12, 2, latest：
  • 对应镜像：https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.12.x/nanoserver-ltsc2022/Dockerfile
• 2.12.1-windowsservercore, 2.12-windowsservercore, 2-windowsservercore, windowsservercore：
  • 对应镜像：https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.12.x/windowsservercore-ltsc2022/Dockerfile
• 2.12.1-nanoserver, 2.12-nanoserver, 2-nanoserver, nanoserver：
  • 对应镜像：https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.12.x/nanoserver-ltsc2022/Dockerfile
• 2.11.10, 2.11：
  • 对应镜像：https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.11.x/nanoserver-ltsc2022/Dockerfile
• 2.11.10-windowsservercore, 2.11-windowsservercore：
  • 对应镜像：https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.11.x/windowsservercore-ltsc2022/Dockerfile
• 2.11.10-nanoserver, 2.11-nanoserver：
  • 对应镜像：https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.11.x/nanoserver-ltsc2022/Dockerfile
• 2.10.29, 2.10：
  • 对应镜像：https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.10.x/nanoserver-ltsc2022/Dockerfile
• 2.10.29-windowsservercore, 2.10-windowsservercore：
  • 对应镜像：https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.10.x/windowsservercore-ltsc2022/Dockerfile
• 2.10.29-nanoserver, 2.10-nanoserver：
  • 对应镜像：https://github.com/nats-io/nats-docker/blob/5b46acd148b1b7d13a084cca7fc1a50e75412360/2.10.x/nanoserver-ltsc2022/Dockerfile

使用场景与适用范围

• 云原生应用：作为微服务间的轻量级消息总线，支持服务解耦与异步通信。
• 高性能消息传递：适用于对延迟敏感的场景（如实时监控、***交易）。
• 流数据处理：通过JetStream实现消息持久化、重放与流处理，满足日志聚合、事件溯源等需求。
• Windows环境部署：专为windows-amd64架构优化，适合Windows Server或Windows容器环境。
• 集群扩展：支持多节点集群部署，提升系统可用性与负载能力。

使用方法

基本运行

通过docker run命令启动单节点NATS服务器：

powershell
# 启动NATS服务器，映射默认端口
docker run -d --name nats-main `
  -p 4222:4222 `  # 客户端连接端口
  -p 8222:8222 `  # HTTP管理端口
  -p 6222:6222 `  # 集群路由端口
  winamd64/nats

端口说明：

• 4222：客户端端口，供生产者/消费者连接。
• 8222：HTTP管理端口，可通过http://localhost:8222/varz查看服务器状态。
• 6222：集群路由端口，用于节点间通信。

启用JetStream（持久化流处理）

通过-js参数启用JetStream，并使用-sd指定数据存储目录（需挂载卷持久化数据）：

powershell
# 启用JetStream并持久化数据
docker run -d --name nats-js `
  -p 4222:4222 `
  -v nats-data:/data `  # 挂载卷存储JetStream数据
  winamd64/nats -js -sd /data  # -js启用JetStream，-sd指定数据目录

集群部署示例

部署两个NATS节点组成集群（需先启动主节点，再启动从节点并连接主节点路由）：

powershell
# 1. 启动主节点（nats-main）
docker run -d --name nats-main `
  -p 4222:4222 -p 8222:8222 -p 6222:6222 `
  winamd64/nats

# 2. 启动从节点（nats-2），连接主节点路由
docker run -d --name nats-2 `
  -p 4223:4222 -p 8223:8222 -p 6223:6222 `  # 避免端口冲突，映射到主机4223/8223/6223
  --link nats-main `  # 链接主节点容器
  winamd64/nats -c /etc/nats/nats-server.conf `  # 使用默认配置文件
  --routes=nats-route://ruser:T0pS3cr3t@nats-main:6222  # 连接主节点路由端口

集群验证：通过从节点日志确认路由连接成功，或访问主节点http://localhost:8222/routez查看集群路由状态。

配置说明

默认配置文件

容器内默认配置文件路径为/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 = []
}

命令行选项

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

服务器选项

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

JetStream选项

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

集群选项

• --routes <rurl-1,rurl-2>：指定要连接的集群路由URL（如nats-route://ruser:T0pS3cr3t@host:6222）。
• --cluster_name <name>：集群名称（覆盖配置文件中的cluster.name）。

日志与调试选项

• -D, --debug：启用调试日志。
• -V, --trace：启用协议跟踪日志。
• -l, --log <file>：日志输出到文件。

镜像变体

NATS镜像提供两种Windows基础镜像变体，适用于不同场景：

windowsservercore

• 基础镜像：基于mcr.microsoft.com/windows/servercore（Windows Server Core）。
• 特点：功能完整，包含更多系统组件，兼容性强。
• 适用场景：需要依赖Windows Server完整功能的环境。

nanoserver

• 基础镜像：基于mcr.microsoft.com/windows/nanoserver（Windows Nano Server）。
• 特点：轻量级，体积小，启动快，资源占用低。
• 适用场景：对镜像大小和启动速度有要求的场景（如边缘计算、资源受限环境）。

维护与支持

• 维护者：https://github.com/nats-io/nats-docker。
• 获取帮助：Docker社区Slack、Server Fault、Stack Overflow。
• 提交Issue：https://github.com/nats-io/nats-docker/issues。
• 镜像更新：通过https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fnats跟踪更新。
• 支持架构：除windows-amd64外，还支持amd64、arm32v6、arm64v8等（详见https://hub.docker.com/_/nats）。

许可证信息

• 软件许可：NATS服务器遵循https://github.com/nats-io/gnatsd/blob/master/LICENSE。
• 镜像许可：Docker镜像可能包含基础镜像及依赖软件，用户需确保符合所有组件的许可条款。

详细许可信息请参见https://github.com/nats-io/gnatsd/blob/master/LICENSE。