系统要求
在开始安装之前,请确保你的系统满足以下要求: 操作系统:Windows 10/11 (64 位) 内存:至少 4GB RAM(推荐 8GB 以上) 磁盘空间:至少 20GB 可用空间 Java 版本:JDK 11 或更高版本
如下是 Neo4j 版本对应的 JDK 版本:
| Neo4j 版本 | 官方推荐 JDK 版本 |
|---|---|
| 4.4.46 | JDK 11 |
| 5.26.13 | JDK 17 |
| 2025.09.0 | JDK 21 |
本文以 5.26.13 为例进行讲解。
安装 Java 环境
Neo4j 需要 Java 运行环境,如果未安装请按以下步骤操作:
步骤 1:检查 Java 版本
按下 Win + R 打开运行对话框,输入 cmd 并回车打开命令提示符。
在命令提示符中输入以下命令:
java -version
如果显示 Java 版本信息且版本号大于等于 11,可以跳过 Java 安装步骤。如果没有安装 Java 或版本过低,请继续下面的步骤。
步骤 2:下载 Java JDK
访问 Oracle 官网或 OpenJDK 官网下载 Java JDK: Oracle JDK:https://www.oracle.com/java/technologies/downloads/ OpenJDK:https://jdk.java.net/
进入官网后下滑找到 Java17,下载适配 Windows 系统的 exe 安装程序。

选择适合 Windows 的版本进行下载(推荐下载 JDK 17)。
步骤 3:安装 Java JDK
双击下载的 JDK 安装包,按照安装向导进行安装,建议使用默认安装路径。

安装完成,exe 程序安装后会自动配置环境变量,无需手动设置。

打开一个新的命令提示符,验证 Java 安装:
java -version
javac -version

下载 Neo4j
步骤 1:访问官方网站下载 Neo4j
打开浏览器,访问 Neo4j 官方网站:https://neo4j.com/deployment-center/
进入后往下滑进行下载。本教程下载的是 Neo4j 5+ 版本,所以 JDK 版本需要是 17。

步骤 2:解压 Neo4j
建议解压到简单路径,如:C:\neo4j。

启动 Neo4j 服务
步骤 1:以管理员身份打开命令提示符
搜索"cmd",右键选择"以管理员身份运行"。

步骤 2:导航到 Neo4j 的 bin 目录
此时我们需要导航到 Neo4j 的 bin 目录,我的 Neo4j 目录在 C:\neo4j\neo4j-community-2025.09.0\bin。
cd C:\neo4j\neo4j-community-5.26.13\bin
步骤 3:安装 Neo4j 服务
安装 Neo4j 之前,要确保已安装 Java。
# Neo4j 5+版本的安装命令
neo4j.bat windows-service install
# Neo4j 4+版本的安装命令
neo4j.bat install-service
如果成功,会显示服务安装成功的消息。

步骤 4:启动 Neo4j 服务
neo4j.bat start
等待几秒钟,服务启动成功后会显示相关信息。

步骤 5:验证服务状态
neo4j.bat status
如果显示"Neo4j is running",说明服务已成功启动。

访问 Neo4j
在地址栏输入:http://localhost:7474 进行访问。
首次登录会看到 Neo4j 浏览器登录界面,默认用户名 neo4j,默认密码 neo4j,输入后点击 Connect 连接。

登录成功后,系统会要求修改密码,填写密码后点击 Change Password 更新密码。

成功登录后,可以看到 Neo4j 浏览器的主界面。

基本操作和配置
登录成功后,创建一些示例数据来验证 Neo4j 是否正常工作。 在 Neo4j 浏览器的查询框中输入以下 Cypher 语句:
// 创建节点和关系
CREATE (alice:Person {name: 'Alice', age: 30})
CREATE (bob:Person {name: 'Bob', age: 25})
CREATE (charlie:Person {name: 'Charlie', age: 35})
CREATE (alice)-[:KNOWS]->(bob)
CREATE (bob)-[:KNOWS]->(charlie)
CREATE (alice)-[:KNOWS]->(charlie)

执行以下查询来查看刚创建的数据:
MATCH (n:Person)-[r:KNOWS]->(m:Person) RETURN n, r, m
执行后,可以看到一个图形化的可视化界面,显示人物节点和他们之间的关系。

常用管理命令
以下是服务管理命令:
# 停止 Neo4j 服务
neo4j.bat stop
# 重启 Neo4j 服务
neo4j.bat restart
# 卸载 Neo4j 服务
neo4j.bat windows-service uninstall
# 查看服务状态
neo4j.bat status
配置文件修改
Neo4j 的主要配置文件位于:\conf\neo4j.conf
# 修改默认端口(默认 7474)
server.http.listen_address=:7474
# 启用 HTTPS(可选)
server.https.enabled=true
server.https.listen_address=:7473
# 设置数据库存储路径
server.directories.data=data
# 设置日志级别
server.logs.config=conf/user-logs.xml
修改配置后需要重启服务:
neo4j.bat restart
常见问题解决
问题 1:端口被占用
如果 7474 端口被占用,可以:
- 修改配置文件中的端口号
- 或者找到占用端口的程序并关闭
# 查看端口占用情况
netstat -ano | findstr :7474
# 强制结束该进程
taskkill /PID 进程 PID /F
问题 2:Java 版本不匹配
确保 Java 版本与 Neo4j 版本匹配:
- Neo4j 5.x 需要 JDK 17+
- Neo4j 4.x 需要 JDK 11+
问题 3:服务启动失败
检查日志文件:\logs\neo4j.log
常见原因:
- 权限不足(需要管理员权限)
- 端口冲突
- Java 环境配置问题


