Neo4j5.x 社区版安装、配置指南（Windows & Linux）

一、环境准备

1. 系统要求

• 操作系统：
  • Windows 10/11
  • Linux（Ubuntu/CentOS 等）
• 内存：
  • 最低 2GB，推荐 8GB 及以上（处理大数据需更高配置）
• JDK 版本：
  • Neo4j 5.x 需 JDK 17（LTS 版本）
  • （低版本 Neo4j 如 4.x 可能需 JDK 11）

2. 下载资源

• JDK：
  • Oracle JDK 17
  • OpenJDK 17
• Neo4j 社区版：
  • 官网下载地址

---

二、Windows 安装步骤

1. 安装 JDK

1. 运行 JDK 安装程序（默认路径：C:\Program Files\Java\jdk-17.x.x）
2. 配置环境变量：
   • 新建系统变量 JAVA_HOME → 值设为 JDK 安装路径（如 C:\Program Files\Java\jdk-17.0.7）
   • 编辑 Path → 添加 %JAVA_HOME%\bin
3. 验证安装：

   java -version  # 应显示 JDK 17.x.x
   

2. 安装 Neo4j

1. 解压 neo4j-community-x.x.x-windows.zip 到非系统盘（如 D:\neo4j）
2. 配置环境变量：
   • 新建系统变量 NEO4J_HOME → 值设为解压路径（如 D:\neo4j\neo4j-community-5.15.0）
   • 编辑 Path → 添加 %NEO4J_HOME%\bin

3. 启动 Neo4j

# 控制台模式启动（关闭窗口即停止服务）
neo4j.bat console

# 或安装为系统服务
neo4j.bat install-service
neo4j.bat start

4. 访问管理界面

• 浏览器打开 http://localhost:7474
• 首次登录使用默认账号 neo4j/neo4j，按提示修改密码

---

三、Linux 安装步骤（以 Ubuntu 为例）

1. 安装 JDK

# 解压 JDK 到 /opt 目录
sudo tar -xzf jdk-17_linux-x64_bin.tar.gz -C /opt/

# 配置环境变量
echo 'export JAVA_HOME=/opt/jdk-17.0.7' | sudo tee -a /etc/profile
echo 'export PATH=$JAVA_HOME/bin:$PATH' | sudo tee -a /etc/profile
source /etc/profile

2. 安装 Neo4j

# 解压 Neo4j 到 /opt 目录
sudo tar -xzf neo4j-community-x.x.x-unix.tar.gz -C /opt/

# 配置环境变量
echo 'export NEO4J_HOME=/opt/neo4j-community-5.15.0' | sudo tee -a /etc/profile
echo 'export PATH=$NEO4J_HOME/bin:$PATH' | sudo tee -a /etc/profile
source /etc/profile

3. 修改配置文件（可选）

编辑 $NEO4J_HOME/conf/neo4j.conf：

dbms.default_listen_address=0.0.0.0    # 允许远程访问
dbms.connector.bolt.listen_address=:7687  # Bolt 协议端口
dbms.connector.http.listen_address=:7474  # HTTP 端口

4. 启动服务

# 控制台模式启动
neo4j console

# 或后台服务模式
neo4j start

---

四、常见问题解决

问题类型	解决方案
端口冲突	修改 neo4j.conf 中的 7474 或 7687 端口
内存不足	在 neo4j.conf 中调整： dbms.memory.heap.initial_size=2g dbms.memory.heap.max_size=4g
远程连接失败	确保防火墙开放端口，且配置文件中设置 dbms.default_listen_address=0.0.0.0

---

五、验证安装成功

1. 命令行验证：

   neo4j version  # 显示 Neo4j 版本
   

2. 浏览器验证：
   • 访问 http://localhost:7474，成功进入 Neo4j Browser 即表示安装成功

> **提示**：生产环境建议使用 JDK 17 长期支持版本，并通过 `jcmd <pid> VM.flags` 监控 JVM 内存状态。