neo4jchina/neo4j-chs

Neo4j 简体中文版 Docker 镜像

镜像概述

Neo4j 简体中文版 Docker 镜像（neo4jchina/neo4j-chs:4.2.1）是针对中文用户优化的图数据库镜像，基于官方 Neo4j 4.2.1 版本构建，集成了中文界面支持，保留了 Neo4j 完整的图数据库功能，同时提供本地化的使用体验，降低中文用户的上手门槛。

核心功能与特性

• 完整图数据库能力：基于官方 Neo4j 4.2.1 版本，支持 ACID 事务、Cypher 查询语言、高性能图遍历与分析等核心功能。
• 中文界面支持：管理界面、提示信息等内容本地化，适配中文用户操作习惯。
• 轻量部署：Docker 容器化封装，支持快速启动、跨环境一致性部署。
• 兼容性：完全兼容 Neo4j 4.2.1 的数据格式与 API，可无缝迁移现有 Neo4j 应用。

使用场景

• 中文开发团队的图数据库应用开发、测试与生产环境部署。
• 学习 Neo4j 图数据库的中文用户（降低语言障碍）。
• 需要中文界面的企业内部图数据库服务（如知识图谱、社交关系分析等场景）。

使用方法

基本启动命令

通过 docker run 快速启动容器，映射必要端口：

bash
docker run --publish=7474:7474 --publish=7687:7687 docker.xuanyuan.run/neo4jchina/neo4j-chs:4.2.1

• 端口说明：
  • 7474：Neo4j Web 管理界面端口（HTTP 协议）。
  • 7687：Neo4j Bolt 协议端口（应用程序通过 Bolt 驱动连接的默认端口）。

配置访问认证

默认情况下，Neo4j 启动时需要设置初始密码。通过环境变量 NEO4J_AUTH 预配置用户名和密码：

bash
docker run \
  --publish=7474:7474 --publish=7687:7687 \
  --env=NEO4J_AUTH=neo4j/your_secure_password \  # 格式：用户名/密码
  neo4jchina/neo4j-chs:4.2.1

数据持久化配置

为避免容器重启后数据丢失，需挂载本地目录持久化存储数据：

bash
docker run \
  --publish=7474:7474 --publish=7687:7687 \
  --volume=/path/to/local/neo4j/data:/data \  # 本地数据目录映射到容器内 /data
  neo4jchina/neo4j-chs:4.2.1

注意：本地目录需提前创建并赋予读写权限（如 mkdir -p /path/to/local/neo4j/data && chmod 777 /path/to/local/neo4j/data）。

Docker Compose 配置示例

创建 docker-compose.yml 文件，支持更复杂的服务编排：

yaml
version: '3'
services:
  neo4j-chs:
    image: docker.xuanyuan.run/neo4jchina/neo4j-chs:4.2.1
    ports:
      - "7474:7474"   # Web 管理界面
      - "7687:7687"   # Bolt 协议端口
    environment:
      - NEO4J_AUTH=neo4j/admin123  # 配置用户名/密码
    volumes:
      - ./neo4j-data:/data         # 本地数据持久化
    restart: unless-stopped        # 容器退出时自动重启（非手动停止情况）

启动命令：docker-compose up -d（后台运行）。

访问与验证

容器启动后，通过以下方式访问服务：

• Web 管理界面：浏览器访问 http://localhost:7474，使用配置的用户名/密码登录（默认初始密码需首次登录时修改，或通过 NEO4J_AUTH 预配置）。
• 应用程序连接：通过 Bolt 驱动连接 bolt://localhost:7687，使用认证信息进行数据操作。

注意事项

• 生产环境建议配置数据持久化（挂载 /data 目录），并通过环境变量设置强密码。
• 如需调整 JVM 参数、日志配置等高级选项，可通过挂载配置文件（如 /conf/neo4j.conf）实现自定义。