# ---------------------------------- Cluster -----------------------------------
cluster.name: my-cluster
# 集群的名称
node.name: node-1
# 节点的名称
node.master: true
# 是否允许节点成为主节点(默认为 true)
node.data: true
# 是否允许节点存储数据(默认为 true)
# ----------------------------------- Paths ------------------------------------
path.data: /path/to/data
# 数据文件的存储路径
path.logs: /path/to/logs
# 日志文件的存储路径
# ---------------------------------- Network -----------------------------------
network.host: 0.0.0.0
# 监听的网络接口地址(默认为 0.0.0.0,即监听所有接口)
http.port: 9200
# HTTP 通信使用的端口号(默认为 9200)
transport.tcp.port: 9300
# 节点间通信使用的 TCP 端口号(默认为 9300)
# --------------------------------- Discovery ----------------------------------
discovery.seed_hosts: [ "host1", "host2" ]
# 发现初始主机节点的地址列表,用于集群自动发现
cluster.initial_master_nodes: [ "node-1", "node-2" ]
# 初始主节点列表,用于集群自动发现
# ---------------------------------- Gateway -----------------------------------
gateway.recover_after_nodes: 3
# 节点数达到指定数量后,才开始恢复数据(默认为 3)
gateway.expected_nodes: 5
# 预期的节点数量,用于恢复数据(默认为 5)
# ---------------------------------- Memory ------------------------------------
bootstrap.memory_lock: true
# 是否锁定 Elasticsearch 进程的内存(需要设置文件系统权限)
# ---------------------------------- Various -----------------------------------
action.destructive_requires_name: true
# 在执行危险操作(如删除索引)时,需要显式指定操作名称(默认为 true)
# ---------------------------------- Security ----------------------------------
xpack.security.enabled: true
# 是否启用 X-Pack 安全功能(默认为 false)
xpack.security.authc.api_key.enabled: true
# 是否启用 API 密钥认证(默认为 false)
# ---------------------------------- Logging ----------------------------------
logger.org.elasticsearch.transport: debug
# 日志级别设置(可选:trace, debug, info, warn, error, fatal)
cluster.name
是 Elasticsearch 配置文件中的一个重要选项,用于指定集群的名称。每个运行的 Elasticsearch 实例都必须具有相同的集群名称才能加入同一个集群。
cluster.name: my-cluster
cluster.name
是一个自定义的字符串,用于标识一个 Elasticsearch 集群。集群名称可以是任何合法的字符串,但最好选择一个具有描述性的名称,以便在多个集群之间区分。
cluster.name
值。这样,它们才能相互发现并协同工作,共享数据和状态。
cluster.name
选项的值,需要确保所有节点都使用相同的集群名称,并重新启动它们才能生效。
cluster.name
设置为唯一的名称。
确保在配置 Elasticsearch 集群时,将所有节点的cluster.name
选项设置为相同的值,以确保它们能够正常加入同一个集群并协同工作。
node.name
是 Elasticsearch 配置文件中的一个选项,用于指定节点的名称。每个运行的 Elasticsearch 节点都应该具有唯一的名称,以便在集群中进行识别和通信。
node.name: node-1
node.name
是一个自定义的字符串,用于标识一个 Elasticsearch 节点。节点名称可以是任何合法的字符串,但最好选择一个具有描述性的名称,以便在集群中识别和管理节点。
node.name
值,以避免与其他节点发生冲突。
node.name
选项的值,需要确保每个节点都使用唯一的名称,并重新启动它们才能生效。
node.name
选项,Elasticsearch 会自动生成一个随机的节点名称。
在配置 Elasticsearch 节点时,确保为每个节点设置唯一的node.name
值,以便在集群中正确识别和管理节点。这将有助于确保节点之间的正常通信和协作。
node.master
是 Elasticsearch 配置文件中的一个选项,用于指定节点是否可以成为主节点。主节点负责集群中的元数据管理和协调工作。
node.master: true
node.master
是一个布尔值选项,用于指定节点是否可以成为主节点。默认情况下,它的值为true
,表示节点可以担任主节点的角色。
node.master
选项设置为false
。
确保在配置节点时,根据集群的需求和规模,正确设置node.master
选项,以确保主节点的角色分配和集群的正常运行。
node.data
是 Elasticsearch 配置文件中的一个选项,用于指定节点是否可以存储数据。数据节点负责存储和处理索引数据。
node.data: true
node.data
是一个布尔值选项,用于指定节点是否可以存储数据。默认情况下,它的值为true
,表示节点可以作为数据节点。
node.data
选项设置为false
。
确保在配置节点时,根据集群的需求和规模,正确设置node.data
选项,以确保数据节点的角色分配和集群的正常运行。
path.data
是 Elasticsearch 配置文件中的一个选项,用于指定数据文件的存储路径。
以下是对path.data
选项的详细解释:
path.data: /path/to/data
path.data
用于指定 Elasticsearch 存储索引数据的路径。这个路径可以是一个本地文件系统的目录,也可以是一个挂载的网络文件系统(NFS)路径。
/path/to/data
替换为实际的数据存储路径。
data
的子目录,并在该目录下存储索引数据。
path.data
选项来指定自定义的数据存储路径。确保目录具有适当的权限,以便 Elasticsearch 进程可以读取和写入数据。
path.data
配置应该指向相同的目录,以确保数据的共享和一致性。
确保在配置 Elasticsearch 节点时,正确设置path.data
选项,以指定数据文件的存储路径,并确保路径的可用性和适当的权限设置。
path.logs
是 Elasticsearch 配置文件中的一个选项,用于指定日志文件的存储路径。
以下是对path.logs
选项的详细解释:
path.logs: /path/to/logs
path.logs
用于指定 Elasticsearch 存储日志文件的路径。这个路径可以是一个本地文件系统的目录,也可以是一个挂载的网络文件系统(NFS)路径。
/path/to/logs
替换为实际的日志文件存储路径。
logs
的子目录,并在该目录下存储日志文件。
path.logs
选项来指定自定义的日志文件存储路径。确保目录具有适当的权限,以便 Elasticsearch 进程可以写入日志文件。
确保在配置 Elasticsearch 节点时,正确设置path.logs
选项,以指定日志文件的存储路径,并确保路径的可用性和适当的权限设置。
network.host
是 Elasticsearch 配置文件中的一个选项,用于指定 Elasticsearch 监听的网络接口地址。
以下是对network.host
选项的详细解释:
network.host: 192.168.0.1
network.host
用于指定 Elasticsearch 监听的网络接口地址。可以使用具体的 IP 地址或主机名来指定要监听的网络接口。
network.host
的值是localhost
,表示 Elasticsearch 只监听本地回环接口(127.0.0.1
),即只允许本地访问。
network.host
设置为具体的 IP 地址或主机名。
192.168.0.1
)来监听特定的网络接口。也可以使用通配符地址(如0.0.0.0
)来监听所有可用的网络接口。
network.host
选项时,需要注意安全性和访问控制,确保只允许受信任的主机或网络访问 Elasticsearch。
确保在配置 Elasticsearch 节点时,根据实际需求、网络环境和安全考虑,正确设置network.host
选项,以指定 Elasticsearch 监听的网络接口地址。
http.port
是 Elasticsearch 配置文件中的一个选项,用于指定 Elasticsearch HTTP 通信所使用的端口号。
以下是对http.port
选项的详细解释:
http.port: 9200
http.port
用于指定 Elasticsearch 监听的 HTTP 通信端口号。默认情况下,它的值是9200
。
http.port
指定的端口号。
http.port
的值为所需的端口号。
http.port
来避免端口冲突。
确保在配置 Elasticsearch 节点时,根据实际需求和网络环境,正确设置http.port
选项,以指定 Elasticsearch HTTP 通信所使用的端口号。
transport.tcp.port
是 Elasticsearch 配置文件中的一个选项,用于指定 Elasticsearch 节点间通信所使用的 TCP 端口号。
以下是对transport.tcp.port
选项的详细解释:
transport.tcp.port: 9300
transport.tcp.port
用于指定 Elasticsearch 节点间通信所使用的 TCP 端口号。默认情况下,它的值是9300
。
transport.tcp.port
指定的端口号。节点间的通信主要用于数据复制、协调和集群管理等操作。
transport.tcp.port
的值为所需的端口号。
transport.tcp.port
来避免端口冲突。
transport.tcp.port
进行通信。
确保在配置 Elasticsearch 节点时,根据实际需求和网络环境,正确设置transport.tcp.port
选项,以指定 Elasticsearch 节点间通信所使用的 TCP 端口号。
discovery.seed_hosts
是 Elasticsearch 配置文件中的一个选项,用于指定集群自动发现所需的初始主机节点列表。
以下是对discovery.seed_hosts
选项的详细解释:
discovery.seed_hosts: [ "host1", "host2" ]
discovery.seed_hosts
用于指定集群自动发现时需要连接的初始主机节点列表。这些主机节点是用于引导新加入的节点发现和加入集群。
discovery.seed_hosts
的值应该是一个字符串数组,包含了初始主机节点的主机名或 IP 地址。
discovery.seed_hosts
列表中的每个主机,以获取集群的初始状态和其他节点的信息。
discovery.seed_hosts
中的主机节点通信,自动发现并加入集群。
discovery.seed_hosts
中的主机节点是可达的,并且在启动新节点之前,这些主机节点已经在运行。
discovery.seed_hosts
选项在集群的初始配置中非常重要,它确保新节点能够正确加入已有的 Elasticsearch 集群。
确保在配置 Elasticsearch 节点时,根据实际需求和集群拓扑,正确设置discovery.seed_hosts
选项,以指定集群自动发现所需的初始主机节点列表。
cluster.initial_master_nodes
是 Elasticsearch 配置文件中的一个选项,用于指定集群的初始主节点列表。
以下是对cluster.initial_master_nodes
选项的详细解释:
cluster.initial_master_nodes: [ "node-1", "node-2" ]
cluster.initial_master_nodes
用于指定集群的初始主节点列表。这些节点是集群中的初始主节点,负责集群的管理和协调工作。
cluster.initial_master_nodes
的值应该是一个字符串数组,包含了初始主节点的名称。
cluster.initial_master_nodes
列表中的每个节点,以选举出集群中的主节点。
cluster.initial_master_nodes
中的节点名称是正确的,并且这些节点已经在运行。
cluster.initial_master_nodes
选项在集群的初始配置中非常重要,它确保正确选举出初始的主节点,以启动和管理集群。
确保在配置 Elasticsearch 节点时,根据实际需求和集群拓扑,正确设置cluster.initial_master_nodes
选项,以指定集群的初始主节点列表。
gateway.recover_after_nodes
是 Elasticsearch 配置文件中的一个选项,用于指定在多少个节点可用后开始进行数据恢复。
以下是对gateway.recover_after_nodes
选项的详细解释:
gateway.recover_after_nodes: 3
gateway.recover_after_nodes
用于指定在多少个节点可用后开始进行数据恢复。默认情况下,它的值是3
。
gateway.recover_after_nodes
的值应该是一个正整数,表示需要达到的可用节点数量。
gateway.recover_after_nodes
,可以确保在集群中有足够的节点可用时才进行数据恢复,以避免数据恢复过程对集群的过大负载。
gateway.recover_after_nodes
选项仅适用于启用了持久化存储的情况,例如使用本地磁盘或专用数据存储。
gateway.recover_after_nodes
值,数据恢复将不会自动开始。在这种情况下,您需要手动触发数据恢复过程。
确保在配置 Elasticsearch 节点时,根据实际需求和集群规模,正确设置gateway.recover_after_nodes
选项,以确保在足够数量的节点可用后开始进行数据恢复。
gateway.expected_nodes
是 Elasticsearch 配置文件中的一个选项,用于指定预期的节点数量,用于数据恢复。
以下是对gateway.expected_nodes
选项的详细解释:
gateway.expected_nodes: 5
gateway.expected_nodes
用于指定预期的节点数量,用于数据恢复。默认情况下,它的值是5
。
gateway.expected_nodes
的值应该是一个正整数,表示期望的节点数量。
gateway.expected_nodes
,可以确保在集群中有足够的节点可用时才开始数据恢复,以确保数据的完整性和一致性。
gateway.expected_nodes
选项仅适用于启用了持久化存储的情况,例如使用本地磁盘或专用数据存储。
确保在配置 Elasticsearch 节点时,根据实际需求和集群规模,正确设置gateway.expected_nodes
选项,以确保在达到预期的节点数量时开始数据恢复。这有助于保证数据的完整性和一致性。
bootstrap.memory_lock
是 Elasticsearch 配置文件中的一个选项,用于锁定 Elasticsearch 进程的内存,以防止内存被交换到磁盘上。
以下是对bootstrap.memory_lock
选项的详细解释:
bootstrap.memory_lock: true
bootstrap.memory_lock
用于指定是否锁定 Elasticsearch 进程的内存。默认情况下,它的值是false
,即未启用内存锁定。
bootstrap.memory_lock
设置为true
时,Elasticsearch 将尝试锁定进程的内存,防止操作系统将内存交换到磁盘上。
bootstrap.memory_lock
设置为false
,以允许 Elasticsearch 进程的内存被交换到磁盘上。
确保在配置 Elasticsearch 节点时,根据实际需求和系统配置,正确设置bootstrap.memory_lock
选项,以控制是否锁定 Elasticsearch 进程的内存。请确保在启用内存锁定之前了解相关的权限和操作系统要求。
action.destructive_requires_name
是 Elasticsearch 配置文件中的一个选项,用于要求在执行危险操作(如删除索引)时显式指定操作名称。
以下是对action.destructive_requires_name
选项的详细解释:
action.destructive_requires_name: true
action.destructive_requires_name
用于控制在执行危险操作时是否要求显式指定操作名称。默认情况下,它的值是false
,即不要求指定操作名称。
action.destructive_requires_name
设置为true
时,执行危险操作时需要在请求中显式指定操作名称,以增加操作的安全性。
action.destructive_requires_name
为true
可以帮助防止意外的数据丢失或集群不可用,但同时需要确保在需要执行危险操作时能够正确指定操作名称。
确保在配置 Elasticsearch 节点时,根据实际需求和安全要求,正确设置action.destructive_requires_name
选项,以控制在执行危险操作时是否要求显式指定操作名称。这有助于提高操作的安全性和可靠性。
xpack.security.enabled
是 Elasticsearch 配置文件中的一个选项,用于启用或禁用 Elasticsearch 的安全功能(X-Pack Security)。
以下是对xpack.security.enabled
选项的详细解释:
xpack.security.enabled: true
xpack.security.enabled
用于启用或禁用 Elasticsearch 的安全功能。默认情况下,它的值是false
,即未启用安全功能。
xpack.security.enabled
设置为true
时,Elasticsearch 将启用安全功能,包括身份验证、授权、加密通信等。
确保在配置 Elasticsearch 节点时,根据实际需求和安全要求,正确设置xpack.security.enabled
选项,以启用或禁用 Elasticsearch 的安全功能。请确保在启用安全功能之前,正确安装和配置 X-Pack Security 插件,并了解相关的身份验证和授权机制。
xpack.security.authc.api_key.enabled
是 Elasticsearch 配置文件中的一个选项,用于启用或禁用 API 密钥身份验证方式。
以下是对xpack.security.authc.api_key.enabled
选项的详细解释:
xpack.security.authc.api_key.enabled: true
xpack.security.authc.api_key.enabled
用于启用或禁用 API 密钥身份验证方式。默认情况下,它的值是false
,即禁用 API 密钥身份验证。
xpack.security.authc.api_key.enabled
设置为true
时,Elasticsearch 将启用 API 密钥身份验证方式。
确保在配置 Elasticsearch 节点时,根据实际需求和安全要求,正确设置xpack.security.authc.api_key.enabled
选项,以启用或禁用 API 密钥身份验证方式。请确保在启用 API 密钥身份验证之前,正确配置和管理 API 密钥,并了解相关的权限和安全机制。
logger.org.elasticsearch.transport
是 Elasticsearch 配置文件中用于配置 Elasticsearch 传输模块的日志记录器。
以下是对logger.org.elasticsearch.transport
的详细解释:
logger.org.elasticsearch.transport: debug
logger.org.elasticsearch.transport
用于配置 Elasticsearch 传输模块的日志记录级别。默认情况下,它的值是info
。
trace
、debug
、info
、warn
和error
。级别从最详细的trace
到最简要的error
逐渐减少。
logger.org.elasticsearch.transport
的值为debug
将启用详细的调试日志记录,有助于追踪和调试与传输模块相关的问题。
确保在配置 Elasticsearch 节点时,根据实际需求和调试要求,正确设置logger.org.elasticsearch.transport
选项,以配置 Elasticsearch 传输模块的日志记录级别。请注意在生产环境中谨慎使用详细的日志记录级别,以避免过多的日志输出。
本文由 mdnice 多平台发布