配置网络连接器

Neo4j 通过网络连接器支持 Bolt、HTTP 和 HTTPS 协议。网络连接器在 neo4j.conf 文件中配置。

可用网络连接器

下表列出了 Neo4j 中可用的网络连接器

表 1. Neo4j 网络连接器和端口号
网络连接器名称	协议	默认端口号
`server.bolt`	Bolt	`7687`
`server.http`	HTTP	`7474`
`server.https`	HTTPS	`7473`

配置 HTTPS 或 Bolt 连接器时，另请参阅 SSL 框架，了解如何使用 SSL 证书的详细信息。

配置选项

网络连接器通过 server.<network-connector-name>.<setting-suffix>> 格式的设置进行配置。

表 2. 网络连接器的配置选项后缀
选项名称	默认值	设置	描述
`enabled`	`true` ^[1]	`server.bolt.enabled`, `server.http.enabled`, `server.https.enabled` ^[2]	此设置允许启用或禁用客户端连接器。禁用时，Neo4j 不会监听相关端口上的传入连接。
`listen_address`	`localhost:<网络连接器默认端口>`	`server.bolt.listen_address`, `server.https.listen_address`, `server.http.listen_address`	此设置指定 Neo4j 如何监听传入连接。它由两部分组成：IP 地址（例如 127.0.0.1 或 0.0.0.0）和端口号（例如 7687），格式为 `<ip-address>:<port-number>`。有关使用示例，请参见下文。
`advertised_address`	`localhost:<网络连接器默认端口>`	`server.bolt.advertised_address`, `server.https.advertised_address`, `server.http.advertised_address`	此设置指定客户端应为此网络连接器使用的地址。这在集群中很有用，因为它允许每个服务器正确通告集群中其他服务器的地址。通告地址由两部分组成：地址（完全限定域名、主机名或 IP 地址）和端口号（例如 7687），格式为 `<address>:<port-number>`。有关使用示例，请参见下文。
`tls_level`	`DISABLED`	`server.bolt.tls_level`	此设置仅适用于 Bolt 连接器。它允许 Bolt 连接器接受加密和/或未加密的连接。默认值为 `DISABLED`，表示此连接器只接受未加密的客户端连接，所有加密连接都将被拒绝。其他值为 `REQUIRED` 和 `OPTIONAL`。当此连接器只接受加密客户端连接，并且所有未加密连接都将被拒绝时，请使用 `REQUIRED`。当此连接器接受加密或未加密客户端连接时，请使用 `OPTIONAL`。
1. 当 Neo4j 以嵌入模式使用时，默认值为 `false`。 2. `server.https.enabled` 的默认值为 `false`。

示例 1. 为 Bolt 连接器指定 listen_address

要在所有网络接口 (0.0.0.0) 和端口 7000 上监听 Bolt 连接，请为 Bolt 连接器设置 listen_address

server.bolt.listen_address=0.0.0.0:7000

示例 2. 为 Bolt 连接器指定 advertised_address

如果通过代理路由流量，或者正在使用端口映射，则可以为每个网络连接器单独指定 advertised_address。例如，如果 Neo4j 服务器上的端口 7687 映射到外部网络上的端口 9000，请为 Bolt 连接器指定 advertised_address

server.bolt.advertised_address=<server-name>:9000

Bolt 线程池选项

请参阅 Bolt 线程池配置，了解有关 Bolt 线程池以及如何在网络连接器级别配置它的更多信息。

地址的默认值

可以为带有 listen_address 和 advertised_address 后缀的配置选项指定默认值。设置默认值将应用于所有网络连接器，除非针对特定连接器进行了单独配置。

server.default_listen_address

此配置选项定义了所有网络连接器中带有 listen_address 后缀的设置的默认 IP 地址。如果未指定 listen_address 的 IP 地址部分，它将继承自共享设置 server.default_listen_address。

示例 3. 为 Bolt 连接器指定 listen_address

要在所有网络接口 (0.0.0.0) 和端口 7000 上监听 Bolt 连接，请为 Bolt 连接器设置 listen_address

server.bolt.listen_address=0.0.0.0:7000

这等效于使用 server.default_listen_address 设置指定 IP 地址，然后为 Bolt 连接器指定端口号。

server.default_listen_address=0.0.0.0

server.bolt.listen_address=:7000

server.default_advertised_address

此配置选项定义了所有网络连接器中带有 advertised_address 后缀的设置的默认地址。如果未指定 advertised_address 的地址部分，它将继承自共享设置 server.default_advertised_address。

示例 4. 为 Bolt 连接器指定 advertised_address

指定客户端应为 Bolt 连接器使用的地址

server.bolt.advertised_address=server1:9000

这等效于使用 server.default_advertised_address 设置指定地址，然后为 Bolt 连接器指定端口号。

server.default_advertised_address=server1

server.bolt.advertised_address=:9000

默认地址设置只能接受完整套接字地址的主机名或 IP 地址部分。端口号是协议特定的，并且只能通过协议特定的网络连接器配置添加。

例如，如果您将默认地址值配置为 example.com:9999，Neo4j 将无法启动，并且您将在 neo4j.log 中收到错误。