Neo4j 图数据库安装教程（2024最新版）—— Windows / Linux / macOS 全平台指南

Neo4j 图数据库安装教程（2024最新版）—— Windows / Linux / macOS 全平台指南

Neo4j 是目前最流行的图数据库（Graph Database），广泛应用于社交网络、推荐系统、知识图谱等领域。本文将详细介绍 Windows、Linux 和 macOS 三大平台的 Neo4j 安装方法，并包含配置优化、基础使用示例和常见问题解决。

一、Neo4j 简介

1. 什么是 Neo4j？

Neo4j 是一个高性能的 NoSQL 图数据库，使用 Cypher 查询语言，以节点（Node）、**关系（Relationship）和属性（Property）**存储数据，适合处理复杂关联关系。

2. 适用场景

✅ 社交网络分析
✅ 实时推荐引擎
✅ 欺诈检测
✅ 知识图谱构建

二、安装 Neo4j（社区版）

Neo4j 提供 Community（免费） 和 Enterprise（企业版），本教程以 Community Edition 为例。

1. Windows 安装

方法1：直接下载安装包（推荐）

1. 下载 Neo4j

   • 访问官网：https://neo4j.com/download-center/
   • 选择 Community Edition → Windows 版本（.msi 安装包）。

2. 运行安装向导

   • 双击 .msi 文件，按提示安装（默认路径 C:\Program Files\Neo4j）。
   • 勾选 “Install Neo4j as a Service”（可选，作为后台服务运行）。

3. 启动 Neo4j

   • 安装完成后，打开 Neo4j Desktop 或运行：

     neo4j console
     

   • 访问管理界面：http://localhost:7474
     • 默认用户名：neo4j
     • 默认密码：neo4j（首次登录需修改）。

方法2：Docker 安装（适合开发者）

docker run --name neo4j -p 7474:7474 -p 7687:7687 -v neo4j_data:/data -e NEO4J_AUTH=neo4j/password123 neo4j:latest

访问：http://localhost:7474

2. Linux 安装（Ubuntu/CentOS）

方法1：APT/YUM 安装

# Ubuntu/Debian
wget -O - https://debian.neo4j.com/neotechnology.gpg.key | sudo apt-key add -
echo 'deb https://debian.neo4j.com stable latest' | sudo tee /etc/apt/sources.list.d/neo4j.list
sudo apt update
sudo apt install neo4j

# CentOS/RHEL
sudo rpm --import https://debian.neo4j.com/neotechnology.gpg.key
cat <<EOF | sudo tee /etc/yum.repos.d/neo4j.repo
[neo4j]
name=Neo4j RPM Repository
baseurl=https://yum.neo4j.com/stable
enabled=1
gpgcheck=1
EOF
sudo yum install neo4j

启动服务：

sudo systemctl enable neo4j
sudo systemctl start neo4j

访问：http://localhost:7474

方法2：手动下载.tar.gz

wget https://neo4j.com/artifact.php?name=neo4j-community-5.12.0-unix.tar.gz
tar -xf neo4j-community-5.12.0-unix.tar.gz
cd neo4j-community-5.12.0
./bin/neo4j start

3. macOS 安装

方法1：Homebrew 安装（推荐）

brew install neo4j
brew services start neo4j

访问：http://localhost:7474

方法2：Docker

docker run --name neo4j -p 7474:7474 -p 7687:7687 -v ~/neo4j/data:/data -e NEO4J_AUTH=neo4j/password123 neo4j

三、Neo4j 基础使用

1. 登录管理界面

• 浏览器打开：http://localhost:7474
• 输入用户名/密码（默认 neo4j/neo4j）。

2. 运行第一个 Cypher 查询

CREATE (a:Person {name: 'Alice', age: 30})-[:FRIENDS_WITH]->(b:Person {name: 'Bob', age: 25})
RETURN a, b

执行后，数据库会创建两个节点和一条关系。

3. 常用命令

四、配置优化

1. 修改默认端口

编辑 conf/neo4j.conf：

dbms.connector.bolt.listen_address=:7687
dbms.connector.http.listen_address=:7474

2. 调整 JVM 内存

修改 conf/neo4j.conf：

dbms.memory.heap.initial_size=2G
dbms.memory.heap.max_size=4G

3. 开启远程访问

dbms.connector.bolt.advertised_address=0.0.0.0:7687
dbms.connector.http.advertised_address=0.0.0.0:7474

五、常见问题

1. 无法访问 7474 端口

• 检查防火墙：

  sudo ufw allow 7474  # Ubuntu
  sudo firewall-cmd --add-port=7474/tcp --permanent  # CentOS
  

• 确保 Neo4j 服务已启动：

  neo4j status
  

2. 忘记密码

neo4j-admin dbms set-initial-password newpassword

3. 数据存储位置

• 默认路径：
  • Linux/macOS: /var/lib/neo4j/data
  • Windows: C:\Program Files\Neo4j\data

六、总结

本文详细介绍了 Windows/Linux/macOS 安装 Neo4j 的方法，并提供了基础使用和优化建议。

• 新手推荐：Windows/macOS 直接安装包或 Docker。
• 生产环境：Linux + 手动配置优化。

下一步学习：

• Neo4j 官方文档
• Cypher 查询语言教程

如果有问题，欢迎在评论区留言！ 🚀