Neo4j 实验性 Docker 镜像文档

1. 镜像概述和主要用途

1.1 概述

本镜像为 Neo4j 数据库的实验性 Docker 镜像，仅用于测试和实验目的，不提供官方技术支持，且严禁用于生产环境。官方支持的稳定版 Neo4j 镜像请参考 Docker Hub 官方镜像库。

1.2 主要用途

• 验证 Neo4j 新特性或测试版本的功能
• 开发环境中的临时测试
• 学***和研究 Neo4j 数据库的实验性配置

2. 核心功能和特性

• 基于 Neo4j 数据库内核，包含基础图数据库功能（节点、关系、属性管理，Cypher 查询等）
• 可能包含未正式发布的实验性特性（具体特性随镜像版本变化，需参考对应版本的更新说明）
• 与官方 Neo4j 镜像类似的容器化部署方式，支持基础配置和扩展

3. 使用场景和适用范围

3.1 适用场景

• 开发测试：验证新功能或配置在非生产环境中的表现
• 特性验证：测试 Neo4j 实验性 API 或功能的兼容性
• 学*研究**：在隔离环境中探索 Neo4j 数据库的高级特性

3.2 禁用场景

• 生产环境：镜像稳定性、安全性和数据可靠性未经过生产级验证，严禁用于生产系统
• 关键业务：涉及数据持久化、高可用性或性能要求的场景

4. 使用方法和配置说明

4.1 前提条件

• 已安装 Docker 引擎（推荐版本 20.10+）
• 网络环境允许容器端口映射（默认需开放 HTTP 和 Bolt 端口）

4.2 基本使用（docker run 命令）

通过以下命令启动实验性 Neo4j 容器：

docker run -d \
  --name neo4j-experimental \
  -p 7474:7474 \  # HTTP 接口端口
  -p 7687:7687 \  # Bolt 协议端口
  -v neo4j-data:/data \  # 数据持久化卷
  -e NEO4J_AUTH=neo4j/password \  # 数据库认证配置（格式：<用户名>/<密码>，设为 "none" 禁用认证）
  neo4j/experimental:latest  # 镜像名称（标签需替换为具体实验版本）

注：镜像标签（如 latest）需根据实际实验版本指定，具体版本列表可通过镜像仓库查询。

4.3 Docker Compose 配置示例

创建 docker-compose.yml 文件，定义服务配置：

version: '3.8'
services:
  neo4j-experimental:
    image: neo4j/experimental:latest
    container_name: neo4j-experimental
    ports:
      - "7474:7474"  # HTTP 管理界面
      - "7687:7687"  # Bolt 连接端口
    environment:
      - NEO4J_AUTH=neo4j/password  # 认证配置
      - NEO4J_dbms_memory_heap_initial__size=512m  # 堆内存初始大小（实验性配置可能支持自定义）
      - NEO4J_dbms_memory_heap_max__size=1g  # 堆内存最大大小
    volumes:
      - neo4j-data:/data  # 数据持久化卷
    restart: unless-stopped  # 非生产环境建议，生产环境禁用

volumes:
  neo4j-data:  # 命名卷用于数据持久化

4.4 环境变量配置

实验性镜像可能支持部分与官方镜像相同的环境变量，也可能包含实验性参数，以下为常用基础配置（具体以镜像版本为准）：

注意：实验性镜像可能引入额外环境变量或变更现有变量，使用前需参考对应版本的官方说明文档。

4.5 数据持久化

为避免容器重启导致数据丢失，需将容器内 /data 目录（Neo4j 数据存储路径）挂载到宿主机或命名卷：

# 使用命名卷（推荐）
docker volume create neo4j-experimental-data
docker run -d -v neo4j-experimental-data:/data neo4j/experimental:latest

# 挂载宿主机目录
docker run -d -v /path/on/host:/data neo4j/experimental:latest

4.6 网络配置

Neo4j 默认使用以下端口，需根据场景映射到宿主机：

• 7474：HTTP 协议（Web 管理界面）
• 7687：Bolt 协议（应用程序连接，推荐用于高性能查询）

示例端口映射：

docker run -d -p 7474:7474 -p 7687:7687 neo4j/experimental:latest

5. 注意事项

1. 实验性风险：镜像可能包含未稳定的功能或 Bug，数据安全和服务可用性无法保证。
2. 版本兼容性：不同实验版本的配置方式、环境变量可能存在差异，升级前需备份数据并验证兼容性。
3. 数据备份：建议定期通过 /data 卷备份数据，避免因镜像问题导致数据丢失。
4. 官方支持：本镜像不提供官方技术支持，生产环境请使用 Docker Hub 官方 Neo4j 镜像。

6. 问题反馈

如在使用中遇到问题或有疑问，请通过 GitHub Issue 提交反馈。