跳到主要内容

安装与配置

Neo4j 支持多种安装方式，包括桌面版、服务器版和 Docker 部署。本章将介绍不同平台的安装方法。

Neo4j Desktop（推荐用于学习）​

Neo4j Desktop 是一个图形化管理工具，适合本地开发和测试。

下载安装​

  1. 访问 Neo4j 下载页面
  2. 下载 Neo4j Desktop（需要免费注册账号）
  3. 运行安装程序，按向导完成安装

创建数据库​

  1. 打开 Neo4j Desktop
  2. 点击 "New" → "Create a Local Graph"
  3. 设置数据库名称和密码
  4. 点击 "Create" 创建数据库
  5. 点击 "Start" 启动数据库
  6. 点击 "Open" 打开 Neo4j Browser

服务器版安装​

Windows 安装​

  1. 下载 Windows 版安装包（.zip 文件）
  2. 解压到目标目录，如 C:\neo4j
  3. 配置环境变量：
# 添加 NEO4J_HOME 环境变量
[Environment]::SetEnvironmentVariable("NEO4J_HOME", "C:\neo4j", "Machine")

# 添加到 Path
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\neo4j\bin", "Machine")
  1. 安装并启动服务：
# 以管理员身份运行 PowerShell
neo4j install-service
neo4j start
  1. 访问 http://localhost:7474，默认账号密码都是 neo4j

Linux 安装（Ubuntu/Debian）​

# 添加 Neo4j 仓库
wget -O - https://debian.neo4j.com/neotechnology.gpg.key | sudo apt-key add -
echo 'deb https://debian.neo4j.com stable 5' | sudo tee /etc/apt/sources.list.d/neo4j.list

# 更新并安装
sudo apt-get update
sudo apt-get install neo4j

# 启动服务
sudo systemctl start neo4j
sudo systemctl enable neo4j

macOS 安装（使用 Homebrew）​

# 安装
brew install neo4j

# 启动服务
neo4j start

# 查看状态
neo4j status

Docker 部署​

使用 Docker 是最快捷的部署方式：

# 拉取镜像
docker pull neo4j:latest

# 运行容器
docker run -d \
  --name neo4j \
  -p 7474:7474 \
  -p 7687:7687 \
  -v $HOME/neo4j/data:/data \
  -v $HOME/neo4j/logs:/logs \
  -v $HOME/neo4j/import:/var/lib/neo4j/import \
  -e NEO4J_AUTH=neo4j/password \
  neo4j:latest

参数说明：

  • -p 7474:7474：HTTP/WebSocket 端口（Browser 界面）
  • -p 7687:7687：Bolt 协议端口（驱动连接）
  • -v：挂载数据卷，持久化数据
  • -e NEO4J_AUTH：设置初始用户名和密码

配置说明​

配置文件位置​

  • Windows：%NEO4J_HOME%\conf\neo4j.conf
  • Linux/macOS：/etc/neo4j/neo4j.conf
  • Docker：通过环境变量或挂载配置文件

常用配置项​

# 监听地址（默认只监听 localhost，如需远程访问需修改）
dbms.default_listen_address=0.0.0.0

# Bolt 端口
dbms.connector.bolt.enabled=true
dbms.connector.bolt.listen_address=:7687

# HTTP 端口
dbms.connector.http.enabled=true
dbms.connector.http.listen_address=:7474

# 内存配置（根据服务器配置调整）
dbms.memory.heap.initial_size=512m
dbms.memory.heap.max_size=2G
dbms.memory.pagecache.size=2G

# 日志级别
dbms.logs.debug.level=INFO

远程访问配置​

如需从其他机器访问 Neo4j：

  1. 修改 neo4j.conf：
dbms.default_listen_address=0.0.0.0
dbms.connector.bolt.advertised_address=服务器IP:7687
  1. 防火墙开放端口：
# Linux (ufw)
sudo ufw allow 7474/tcp
sudo ufw allow 7687/tcp
  1. 重启 Neo4j 服务

验证安装​

使用 Neo4j Browser​

  1. 打开浏览器访问 http://localhost:7474
  2. 使用用户名 neo4j 和设置的密码登录
  3. 在命令框输入测试查询：
RETURN "Hello, Neo4j!" AS message

使用命令行（cypher-shell）​

# 连接数据库
cypher-shell -u neo4j -p password

# 执行查询
neo4j@neo4j> RETURN "Hello, Neo4j!" AS message;

使用驱动连接​

Python 示例：

from neo4j import GraphDatabase

uri = "bolt://localhost:7687"
username = "neo4j"
password = "password"

driver = GraphDatabase.driver(uri, auth=(username, password))

with driver.session() as session:
    result = session.run("RETURN 'Hello, Neo4j!' AS message")
    print(result.single()["message"])

driver.close()

常见问题​

1. 端口被占用​

# 查找占用 7474 端口的进程
# Windows
netstat -ano | findstr :7474

# Linux/macOS
lsof -i :7474

2. 内存不足​

修改 neo4j.conf 中的内存配置：

dbms.memory.heap.initial_size=256m
dbms.memory.heap.max_size=1G

3. 无法远程连接​

检查：

  • 防火墙是否开放端口
  • dbms.default_listen_address 是否设置为 0.0.0.0
  • 认证信息是否正确

下一步​

安装完成后，继续学习 基础概念，了解 Neo4j 的核心数据模型。