本地开发环境 Neo4j 部署全套方案（Windows/macOS）

本地开发优先推荐两种方案：

1. Docker 一键启动（推荐，环境统一、不污染本机、切换版本方便）
2. Neo4j Desktop 可视化客户端（新手友好，多库管理）

方案1 Docker

1、前置准备

安装 Docker Desktop（官网下载），启动 Docker。

2、一键启动命令（自定义端口、内置 APOC）

打开终端（PowerShell / CMD / 终端）执行：

bash

运行

docker run -d \ --name neo4j-dev \ --restart no \ -p 7474:7474 \ -p 7687:7687 \ -v D:/neo4j_dev_data:/data \ # Windows持久化目录 # -v ~/neo4j_dev_data:/data \ # macOS替换此行 -e NEO4J_AUTH=neo4j/dev@123456 \ -e NEO4J_PLUGINS='["apoc"]' \ -e NEO4J_dbms_memory_heap_max_size=2G \ neo4j:5.20

参数说明：

• 账号：neo4j密码：dev@123456，本地开发简单密码
• 自动安装 APOC 插件，做文本实体抽取必备
• 数据挂载本地文件夹，删除容器数据不丢失
• heap 内存 2G，满足本地金相图谱调试

修改默认端口

启动命令直接映射（推荐，不用改容器内部配置）

只改宿主机对外端口，容器内部仍使用 7474/7687，无需修改 conf

bash

运行

docker run -d \ --name neo4j-graphrag \ -p 8080:7474 \ # 宿主机8080 → 容器7474网页 -p 8081:7687 \ # 宿主机8081 → 容器7687程序连接 -e NEO4J_AUTH=neo4j/Neo4j@2026 \ neo4j:5.20

Python 连接：bolt://IP:8081，浏览器：http://IP:8080

4、本地访问

网页管理面板：http://127.0.0.1:7474Python 连接地址：bolt://127.0.0.1:7687

5、Python 本地连接配置（settings.py）

python

运行

NEO4J_URI = "bolt://127.0.0.1:7687" NEO4J_USER = "neo4j" NEO4J_PASSWORD = "dev@123456"

日常开发常用命令

bash

运行

# 查看实时日志，调试报错 docker logs -f neo4j-dev # 停止 docker stop neo4j-dev # 重启 docker restart neo4j-dev # 删除容器（数据还在本地挂载目录） docker rm neo4j-dev

方案2 Desktop可视化

1、下载安装

官网：https://neo4j.com/download/neo4j-desktop/ Windows/macOS 直接安装图形化软件。

2、创建本地开发数据库

1. 打开软件 → 点击Create DBMS
2. Name：metallurgy_dev
3. Password：dev@123456
4. Version 选择 5.20，创建
5. 点击 Start 启动数据库

3、安装 APOC 插件（必须）

1. 数据库卡片右侧Plugins
2. 搜索APOC点击安装
3. 重启数据库生效

4、本地连接信息

• Web 地址：http://localhost:7474
• Bolt：bolt://localhost:7687

优势

• 图形界面管理多个数据库（开发 / 测试分开）
• 内置查询编辑器、图谱可视化、数据导入导出
• 一键启停，无需命令行