Docker化Spring Boot Eureka Server的hostname与defaultZone配置咨询

问题描述 #

我正在将Spring Boot Eureka Server容器化，不确定eureka.instance.hostname和eureka.client.serviceUrl.defaultZone应配置什么值。以下是我当前的application.yml配置：

# Application Name
spring:
  application:
    name: service-registry

# Eureka Server Configuration
eureka:
  server:
    eviction-interval-timer-in-ms: 60000  # 调整服务剔除间隔（默认60秒）
    response-cache-update-interval-ms: 10000  # 调整缓存刷新频率
  client:
    register-with-eureka: false
    fetch-registry: false
    service-url:
      defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/
  # 主机与端口配置
  instance:
    hostname: localhost

logging:
  level:
    eureka:
      com.netflix.discovery: 'DEBUG'
      com.netflix.eureka: 'DEBUG'

server:
  port: 8761

我希望Eureka Server运行在Docker容器中，其他同样在Docker中的微服务能够向其注册。我需要确保网络配置正确，使微服务能无问题地发现Eureka。请问在Docker中运行时，是否应保留eureka.instance.hostname: localhost？微服务中的eureka.client.serviceUrl.defaultZone应配置什么值才能找到并注册到Docker中的Eureka？

核心配置调整说明 #

1. Eureka Server端的eureka.instance.hostname配置 #

绝对不能保留localhost，原因很直接：

• Docker容器内的localhost仅指向容器自身，其他容器根本无法通过这个地址访问到Eureka Server。
• 正确配置方式分两种场景：
  • 用Docker Compose编排服务：直接把hostname设为Eureka在Compose中的服务名称（比如示例里的service-registry），同网络内的其他容器可以通过服务名直接解析到Eureka容器。
  • 单独运行Docker容器：可以通过docker run --hostname eureka-server给容器指定自定义主机名，或者配置为容器所在宿主机的IP（但宿主机IP变动会出问题，更推荐用Docker网络服务名的方式）。

调整后的Eureka Server配置片段：

eureka:
  instance:
    hostname: service-registry  # 对应Docker Compose服务名或自定义容器主机名

2. 微服务端的eureka.client.serviceUrl.defaultZone配置 #

根据部署方式不同，配置分两种情况：

• Docker Compose编排场景：直接填Eureka服务名+端口，格式为http://service-registry:8761/eureka/，因为Compose默认会创建统一的自定义网络，服务名可直接解析。
• 单独容器运行场景：
  • 微服务和Eureka在同一Docker自定义网络中：用Eureka容器的主机名或容器名作为地址，比如http://eureka-server:8761/eureka/。
  • 不在同一网络：填宿主机IP+宿主机映射的Eureka端口（假设容器8761端口映射到宿主机8761），格式为http://宿主机IP:8761/eureka/。

额外注意事项 #

• 运行Eureka容器时，记得暴露端口：docker run -p 8761:8761 your-eureka-image。
• Docker Compose默认会给所有服务分配同一网络，无需额外配置；如果手动创建网络，要确保所有服务都加入该网络。
• 建议用环境变量传递配置项，避免硬编码，比如启动容器时加参数：-e EUREKA_INSTANCE_HOSTNAME=service-registry。

内容的提问来源于stack exchange，提问作者Zakaria Ait Yakoub