一、安装前准备
1. 安装 JDK 17
- 版本要求:Neo4j 5.26.4 需要 JDK 17 或更高版本,低于此版本会导致运行失败。
- 下载地址:
- 官方下载:Oracle JDK 17
- 备用网盘(若官网慢):JDK 17 提取码 vx71
- 安装步骤:
- 双击安装包,按提示选择安装路径(建议
D:\Java\jdk-17
)。 - 配置环境变量:
- 新建系统变量
JAVA_HOME
,值为 JDK 安装路径(如D:\Java\jdk-17
)。 - 在
Path
中添加%JAVA_HOME%\bin
。
- 新建系统变量
- 验证安装:命令行输入
java -version
,显示版本信息即成功。
- 双击安装包,按提示选择安装路径(建议
二、安装 Neo4j 5.26.4
1. 下载与解压
- 下载地址:
- 官网:Neo4j 社区版下载页
- 备用网盘(含 5.26.4 版本):Neo4j 网盘地址
- 解压步骤:
- 将压缩包解压至目标目录(路径建议简短且不含中文,如
D:\neo4j-community-5.26.4
)。
- 将压缩包解压至目标目录(路径建议简短且不含中文,如
2. 配置环境变量
- 设置
NEO4J_HOME
:- 变量名:
NEO4J_HOME
- 变量值:Neo4j 解压路径(如
D:\neo4j-community-5.26.4
)。
- 变量名:
- 配置
Path
:在系统变量Path
中添加%NEO4J_HOME%\bin
。
三、启动 Neo4j 服务
方式一:前台运行(临时测试)
- 以管理员身份打开命令行,输入:
neo4j console
- 当显示
Started
时,服务已启动。
方式二:后台服务(长期运行)
- 进入 Neo4j 的
bin
目录:cd D:\neo4j-community-5.26.4\bin
- 注册 Windows 服务:
neo4j windows-service install
- 启动/停止服务:
neo4j start # 启动 neo4j stop # 停止
注意:需允许系统弹窗权限。
四、验证安装
- 访问管理界面:
- 浏览器打开
http://localhost:7474
,默认用户名和密码均为neo4j
。 - 首次登录需修改密码(如
neo4j123
)。
- 浏览器打开
- 命令行验证:
neo4j status # 查看服务状态
五、常见问题解决
- 端口冲突:
- 检查
7474
(HTTP)和7687
(Bolt)端口是否被占用。
- 检查
- 环境变量错误:
- 确保
NEO4J_HOME
和Path
配置正确。
- 确保
- 无法访问管理界面:
- 关闭防火墙或放行相关端口。
六、高级配置(可选)
- 修改监听地址:
- 编辑
conf/neo4j.conf
,取消注释并修改:dbms.default_listen_address=0.0.0.0 # 允许远程访问
- 编辑
- 优化内存设置:
- 调整
server.memory.heap.initial_size
和server.memory.heap.max_size
以适应硬件性能。
- 调整
- 安装 APOC 插件:
- 下载与 Neo4j 5.26 兼容的 APOC 版本,放入
plugins
目录并重启服务。
- 下载与 Neo4j 5.26 兼容的 APOC 版本,放入