槐肆寄渭? neo4j-community-5.26.0 服务配置结果
服务名称: neo4j
显示名称: Neo4j Graph Database - neo4j
状态: Running (运行中)
启动类型: Automatic (自动)
neo4j-community-5.26 登录界面
neo4j-community-5.26 登录成功
neo4j-community-5.26 查询知识图谱
?? 完整配置步骤
步骤 1:下载并解压 Neo4j
下载 Neo4j 压缩包
下载地址:https://we-yun.com/doc/neo4j/5.26.0/neo4j-community-5.26.0-windows.zip
文件大小:约 150-200 MB
解压到指定目录
解压位置:d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0
验证目录结构
neo4j-community-5.26.0/
├── bin/ # 可执行文件和脚本
├── certificates/ # SSL 证书
├── conf/ # 配置文件
├── data/ # 数据库文件
├── import/ # 数据导入目录
├── labs/ # 实验性功能
├── lib/ # Java 库文件
├── licenses/ # 许可证文件
├── logs/ # 日志文件
├── plugins/ # 插件目录
├── products/ # 产品信息
└── run/ # 运行时文件
步骤 2:配置 Neo4j
编辑配置文件
文件位置:d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\conf\neo4j.conf
基本配置项
网络绑定(允许远程访问)
server.default_listen_address=0.0.0.0
Bolt 协议端口(Python 驱动连接用)
server.bolt.listen_address=:7687
HTTP 端口(浏览器访问用)
server.http.listen_address=:7474
内存设置
server.memory.heap.initial_size=512m
server.memory.heap.max_size=1G
server.memory.pagecache.size=512m
安全设置
server.bolt.tls_level=DISABLED
server.http.enabled=true
配置说明
0.0.0.0:允许所有网络接口访问
7687:Bolt 协议端口(客户端连接)
7474:HTTP 端口(浏览器访问)
内存设置根据系统资源调整
tls_level=DISABLED:开发环境可禁用 TLS
步骤 3:设置初始密码
打开 PowerShell 或 CMD(以管理员身份)
右键点击"开始"菜单 -> Windows PowerShell (管理员)
进入 Neo4j bin 目录
cd d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\bin
设置初始密码
方式 1:使用 neo4j-admin 工具
.\neo4j-admin.bat dbms set-initial-password ne123456
或方式 2:如果服务已安装,可以通过浏览器首次登录时设置
访问 http://localhost:7474
默认用户名:neo4j
默认密码:neo4j
首次登录会要求修改密码
步骤 4:安装 Windows 服务
以管理员身份打开 PowerShell
右键"开始"菜单 -> Windows PowerShell (管理员)
进入 Neo4j bin 目录
cd d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\bin
安装服务
执行安装命令
.\neo4j.bat install-service
预期输出
Neo4j service installed
验证服务安装
Get-Service -Name neo4j
输出示例:
Status Name DisplayName
Stopped neo4j Neo4j Graph Database - neo4j
步骤 5:配置服务启动类型
设置为自动启动
Set-Service -Name neo4j -StartupType Automatic
验证启动类型
Get-Service -Name neo4j | Select-Object Name, StartType, Status
步骤 6:启动服务
方式 1:使用 PowerShell
Start-Service -Name neo4j
方式 2:使用 neo4j.bat 脚本
cd d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\bin
.\neo4j.bat start
方式 3:使用 Windows 服务管理器
-
按 Win + R
-
输入:services.msc
-
找到 "Neo4j Graph Database - neo4j"
-
右键 -> 启动
方式 4:使用 net 命令
net start neo4j
步骤 7:验证服务运行
检查服务状态
Get-Service -Name neo4j
预期输出:
Status Name DisplayName
Running neo4j Neo4j Graph Database - neo4j
查看详细信息
Get-Service -Name neo4j | Format-List *
检查进程
Get-Process -Name java | Where-Object {$_.CommandLine -like "*neo4j*"}
检查端口监听
netstat -ano | findstr "7474"
netstat -ano | findstr "7687"
访问 Web 界面
浏览器访问:http://localhost:7474
用户名:neo4j
密码:ne123456(或你设置的密码)
测试 Bolt 连接
使用 Python 测试
python -c "from neo4j import GraphDatabase; driver = GraphDatabase.driver('bolt://localhost:7687', auth=('neo4j', 'ne123456')); driver.verify_connectivity(); print('? Connection successful')"
?? 服务管理命令
常用 PowerShell 命令
查看服务状态
Get-Service -Name neo4j
启动服务
Start-Service -Name neo4j
停止服务
Stop-Service -Name neo4j
重启服务
Restart-Service -Name neo4j
查看服务详细信息
Get-Service -Name neo4j | Format-List *
查看服务启动类型
Get-Service -Name neo4j | Select-Object Name, StartType, Status
设置为自动启动
Set-Service -Name neo4j -StartupType Automatic
设置为手动启动
Set-Service -Name neo4j -StartupType Manual
设置为禁用
Set-Service -Name neo4j -StartupType Disabled
使用 neo4j.bat 脚本
cd d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\bin
安装服务
.\neo4j.bat install-service
卸载服务
.\neo4j.bat uninstall-service
启动服务
.\neo4j.bat start
停止服务
.\neo4j.bat stop
重启服务
.\neo4j.bat restart
查看状态
.\neo4j.bat status
查看版本
.\neo4j.bat version
使用 CMD 命令
REM 启动服务
net start neo4j
REM 停止服务
net stop neo4j
REM 查看服务
sc query neo4j
REM 查看服务配置
sc qc neo4j
?? 重要目录和文件
配置文件
d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\conf\neo4j.conf
主配置文件
包含网络、内存、安全等设置
数据目录
d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\data\
├── databases/ # 数据库文件
├── dbms/ # DBMS 系统数据
└── transactions/ # 事务日志
日志目录
d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\logs\
├── neo4j.log # 主日志文件
├── debug.log # 调试日志
├── query.log # 查询日志(需配置启用)
└── security.log # 安全日志
插件目录
d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\plugins\
用于放置 Neo4j 插件(如 APOC)
导入目录
d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\import\
用于 CSV 等数据导入
?? 故障排查
问题 1:服务无法启动
可能原因:
端口被占用(7474 或 7687)
Java 环境未配置
权限不足
配置文件错误
解决步骤:
检查端口占用
netstat -ano | findstr "7474"
netstat -ano | findstr "7687"
检查 Java 环境
java -version
要求:Java 17 或更高版本
查看日志文件
Get-Content d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\logs\neo4j.log -Tail 50
验证配置文件
检查配置文件语法
type d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\conf\neo4j.conf
问题 2:无法连接到 Neo4j
检查步骤:
确认服务运行
Get-Service -Name neo4j
测试端口
Test-NetConnection -ComputerName localhost -Port 7474
Test-NetConnection -ComputerName localhost -Port 7687
检查防火墙
添加防火墙规则(如需要)
New-NetFirewallRule -DisplayName "Neo4j HTTP" -Direction Inbound -Protocol TCP -LocalPort 7474 -Action Allow
New-NetFirewallRule -DisplayName "Neo4j Bolt" -Direction Inbound -Protocol TCP -LocalPort 7687 -Action Allow
验证认证信息
默认用户名:neo4j
密码:首次设置的密码
问题 3:服务频繁崩溃
可能原因:
内存不足
磁盘空间不足
数据库损坏
解决步骤:
调整内存设置
编辑 conf\neo4j.conf:
减小内存占用
server.memory.heap.initial_size=256m
server.memory.heap.max_size=512m
server.memory.pagecache.size=256m
检查磁盘空间
Get-PSDrive D | Select-Object Free, Used
检查数据库一致性
cd d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\bin
.\neo4j-admin.bat check database neo4j
?? 安全配置
- 修改默认密码
方式 1:使用 neo4j-admin
cd d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\bin
.\neo4j-admin.bat dbms set-initial-password <新密码>
方式 2:通过 Cypher 查询(服务运行时)
访问 http://localhost:7474
执行:
ALTER CURRENT USER SET PASSWORD FROM '旧密码' TO '新密码'
- 限制网络访问
编辑 conf\neo4j.conf:
仅允许本地访问
server.default_listen_address=127.0.0.1
或仅允许特定 IP
server.default_listen_address=192.168.1.100
- 启用 TLS
启用 Bolt TLS
server.bolt.tls_level=REQUIRED
启用 HTTPS
server.https.enabled=true
server.https.listen_address=:7473
配置证书
dbms.ssl.policy.bolt.enabled=true
dbms.ssl.policy.bolt.base_directory=certificates/bolt
?? 性能优化
- 内存配置建议
小型系统(< 4GB RAM)
server.memory.heap.initial_size=256m
server.memory.heap.max_size=512m
server.memory.pagecache.size=256m
中型系统(4-8GB RAM)
server.memory.heap.initial_size=512m
server.memory.heap.max_size=1G
server.memory.pagecache.size=512m
大型系统(> 8GB RAM)
server.memory.heap.initial_size=1G
server.memory.heap.max_size=2G
server.memory.pagecache.size=1G
- 查询性能优化
启用查询日志
dbms.logs.query.enabled=true
dbms.logs.query.threshold=1s
增加事务超时
db.transaction.timeout=60s
并发配置
dbms.threads.worker_count=8
?? 备份和恢复
在线备份(需要企业版)
Community 版本不支持在线备份,需要停止服务后进行冷备份。
冷备份步骤
停止 Neo4j 服务
Stop-Service -Name neo4j
备份数据目录
backupPath = "D:\\Backups\\Neo4j\\backup_(Get-Date -Format 'yyyyMMdd_HHmmss')"
Copy-Item -Path "d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\data" -Destination $backupPath -Recurse
启动服务
Start-Service -Name neo4j
恢复步骤
停止服务
Stop-Service -Name neo4j
恢复数据
删除当前数据
Remove-Item -Path "d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\data\*" -Recurse -Force
恢复备份
Copy-Item -Path "$backupPath\*" -Destination "d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\data" -Recurse
启动服务
Start-Service -Name neo4j
?? 卸载服务
完整卸载步骤
停止服务
Stop-Service -Name neo4j
卸载服务
cd d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0\bin
.\neo4j.bat uninstall-service
验证卸载
Get-Service -Name neo4j
应该返回错误:找不到服务
清理数据(可选)
备份重要数据后
Remove-Item -Path "d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0" -Recurse -Force
? 验证清单
Neo4j 已解压到正确目录
配置文件已正确配置
初始密码已设置
Windows 服务已安装
服务启动类型设置为"自动"
服务状态为"Running"
可以访问 Web 界面(http://localhost:7474)
Bolt 连接正常(端口 7687)
日志文件正常生成
可以执行 Cypher 查询
?? 参考资源
官方文档