Bitnami Neo4j 镜像文档

镜像概述和主要用途

Neo4j 是一个高性能图数据库，具备成熟稳健数据库的所有特性，如友好的查询语言和ACID事务支持。Bitnami Neo4j 镜像将 Neo4j 打包为容器化应用，提供简单、可靠且安全的部署方式，适用于开发和生产环境。

Neo4j 官方网站

商标说明：本软件列表由 Bitnami 打包。所提及的 respective 商标归各自公司所有，使用这些商标并不意味着任何关联或认可。

核心功能和特性

• 高性能图数据库引擎，专为存储和查询图结构数据优化
• 支持 Cypher 查询语言，专为图数据模型设计
• 完整 ACID 事务支持，确保数据一致性
• 水平和垂直扩展能力
• 企业级特性：高可用性、备份、监控和安全控制
• Bitnami 优化：精简镜像大小、安全强化、简单配置接口

使用场景和适用范围

• 社交网络和关系分析
• 推荐系统和个性化服务
• 知识图谱构建与查询
• 网络和基础设施监控
• 欺诈检测和安全分析
• 路径查找和路由优化
• 生物信息学和药物研发
• 供应链和物流管理

快速开始

使用 Helm 安装（Kubernetes）

helm install my-release oci://registry-1.docker.io/bitnamicharts/neo4j

重要通知：Bitnami 镜像目录即将变更

自2025年8月28日起，Bitnami 将升级其公共目录，在新的 Bitnami Secure Images 计划下提供精选的强化安全镜像：

• 首次向社区用户提供流行容器镜像的安全优化版本
• Bitnami 将开始在免费层中弃用对非强化的基于 Debian 的软件镜像的支持，并逐步从公共目录中移除非最新标签
• 从8月28日开始，在两周内，所有现有容器镜像，包括旧版本或特定版本标签（如 2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移到"Bitnami Legacy"仓库（docker.io/bitnamilegacy），不再接收更新
• 对于生产工作负载和长期支持，建议采用 Bitnami Secure Images，包括强化容器、更小的攻击面、CVE 透明度（通过 VEX/KEV）、SBOM 和企业支持

详细使用方法和配置说明

前提条件

• Kubernetes 1.23+（使用 Helm Chart 时）
• Helm 3.8.0+（使用 Helm Chart 时）
• 底层基础设施支持 PV 供应器
• 用于部署扩展的 ReadWriteMany 卷

Docker 运行命令

# 基本运行
docker run --name neo4j -p 7474:7474 -p 7687:7687 bitnami/neo4j:latest

# 带持久化存储
docker run --name neo4j -p 7474:7474 -p 7687:7687 \
  -v /path/to/neo4j/data:/bitnami \
  bitnami/neo4j:latest

# 自定义认证信息
docker run --name neo4j -p 7474:7474 -p 7687:7687 \
  -e NEO4J_PASSWORD=mysecretpassword \
  bitnami/neo4j:latest

Docker Compose 配置

version: '3'

services:
  neo4j:
    image: bitnami/neo4j:latest
    ports:
      - "7474:7474"
      - "7687:7687"
    environment:
      - NEO4J_PASSWORD=mysecretpassword
    volumes:
      - neo4j_data:/bitnami
    networks:
      - neo4j_network

networks:
  neo4j_network:
    driver: bridge

volumes:
  neo4j_data:
    driver: local

Kubernetes 部署（Helm Chart）

安装 Helm Chart

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/neo4j

注意：需要将占位符 REGISTRY_NAME 和 REPOSITORY_NAME 替换为 Helm 图表仓库和仓库名称。例如，Bitnami 官方仓库使用 REGISTRY_NAME=registry-1.docker.io 和 REPOSITORY_NAME=bitnamicharts。

升级 Chart

helm upgrade my-release oci://registry-1.docker.io/bitnamicharts/neo4j

卸载 Chart

helm uninstall my-release

配置参数

全局参数

通用参数

Neo4j 特定参数

环境变量

持久化配置

Bitnami Neo4j 镜像将数据和配置存储在容器的 /bitnami 路径下。持久卷声明（PVC）用于在部署之间保留数据。

Docker 持久化

docker run --name neo4j -v /path/to/neo4j/data:/bitnami bitnami/neo4j:latest

Kubernetes 持久化

persistence:
  enabled: true
  storageClass: "standard"
  accessModes:
    - ReadWriteOnce
  size: 8Gi
  annotations: {}

网络配置

服务配置

Ingress 配置

ingress:
  enabled: false
  hostname: neo4j.example.com
  annotations: {}
  tls: false
  secrets: []

安全配置

TLS 加密

要启用 TLS 支持，需配置以下参数：

tls:
  enabled: true
  existingSecret: "neo4j-tls-secret"
  certFilename: "cert.pem"
  certKeyFilename: "cert.key"
  certCAFilename: "ca.pem"

创建 TLS 密钥：

kubectl create secret generic neo4j-tls-secret --from-file=./cert.pem --from-file=./cert.key --from-file=./ca.pem

更新凭据

Bitnami 图表在首次启动时配置凭据。后续对密钥或凭据的任何更改都需要手动干预：

1. 按照上游文档更新用户密码
2. 使用新值更新密码密钥：

kubectl create secret generic SECRET_NAME --from-literal=password=PASSWORD --dry-run -o yaml | kubectl apply -f -

备份与恢复

要在 Kubernetes 上备份和恢复 Helm 图表部署，需要使用 Velero 备份源部署的持久卷并将其附加到新部署。

基本备份步骤

1. 安装 Velero
2. 创建备份：

   velero backup create neo4j-backup --include-resources=pvc,pv
   

3. 恢复备份：

   velero restore create --from-backup neo4j-backup
   

故障排除

持久卷问题

如果使用持久卷时遇到错误，请参考 Bitnami 的持久卷故障排除指南。

诊断模式

启用诊断模式以排查部署问题：

diagnosticMode:
  enabled: true
  command: ["sleep"]
  args: ["infinity"]

镜像变更通知

自2025年8月28日起，Bitnami 将对其容器镜像进行重大调整：

• 所有现有容器镜像（包括旧版本或特定版本标签）将从 docker.io/bitnami 迁移到 docker.io/bitnamilegacy
• 迁移后的镜像将不再接收更新
• 社区用户将可以访问安全优化版本的容器镜像
• 非强化的 Debian 基础镜像将逐步被弃用

建议生产环境用户采用 Bitnami Secure Images，以获得强化容器、更小的攻击面和长期支持。

完整文档请访问 Bitnami Neo4j Helm Chart GitHub 仓库