apache/seata-naming-server

Apache Seata Naming Server 镜像文档

镜像概述

本镜像包含Apache Seata(incubating)的Naming Server组件，是Seata分布式事务解决方案的核心服务注册发现模块。Naming Server负责Seata事务协调器（TC）、事务管理器（TM）及资源管理器（RM）之间的服务注册与发现，支持分布式事务场景下的服务定位与通信，为微服务架构中的跨服务事务提供基础协调能力。

核心功能与特性

• 服务注册：支持Seata组件（TC/TM/RM）节点注册至Naming Server，维护服务实例元数据
• 服务发现：提供基于服务名的实例查询能力，支持按服务类型（如TC集群）筛选
• 健康检查：内置服务实例健康状态检测机制，自动剔除不可用节点
• 负载均衡：支持多种负载均衡策略（如轮询、随机），优化服务调用分发
• 多注册中心适配：兼容主流注册中心（如Nacos、Eureka、Zookeeper），支持灵活扩展

使用场景与适用范围

• 基于Apache Seata构建的分布式事务系统
• 微服务架构中跨服务事务协调场景
• 需要统一服务注册发现机制的Seata集群部署
• 对服务可用性、通信可靠性有较高要求的分布式业务场景

使用方法与配置说明

快速启动

通过以下命令快速启动Naming Server容器：

bash
docker run -d --name seata-naming-server \
  -p 8848:8848 \
  -e SERVER_PORT=8848 \
  -e REGISTRY_TYPE=nacos \
  -e NACOS_SERVER_ADDR=127.0.0.1:8848 \
  apache/seata-naming-server:latest

环境变量配置

配置文件挂载

如需自定义详细配置，可通过挂载Seata配置文件目录进行配置覆盖：

bash
docker run -d --name seata-naming-server \
  -p 8848:8848 \
  -v /host/path/to/seata-config:/seata/conf \
  apache/seata-naming-server:latest

配置文件路径：/seata/conf/naming-server.yaml，支持自定义服务发现策略、健康检查参数等高级配置。

集群部署

通过指定相同注册中心地址，启动多个Naming Server实例即可形成集群，实现高可用：

bash
# 节点1
docker run -d --name seata-naming-server-1 \
  -p 8848:8848 \
  -e SERVER_PORT=8848 \
  -e REGISTRY_TYPE=nacos \
  -e NACOS_SERVER_ADDR=nacos-cluster:8848 \
  apache/seata-naming-server:latest

# 节点2
docker run -d --name seata-naming-server-2 \
  -p 8849:8848 \
  -e SERVER_PORT=8848 \
  -e REGISTRY_TYPE=nacos \
  -e NACOS_SERVER_ADDR=nacos-cluster:8848 \
  apache/seata-naming-server:latest

注意事项

• 确保注册中心（如Nacos）已提前部署并可访问
• 集群部署时，各节点需配置相同的注册中心地址
• 生产环境建议通过配置文件自定义健康检查阈值及负载均衡策略
• 镜像版本需与Seata TC/TM/RM组件版本保持一致，避免兼容性问题