provide/nats-server

NATS Server (支持 JWT、WebSocket 与 JetStream)

镜像概述

NATS 是一个简单、安全且高性能的云原生消息通信系统，专为数字系统、服务和设备设计，是云原生计算基金会（CNCF）的孵化项目。本镜像基于 NATS Server 的高性能分支构建，在原生功能基础上，深度集成了 Bearer JWT 身份验证、WebSockets 协议支持以及 JetStream 持久化流处理引擎，旨在简化和保障现代分布式系统的设计与运维。

核心功能与特性

• 极致性能与轻量级：核心服务器采用 Go 语言编写，资源占用极低，提供极高的吞吐量和极低的延迟。
• JetStream 流处理：内置 JetStream 引擎，支持消息持久化、重放、Exactly-Once 语义及分布式流处理。
• 增强的安全认证：原生支持 Bearer JWT 认证机制，结合 NATS 的细粒度权限控制，保障零信任网络环境下的通信安全。
• WebSockets 支持：允许 Web 浏览器及前端应用直接通过 WebSocket 协议连接 NATS 服务器，无需额外的代理层。
• 多语言与跨平台：提供超过 30 种编程语言的客户端 SDK，服务器可无缝运行在本地数据中心、公有云、边缘节点甚至树莓派等微型设备上。

使用场景与适用范围

• 微服务通信：作为微服务架构中的核心消息总线，实现服务间的解耦与异步通信。
• 事件驱动架构：利用 JetStream 构建可靠的事件溯源（Event Sourcing）和 CQRS 系统。
• 物联网 (IoT) 与边缘计算：凭借低资源消耗和跨平台特性，适用于边缘网关和海量设备的数据采集与指令下发。
• 实时 Web 应用：通过 WebSocket 支持，为 Web 端提供低延迟的实时消息推送和双向通信。

使用方法与配置说明

基础运行

快速启动一个默认的 NATS 服务器实例：

bash
docker run -d --name nats-server -p 4222:4222 -p 8222:8222 docker.xuanyuan.run/nats:latest

注：4222 为客户端连接端口，8222 为 HTTP 监控端口。

启用 JetStream 与 WebSocket

通过命令行参数快速启用 JetStream 和 WebSocket 功能：

bash
docker run -d --name nats-server \
  -p 4222:4222 \
  -p 8222:8222 \
  -p 8080:8080 \
  docker.xuanyuan.run/nats:latest \
  -js \
  --websocket_port 8080 \
  --websocket_no_tls

使用自定义配置文件 (推荐)

对于生产环境，建议通过挂载配置文件来管理 NATS 服务器。

1. 创建 nats.conf 配置文件：

text
# 客户端连接端口
port: 4222

# HTTP 监控端口
http_port: 8222

# 启用 JetStream
jetstream {
  store_dir: /data/jetstream
  max_mem: 1G
  max_file: 10G
}

# 配置 WebSocket
websocket {
  port: 8080
  no_tls: true
}

# 配置 JWT 认证 (示例)
authorization {
  # 此处可配置 JWT 解析器或具体的 token
}

2. 使用 Docker Compose 部署：

yaml
version: '3.8'
services:
  nats:
    image: docker.xuanyuan.run/nats:latest
    container_name: nats-server
    ports:
      - "4222:4222"   # 客户端连接
      - "8222:8222"   # 监控 API
      - "8080:8080"   # WebSocket
    volumes:
      - ./nats.conf:/etc/nats/nats.conf
      - nats-data:/data/jetstream
    command: ["-c", "/etc/nats/nats.conf"]
    restart: always

volumes:
  nats-data:

核心端口说明

安全与许可

• 安全审计：NATS 核心代码已由第三方安全机构 Cure53 进行过全面的安全审计。
• 漏洞报告：如发现安全漏洞，请通过邮件联系 security@nats.io。
• 开源许可：本镜像及 NATS 源代码基于 Apache License 2.0 协议开源。