Neo4j Docker 镜像文档

注意

这是 neo4j 官方镜像 的 amd64 架构构建的“每架构”仓库——更多信息，请参见官方镜像文档中的“除 amd64 外的架构？” 和官方镜像常见问题中的“镜像源在 Git 中已更改，现在该怎么办？”。

1. 镜像概述和主要用途

Neo4j 是全球领先的原生图数据库，具备高度可扩展、健壮的特性，专为存储和处理图结构数据设计。本镜像为 amd64 架构的 Neo4j 官方 Docker 镜像，用于在容器化环境中快速部署 Neo4j 图数据库实例，支持社区版（Community）和企业版（Enterprise），适用于开发、测试及生产环境。

2. 核心功能和特性

• 原生图存储：采用专为图数据优化的存储引擎，高效存储节点、关系及属性
• ACID 合规：确保事务的原子性、一致性、隔离性和持久性，保障数据可靠性
• 高性能查询：通过 Cypher 声明式查询语言，支持复杂图模式匹配和关系遍历
• 高可扩展性：支持水平扩展和集群部署（企业版特性），满足大规模数据需求
• 多版本支持：提供 4.x、5.x、2025.x 等多个稳定版本，适配不同场景需求
• 灵活部署：基于 Debian (bullseye) 和 Red Hat UBI9 基础镜像，支持多样化环境

3. 支持的标签及对应 Dockerfile 链接

2025.x 系列

• 社区版 (bullseye 基础)：2025.09.0-community-bullseye, 2025.09-community-bullseye, 2025-community-bullseye, 2025.09.0-community, 2025.09-community, 2025-community, 2025.09.0-bullseye, 2025.09-bullseye, 2025-bullseye, 2025.09.0, 2025.09, 2025, community-bullseye, community, bullseye, latest
  Dockerfile 链接

• 企业版 (bullseye 基础)：2025.09.0-enterprise-bullseye, 2025.09-enterprise-bullseye, 2025-enterprise-bullseye, 2025.09.0-enterprise, 2025.09-enterprise, 2025-enterprise, enterprise-bullseye, enterprise
  Dockerfile 链接

• 社区版 (ubi9 基础)：2025.09.0-community-ubi9, 2025.09-community-ubi9, 2025-community-ubi9, 2025.09.0-ubi9, 2025.09-ubi9, 2025-ubi9, community-ubi9, ubi9
  Dockerfile 链接

• 企业版 (ubi9 基础)：2025.09.0-enterprise-ubi9, 2025.09-enterprise-ubi9, 2025-enterprise-ubi9, enterprise-ubi9
  Dockerfile 链接

5.x 系列

• 社区版 (bullseye 基础)：5.26.13-community-bullseye, 5.26-community-bullseye, 5-community-bullseye, 5.26.13-community, 5.26-community, 5-community, 5.26.13-bullseye, 5.26-bullseye, 5-bullseye, 5.26.13, 5.26, 5
  Dockerfile 链接

• 企业版 (bullseye 基础)：5.26.13-enterprise-bullseye, 5.26-enterprise-bullseye, 5-enterprise-bullseye, 5.26.13-enterprise, 5.26-enterprise, 5-enterprise
  Dockerfile 链接

• 社区版 (ubi9 基础)：5.26.13-community-ubi9, 5.26-community-ubi9, 5-community-ubi9, 5.26.13-ubi9, 5.26-ubi9, 5-ubi9
  Dockerfile 链接

• 企业版 (ubi9 基础)：5.26.13-enterprise-ubi9, 5.26-enterprise-ubi9, 5-enterprise-ubi9
  Dockerfile 链接

4.x 系列

• 社区版：4.4.46, 4.4.46-community, 4.4, 4.4-community
  Dockerfile 链接

• 企业版：4.4.46-enterprise, 4.4-enterprise
  Dockerfile 链接

3. 使用场景和适用范围

Neo4j 作为原生图数据库，适用于需高效处理实体关系的场景，主要包括：

• 社交网络分析：存储用户关系、互动行为，支持好友推荐、影响力分析
• 推荐系统：基于用户-商品、商品-商品关系构建个性化推荐模型
• 欺诈检测：通过识别异常关系模式（如虚假账户关联、异常交易路径）预防欺诈
• 知识图谱：构建结构化知识网络，支持智能问答、语义检索
• 供应链管理：追踪物料流转路径，优化库存和物流效率
• 网络与 IT 运维：建模网络拓扑、服务依赖，支持故障定位和影响分析

4. 详细使用方法和配置说明

4.1 快速启动（docker run 命令）

通过以下命令启动基础 Neo4j 容器：

docker run \
  --name neo4j \
  --publish=7474:7474 \  # HTTP 端口（Web 管理界面）
  --publish=7687:7687 \  # Bolt 端口（高性能客户端连接）
  --volume=$HOME/neo4j/data:/data \  # 持久化数据库数据
  --volume=$HOME/neo4j/logs:/logs \  # 持久化日志
  --volume=$HOME/neo4j/import:/var/lib/neo4j/import \  # 挂载导入数据目录
  --env=NEO4J_AUTH=neo4j/your_password \  # 设置初始用户名/密码
  amd64/neo4j:latest

参数说明：

• 端口映射：7474 为 Web 管理界面端口，7687 为 Bolt 协议端口（Cypher 查询主要使用此端口）
• 数据持久化：通过 -v 挂载 /data（数据库文件）、/logs（日志）、/import（数据导入目录）到宿主机，避免容器删除导致数据丢失
• 认证配置：NEO4J_AUTH=neo4j/your_password 设置初始用户密码；开发环境可使用 NEO4J_AUTH=none 禁用认证

4.2 Docker Compose 配置示例

创建 docker-compose.yml 文件简化部署：

version: '3.8'
services:
  neo4j:
    image: amd64/neo4j:5.26.13-community
    container_name: neo4j
    ports:
      - "7474:7474"
      - "7687:7687"
    volumes:
      - ./data:/data
      - ./logs:/logs
      - ./import:/var/lib/neo4j/import
      - ./plugins:/plugins  # 挂载插件目录（如 APOC、Graph Data Science）
    environment:
      - NEO4J_AUTH=neo4j/admin123
      - NEO4J_dbms_memory_heap_initial__size=1G  # 堆内存初始大小
      - NEO4J_dbms_memory_heap_max__size=4G      # 堆内存最大大小
      - NEO4J_dbms_default__listen__address=0.0.0.0  # 监听所有网络接口
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动服务：

docker-compose up -d

4.3 核心环境变量配置

通过 --env 或 environment 配置 Neo4j 参数，常用变量如下：

4.4 数据导入与备份

数据导入：

1. 将待导入文件（如 CSV）放入宿主机 ./import 目录（已通过 -v 挂载到容器内 /var/lib/neo4j/import）
2. 通过 Cypher 命令导入：

   LOAD CSV WITH HEADERS FROM "file:///data.csv" AS row
   CREATE (:Node {id: row.id, name: row.name})
   

数据备份：

通过 neo4j-admin 工具备份数据库（需进入容器执行）：

docker exec -it neo4j neo4j-admin database dump neo4j --to-path=/backup

备份文件将保存至容器内 /backup 目录（建议挂载宿主机目录以便持久化）。

5. 快速参考

维护者

Neo4j

获取帮助

Neo4j 社区论坛

提交问题

GitHub Issues

支持架构

amd64, arm64v8

官方文档

Neo4j Docker 部署手册

6. 许可证信息

镜像中软件的许可信息请参见 Neo4j 许可说明。
与所有 Docker 镜像一样，本镜像可能包含其他软件（如基础发行版的 Bash 等），这些软件可能具有独立许可。
自动检测到的额外许可信息可在 repo-info 仓库的 neo4j 目录 中找到。
使用本镜像时，用户需确保符合其中所有软件的相关许可要求。