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-net

Step 2：把 Studio 容器加入这个 network

docker network connect nebula-docker-compose_nebula-net nebula-graph-studio-380-web-1

nebula-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 名称

两个 Docker 容器如何通信？

Docker 容器之间通信，优先使用：

👉 同一个 Docker network + 容器名（或 service name）