1.3 环境搭建与安装

1.3 环境搭建与安装

Neo4j环境搭建与安装详解 (1.3 环境搭建与安装)

1.3 环境搭建与安装

欢迎来到Neo4j图数据库的世界！在您开始构建强大的图应用之前，第一步也是至关重要的一步，就是搭建并安装Neo4j环境。本篇文章将作为 Neo4j 基础领域 的 1.3 环境搭建与安装 部分，为您提供详尽的指导，确保您能够顺利地在本地或服务器上部署 Neo4j，并开始您的图数据库之旅。

我们将涵盖以下内容：

• 1.3.1 环境准备： 了解安装 Neo4j 前的必要准备工作，包括操作系统和 Java 环境。

• 1.3.2 Neo4j 下载与安装： 详细介绍不同 Neo4j 版本（社区版、企业版）的下载方式，以及针对不同操作系统（Windows、macOS、Linux）的安装步骤。

• 1.3.3 Neo4j 启动与访问： 学习如何启动 Neo4j 服务，并使用 Neo4j Browser 访问数据库，进行初步操作。

• 1.3.4 Neo4j 配置详解 (基础)： 简要介绍 Neo4j 配置文件 neo4j.conf 的基本配置项，为后续深入学习打下基础。

• 1.3.5 代码实践与验证： 通过简单的 Cypher 代码示例，验证 Neo4j 环境是否安装成功，并进行初步的图数据操作。

1.3.1 环境准备

在开始安装 Neo4j 之前，我们需要确保您的系统满足一些基本要求。Neo4j 是基于 Java 开发的，因此 Java 环境 是运行 Neo4j 的先决条件。

1. Java 环境 (Java Development Kit - JDK)

• 版本要求: Neo4j 通常需要 Java 11 或更高版本。建议使用 Java 11 或 Java 17，这两个版本都是长期支持 (LTS) 版本，拥有更好的稳定性和安全性。 您可以访问 Oracle 官网 或 OpenJDK 官网 下载适合您操作系统的 JDK 版本。

• 验证 Java 安装: 安装完成后，打开命令行终端（Windows 的命令提示符或 PowerShell，macOS/Linux 的 Terminal），输入以下命令并回车：

  java -version
  javac -version
  ​

  如果正确安装了 JDK，您应该能看到 Java 和 Javac 的版本信息输出，类似于：

  java version "17.0.2" 2022-01-18 LTS
  Java(TM) SE Runtime Environment (build 17.0.2+8-LTS-86)
  Java HotSpot(TM) 64-Bit Server VM (build 17.0.2+8-LTS-86, mixed mode, sharing)
  javac 17.0.2
  ​

  如果提示找不到命令或版本过低，请检查您的 Java 安装是否正确，并配置了环境变量。

2. 操作系统兼容性

Neo4j 支持多种操作系统，包括：

• Windows: Windows 10 或更高版本 (64位)

• macOS: macOS 10.15 (Catalina) 或更高版本

• Linux: 多种 Linux 发行版，如 Ubuntu, CentOS, Debian 等 (64位)

请确保您的操作系统是 64 位版本，并且是 Neo4j 支持的操作系统。

3. 硬件要求 (建议)

虽然 Neo4j 对硬件要求不高，但为了获得更好的性能，建议您至少具备以下配置：

• 内存 (RAM): 至少 4GB 内存，建议 8GB 或以上，尤其是在处理大型图数据时。

• 磁盘空间: 根据您的数据量需求，预留足够的磁盘空间。安装 Neo4j 本身需要一定的空间，同时数据存储也需要空间。

• 处理器 (CPU): 多核处理器能够提升 Neo4j 的查询性能。

环境准备 Mermaid 图示:

1.3.2 Neo4j 下载与安装

Neo4j 提供了多种安装方式，您可以根据自己的需求和技术水平选择合适的方式。 主要有以下几种方式：

• Neo4j Desktop: 官方推荐的 图形化界面管理工具，适用于开发、学习和本地测试。它集成了 Neo4j 服务器、Neo4j Browser 和各种工具，操作简单直观，非常适合初学者。

• Standalone Server (独立服务器): 传统的 命令行方式安装，适用于服务器环境或需要更精细控制的用户。您可以直接下载 Neo4j 服务器的压缩包，解压后通过命令行启动和管理。

• Docker: 使用 Docker 容器 部署 Neo4j，适用于容器化环境和快速部署。

• Cloud Services (云服务): 利用云服务提供商提供的 Neo4j 服务，如 Neo4j AuraDB，无需自行安装和维护，适用于生产环境。

在本篇文章中，我们将重点介绍 Neo4j Desktop 和 Standalone Server 两种最常用的安装方式。

1.3.2.1 Neo4j Desktop 安装

1. 下载 Neo4j Desktop:

访问 Neo4j 官网下载页面 ，选择 Neo4j Desktop 下载适合您操作系统的版本（Windows, macOS, Linux）。

2. 安装 Neo4j Desktop:

• Windows: 下载 .exe 安装包，双击运行，按照安装向导的提示进行安装，通常只需点击“下一步”即可完成安装。

• macOS: 下载 .dmg 镜像文件，双击打开，将 Neo4j Desktop 图标拖拽到 "Applications" 文件夹即可完成安装。

• Linux: 下载 .AppImage 文件，您可能需要赋予该文件执行权限 (例如 chmod +x neo4j-desktop-*.AppImage)，然后双击运行即可。

3. 启动 Neo4j Desktop:

安装完成后，在您的应用程序列表或启动台中找到 "Neo4j Desktop" 图标，点击启动。

4. 创建 Neo4j 数据库实例:

首次启动 Neo4j Desktop，您需要创建一个 Neo4j 数据库实例。

• 点击 "Create" 按钮。

• 选择 "Local DBMS"。

• 输入数据库实例名称 (例如 "neo4j-demo")。

• 设置数据库密码 (请务必记住密码)。

• 选择 Neo4j 版本 (建议选择最新稳定版本)。

• 点击 "Create" 按钮。

Neo4j Desktop 将会自动下载并配置您选择的 Neo4j 版本，并创建一个新的数据库实例。

Neo4j Desktop 安装流程 Mermaid 图示:

1.3.2.2 Standalone Server 安装

1. 下载 Neo4j Standalone Server:

访问 Neo4j 官网下载页面 ，选择 Neo4j Community Server （社区版）或 Neo4j Enterprise Server （企业版，需要许可证）。 下载适合您操作系统的压缩包 (.zip for Windows, .tar.gz for macOS/Linux)。 社区版对于学习和个人项目已经足够使用。

2. 解压压缩包:

• Windows: 将下载的 .zip 文件解压到您希望安装 Neo4j 的目录，例如 C:\neo4j.

• macOS/Linux: 使用 tar -xzf neo4j-community-*.tar.gz 命令解压 .tar.gz 文件到您希望安装 Neo4j 的目录，例如 /opt/neo4j.

3. 配置环境变量 (可选但建议):

为了方便在命令行中直接使用 Neo4j 命令，您可以将 Neo4j 的 bin 目录添加到系统环境变量 PATH 中。

• Windows:

  • 打开 "系统属性" -> "高级" -> "环境变量"。

  • 在 "系统变量" 中找到 "Path" 变量，点击 "编辑"。

  • 点击 "新建"，添加 Neo4j bin 目录的路径，例如 C:\neo4j\bin (根据您的实际解压路径修改)。

  • 点击 "确定" 保存更改。

• macOS/Linux:

  • 打开终端，编辑 ~/.bash_profile 或 ~/.zshrc 文件 (根据您使用的 Shell)。

  • 在文件末尾添加以下行 (根据您的实际解压路径修改)：

    export NEO4J_HOME=/opt/neo4j  # 例如您的 Neo4j 解压目录
    export PATH=$PATH:$NEO4J_HOME/bin
    ​

  • 保存文件，并执行 source ~/.bash_profile 或 source ~/.zshrc 命令使环境变量生效。

4. 修改配置文件 (可选，但建议修改密码):

打开 Neo4j 安装目录下的 conf/neo4j.conf 文件。 您可以使用文本编辑器打开，例如 Notepad++ (Windows), TextEdit (macOS), nano/vim (Linux)。

• 修改默认密码: 找到 #dbms.default_listen_address=0.0.0.0 和 #dbms.default_advertised_address=localhost 这两行配置，取消注释（移除行首的 # 符号），并根据需要修改监听地址和广播地址 (通常默认即可)。

• 设置初始密码: 找到 #dbms.security.auth_enabled=true 这行，取消注释，并修改下一行 #dbms.security.default_admin_password=password 中的 password 为您自己的初始密码。 例如： dbms.security.default_admin_password=your_strong_password 。 请务必修改默认密码，提高安全性!

Standalone Server 安装流程 Mermaid 图示:

1.3.3 Neo4j 启动与访问

1.3.3.1 启动 Neo4j

Neo4j Desktop:

• 在 Neo4j Desktop 界面中，找到您创建的数据库实例。

• 点击数据库实例右侧的 "Start" 按钮。

• 等待数据库实例状态变为 "Running"，表示 Neo4j 服务已成功启动。

Standalone Server:

• 打开命令行终端，进入 Neo4j 安装目录的 bin 目录。

• Windows: 执行 neo4j.bat console 命令。

• macOS/Linux: 执行 ./neo4j console 命令。

  您也可以使用后台启动方式，例如：

  • Windows: neo4j.bat start

  • macOS/Linux: ./neo4j start

  使用 console 启动会在终端显示 Neo4j 的日志信息，方便查看启动过程。使用 start 启动会在后台运行，不占用终端窗口。

1.3.3.2 访问 Neo4j Browser

Neo4j Browser 是 Neo4j 官方提供的 Web 图形界面工具，用于与 Neo4j 数据库进行交互，执行 Cypher 查询，可视化图数据，管理数据库等。

Neo4j Desktop:

• 在 Neo4j Desktop 界面中，找到您运行中的数据库实例。

• 点击数据库实例右侧的 "Browser" 按钮。

• Neo4j Browser 将会在您的默认浏览器中自动打开。

Standalone Server:

• 打开您的浏览器，访问 URL: http://localhost:7474 (默认地址)。

• 如果您修改了配置文件中的端口，请使用您配置的端口。

登录 Neo4j Browser:

首次访问 Neo4j Browser，您需要进行登录。

• 用户名: 默认用户名是 neo4j。

• 密码:

  • Neo4j Desktop: 您在创建数据库实例时设置的密码。

  • Standalone Server: 如果您没有修改默认密码，则为 neo4j。如果您修改了 neo4j.conf 文件中的密码，则使用您设置的新密码。

首次登录时，Neo4j Browser 会强制您 修改密码，请设置一个新的强密码并记住。

启动与访问流程 Mermaid 图示:

1.3.4 Neo4j 配置详解 (基础)

Neo4j 的主要配置文件是 neo4j.conf，位于 Neo4j 安装目录的 conf 文件夹下。 这个文件包含了大量的配置项，用于控制 Neo4j 服务器的各种行为，例如端口、内存、日志、安全等。

这里我们只介绍几个最基础和常用的配置项，更详细的配置将在后续章节深入讲解。

• dbms.connector.http.enabled=true 和 dbms.connector.bolt.enabled=true: 这两个配置项分别控制 HTTP 和 Bolt 连接器的启用状态。 Neo4j Browser 使用 HTTP 连接，Cypher 驱动程序 (例如 Java, Python 驱动) 通常使用 Bolt 连接。 默认情况下，这两个连接器都是启用的。

• dbms.connector.http.listen_address=:7474 和 dbms.connector.bolt.listen_address=:7687: 这两个配置项分别设置 HTTP 和 Bolt 连接器的 监听端口。 默认 HTTP 端口是 7474，默认 Bolt 端口是 7687。 如果端口被占用，您可以修改这些配置项来更改端口号。

• dbms.memory.heap.initial_size=512m 和 dbms.memory.heap.max_size=512m: 这两个配置项设置 Neo4j 服务器的 Java 堆内存 的初始大小和最大大小。 默认值通常为 512MB。 如果您的图数据量较大，或者查询比较复杂，您可能需要增加堆内存大小，以避免内存溢出错误。 建议根据实际情况和硬件资源进行调整。 例如： dbms.memory.heap.max_size=4g 表示设置最大堆内存为 4GB。

• dbms.directories.data=data 和 dbms.directories.logs=logs: 这两个配置项设置 Neo4j 数据文件和日志文件的存储目录。 默认情况下，数据文件存储在 data 目录，日志文件存储在 logs 目录，都位于 Neo4j 安装目录下。 您可以修改这些配置项，将数据和日志文件存储到其他位置。

• dbms.security.auth_enabled=true 和 dbms.security.default_admin_password=your_strong_password: 这两个配置项控制 身份验证 的启用状态和默认管理员密码。 dbms.security.auth_enabled=true 表示启用身份验证，需要用户名和密码才能访问数据库。 dbms.security.default_admin_password 设置默认管理员用户 neo4j 的密码。 强烈建议启用身份验证并设置强密码，保护您的数据库安全。

neo4j.conf 基础配置 Mermaid 图示:

1.3.5 代码实践与验证

安装并启动 Neo4j 后，我们通过一个简单的 Cypher 代码示例来验证环境是否搭建成功，并进行初步的图数据操作。

1. 打开 Neo4j Browser:

按照 1.3.3.2 节的步骤打开 Neo4j Browser 并登录。

2. 在 Cypher 编辑器中输入以下代码:

// 创建两个节点
CREATE (alice:Person {name: 'Alice', age: 30})
CREATE (bob:Person {name: 'Bob', age: 25})
// 创建一个关系连接这两个节点
CREATE (alice)-[:KNOWS]->(bob)
// 查询所有 Person 节点和 KNOWS 关系
MATCH (p:Person)-[r:KNOWS]->(friend:Person)
RETURN p, r, friend
​

3. 点击 "执行" 按钮 (或按 Ctrl+Enter / Cmd+Enter)。

4. 查看结果:

如果 Neo4j 环境安装成功，您应该能在 Neo4j Browser 的结果区域看到以下内容：

• Graph 视图: 会显示一个包含两个 Person 节点 (Alice, Bob) 和一个 KNOWS 关系的图。 您可以拖动节点，放大缩小，查看节点和关系的属性。

• Table/Text 视图: 会显示表格或文本形式的查询结果，包含节点和关系的详细信息。

代码实践验证 Mermaid 图示:

恭喜您! 如果您成功看到了上述结果，说明您已经成功搭建并安装了 Neo4j 环境，并且可以开始使用 Cypher 语言进行图数据操作了！

总结:

本篇文章详细介绍了 Neo4j 环境搭建与安装的步骤，包括环境准备、Neo4j Desktop 和 Standalone Server 的安装、Neo4j 的启动与访问、基础配置以及代码实践验证。 希望这份指南能够帮助您顺利地开始您的 Neo4j 图数据库之旅。 在后续的学习中，您将深入了解 Cypher 语言，数据建模，图算法，以及 Neo4j 的更多高级特性。 祝您学习愉快！