萌新轻松上手 NebulaGraph 的三种方案

导读：‍‍‍‍NebulaGraph 作为领先的分布式图数据库，凭借其强大的性能与灵活的扩展性，为众多开发者与数据分析师打开了高效处理海量关联数据的大门。为了让个人用户能够迅速融入 NebulaGraph 的世界，本文精心整理了三种实用方案，无论是 Windows、macOS 用户，还是 Linux 爱好者，亦或是青睐云端服务的开发者，都能从中找到适合自己的快速上手路径。

▌一、Windows & macOS 用户首选

NebulaGraph Desktop

对于习惯于使用图形化界面进行操作的 Windows 和 macOS 用户来说，NebulaGraph Desktop 是开启 NebulaGraph 之旅的理想起点。这款由 NebulaGraph 社区推出的桌面软件，集成了本地实例管理、可视化数据管理以及开发调试等丰富功能，解决了以往部署繁琐、工具分散的痛点，让数据库管理变得轻松愉悦。

NebulaGraph Desktop 特点

用于管理 NebulaGraph 服务的现代、直观的界面
实时服务监控和健康检查
资源使用指标（CPU、内存、网络）
单独的服务控制
服务日志查看器
美观、响应迅速的 UI
支持离线模式（无需提取 Docker Hub 镜像）

项目地址

https://github.com/wey-gu/NebulaGraph-Desktop

NebulaGraph Desktop 遵循 Apache 2.0 协议，欢迎开发者们共同参与功能迭代与生态扩展。

安装步骤

1. 安装 Docker Desktop

NebulaGraph Desktop 依赖于 Docker Desktop，因此首先需要安装 Docker Desktop。它是一款功能强大的容器管理工具，适用于 Mac、Linux (Ubuntu, Debian, Fedora, Arch, RHEL) 或 Windows 等多种操作系统，能够帮助用户轻松构建、共享和运行容器化应用程序及微服务。其简洁的图形用户界面，让容器、应用程序和映像的管理变得直观而高效。

在 Windows 系统下，Docker Desktop 需要使用 WSL 2 或 Hyper-V，安装完成后，会默认下载安装 WSL 子系统，无需额外进行配置。

2. 安装 NebulaGraph Desktop

下载 NebulaGraph.Desktop.Setup.0.3.5-windows.exe.

依据安装提示快速完成软件部署。

3. 启动 NebulaGraph 服务

安装完成后，打开 NebulaGraph Desktop，点击【Start All】按钮，即可轻松启动 NebulaGraph 服务。

可以看到有四个服务正在健康运行，表明数据库已成功启动。

浏览器中访问 localhost:7001/login 即可进入 NebulaGraph Studio 工具，开始进行数据管理与操作。

‍

▌二、Linux 开发必备 NebulaGraph 单机版

Linux 版本更适合于 DBA 或者有 Linux 运维经验的从业者。以 CentOS 7 为例，其安装与使用过程简洁明了，能够让开发者迅速搭建起专属的开发环境，专注于核心业务逻辑的实现。

1. 下载安装包

使用 wget 命令，从官方 NebulaGraph 的 RPM 安装包以及控制台工具。

wget https://oss-cdn.nebula-graph.com.cn/package/3.1.0/nebula-graph-3.1.0.el7.x86_64.rpm
wget https://github.com/vesoft-inc/nebula-console/releases/download/v3.8.0/nebula-console-linux-amd64-v3.8.0

2. 执行安装

使用 yum 命令完成安装。

sudo yum install -y nebula-graph-3.1.0.el7.x86_64.rpm

3. 启动服务并检查状态

安装完成后，使用 NebulaGraph 提供的脚本启动所有相关服务，并通过 status 命令查看服务的运行状态。

[shawnyan@el7 ~]$ sudo /usr/local/nebula/scripts/nebula.service start all
[WARN] The maximum files allowed to open might be too few: 1024
[INFO] Starting nebula-metad...
[INFO] Done
[INFO] Starting nebula-graphd...
[INFO] Done
[INFO] Starting nebula-storaged...
[INFO] Done
[shawnyan@el7 ~]$ sudo /usr/local/nebula/scripts/nebula.service status all
[WARN] The maximum files allowed to open might be too few: 1024
[INFO] nebula-metad(33fd35e): Running as 2501, Listening on 9559
[INFO] nebula-graphd(33fd35e): Running as 2570, Listening on 9669
[INFO] nebula-storaged(33fd35e): Running as 2602, Listening on 9779
[shawnyan@el7 ~]$

4. 连接到 NebulaGraph

赋予控制台工具可执行权限，并运行该工具，即可连接到本地的 NebulaGraph 实例。

[shawnyan@el7 ~]$ chmod +x nebula-console-linux-amd64-v3.8.0
[shawnyan@el7 ~]$ ./nebula-console-linux-amd64-v3.8.0
Notice: Defaulting to localhost (127.0.0.1) with port 9669 using credentials (username: root, password: nebula).

Welcome!

(root@nebula) [(none)]> show hosts;
+-------------+------+-----------+----------+--------------+---------------------+------------------------+---------+
| Host        | Port | HTTP port | Status   | Leader count | Leader distribution | Partition distribution | Version |
+-------------+------+-----------+----------+--------------+---------------------+------------------------+---------+
| "127.0.0.1" | 9779 | 19669     | "ONLINE" | 100          | "my_space_1:100"    | "my_space_1:100"       | "3.1.0" |
+-------------+------+-----------+----------+--------------+---------------------+------------------------+---------+
Got 1 rows (time spent 2.097ms/2.728015ms)

Mon, 10 Mar 2025 12:34:56 CST

(root@nebula) [(none)]>

▌三、14 天免费试用 NebulaGraph Cloud on AWS

NebulaGraph Cloud 是一项完全托管的云数据库服务，支持原生 GQL，全天候 24*7 可用，安全可靠，按需付费，提供多种规格选项，注册账号即刻享受服务，突破物理环境的局限。

注册地址：https://cloud.nebula-graph.io/login

目前，NebulaGraph Cloud 提供 14 天免费试用，在 2025 年 4 月之前订阅可享受 6 个月的特别折扣。

注册成功后，登陆管理界面，创建数据库。

云提供商默认为 AWS，可用区默认为 us-east-2。稍等片刻，数据库创建成功。

使用 NebulaGraph Studio 连接到数据库，并写入、查看测试数据。

NebulaGraph Cloud 提供了丰富的观测指标，用户可以在管理界面中实时监控数据库的运行状态，包括性能指标、资源利用率等。

▌四、总结‍‍

以上三种方案各有优势，涵盖本地开发与云端部署场景，除以上部署方式外，NebulaGraph 还支持分布式集群部署，大家可按需选择。

方案	场景	优势	注意事项
NebulaGraph Desktop	本地开发、图形化操作	一键部署，集成工具链	需安装 Docker Desktop
单机版部署	Linux 服务器部署	纯命令行控制，资源占用低	需手动维护服务
NebulaGraph Cloud	基于 AWS，出海必备	免运维，弹性伸缩	可用区较少

祝你在 NebulaGraph 图数据库之旅玩得开心～

‍