作者：ShunWah
在运维管理领域，我拥有多年深厚的专业积累，兼具坚实的理论基础与广泛的实践经验。我始终站在技术前沿，致力于推动运维自动化，不懈追求运维效率的最大化。
我精通运维自动化流程，对于OceanBase、MySQL等多种数据库的部署与运维，具备从初始部署到后期维护的全链条管理能力。凭借OceanBase的OBCA和OBCP认证、OpenGauss社区认证结业证书，以及崖山DBCA、亚信AntDBCA、翰高HDCA、GBase 8a | 8c | 8s、Galaxybase GBCA、Neo4j Graph Data Science Certification、NebulaGraph NGCI & NGCP等多项权威认证，我不仅展现了自己的专业技能，也彰显了对技术的深厚热情与执着追求。
在OceanBase & 墨天轮的技术征文大赛中，我凭借卓越的技术实力和独特的见解，多次荣获一、二、三等奖。同时，在OpenGauss第五届、第六届、第七届技术征文大赛，TiDB社区第三届专栏征文大赛，金仓数据库有奖征文活动，以及首批YashanDB「产品体验官」尝鲜征文等活动中，我也屡获殊荣。此外，我还活跃于墨天轮、CSDN等技术平台，经常发布原创技术文章，并多次被首页推荐，积极与业界同仁分享我的运维经验和独到见解。
::: hljs-center
:::
前言
在数据科学领域，图数据库作为一种专门处理图结构数据的数据库，凭借其独特的数据模型和强大的关系处理能力，已经逐渐成为研究和应用的热点。NebulaGraph，作为一款开源、分布式、易扩展的图数据库，凭借其强大的性能和丰富的功能，在图数据库市场中占据了重要地位。而近期推出的NebulaGraph桌面版，更是为初学者和开发者提供了一个便捷的学习和开发环境。近日，NebulaGraph Desktop推出了全新版本，优化了可视化操作与集群管理功能。本文将以Windows系统为环境，手把手教你通过Docker Desktop快速部署并测试这一新版本，探索其核心特性。以下是对NebulaGraph桌面版的详细评测与使用心得，包括实操命令的安装步骤。
一、NebulaGraph桌面版的背景与介绍
NebulaGraph桌面版是由wey-gu在GitHub上开源的一个项目，旨在为不熟悉Docker、不方便从Docker Hub拉取镜像的用户提供一个自包含的Windows/macOS上的分发版。这个桌面版大大降低了NebulaGraph的学习门槛，使得用户可以在无需深入了解Docker和图数据库底层架构的情况下，轻松上手NebulaGraph的开发和使用。
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 验证 Docker Desktop 安装：
4.3 登录或注册 docker 账号
4.4 创建 docker 账号
4.5 查看Docker版本
打开命令提示符（或终端），输入docker --version查看Docker版本。
输入docker version查看Docker环境信息。
四、安装NebulaGraph桌面版
安装好Docker - desktop后，便进入关键的部署环节。NebulaGraph桌面版是一个自包含的Windows/macOS分发版，方便学习和开发。整个部署过程不涉及参数设置，非常简单，只要严格按照步骤操作，就能顺利完成。以下是安装步骤：
1、下载NebulaGraph桌面版：
前往GitHub上的NebulaGraph-Desktop项目页面，下载安装包。
只需要在 release 里下载v 0.3.1安装包，部署就可以了。(后续版本可能有变化，请以实际为准)
2、安装NebulaGraph桌面版：
2.1 双击安装包进行安装，按照提示完成安装过程。
2.2 选择安装位置
2.3 完成安装
3、方法一：运行NebulaGraph桌面版：
安装完成后，运行NebulaGraph桌面版。确保已提前安装并运行了新版本的Docker Desktop。
3.1 运行NebulaGraph桌面版
部署完成后，迫不及待地打开NebulaGraph桌面版，NebulaGraph Desktop的界面便映入眼帘。简洁直观的交互设计让人眼前一亮，即使是初次接触图数据库的用户也能快速上手。
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容器
五、图数据库日常操作体验
NebulaGraph桌面版提供了一个直观易用的用户界面，方便用户进行图数据库的创建、管理、查询等操作。
1、NebulaGraph Studio 可视化运维：
NebulaGraph 提供了 Studio 可视化工具，帮助用户更直观地理解图数据库中的数据结构和关系。
2、登录NebulaGraph Studio 默认端口：7001
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 文件不存在
现象：
启动Nebula Graph 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
解决办法：
升级Nebula Graph 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 启动成功
4、优化建议
4.1 服务图标显示问题：
现象：Services右侧UI图标显示全白，鼠标悬停后才显示内容。
4.2 日志滚动条问题：
现象：查看服务日志时，右下角的滚动条不明显，《scroll to bottom》无法清晰看到内容。
4.3 暂停服务后启动按钮问题：
现象：暂停某个服务后，难以找到启动按钮。
七、使用心得
本次测试中，NebulaGraph Desktop新版本展现了以下优势：
开箱即用：Docker化部署大幅降低入门门槛，适合快速搭建测试环境。
功能聚合：将图数据库管理、数据建模、监控告警整合至统一界面，提升运维效率。
性能透明化：内置监控与调试工具，让查询优化有据可依。
对于开发者来说，NebulaGraph桌面版提供了一个便捷的开发环境，支持快速迭代和测试。通过这款工具，用户可以轻松地创建、管理和使用图数据库，无需深入了解Docker和图数据库底层架构。无论是初学者还是开发者，都能从中受益匪浅。此外，NebulaGraph桌面版还内置了Docker镜像，无需担心国内网络对Docker Hub的干扰问题。这为用户提供了一个更加稳定和可靠的使用体验。当然，NebulaGraph桌面版还有很大的发展空间。未来可进一步探索其与Kubernetes的集成能力，以及AI辅助索引推荐等智能化功能。无论是图数据库新手还是资深运维，NebulaGraph Desktop新版本都值得纳入技术栈选型清单。
以上就是本次评测的全部内容。希望能够帮助大家更好地了解 NebulaGraph，了解 NebulaGraph 桌面版，并在学习和开发过程中取得更好的成果。
—— 仅供参考。如果有更多具体的问题或需要进一步的帮助，请随时告知。
！