Neo4j安装与配置 #

一、安装要求 #

1.1 系统要求 #

组件 最低要求 推荐配置
操作系统 Windows/Linux/macOS 64位操作系统
Java OpenJDK 11+ OpenJDK 17
内存 2GB 8GB+
磁盘 10GB SSD 50GB+
CPU 2核 4核+

1.2 Java环境检查 #

bash 
java -version

输出示例：

text 
openjdk version "17.0.2" 2022-01-18
OpenJDK Runtime Environment (build 17.0.2+8-86)
OpenJDK 64-Bit Server VM (build 17.0.2+8-86, mixed mode, sharing)

二、Windows安装 #

2.1 下载安装包 #

  1. 访问官网下载页面：https://neo4j.com/download/
  2. 选择Windows版本下载
  3. 解压到指定目录

2.2 配置环境变量 #

text 
NEO4J_HOME=C:\neo4j-community-5.x.x
Path添加：%NEO4J_HOME%\bin

2.3 启动服务 #

powershell 
neo4j console

2.4 安装为Windows服务 #

powershell 
neo4j windows-service install
neo4j start
neo4j stop
neo4j restart
neo4j status

三、Linux安装 #

3.1 使用包管理器安装 #

Debian/Ubuntu：

bash 
wget -O - https://debian.neo4j.com/neotechnology.gpg.key | sudo apt-key add -
echo 'deb https://debian.neo4j.com stable 5.x' | sudo tee /etc/apt/sources.list.d/neo4j.list
sudo apt-get update
sudo apt-get install neo4j=1:5.x.x

RHEL/CentOS：

bash 
sudo rpm --import https://rpm.neo4j.com/neotechnology.gpg.key
sudo tee /etc/yum.repos.d/neo4j.repo <<EOF
[neo4j]
name=Neo4j RPM Repository
baseurl=https://rpm.neo4j.com
enabled=1
gpgcheck=1
EOF
sudo yum install neo4j-5.x.x

3.2 手动安装 #

bash 
cd /opt
sudo tar -xzf neo4j-community-5.x.x-unix.tar.gz
sudo ln -s neo4j-community-5.x.x neo4j

配置环境变量：

bash 
echo 'export NEO4J_HOME=/opt/neo4j' >> ~/.bashrc
echo 'export PATH=$NEO4J_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

3.3 启动服务 #

bash 
sudo systemctl start neo4j
sudo systemctl enable neo4j
sudo systemctl status neo4j

3.4 服务管理命令 #

bash 
neo4j start
neo4j stop
neo4j restart
neo4j status
neo4j console

四、macOS安装 #

4.1 使用Homebrew安装 #

bash 
brew install neo4j

4.2 启动服务 #

bash 
neo4j start
neo4j stop
neo4j restart
neo4j status

4.3 作为服务运行 #

bash 
brew services start neo4j
brew services stop neo4j
brew services restart neo4j

五、Docker安装 #

5.1 拉取镜像 #

bash 
docker pull neo4j:5-community

5.2 运行容器 #

bash 
docker run \
    --name neo4j \
    -p 7474:7474 \
    -p 7687:7687 \
    -v $HOME/neo4j/data:/data \
    -v $HOME/neo4j/logs:/logs \
    -v $HOME/neo4j/import:/var/lib/neo4j/import \
    -v $HOME/neo4j/plugins:/plugins \
    -e NEO4J_AUTH=neo4j/password \
    -d neo4j:5-community

5.3 Docker Compose配置 #

创建 docker-compose.yml 文件：

yaml 
version: '3.8'

services:
  neo4j:
    image: neo4j:5-community
    container_name: neo4j
    ports:
      - "7474:7474"
      - "7687:7687"
    volumes:
      - ./neo4j/data:/data
      - ./neo4j/logs:/logs
      - ./neo4j/import:/var/lib/neo4j/import
      - ./neo4j/plugins:/plugins
    environment:
      - NEO4J_AUTH=neo4j/password
      - NEO4J_server_memory_pagecache_size=256M
      - NEO4J_server_memory_heap_initial__size=512M
      - NEO4J_server_memory_heap_max__size=512M
    restart: unless-stopped

启动服务：

bash 
docker-compose up -d

5.4 Docker常用命令 #

bash 
docker start neo4j
docker stop neo4j
docker restart neo4j
docker logs neo4j
docker exec -it neo4j cypher-shell

六、Neo4j Desktop安装 #

6.1 下载安装 #

  1. 访问 https://neo4j.com/download/
  2. 下载Neo4j Desktop
  3. 运行安装程序

6.2 创建项目 #

text 
步骤：
├── 打开Neo4j Desktop
├── 创建新项目
├── 添加本地数据库
├── 设置密码
└── 启动数据库

6.3 优势 #

  • 图形化管理界面
  • 多数据库管理
  • 插件一键安装
  • 示例项目模板

七、配置文件详解 #

7.1 配置文件位置 #

text 
配置文件路径：
├── conf/neo4j.conf    主配置文件
├── conf/apoc.conf     APOC配置
└── conf/cypher.conf   Cypher配置

7.2 核心配置项 #

properties 
server.default_listen_address=0.0.0.0

server.http.enabled=true
server.http.listen_address=:7474
server.http.advertised_address=:7474

server.bolt.enabled=true
server.bolt.listen_address=:7687
server.bolt.advertised_address=:7687

server.https.enabled=true
server.https.listen_address=:7473
server.https.advertised_address=:7473

server.database.default=neo4j

server.memory.heap.initial_size=512m
server.memory.heap.max_size=512m
server.memory.pagecache.size=256m

dbms.security.auth_enabled=true

dbms.tx_log.rotation.retention_policy=2 days 1G size

7.3 内存配置 #

properties 
server.memory.heap.initial_size=2G
server.memory.heap.max_size=2G
server.memory.pagecache.size=1G
server.memory.off_heap.max_size=2G

内存配置建议：

总内存 Heap PageCache 建议
4GB 1GB 1GB 开发环境
8GB 2GB 2GB 小型生产
16GB 4GB 6GB 中型生产
32GB 8GB 12GB 大型生产

7.4 安全配置 #

properties 
dbms.security.auth_enabled=true
dbms.security.auth_provider=internal

dbms.security.procedures.unrestricted=apoc.*
dbms.security.procedures.allowlist=apoc.*

server.ssl.policy.bolt.enabled=true
server.ssl.policy.bolt.base_directory=certificates
server.ssl.policy.bolt.private_key=private.key
server.ssl.policy.bolt.public_certificate=public.crt

7.5 日志配置 #

properties 
server.logs.debug.level=INFO
server.logs.default_debug_level=INFO
server.logs.query.enabled=true
server.logs.query.threshold=0s

八、访问Neo4j #

8.1 Web界面（Neo4j Browser） #

text 
HTTP访问：http://localhost:7474
HTTPS访问：https://localhost:7473

默认用户名：neo4j
默认密码：neo4j（首次登录需修改）

8.2 Cypher Shell命令行 #

bash 
cypher-shell -u neo4j -p password

常用命令：

bash 
cypher-shell -u neo4j -p password -a bolt://localhost:7687
cypher-shell -u neo4j -p password -d neo4j
cypher-shell -u neo4j -p password -f query.cypher

8.3 端口说明 #

端口 协议 用途
7474 HTTP Web界面
7473 HTTPS 安全Web界面
7687 Bolt 驱动连接

九、验证安装 #

9.1 检查服务状态 #

bash 
neo4j status

9.2 测试连接 #

bash 
cypher-shell -u neo4j -p password "RETURN 1"

9.3 创建测试数据 #

cypher 
CREATE (n:Test {name: 'Hello Neo4j'})
RETURN n

9.4 查询测试数据 #

cypher 
MATCH (n:Test)
RETURN n

9.5 清理测试数据 #

cypher 
MATCH (n:Test)
DELETE n

十、常见问题 #

10.1 端口被占用 #

bash 
netstat -tlnp | grep 7474
netstat -tlnp | grep 7687

修改配置文件中的端口：

properties 
server.http.listen_address=:7475
server.bolt.listen_address=:7688

10.2 内存不足 #

错误信息：

text 
Error: could not reserve enough space for object heap

解决方案：

properties 
server.memory.heap.initial_size=256m
server.memory.heap.max_size=256m

10.3 权限问题 #

bash 
sudo chown -R neo4j:neo4j /var/lib/neo4j
sudo chmod -R 755 /var/lib/neo4j

10.4 重置密码 #

bash 
neo4j-admin set-initial-password newpassword

10.5 查看日志 #

bash 
tail -f logs/neo4j.log
tail -f logs/debug.log
tail -f logs/query.log

十一、卸载 #

11.1 Windows卸载 #

powershell 
neo4j windows-service uninstall
删除安装目录

11.2 Linux卸载 #

bash 
sudo systemctl stop neo4j
sudo apt-get remove neo4j
sudo rm -rf /var/lib/neo4j
sudo rm -rf /var/log/neo4j

11.3 Docker卸载 #

bash 
docker stop neo4j
docker rm neo4j
docker rmi neo4j:5-community

十二、总结 #

安装要点总结：

环境 推荐方式 适用场景
Windows Neo4j Desktop 开发学习
Linux 包管理器 生产环境
macOS Homebrew 开发环境
Docker Docker Compose 快速部署

下一步，让我们学习Cypher语法基础！

最后更新：2026-03-27