详细到没朋友的 NebulaGraph 桌面版部署指南

NebulaGraph 技术社区 2025-03-07

导读：‍‍‍‍

NebulaGraph Desktop,可零基础启动部署、实现全周期生命管理，并提供模板化脚本、调试工具与文档指引，旨在全方位为 NebulaGraph 初学者和开发者提供便捷的学习和开发环境。

本文将以 Windows 系统为环境，手把手教你快速部署并测试 NebulaGraph Desktop.

▌一、NebulaGraph Desktop

NebulaGraph Desktop （欢迎参与有奖公测）由@NebulaGraph committer wey-gu 开发，旨在为不熟悉 Docker、不方便从 Docker Hub 拉取镜像的用户提供一个自包含的 Windows/macOS 上的分发版。大大降低了 NebulaGraph 的学习门槛，使得用户可以在无需深入了解 Docker 和图数据库底层架构的情况下，轻松上手 NebulaGraph 的开发和使用。

特点与优势：

自包含分发版：NebulaGraph 桌面版是一个自包含的分发版，用户无需额外安装 Docker 或其他依赖项，只需下载安装包并部署即可。这大大降低了用户的学习成本和时间成本。
跨平台支持：NebulaGraph 桌面版支持 Windows 和 macOS 两大主流操作系统，满足了不同用户的需求。
内置镜像：桌面版内置了 NebulaGraph 的镜像，用户无需从 Docker Hub 拉取镜像，即可直接使用 NebulaGraph 进行开发和测试。这对于国内用户来说，尤其是一个福音，因为国内网络访问 Docker Hub 可能会遇到一些困难。
简单易用：NebulaGraph 桌面版提供了直观的用户界面和简洁的操作流程，使得用户可以轻松地创建、管理和使用图数据库。

NebulaGraph桌面版的使用体验

在安装 NebulaGraph 桌面版之前，用户需要提前安装新版本的 Docker Desktop 并运行它。对于 macOS 用户来说，可能还需要参考 README 解锁应用签名的报错。不过，这些步骤都相对简单，用户只需要按照提示进行操作即可。

▌二、系统基础环境配置

工欲善其事，必先利其器。在开始部署之前，确保 Windows 系统满足一定条件。首先，系统需为 Windows 10 64位及以上版本，且开启 Hyper-V 或 WSL 2 虚拟化功能。其次，要使用 NebulaGraph 桌面版，需要安装 Docker Desktop. 以下是 Windows 平台上的安装步骤：

1、检查系统要求：

Windows 11 64 位：家庭版或专业版，至少 21H2；企业版或教育版，至少 21H2。
Windows 10 64 位：家庭版或专业版，至少 21H1；企业版或教育版，至少 20H2。

本次测试环境电脑配置设备名称处理器 Intel(R) Core™ i5-9500 CPU @ 3.00GHz 3.00 GHz机带 RAM 24.0 GB (23.8 GB 可用)系统类型 64 位操作系统, 基于 x64 的处理器笔和触控没有可用于此显示器的笔或触控输入

2、Hyper-V 和 WSL 2 的关系和区别：

2.1 Hyper-V 模式（传统方案）

Hyper-V 是 Microsoft 开发的硬件虚拟化技术，允许在物理主机上创建和运行多个虚拟机（VM）。它是 Windows 专业版和企业版的原生功能。

Docker 如何依赖 Hyper-V 在早期版本的 Docker Desktop（如 2018 年之前）中，Docker 依赖 Hyper-V 创建一个轻量级的 Linux 虚拟机（称为 MobyLinuxVM）。与某些软件冲突：与 VMware、VirtualBox 等虚拟化工具不兼容（需关闭 Hyper-V）。

2.2 WSL 2 模式（现代方案）

WSL 2（Windows Subsystem for Linux 2）是 Microsoft 推出的 Linux 子系统，允许直接在 Windows 上运行原生 Linux 二进制文件。基于轻量级虚拟机技术（底层仍依赖 Hyper-V 的虚拟化层，但用户无需手动管理）。提供与 Linux 内核的高度兼容性。

2.3 Docker Desktop 如何选择模式

如果系统支持 WSL 2，Docker Desktop 默认优先使用 WSL 2 后端。
如果 WSL 2 不可用（如旧版 Windows），则回退到传统的 Hyper-V 虚拟机模式。

2.4 如何检查和切换 Docker Desktop 的模式

检查当前模式打开 Docker Desktop → 点击右上角齿轮图标（Settings）。

左侧导航栏选择 General → 查看 Use WSL 2 based engine 是否勾选：

勾选：使用 WSL 2 模式。
未勾选：使用传统 Hyper-V 模式（需手动启用 WSL 2）。

3、启用 WSL 2 功能：

在 Windows 上成功运行 WSL 2，需要具有二级地址转换（SLAT）功能的 64 位处理器、4GB 系统内存，并在 BIOS 设置中启用 BIOS 级别的硬件虚拟化支持。（如前期已经配置好，请忽略当前步骤）

3.1 下载并安装Linux内核更新程序包

前往 wsl2 安装包下载地址，下载并安装 Linux 内核更新程序包。

3.2 启用适用于 Linux 的 Windows 子系统

需要先启用“适用于 Linux 的 Windows 子系统”可选功能，然后才能在 Windows 上安装 Linux 分发。
以管理员身份打开 PowerShell（“开始”菜单 >“PowerShell” >单击右键 >“以管理员身份运行”），然后输入以下命令：

dism.exe online enable-feature featurename:Microsoft-Windows-Subsystem-Linux all norestart
复制

3.3 启用虚拟机功能

安装 WSL 2 之前，必须启用“虚拟机平台”可选功能。计算机需要虚拟化功能才能使用此功能。以管理员身份打开 PowerShell 并运行：

dism.exe online enable-feature featurename:VirtualMachinePlatform all norestart
复制

重新启动计算机，以完成 WSL 安装并更新到 WSL 2。

3.4 下载 Linux 内核更新包

下载最新包：适用于 x64 计算机的 WSL2 Linux 内核更新包;运行上一步中下载的更新包。（双击以运行 - 系统将提示你提供提升的权限，选择“是”以批准此安装。）

3.5 将 WSL 2 设置为默认版本

打开 PowerShell，然后在安装新的 Linux 发行版时运行以下命令，将 WSL 2 设置为默认版本：

wsl --set-default-version 2
复制

3.6 安装所选的 Linux 分发

打开 Microsoft Store，并选择你偏好的 Linux 分发版。

选择 Ubuntu 20.04

▌三、安装 Docker Desktop

Docker Desktop 作为容器化平台，能够轻松创建、部署和运行应用程序，为 NebulaGraph Desktop 的部署提供了便捷的环境。

1、下载并安装 Docker Desktop：

（如前期已经配置好，请忽略当前步骤）

前往 Docker Desktop下载页面，选择Windows版本和相应架构安装包进行下载。

2、安装Docker Desktop

双击Docker Desktop Installer.exe进行安装，安装完成后双击桌面快捷方式启动Docker Desktop。
安装成功后，Close and log out退出安装界面。

系统将会重启

3、Docker 订阅服务协议

重启后提示 Docker 订阅服务协议这个信息是关于 Docker 订阅服务协议的。简单来说，如果你选择接受，就表示你同意了订阅服务协议、Docker 数据处理协议以及数据隐私政策。

4、设置 Docker Desktop

要完成 Docker Desktop 的安装，你可以按照以下步骤进行，并根据你的需求选择使用推荐设置或高级设置：

4.1 建议选择使用推荐设置（需要管理员密码）

4.2 验证安装‍

4.3 登录或注册账号

4.4 创建账号

4.5 查看Docker版本

打开命令提示符（或终端），输入 docker --version 查看 Docker 版本。输入 docker version 查看 Docker 环境信息。

▌四、安装 NebulaGraph 桌面版

安装好 Docker - desktop 后，便进入关键的部署环节。以下是安装步骤：

1、下载NebulaGraph桌面版：

前往 https://github.com/wey-gu/NebulaGraph-Desktop，下载安装包。

只需要在 release 里下载v 0.3.1安装包，部署就可以了。(后续版本可能有变化，请以实际为准)

2、安装NebulaGraph桌面版：

2.1 双击安装包进行安装

2.2 选择安装位置

2.3 完成安装

3、方法一：运行 NebulaGraph 桌面版：

安装完成后，运行 NebulaGraph 桌面版。确保已提前安装并运行了新版本的 Docker Desktop.

3.1 运行 NebulaGraph 桌面版

部署完成后，迫不及待地打开 NebulaGraph 桌面版，简洁直观的交互设计让人眼前一亮，即使是初次接触图数据库的用户也能快速上手。

3.2 Start ALL一键启动所有服务

3.3 检查状态，启动正常

安装完成后，用户可以打开 NebulaGraph 桌面版，开始创建和管理自己的图数据库。界面简洁明了，用户可以通过直观的图形界面进行各种操作，如创建数据库、导入数据、执行查询等。同时，桌面版还提供了丰富的文档和教程，帮助用户快速上手 NebulaGraph 的使用。

在使用过程中，NebulaGraph 桌面版表现出了良好的稳定性和性能。用户可以流畅地进行各种操作，无需担心卡顿或崩溃等问题。此外，桌面版还支持多种数据导入方式和查询语言，满足了不同用户的需求。

3.4 Stop ALL一键停止服务

4、方法二：通过 docker-desktop 启动停止 NebulaGraph 容器

（如前期已经启动 NebulaGraph 桌面版，请忽略当前步骤）

4.1 通过 docker-desktop Images 查看 NebulaGraph 镜像

4.2 通过 docker-desktop Containers 启动停止NebulaGraph容器

4.3 查看状态NebulaGraph容器

▌五、NebulaGaph 桌面版体验

NebulaGraph 桌面版提供了一个直观易用的用户界面，方便用户进行图数据库的创建、管理、查询等操作。

1、NebulaGraph Studio 可视化运维：

提供了可视化工具，帮助用户更直观地理解图数据库中的数据结构和关系。

2、登录NebulaGraph Studio

3、使用 NebulaGraph Console 查询

4、创建测试图空间与数据：

在 NebulaGraph 桌面版中，可以轻松创建新的图数据库集合，并配置相关参数。

4.1 创建图数据集合 CREATE SPACE

4.2 查看SPACE 图空间

4.3 创建 Schema

4.4 查看 Schema 已经完成创建

5、数据查询

整个过程高效稳定，几乎没有出现任何卡顿或错误。NebulaGraph 提供了丰富的查询和分析功能，支持 nGQL（Nebula Graph Query Language）查询语言，方便用户进行复杂的数据查询和分析操作。

// 使用 GO 语句查询
nebula> GO FROM "11" over e1 YIELD properties(edge);
+----------------------+
| properties(EDGE)     |
+----------------------+
| {age: 1, name: "n1"} |
+----------------------+
复制

▌六、踩坑问题

1、启动报错 docker-compose 文件不存在

现象：启动 NebulaGraph Desktop 时提示 docker-compose 文件不存在。

Command failed: cd "C:\Users\dell\AppData\Roaming\nebulagraph-desktop\.nebulagraph-desktop" && docker compose up -d no configuration file provided: not found
复制

通过 PowerShel 终端启动也报错

error during connect: Post "http://%2F%2F.%2Fpipe%2FdockerDesktopLinuxEngine/v1.47/containers/create?name=nebulagraph-desktop-metad-1": EOF
复制

解决办法：

升级 NebulaGraph Desktop 版本：提示的问题可能与旧版本（如0.3.0）相关，建议从官方 releases 页面下载最新版本（如0.3.1）并重新安装。（后续版本可能有变化，请以实际为准）‍‍‍‍

2、提示 WSL 报错

解决办法：

检查 WSL 2 状态，打开 PowerShell, 运行以下命令，查看 WSL 2 是否已启用：

wsl --list --verbose
复制

如图显示「适用于 Linux 的 Windows 子系统没有已安装的分发版。可以通过访问 Microsoft Store 来安装分发版」，说明未能安装成功，可以设置虚拟化启用 Hyper-V 。

解决办法：

需要启用相关Windows功能：（启用Hyper-V ）
打开“控制面板” → “程序” → “启用或关闭Windows功能”。勾选以下选项：Hyper-V（需专业版系统）

重启电脑生效

在 Windows 系统中，Docker Desktop 的运行依赖于虚拟化技术。随着 Windows 系统的更新和 Docker 的演进，Docker Desktop 的底层支持方案也发生了变化，主要涉及 Hyper-V 和 WSL 2 两种技术。如果 WSL 2 不能用，直接启用 Hyper-V 即可。

3、启动 Docker Desktop 报错

Privileged helper service is not running
复制

解决办法：

启动 Docker Desktop Service 服务

选择自动启动

再次启动 docker 启动成功

▌七、测评体验

本次测试中，NebulaGraph Desktop 展现了以下优势：

开箱即用：Docker 化部署大幅降低入门门槛，适合快速搭建测试环境。
功能聚合：将图数据库管理、数据建模、监控告警整合至统一界面，提升运维效率。
性能透明化：内置监控与调试工具，让查询优化有据可依。

对于开发者来说，NebulaGraph 桌面版提供了一个便捷的开发环境，支持快速迭代和测试。通过这款工具，用户可以轻松地创建、管理和使用图数据库，无需深入了解 Docker 和图数据库底层架构。无论是初学者还是开发者，都能从中受益匪浅。

此外，NebulaGraph 桌面版还内置了 Docker 镜像，无需担心国内网络对 Docker Hub 的干扰问题。这为用户提供了一个更加稳定和可靠的使用体验。

当然，NebulaGraph 桌面版还有很大的发展空间。未来可进一步探索其与 Kubernetes 的集成能力，以及 AI 辅助索引推荐等智能化功能。无论是图数据库新手还是资深运维，NebulaGraph Desktop 都值得纳入技术栈选型清单。

✦

如果你觉得 NebulaGraph能帮到你，或者你只是单纯支持开源精神，可以在 GitHub 上为 NebulaGraph 点个 Star！每一个 Star 都是对我们的支持和鼓励✨

https://github.com/vesoft-inc/nebula

✦

扫码添加

可爱星云

技术交流

资料分享

✨ NebulaGraph 推荐阅读

文章转载自NebulaGraph 技术社区，如果涉嫌侵权，请发送邮件至：contact@modb.pro进行举报，并提供相关证据，一经查实，墨天轮将立刻删除相关内容。

详细到没朋友的 NebulaGraph 桌面版部署指南

1、检查系统要求：

2、Hyper-V 和 WSL 2 的关系和区别：

2.1 Hyper-V 模式（传统方案）

2.2 WSL 2 模式（现代方案）

2.3 Docker Desktop 如何选择模式

2.4 如何检查和切换 Docker Desktop 的模式

3、启用 WSL 2 功能：

3.1 下载并安装Linux内核更新程序包

3.2 启用适用于 Linux 的 Windows 子系统

3.3 启用虚拟机功能

3.4 下载 Linux 内核更新包

3.5 将 WSL 2 设置为默认版本

3.6 安装所选的 Linux 分发

▌三、安装 Docker Desktop

1、下载并安装 Docker Desktop：

2、安装Docker Desktop

3、Docker 订阅服务协议

4、设置 Docker Desktop

4.1 建议选择使用推荐设置（需要管理员密码）

4.2 验证安装‍

4.3 登录或注册账号

4.4 创建账号

4.5 查看Docker版本

▌四、安装 NebulaGraph 桌面版

2、安装NebulaGraph桌面版：

2.2 选择安装位置

2.3 完成安装

3、方法一：运行 NebulaGraph 桌面版：

3.3 检查状态，启动正常

4、方法二：通过 docker-desktop 启动停止 NebulaGraph 容器

4.1 通过 docker-desktop Images 查看 NebulaGraph 镜像

4.2 通过 docker-desktop Containers 启动停止NebulaGraph容器

4.3 查看状态NebulaGraph容器

▌五、NebulaGaph 桌面版体验

1、NebulaGraph Studio 可视化运维：

3、使用 NebulaGraph Console 查询

4、创建测试图空间与数据：

4.1 创建图数据集合 CREATE SPACE

4.2 查看SPACE 图空间

1、启动报错 docker-compose 文件不存在

评论