NEO4J图数据库入门安装指南

0x33012

509人浏览 · 2026-05-28 10:51:19

0x33012 · 2026-05-28 10:51:19 发布

安装指南：

推荐采用docker安装

一、Neo4j 安装

1. 下载 Neo4j

官方安装包下载页：
🔗 Neo4j Desktop Download | Free Graph Database Download

你可以选择：

Neo4j Desktop（图形化界面，适合开发学习）
Neo4j Community/Enterprise Server（生产或自定义部署）
Neo4j AuraDB 云实例（无需安装，可在线使用）

2. Neo4j Desktop 安装（Windows/macOS/Linux）

官方安装及说明文档：
🔗 Installation - Neo4j Desktop

基本步骤（以 Desktop 为例）：

下载 Neo4j Desktop 客户端。
运行安装程序并完成安装。
启动 Neo4j Desktop，创建一个 Local DBMS 实例。
设置数据库密码并启动服务。(Graph Database & Analytics)

3. 在 Linux/macOS 使用二进制或包安装

macOS 安装说明（包含环境配置）：
🔗 macOS 安装- 操作手册
在 Ubuntu 上用官方源安装 Neo4j：
🔗 Neo4j Graph Database: Installing Neo4j on Ubuntu 20.04

这些方法适合不使用 Desktop，而是以服务器方式启动 Neo4j。(neo4j.ac.cn)

Neo4j Docker 安装指南

1. 官方 Docker 镜像与文档

Neo4j 提供官方 Docker 镜像，可以在任何支持 Docker 的环境（Linux/macOS/Windows）上快速运行 Neo4j。
Docker 官方镜像页面：
🔗 Neo4j Official Image（Docker Hub） (Docker Hub)

官方 Docker 安装与使用说明：
🔗 Neo4j Docker 操作手册 - 官方文档 (Graph Database & Analytics)

2. 使用 Docker 命令启动 Neo4j

基本启动命令

在 terminal（终端）执行：

docker run \
    --publish=7474:7474 \
    --publish=7687:7687 \
    --volume=$HOME/neo4j/data:/data \
    --env NEO4J_AUTH=neo4j/your_password \
    neo4j

7474：HTTP Web 浏览器界面端口
7687：Bolt 协议端口（用于驱动连接，如 Python/Java）
NEO4J_AUTH=neo4j/your_password：设置默认用户密码
--volume：把本地目录挂载到容器的 /data 下以便持久化数据
默认登录账号是：admin/neo4j（运行后需修改密码） (Docker Hub)

启动后，用浏览器访问：
🔗 http://localhost:7474
进行登录并设置密码即可。

3. 设置 Neo4j 密码与关掉认证

设置初始密码（在上面命令里用 NEO4J_AUTH=neo4j/your_password 即可）
禁用认证用于测试环境（不建议用于生产）：

--env NEO4J_AUTH=none

这会允许你无需账号密码直接访问。 (Graph Database & Analytics)

4. 持久化数据与挂载卷

要让 Neo4j 数据库在容器停止后不会丢失，请挂载数据卷：

docker run \
    -p 7474:7474 \
    -p 7687:7687 \
    --env NEO4J_AUTH=neo4j/your_password \
    --volume /path/to/local/neo4j/data:/data \
    neo4j

或者用 Docker named volume：

docker volume create neo4jdata

docker run \
    -p 7474:7474 -p 7687:7687 \
    --env NEO4J_AUTH=neo4j/your_password \
    --volume neo4jdata:/data \
    neo4j

这保证你每次启动容器时数据不会丢失。 (Graph Database & Analytics)

5. 使用 Docker Compose 管理 Neo4j

你也可以使用 docker-compose 来启动 Neo4j：

示例 docker-compose.yml

version: '3.8'

services:
  neo4j:
    image: neo4j
    ports:
      - "7474:7474"
      - "7687:7687"
    environment:
      - NEO4J_AUTH=neo4j/your_password
    volumes:
      - ./data:/data

运行：

docker-compose up -d

这样可以更方便管理容器生命周期。 (Graph Database & Analytics)

6. 常用 Docker 操作

🔹 查看运行容器

docker ps

🔹 进入 Neo4j 容器执行命令

比如使用 bash 或管理命令：

docker exec -it <container_name> bash

或者执行 cypher-shell：

docker exec -it <container_name> cypher-shell -u neo4j -p your_password

这方便你从容器内部管理 Neo4j 数据库。 (Graph Database & Analytics)

🔗 官方文档 & 参考资源

资源	链接
Neo4j Docker 官方文档	https://neo4j.com/docs/operations-manual/current/docker/(Graph Database & Analytics)
Neo4j DockerHub 官方镜像	https://hub.docker.com/_/neo4j(Docker Hub)
Docker 持久化说明	https://neo4j.com/docs/operations-manual/current/docker/mounting-volumes/(Graph Database & Analytics)

二、用 Python 开发 Neo4j 应用

1. 官方 Python 驱动指南（安装 & 快速使用）

Neo4j 官方 Python 驱动文档：
🔗 Build applications with Neo4j and Python - Manual

安装驱动

pip install neo4j

支持 Python ≥ 3.7。(Graph Database & Analytics)

Python 连接 Neo4j 示例

from neo4j import GraphDatabase

URI = "neo4j://localhost:7687"
AUTH = ("neo4j", "你的密码")

with GraphDatabase.driver(URI, auth=AUTH) as driver:
    driver.verify_connectivity()
    print("Connected!")

这段代码创建驱动并验证连接是否成功。(Graph Database & Analytics)

2. 推荐快速教程（完整示例）

官方入门教程（含项目结构、查询示例等）：
🔗 Get Started with Neo4j and Python

它包含：

项目结构
虚拟环境配置
查询执行示例
参数化 Cypher 查询语法示例
（包含完整示例代码）(Graph Database & Analytics)

三、用 Java 开发 Neo4j 应用

1. 官方 Java 驱动指南

Neo4j 官方 Java 驱动文档：
🔗 Build applications with Neo4j and Java - Manual

加入依赖（Maven）示例：

<dependency>
    <groupId>org.neo4j.driver</groupId>
    <artifactId>neo4j-java-driver</artifactId>
    <version>6.1.0</version>
</dependency>

（版本号可根据最新文档调整）(Graph Database & Analytics)

2. Java 连接与查询示例

import org.neo4j.driver.AuthTokens;
import org.neo4j.driver.GraphDatabase;
import org.neo4j.driver.Driver;

public class Neo4jApp {
    public static void main(String[] args) {
        try (Driver driver = GraphDatabase.driver(
                "neo4j://localhost:7687",
                AuthTokens.basic("neo4j", "你的密码"))) {
            driver.verifyConnectivity();
            System.out.println("Connected!");
        }
    }
}

这段代码展示了创建 Java 驱动并建立连接的基本流程。(Graph Database & Analytics)