两个 Docker 容器如何通信？Docker 网络问题完整踩坑与解决指南
NebulaGraph Studio 连接失败？Docker 网络问题完整踩坑与解决指南（小白友好）
一、问题背景
我在本地使用Docker 部署 NebulaGraph 集群，同时使用Nebula Graph Studio（Web UI）进行可视化管理。
- Nebula Graph：
docker-compose启动 - Nebula Studio：单独一个 Docker 容器
- Studio 页面可以正常访问：
👉http://127.0.0.1:7001
但在Studio 新建连接时，无论怎么填 IP，都会报错。
二、遇到的错误现象
1️⃣ 连接超时错误
ErrBadRequest::failed to open connection dial tcp 13.251.172.174:9669: i/o timeout三、为什么会这样？（核心原理）
1️⃣ NebulaGraph 架构说明
NebulaGraph 并不是一个单体服务，而是由多个组件组成：
组件 作用 默认端口
nebula-studio Web 管理界面 7001
graphd 查询入口（真正连的服务） 9669
metad 元数据服务 9559
storaged 数据存储 9779
👉 Studio ≠ 数据库本身
👉 Studio 只是一个客户端，需要去连接 graphd
2️⃣ Docker 网络隔离是“真凶”
Docker 中有一个非常重要的概念：
不同 Docker network 之间的容器，默认是完全隔离的
我当时的网络结构是：
nebula-docker-compose_nebula-net ← Nebula Graph 集群
nebula-graph-studio-380_nebula-web ← Nebula Studio
📌 两个 network 不一样！
结果就是：
Studio 容器里 无法解析 graphd 容器名
nebula-graphd / nebula-docker-compose-graphd-1 都找不到
Docker DNS 返回 no such host
四、关键排查过程
1️⃣ 查看正在运行的容器
docker ps确认：
graphd / metad / storaged 正常运行
Studio 正常运行
2️⃣ 查看 Docker 网络
docker network ls发现：
Nebula Graph 和 Studio 在不同 network
五、正确解决方案（推荐做法）
✅ 核心思路
让 Nebula Studio 和 Nebula Graph 处在同一个 Docker network
Step 1：确认 Nebula Graph 的 network
docker network ls例如：
nebula-docker-compose_nebula-netStep 2：把 Studio 容器加入这个 network
docker network connect nebula-docker-compose_nebula-net nebula-graph-studio-380-web-1nebula-graph-studio-380-web-1 是 Studio 容器名
用 docker ps 可以确认
Step 3：重启 Studio（必须）
docker restart nebula-graph-studio-380-web-1六、Studio 中的正确连接方式
打开浏览器：
http://127.0.0.1:7001
新建连接，填写：
Host: nebula-docker-compose-graphd-1 Port: 9669 Username: root Password: nebula📌 关键点：
Host 填的是 graphd 容器名
不是 127.0.0.1
不是公网 IP
是 Docker 内部 DNS 名称