› › ›

高级配置

通常不建议修改高级设置，因为这可能会对性能和稳定性产生负面影响。在大多数情况下，建议使用 Elasticsearch 提供的默认值。

如有需要，您可以通过添加自定义选项文件（推荐）或设置 ES_JAVA_OPTS 环境变量来覆盖默认的 JVM 选项。

JVM 选项文件必须以 .options 结尾，并包含一个以换行符分隔的 JVM 参数列表。JVM 按字典顺序处理选项文件。

JVM 选项文件的位置取决于安装类型。

不要修改根 jvm.options 文件。请改用 jvm.options.d/ 中的文件。

JVM 选项文件包含一个以换行符分隔的 JVM 参数列表。参数前缀为一个短横线 (-)。要将设置应用于特定版本，请在前面添加版本或版本范围，后跟一个冒号。

空行将被忽略。以 # 开头的行被视为注释并被忽略。未注释且未被识别为有效 JVM 参数的行将被拒绝，Elasticsearch 将无法启动。

在生产环境中，请使用 JVM 选项文件来覆盖默认设置。在测试和开发环境中，您也可以通过 ES_JAVA_OPTS 环境变量来设置 JVM 选项。

export ES_JAVA_OPTS="$ES_JAVA_OPTS -Djava.io.tmpdir=/path/to/temp/dir"
./bin/elasticsearch

如果您使用的是 RPM 或 Debian 包，则可以在系统配置文件中指定 ES_JAVA_OPTS。

Elasticsearch 忽略 JAVA_TOOL_OPTIONS 和 JAVA_OPTS 环境变量。

默认情况下，Elasticsearch 会根据节点的角色和总内存自动设置 JVM 堆大小。对于大多数生产环境，建议使用默认大小。

要覆盖默认堆大小，请设置最小和最大堆大小设置，Xms 和 Xmx。最小值和最大值必须相同。

堆大小应基于可用 RAM。

将 Xms 和 Xmx 设置为不超过总内存的 50%。Elasticsearch 需要用于 JVM 堆以外的目的的内存。例如，Elasticsearch 使用堆外缓冲区进行高效的网络通信，并依赖于操作系统的文件系统缓存来高效地访问文件。JVM 本身也需要一些内存。Elasticsearch 使用的内存超过使用 Xmx 设置配置的限制是正常的。

在容器（例如 Docker）中运行时，总内存定义为容器可见的内存量，而不是主机上的总系统内存。
将 Xms 和 Xmx 设置为不超过压缩普通对象指针 (oops) 的阈值。确切的阈值会有所不同，但在大多数系统上 26GB 是安全的，在某些系统上可以高达 30GB。要验证您是否低于阈值，请检查 Elasticsearch 日志中是否存在类似这样的条目：
```
heap size [1.9gb], compressed ordinary object pointers [true]
```
或者使用节点信息 API 检查节点的 jvm.using_compressed_ordinary_object_pointers 值。
```
resp = client.nodes.info(
    node_id="_all",
    metric="jvm",
)
print(resp)
```
```
response = client.nodes.info(
  node_id: '_all',
  metric: 'jvm'
)
puts response
```
```
const response = await client.nodes.info({
  node_id: "_all",
  metric: "jvm",
});
console.log(response);
```
```
GET _nodes/_all/jvm
```

Elasticsearch 可用的堆越多，它就可以为其内部缓存使用越多的内存。这会为操作系统留下较少的内存来用于文件系统缓存。更大的堆也可能导致更长的垃圾回收暂停。

要配置堆大小，请将 Xms 和 Xmx JVM 参数添加到扩展名为 .options 的自定义 JVM 选项文件，并将其存储在 jvm.options.d/ 目录中。例如，要将最大堆大小设置为 2GB，请将 Xms 和 Xmx 都设置为 2g。

-Xms2g
-Xmx2g

为了测试，您也可以使用 ES_JAVA_OPTS 环境变量来设置堆大小。

ES_JAVA_OPTS="-Xms2g -Xmx2g" ./bin/elasticsearch

ES_JAVA_OPTS 变量会覆盖所有其他 JVM 选项。我们不建议在生产环境中使用 ES_JAVA_OPTS。

如果您正在将 Elasticsearch 作为 Windows 服务运行，则可以使用服务管理器更改堆大小。请参阅在 Windows 上安装和运行 Elasticsearch 作为服务。

此功能处于技术预览阶段，可能会在将来的版本中更改或删除。Elastic 将努力修复任何问题，但技术预览中的功能不受官方 GA 功能的支持 SLA 的约束。

如果已配置，则节点可以在节点处于就绪状态时打开 TCP 端口。当节点成功加入集群时，则认为节点已准备就绪。在单节点配置中，当节点能够接受请求时，则认为节点已准备就绪。

要启用就绪 TCP 端口，请使用 readiness.port 设置。就绪服务将绑定到所有主机地址。

如果节点离开集群，或者使用关闭 API 将节点标记为关闭，则就绪端口将立即关闭。

成功连接到就绪 TCP 端口表示 Elasticsearch 节点已准备就绪。当客户端连接到就绪端口时，服务器只需终止套接字连接。不会向客户端发送任何数据。如果客户端无法连接到就绪端口，则节点未准备就绪。