`docker-compose` 安装 Neo4j 的详细步骤

发布于:2025-07-05 ⋅ 阅读:(14) ⋅ 点赞:(0)

docker-compose 安装 Neo4j 的详细步骤,适用于本地开发或测试环境(适配 Neo4j 5.x 或 4.x 版本):


一、准备环境

1. 安装 Docker 和 Docker Compose

如果尚未安装,请根据系统安装:

  • Linux/macOS 推荐安装 Docker Desktop(已集成 Docker Compose)
  • Windows 安装 Docker Desktop

验证安装:

docker -v
docker-compose -v

二、创建项目目录和配置文件

1. 新建一个目录:

mkdir neo4j-docker
cd neo4j-docker

2. 新建 docker-compose.yml

创建一个基本的 docker-compose.yml 文件:

version: '3.8'

services:
  neo4j:
    image: neo4j:5.18  # 可改为指定版本,例如 neo4j:4.4
    container_name: neo4j-db
    ports:
      - 7474:7474   # HTTP Web UI
      - 7687:7687   # Bolt 协议端口
    environment:
      NEO4J_AUTH: neo4j/password123  # 设置用户名密码
      NEO4J_dbms_connector_bolt_advertised__address: localhost:7687
    volumes:
      - neo4j_data:/data
      - neo4j_logs:/logs
      - neo4j_import:/import
      - neo4j_plugins:/plugins
    restart: unless-stopped

volumes:
  neo4j_data:
  neo4j_logs:
  neo4j_import:
  neo4j_plugins:

你可以修改用户名密码,例如将 neo4j/password123 改为你自己的安全凭据。


三、启动 Neo4j

docker-compose.yml 所在目录执行:

docker-compose up -d

查看容器运行状态:

docker ps

四、访问 Neo4j

打开浏览器,访问:

http://localhost:7474
  • 用户名:neo4j
  • 密码:password123(首次登录会提示修改密码)

五、常用命令

停止服务:

docker-compose down

查看日志:

docker-compose logs -f

重启服务:

docker-compose restart

六、可选增强配置

使用最新插件(如 APOC):

可以添加环境变量和插件路径:

    environment:
      NEO4J_PLUGINS: '["apoc"]'

或者直接在容器里安装:

docker exec -it neo4j-db bash
# cd /plugins 目录下下载 APOC 插件

设置数据导入目录权限:

确保本地挂载目录的权限允许 Neo4j 容器访问,避免读写失败:

sudo chmod -R 777 ./import ./data