Docker本地部署Prometheus无法连接Node Exporter排查求助

这是一个典型的Docker容器网络隔离导致的问题，我来帮你拆解原因和解决办法：

你在prometheus.yml里配置的localhost:9100，对于Prometheus容器来说，localhost指向的是它自己的容器内部，而不是你的宿主机或者node-exporter容器。虽然你把node-exporter的9100端口映射到了宿主机，但Prometheus容器处于独立的网络命名空间，无法通过自身的localhost访问到宿主机上的端口，这就是为什么会提示localhost:9100不可达。

1. 使用自定义Docker网络（最推荐，适配开发和生产场景） #

Docker自定义网络支持容器间通过容器名直接通信，不需要依赖宿主机端口映射，网络隔离性也更好：

• 第一步，创建专属的Docker网络：

  docker network create prometheus-network
  

• 第二步，重新启动node-exporter，加入这个网络并设置可识别的容器名：

  docker run -d --network prometheus-network --name node-exporter prom/node-exporter
  

• 第三步，修改你的prometheus.yml，把targets改成容器名（自定义网络内容器名可直接被解析）：

  scrape_configs:
    - job_name: 'node'
      static_configs:
        - targets: ['node-exporter:9100']
  

• 第四步，重新启动Prometheus容器，同样加入这个网络：

  docker run \
  -d \
  -p 9090:9090 \
  -v /Users/person/sandbox/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml \
  --network prometheus-network \
  prom/prometheus
  

2. 使用宿主机特殊DNS名称（适合快速测试） #

Docker提供了host.docker.internal这个特殊DNS名称（macOS、Windows默认支持，Linux需Docker 20.10+版本），可以让容器直接访问宿主机上的服务：

• 修改prometheus.yml的targets配置：

  scrape_configs:
    - job_name: 'node'
      static_configs:
        - targets: ['host.docker.internal:9100']
  

• 重启Prometheus容器即可生效。

3. 使用Host网络模式（不推荐，仅临时测试用） #

将Prometheus容器直接挂载到宿主机的网络命名空间，这样容器内的localhost就等同于宿主机的localhost：

• 启动Prometheus时添加--net=host参数（注意此时无需再映射9090端口，容器直接使用宿主机端口）：

  docker run \
  -d \
  --net=host \
  -v /Users/person/sandbox/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml \
  prom/prometheus
  

• 这种方式会打破容器的网络隔离，安全性较低，不建议在生产环境使用。

修改配置并重启容器后，你可以通过以下方式确认是否成功：

1. 访问Prometheus Web界面（http://localhost:9090）
2. 进入「Status」→「Targets」页面，查看node任务的状态是否变为UP
3. 在查询框中输入node_cpu_seconds_total，如果能返回指标数据，说明连接已经正常

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