在 Windows10 下面將 neo4j-community-5.26.0 配置為系統服務
?? 環境信息
- 操作系統:Windows 10
- Neo4j 版本:Community 5.26.0
- 安裝位置:
d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0 - 下載來源:https://we-yun.com/doc/neo4j/5.26.0/neo4j-community-5.26.0-windows.zip
? neo4j-community-5.26.0 服務配置結果
服務名稱: neo4j
顯示名稱: Neo4j Graph Database - neo4j
狀態: Running (運行中)
啟動類型: Automatic (自動)
訪問: http://localhost:7474
?? 完整配置步驟
步驟 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 服務管理器
1. 按 Win + R
2. 輸入:services.msc
3. 找到 "Neo4j Graph Database - neo4j"
4. 右鍵 -> 啟動
方式 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. 修改默認密碼
# 方式 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 '新密碼'
2. 限制網絡訪問
編輯 conf\neo4j.conf:
# 僅允許本地訪問
server.default_listen_address=127.0.0.1
# 或僅允許特定 IP
server.default_listen_address=192.168.1.100
3. 啟用 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
?? 性能優化
1. 內存配置建議
小型系統(< 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
2. 查詢性能優化
# 啟用查詢日志
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 5.x 官方文檔:https://neo4j.com/docs/operations-manual/5/
- Windows 安裝指南:https://neo4j.com/docs/operations-manual/5/installation/windows/
常用鏈接
- Neo4j 瀏覽器:http://localhost:7474
- Bolt 端口:bolt://localhost:7687
- Neo4j 下載:https://we-yun.com/doc/neo4j/5.26.0/
推薦工具
- Neo4j Desktop:圖形化管理工具
- Neo4j Browser:Web 界面(內置)
- Cypher Shell:命令行工具(內置)
?? 總結
Neo4j Community 5.26.0 已成功配置為 Windows 系統服務!
關鍵信息:
- ?? 安裝路徑:
d:\WinUser.dat\CursorMcp\neo4j-community-5.26.0 - ?? Web 界面:http://localhost:7474
- ?? Bolt 端口:bolt://localhost:7687
- ?? 默認用戶:neo4j
- ?? 密碼:ne123456(或自定義密碼)
- ?? 啟動類型:Automatic(自動啟動)
浙公網安備 33010602011771號