apache/seata-server Docker 镜像

Seata Server

什么是Seata

Seata 是一款适用于微服务架构的高性能、易用的分布式事务解决方案。

支持的镜像标签

seata-server 镜像基于 openjdk8 构建。

快速开始

启动 seata-server 实例

通过以下命令快速启动一个默认配置的 seata-server 容器：

bash
$ docker run -p 8091:8091 -p 7091:7091 --name=seata-server --restart=always -d apache/seata-server:latest

使用自定义配置文件启动

若需使用自定义配置，需将配置文件挂载到容器内，并通过环境变量指定配置路径。步骤如下：

1. 准备配置文件：将自定义配置文件（如 registry.conf、file.conf）放在本地目录（例如 /PATH/TO/CONFIG_FILE）。
2. 启动容器：通过 -v 挂载本地配置目录，同时设置 SEATA_CONFIG_NAME 环境变量指定配置文件路径（需以 file: 开头）：

bash
$ docker run --name seata-server \
  -p 8091:8091 \
  -p 7091:7091 \
  -e SEATA_CONFIG_NAME=file:/root/seata-config/registry \  # 指定配置文件路径，对应 /root/seata-config/registry.conf
  -v /PATH/TO/CONFIG_FILE:/root/seata-config  \  # 挂载本地配置目录到容器内 /root/seata-config
  apache/seata-server

说明：容器默认配置文件路径为 /seata-server/resources，建议将自定义配置放在其他目录（如上述 /root/seata-config），避免覆盖默认配置。

指定服务器 IP 启动

若需在注册中心（如 eureka）中使用指定 IP（而非容器 IP），可通过 SEATA_IP 环境变量设置：

bash
$ docker run --name seata-server \
  -p 8091:8091 \
  -p 7091:7091 \
  -e SEATA_IP=192.168.1.1  # 指定注册中心中使用的 IP
  apache/seata-server

使用 Docker Compose 启动

创建 docker-compose.yaml 文件，示例配置如下：

yaml
version: "3.1"

services:
  seata-server:
    image: docker.xuanyuan.run/apache/seata-server:latest
    hostname: seata-server
    ports:
      - 8091:8091  # 服务端口
      - 7091:7091  # 通信端口
    environment:
      - SEATA_PORT=8091  # 可选，指定服务端口（默认 8091）
    expose:
      - 8091
      - 7091

执行启动命令：

bash
$ docker-compose up -d

容器命令行访问与日志查看

进入容器命令行

通过 docker exec 进入运行中的容器：

bash
$ docker exec -it seata-server sh

查看容器日志

通过 docker logs 实时查看服务日志：

bash
$ docker logs -f seata-server

环境变量

可通过以下环境变量调整 seata-server 配置：

快速参考

获取帮助

• [Seata 代码仓库]
• [Seata 官方文档]
• 钉钉群：扫码加入（群***见 [官方仓库] ）

提交问题

若遇到问题，可在 [Seata Issue 页面] 提交反馈。