修改默认配置

Neo4j 镜像提供的默认配置旨在用于学习 Neo4j，但必须修改以使其适用于生产环境。特别是，Neo4j 的默认内存分配非常有限（NEO4J_server_memory_pagecache_size=512M 和 NEO4J_server_memory_heap_max__size=512M），以允许多个容器在同一服务器上运行。您可以在Docker 特定配置设置中了解更多关于配置 Neo4j 的信息。

有三种修改配置的方法

设置环境变量。
挂载 /conf 卷。
构建新镜像。

选择哪种方法取决于您需要自定义镜像的程度。

环境变量

在运行容器时向其传递环境变量，例如

docker run \
    --detach \
    --publish=7474:7474 --publish=7687:7687 \
    --volume=$HOME/neo4j/data:/data \
    --volume=$HOME/neo4j/logs:/logs \
    --env NEO4J_dbms_memory_pagecache_size=4G \
    neo4j:2025.05.0

任何配置值（参见配置设置）都可以使用以下命名方案传递

以 NEO4J_ 为前缀。
下划线必须写两次：_ 写为 __。
句点转换为下划线：. 写为 _。

例如，可以通过向 Docker 指定以下参数来设置 db.tx_log.rotation.size

--env NEO4J_db_tx__log_rotation_size

可以接受多个选项的变量，例如 NEO4J_server_jvm_additional，必须只定义一次，并包含多个值的拼接。例如

--env NEO4J_server_jvm_additional="-Dcom.sun.management.jmxremote.authenticate=true -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.password.file=$HOME/conf/jmx.password -Dcom.sun.management.jmxremote.access.file=$HOME/conf/jmx.access -Dcom.sun.management.jmxremote.port=3637"

通过环境变量为 JVM 设置的 Docker 附加配置不会覆盖默认的 JVM 配置，而是附加到其后。

挂载 /conf 卷

要对 Neo4j 配置进行任意修改，请为容器提供一个 /conf 卷

docker run \
    --detach \
    --publish=7474:7474 --publish=7687:7687 \
    --volume=$HOME/neo4j/data:/data \
    --volume=$HOME/neo4j/logs:/logs \
    --volume=$HOME/neo4j/conf:/conf \
    neo4j:2025.05.0

/conf 卷中的配置文件会覆盖镜像提供的文件。因此，如果您想更改文件中的一个值，则必须确保文件的其余部分完整且正确。Docker 传递给容器的环境变量会覆盖 /conf 卷中配置文件中的值。

如果您使用配置卷，则必须确保监听所有网络接口。这可以通过设置 server.default_listen_address=0.0.0.0 来完成。

要转储初始配置集文件，请使用 dump-config 命令运行镜像。您必须将 neo4j 用户设置为 $HOME/neo4j/conf 的所有者，以允许 Neo4j Docker 容器进行写入访问

sudo chown neo4j:neo4j $HOME/neo4j/conf

Neo4j docker 容器中的进程默认以 neo4j 用户运行。

docker run --rm \
    --volume=$HOME/neo4j/conf:/conf \
    neo4j:2025.05.0 dump-config

自定义 Neo4j Docker 镜像

要自定义 Neo4j Docker 镜像，您可以创建一个基于 Neo4j 镜像（使用 FROM 指令）的自定义 Dockerfile，构建该镜像，然后运行基于该镜像的容器。

建议指定基础 Neo4j Docker 镜像的明确版本。有关可用的 Neo4j Docker 镜像，请参阅 https://hub.docker.com/_/neo4j。

此外，您可以将 EXTENSION_SCRIPT 作为环境变量传递，指向您需要挂载的文件夹中的位置。您可以使用此脚本执行额外的环境初始化或配置，例如，加载凭据或动态设置 neo4j.conf 设置等。Neo4j 镜像的 entrypoint 脚本将检查是否存在 EXTENSION_SCRIPT 环境变量。如果已设置，它将首先执行 entrypoint 代码，然后执行指定的扩展脚本，最后启动 Neo4j。

以下是根据 Neo4j 镜像创建自定义 Dockerfile、构建镜像并运行基于该镜像的容器的示例。它还展示了如何使用 EXTENSION_SCRIPT 功能。

# Create a custom Dockerfile based on a Neo4j image:

/example/Dockerfile

FROM neo4j:2025.05.0-enterprise
COPY extension_script.sh /extension_script.sh
ENV EXTENSION_SCRIPT=/extension_script.sh

/example/extension_script.sh

echo "extension logic"

# Build the custom image:

docker build --file /example/Dockerfile --tag neo4j:2025.05.0-enterprise-custom-container-1 /example

# Create and run a container based on the custom image:

docker run --interactive --tty --name custom-container-1 -p7687:7687 -p7474:7474 -p7473:7473 --env NEO4J_AUTH=neo4j/your_password --env NEO4J_ACCEPT_LICENSE_AGREEMENT=yes neo4j:2025.05.0-enterprise-custom-container-1

构建高效 Docker 镜像的推荐最佳实践和方法可以在Docker 文档 → 编写 Dockerfile 的最佳实践中找到。