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

镜像概述

主要用途

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

核心功能与特性

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

支持的标签

Simple Tags

2.12.1-windowsservercore-ltsc2022, 2.12-windowsservercore-ltsc2022, 2-windowsservercore-ltsc2022, windowsservercore-ltsc2022
2.12.1-nanoserver-ltsc2022, 2.12-nanoserver-ltsc2022, 2-nanoserver-ltsc2022, nanoserver-ltsc2022
2.11.10-windowsservercore-ltsc2022, 2.11-windowsservercore-ltsc2022
2.11.10-nanoserver-ltsc2022, 2.11-nanoserver-ltsc2022
2.10.29-windowsservercore-ltsc2022, 2.10-windowsservercore-ltsc2022
2.10.29-nanoserver-ltsc2022, 2.10-nanoserver-ltsc2022

Shared Tags

2.12.1, 2.12, 2, latest：
- 对应镜像：2.12.1-nanoserver-ltsc2022
2.12.1-windowsservercore, 2.12-windowsservercore, 2-windowsservercore, windowsservercore：
- 对应镜像：2.12.1-windowsservercore-ltsc2022
2.12.1-nanoserver, 2.12-nanoserver, 2-nanoserver, nanoserver：
- 对应镜像：2.12.1-nanoserver-ltsc2022
2.11.10, 2.11：
- 对应镜像：2.11.10-nanoserver-ltsc2022
2.11.10-windowsservercore, 2.11-windowsservercore：
- 对应镜像：2.11.10-windowsservercore-ltsc2022
2.11.10-nanoserver, 2.11-nanoserver：
- 对应镜像：2.11.10-nanoserver-ltsc2022
2.10.29, 2.10：
- 对应镜像：2.10.29-nanoserver-ltsc2022
2.10.29-windowsservercore, 2.10-windowsservercore：
- 对应镜像：2.10.29-windowsservercore-ltsc2022
2.10.29-nanoserver, 2.10-nanoserver：
- 对应镜像：2.10.29-nanoserver-ltsc2022

使用场景与适用范围

云原生应用：作为微服务间的轻量级消息总线，支持服务解耦与异步通信。
高性能消息传递：适用于对延迟敏感的场景（如实时监控、***交易）。
流数据处理：通过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 = []
}