如何访问Docker中的etcd？连接失败问题求助

看起来你遇到的问题主要来自两个核心点：etcdctl版本与容器内etcd版本不兼容，或者环境变量/配置覆盖了你指定的endpoint。我来一步步帮你排查解决：

1. 先确认版本兼容性问题 #

你容器里的etcd是v3.0.4，而本地的etcdctl如果是旧版本，可能默认使用v2 API，这会导致和v3版本的etcd服务连接失败：

• 先查看本地etcdctl的版本：

  etcdctl --version
  

• 如果显示是v2.x版本，需要切换到v3 API模式再执行命令：

  ETCDCTL_API=3 etcdctl --endpoint=http://172.17.0.2:2379 get /testdir/testkey1
  

  这个环境变量会强制etcdctl使用v3 API，和容器里的etcd版本匹配。

2. 检查是否有环境变量覆盖了endpoint #

你的错误提示里显示连接的是0.0.0.0:2379，但你明明指定了容器IP，这很可能是因为本地设置了ETCDCTL_ENDPOINT环境变量，覆盖了命令行参数：

• 先检查这个变量：

  echo $ETCDCTL_ENDPOINT
  

• 如果输出是0.0.0.0:2379，先清空它：

  unset ETCDCTL_ENDPOINT
  

  然后再重新执行你的etcdctl命令试试。

3. 验证容器端口的可达性 #

如果上面两步都没用，先确认主机能访问容器的2379端口：

• 在主机上执行：

  nc -zv 172.17.0.2 2379
  

  （如果没有nc工具，也可以用telnet 172.17.0.2 2379）
• 如果显示连接失败，再检查容器内的etcd是否真的在监听2379端口：

  docker exec 40cc9457f132 netstat -tulpn | grep 2379
  

  正常应该能看到etcd进程监听0.0.0.0:2379。

4. 可选：映射容器端口到主机 #

为了更方便访问，你可以重启容器时加上端口映射，这样直接用localhost就能访问：

# 先停止并删除旧容器
docker stop etcd && docker rm etcd
# 重新启动容器并映射端口
docker run -d --name etcd \
-v /usr/share/ca-certificates/:/etc/ssl/certs \
-p 2379:2379 \
quay.io/coreos/etcd:v3.0.4 /usr/local/bin/etcd \
-advertise-client-urls http://0.0.0.0:2379 \
-listen-client-urls http://0.0.0.0:2379

之后直接用本地地址访问：

ETCDCTL_API=3 etcdctl --endpoint=http://localhost:2379 get /testdir/testkey1

另外，你提到不停止本地etcd时能拿到数据但和容器内的不一致，这是因为此时etcdctl默认连接了本地的etcd服务，而非容器里的，所以停止本地服务后才会暴露连接容器失败的问题。

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