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 容器：

bash
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 文件简化部署：

yaml
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  # 容器退出时自动重启（除非手动停止）

启动服务：

bash
docker-compose up -d

4.3 核心环境变量配置

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

4.4 数据导入与备份

数据导入：

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

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

数据备份：

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

bash
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 目录 中找到。
使用本镜像时，用户需确保符合其中所有软件的相关许可要求。