默认文件位置

Neo4j 目录

本页面介绍了 Neo4j 的各个目录，指明了它们在不同发行版中的默认位置以及最低文件权限要求。

如果 Neo4j 是通过 tar.gz 或 zip 归档文件安装的，<NEO4J_HOME> 指代归档文件解压后的存放路径。

针对 Neo4j Desktop 提供的说明适用于支持 Neo4j Desktop 的所有操作系统。

如果 tmp 被设置为 noexec，建议在 conf/neo4j.conf 中设置 server.jvm.additional=-Djava.io.tmpdir=/home/neo4j，并将 /home/neo4j 替换为具有 exec 权限的路径。

对于 /bin/cypher-shell，可通过环境变量设置：export JAVA_OPTS=-Djava.io.tmpdir=/home/neo4j，并将 /home/neo4j 替换为具有 exec 权限的路径。

对于 Neo4j 使用的 Java Native Access (JNA) 库，请在 conf/neo4j.conf 中设置 server.jvm.additional=-Djna.tmpdir=/tmp，并将 /tmp 替换为具有 exec 权限的路径。

Bin

bin 目录包含 Neo4j 运行脚本和内置工具，例如 Cypher Shell 和 Neo4j Admin 及 Neo4j CLI。

文件权限

只读和执行。

表 1. 各发行版中 bin 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/bin

Windows

<NEO4J_HOME>\bin

Debian / RPM

/usr/bin

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal 并运行 cd bin。

Certificates（证书）

certificates 目录包含 Neo4j TLS 证书。

文件权限

只读。

表 2. 各发行版中 certificates 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/certificates

Windows

<NEO4J_HOME>\certificates

Debian / RPM

/var/lib/neo4j/certificates

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal 并运行 cd certificates。

Configuration（配置）

configuration 目录包含 Neo4j 配置设置、Log4j 配置设置以及 JMX 访问凭据。有关 neo4j.conf 的详细信息，请参阅 The neo4j.conf file。

文件权限

只读

表 3. 各发行版中 configuration 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/conf/neo4j.conf
<NEO4J_HOME>/conf/neo4j-admin.conf
<NEO4J_HOME>/conf/server-logs.xml
<NEO4J_HOME>/conf/user-log.xml

Windows

<NEO4J_HOME>\conf\neo4j.conf
<NEO4J_HOME>\conf\neo4j-admin.conf
<NEO4J_HOME>\conf\server-logs.xml
<NEO4J_HOME>\conf\user-log.xml

Debian / RPM

/etc/neo4j/neo4j.conf
/etc/neo4j/neo4j-admin.conf
/etc/neo4j/server-logs.xml
/etc/neo4j/user-log.xml

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal 并运行 cd conf。

Data（数据）

data 目录包含所有与数据相关的内容，例如数据库、事务、集群状态（如果适用）、转储文件以及 cypher.script 文件（来自 neo4j-admin database restore 命令）。数据目录是 Neo4j 的内部目录，其结构可能会在不同版本间发生变化，恕不另行通知。

文件权限

读写。

表 4. 各发行版中 data 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/data

Windows

<NEO4J_HOME>\data

Debian / RPM

/var/lib/neo4j/data

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal，并运行 cd data。

Import（导入）

import 目录包含 LOAD CSV 命令用于向 Neo4j 导入数据的所有 CSV 文件。

文件权限

只读

表 5. 各发行版中 import 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/import

Windows

<NEO4J_HOME>\import

Debian / RPM

/var/lib/neo4j/import

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal，并运行 cd import。

Labs

labs 目录包含 APOC Core。更多信息，请参阅 APOC 用户指南 → 安装。

文件权限

只读。

表 6. 各发行版中 labs 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/labs

Windows

<NEO4J_HOME>\labs

Debian / RPM

/var/lib/neo4j/labs

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal，并运行 cd labs。

Lib

lib 目录包含所有 Neo4j 依赖项。

文件权限

只读。

表 7. 各发行版中 lib 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/lib

Windows

<NEO4J_HOME>\lib

Debian / RPM

/usr/share/neo4j/lib

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal，并运行 cd lib。

Licenses（许可证）

licenses 目录包含 Neo4j 许可证文件。

文件权限

只读。

表 8. 各发行版中 licenses 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/licenses

Windows

<NEO4J_HOME>\licenses

Debian / RPM

/var/lib/neo4j/licenses

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal，并运行 cd licences。

Logs（日志）

logs 目录包含 Neo4j 日志文件。

文件权限

读写。

表 9. 各发行版中 logs 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/logs [1]

Windows

<NEO4J_HOME>\logs

Debian / RPM

/var/log/neo4j/ [2]

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal，并运行 cd logs。
1. 若要在 Docker 中查看 neo4j.log，请使用 docker logs <containerID/name>。
2. 若要查看 Debian 和 RPM 的 neo4j.log，请使用 journalctl --unit=neo4j。

Metrics（度量标准）

metrics 目录包含用于监控 Neo4j DBMS 及每个独立数据库的 Neo4j 内置度量标准。

文件权限

读写。

表 10. 各发行版中 metrics 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/metrics

Windows

<NEO4J_HOME>\metrics

Debian / RPM

/var/lib/neo4j/metrics

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal，并运行 cd metrics。

Plugins（插件）

plugins 目录包含扩展 Neo4j 的自定义代码，例如用户定义的存储过程、函数和安全插件。

文件权限

只读。

表 11. 各发行版中 plugins 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/plugins

Windows

<NEO4J_HOME>\plugins

Debian / RPM

/var/lib/neo4j/plugins

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal，并运行 cd plugins。

Products（产品）

products 目录包含 Neo4j 产品的 JAR 文件。

对于企业版 (Enterprise Edition)，这些包括：

社区版 (Community Edition) 包含：

在 Neo4j CE 部署中使用 Fleet management 插件会受到一些功能限制（例如无法使用度量标准）。此外，它以“尽力而为”的方式提供。Neo4j 不为其提供任何技术支持。
文件权限

只读。

表 12. 各发行版中 products 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/products

Windows

<NEO4J_HOME>\products

Debian / RPM

/var/lib/neo4j/products

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal，并运行 cd products。

Run

run 目录包含进程 ID。

文件权限

读写。

表 13. 各发行版中 run 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/run

Windows

<NEO4J_HOME>\run

Debian / RPM

/var/lib/neo4j/run

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal，并运行 cd run。

Web
2026.02.3 版本引入

从 Neo4j 2026.02.3 开始，Neo4j 社区版引入了一个新目录 web。web 目录包含作为 .zip 文件打包的 Neo4j Browser。

Neo4j 企业版不包含 web 目录；Neo4j Browser 继续作为位于 lib 目录中的 .jar 文件进行分发。

文件权限

只读。

表 14. 各发行版中 web 目录的默认位置
Neo4j 发行版 默认文件位置

Linux / macOS / Docker

<NEO4J_HOME>/web

Windows

<NEO4J_HOME>\web

Debian / RPM

/var/lib/neo4j/web

Neo4j Desktop

从您活跃的 Neo4j DBMS 的 Open 下拉菜单中，选择 Terminal，并运行 cd web。

自定义您的文件位置

文件位置也可以通过环境变量和选项进行自定义。

<NEO4J_HOME> 和 conf 的位置可以通过环境变量进行配置。

表 15. <NEO4J_HOME> 和 conf 的配置
位置 默认 环境变量 说明

<NEO4J_HOME>

bin 的父目录

NEO4J_HOME

如果 bin 不是子目录，则必须显式设置此项。

conf

<NEO4J_HOME>/conf

NEO4J_CONF

如果它不是 <NEO4J_HOME> 的子目录，则必须显式设置此项。

其余位置可以通过取消 conf/neo4j.conf 文件中相应设置的注释并更改默认值来进行配置。

#server.directories.data=data
#server.directories.plugins=plugins
#server.directories.logs=logs
#server.directories.lib=lib
#server.directories.run=run
#server.directories.licenses=licenses
#server.directories.metrics=metrics
#server.directories.transaction.logs.root=data/transactions
#server.directories.dumps.root=data/dumps
#server.directories.import=import

安全注意事项

如果某个目录存储敏感数据，则绝不能对其进行全局可读或全局可执行的设置。即使限制了内部文件，全局可执行的目录也可能泄露结构信息。

  • 在 Linux 上，请遵循以下建议：

    场景 推荐模式

    仅所有者可访问

    700

    所有者和特定组可能具有访问权限

    750

    确保创建该目录的进程使用严格的 umask（例如 077），以防止出现过于宽松的默认设置。

  • 在 Windows 上，仅允许拥有该目录的帐户（或服务帐户）和 Administrators 组访问。移除 Users、Authenticated Users 和 Everyone 的访问权限。
    在移除宽泛权限之前，请禁用该目录上的权限继承，否则这些权限可能会从父目录中重新引入。

创建备份文件目录时，请考虑上述安全建议。