Docker部署Elastic APM Stack：APM Server无法连接Elasticsearch求助

这个问题我之前帮不少开发者解决过——核心坑点就是Docker容器的网络隔离特性，你用localhost去连Elasticsearch完全找错了对象😅

你遇到的连接拒绝错误，本质原因是：
在Docker容器内部，localhost或127.0.0.1指向的是容器自己的网络栈，而不是你的宿主机或者Elasticsearch所在的独立容器。所以APM Server容器一直在尝试访问自己内部的9200端口，自然会连接失败。

在Docker Compose环境中，服务之间可以通过服务名称直接通信（Compose会自动为所有服务创建自定义网络并分配DNS解析）。下面是完整的可直接复用的部署方案：

1. 推荐用环境变量替代手动修改配置文件 #

不需要折腾apm-server.yml，用环境变量可以更灵活地适配Docker场景，关键配置如下：

• APM_SERVER_HOST: "0.0.0.0:8200"：让APM Server监听容器所有网卡，方便外部服务上报数据
• ELASTICSEARCH_HOSTS: "http://elasticsearch:9200"：用Elasticsearch的服务名作为地址，Compose会自动解析到对应的容器IP

2. 完整可运行的docker-compose.yml文件 #

version: '3.8'

services:
  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:8.11.3
    container_name: elasticsearch
    environment:
      - discovery.type=single-node
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
      - xpack.security.enabled=false  # 开发环境关闭安全，生产环境请开启并配置认证
    ports:
      - "9200:9200"
      - "9300:9300"
    volumes:
      - es-data:/usr/share/elasticsearch/data
    healthcheck:
      test: ["CMD-SHELL", "curl -f http://localhost:9200/_cluster/health || exit 1"]
      interval: 30s
      timeout: 10s
      retries: 3

  kibana:
    image: docker.elastic.co/kibana/kibana:8.11.3
    container_name: kibana
    environment:
      - ELASTICSEARCH_HOSTS=http://elasticsearch:9200
    ports:
      - "5601:5601"
    depends_on:
      elasticsearch:
        condition: service_healthy

  apm-server:
    image: docker.elastic.co/apm/apm-server:8.11.3
    container_name: apm-server
    environment:
      - APM_SERVER_HOST=0.0.0.0:8200
      - ELASTICSEARCH_HOSTS=http://elasticsearch:9200
      - KIBANA_HOST=http://kibana:5601
      - apm-server.kibana.enabled=true  # 开启Kibana集成，方便在可视化界面查看APM数据
    ports:
      - "8200:8200"
    depends_on:
      elasticsearch:
        condition: service_healthy
      kibana:
        condition: service_started
    command: ["apm-server", "-e"]  # 以日志模式启动，方便排查问题

volumes:
  es-data:
    driver: local

3. 关键配置说明 #

• 服务依赖与健康检查：通过depends_on和healthcheck确保Elasticsearch完全就绪后，再启动APM Server和Kibana，避免因服务未启动完成导致的连接失败。
• 网络通信：Compose默认会为所有服务创建一个自定义网络，服务之间可以直接通过服务名访问，无需手动配置IP地址。
• 生产环境注意：上面的配置关闭了Elasticsearch的安全功能，适合开发测试。如果是生产环境部署，需要开启xpack.security.enabled=true，并为APM Server添加ELASTICSEARCH_USERNAME和ELASTICSEARCH_PASSWORD环境变量。

4. 验证部署是否成功 #

启动服务后：

1. 访问http://localhost:5601打开Kibana，进入APM板块
2. 查看APM Server日志：docker logs apm-server，如果看到Successfully connected to Elasticsearch的日志，说明配置生效

内容的提问来源于stack exchange，提问作者Hector Lorenzo