Neo4j 基础教程（一）：安装与快速入门

环境：macOS，Docker / Homebrew / Neo4j Desktop 三种安装方式，以及基础概念，快速入门。

---

方式一：Docker 安装（推荐，5 分钟搞定）

前置条件

已安装 Docker Desktop（官网下载）

启动 Neo4j

# 拉取并启动 Neo4j 容器
docker run \
    --name neo4j \
    -p 7474:7474 \
    -p 7687:7687 \
    -e NEO4J_AUTH=neo4j/password \
    -d \
    neo4j:latest

• 7474 — HTTP 接口（浏览器 UI）
• 7687 — Bolt 协议（程序连接）
• 初始账号：neo4j / password

验证

打开浏览器访问 → http://localhost:7474

输入账号密码登录，即可进入 Neo4j Browser 管理界面。

停止与重启

# 停止
docker stop neo4j

# 重启
docker start neo4j

# 查看日志
docker logs -f neo4j

清理

docker rm -f neo4j     # 删除容器
docker rmi neo4j:latest # 删除镜像（可选）

---

方式二：Homebrew 安装（命令行推荐）

前置条件

已安装 Homebrew（官网，或终端运行以下命令安装）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装 Neo4j

# 添加 Neo4j 官方 Cask 仓库
brew tap neo4j/tap

# 安装 Neo4j Community Edition
brew install neo4j-community

启动服务

# 启动 Neo4j
neo4j start

# 如果是首次启动，需要设置初始密码
neo4j-admin dbms set-initial-password your_password

访问

打开浏览器 → http://localhost:7474

初始账号：neo4j，密码为你设置的密码。

常用命令

neo4j start      # 启动服务
neo4j stop       # 停止服务
neo4j status     # 查看运行状态
neo4j console    # 前台运行（实时查看日志）

重要路径

用途	默认路径
配置文件	/usr/local/etc/neo4j/neo4j.conf
数据存储	/usr/local/var/neo4j/data
日志目录	/usr/local/var/neo4j/logs

修改配置：

nano /usr/local/etc/neo4j/neo4j.conf

💡 注意：Homebrew 版本可能略晚于最新版 Docker，如需最新功能建议使用 Docker。

---

方式三：下载 Tar 包安装（手动部署）

适合不想用 Docker / Homebrew，追求完全掌控的开发者。

下载

1. 访问 https://neo4j.com/product/neo4j-graph-database/#download
2. 选择 Neo4j Community Edition → 下载 macOS / Linux 的 Tarball（.tar.gz）
3. 或者用命令行直接下载（以 5.x 最新版为例）：

需要注意：

• neo4j网站对国内不是很通畅，需要发动程序员特定技能来解决。
• 需确保java环境已经准备好，这里不做具体操作。

# 查看最新版本号
curl -s https://dist.neo4j.org/ | grep -o 'neo4j-community-[0-9\.]*-unix.tar.gz' | head -1

# 下载（替换为实际版本号）
curl -O https://dist.neo4j.org/neo4j-community-5.26.0-unix.tar.gz

解压安装

# 解压到指定目录（建议放在用户目录下）
tar -xzf neo4j-community-5.26.0-unix.tar.gz -C ~

# 重命名为方便管理的目录名
mv ~/neo4j-community-5.26.0 ~/neo4j

tar包如果不愿意跑指令，双击也可以自动解压，然后再将目录copy到自己指定的目录下。

设置环境变量（推荐）

# 写入 ~/.zshrc 或 ~/.bash_profile
echo 'export NEO4J_HOME=~/neo4j' >> ~/.zshrc
echo 'export PATH=$NEO4J_HOME/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

启动 Neo4j

# 启动（后台运行）
neo4j start

# 或者前台运行（实时查看日志）
neo4j console

访问

打开浏览器 → http://localhost:7474

初始账号和密码默认都是：neo4j，登录后会要求修改密码。

重要路径

用途	路径
执行目录	~/neo4j/bin/
配置文件	~/neo4j/conf/neo4j.conf
数据存储	~/neo4j/data/
日志目录	~/neo4j/logs/

升级版本

# 停止当前服务
neo4j stop

# 下载新版本 tar.gz，解压到新目录
# 修改 NEO4J_HOME 指向新目录即可

💡 优点：完全独立，不依赖 Homebrew 或 Docker，可同时安装多个版本切换使用。

其它方式

建议通过Azure部署，直接Azure里搜索Neo4j就可以找到相应资源的不同版本。

---

基本概念速览

概念	说明
Node（节点）	图中的圆点，代表实体
Relationship（关系）	节点之间的连线
Label（标签）	节点的类型（如 :Person）
Property（属性）	节点/关系的键值对
Cypher	Neo4j 的查询语言

---

第一个图：创建与查询

在 Neo4j Browser 的命令框中输入：

// 创建两个人及其关系
CREATE (alice:Person {name: 'Alice', age: 30})
CREATE (bob:Person {name: 'Bob', age: 28})
CREATE (alice)-[:KNOWS {since: 2020}]->(bob)

// 查找 Bob 认识的人
MATCH (p:Person {name: 'Bob'})<-[:KNOWS]-(friend)
RETURN friend

💡 提示：按 Ctrl+Enter（或 Cmd+Enter）执行语句

---

常用清理命令

// 清空整个图数据库
MATCH (n) DETACH DELETE n

// 查看所有节点
MATCH (n) RETURN n

// 查看所有标签
CALL db.labels()

---

数据持久化说明

• Docker 方式：数据存在容器内，删除容器后丢失。可加 -v 挂载本地目录持久化。
• Homebrew 方式：数据默认存在 /usr/local/var/neo4j/data，删除前记得备份。
• Neo4j Desktop：数据默认存在本地，删除项目前记得备份。

Docker 挂载持久化：

docker run \
    --name neo4j \
    -p 7474:7474 \
    -p 7687:7687 \
    -e NEO4J_AUTH=neo4j/password \
    -v ~/neo4j_data:/data \
    -d \
    neo4j:latest

---

下一步

• 教程二：掌握 Cypher CRUD 操作
• 教程三：数据建模与典型应用场景

---