安装 Elasticsearch

Elasticsearch v9.0.0-beta1 的 Linux 归档文件可以按如下方式下载和安装：

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-9.0.0-beta1-linux-x86_64.tar.gz
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-9.0.0-beta1-linux-x86_64.tar.gz.sha512
shasum -a 512 -c elasticsearch-9.0.0-beta1-linux-x86_64.tar.gz.sha512 
tar -xzf elasticsearch-9.0.0-beta1-linux-x86_64.tar.gz
cd elasticsearch-9.0.0-beta1/ 

xattr -d -r com.apple.quarantine <archive-or-directory>

Elasticsearch v9.0.0-beta1 的 MacOS 归档文件可以按如下方式下载和安装：

curl -O https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-9.0.0-beta1-darwin-x86_64.tar.gz
curl https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-9.0.0-beta1-darwin-x86_64.tar.gz.sha512 | shasum -a 512 -c - 
tar -xzf elasticsearch-9.0.0-beta1-darwin-x86_64.tar.gz
cd elasticsearch-9.0.0-beta1/ 

运行以下命令以从命令行启动 Elasticsearch：

./bin/elasticsearch

当首次启动 Elasticsearch 时，安全功能默认情况下是启用并配置好的。以下安全配置会自动发生：

用户elastic的密码和Kibana的注册令牌会输出到您的终端。

我们建议将 elastic 密码存储为 shell 中的环境变量。示例：

export ELASTIC_PASSWORD="your_password"

如果您已对 Elasticsearch 密钥库进行了密码保护，系统将提示您输入密钥库的密码。有关更多详细信息，请参阅 安全设置。

默认情况下，Elasticsearch 将其日志打印到控制台（stdout）以及 日志目录中的 .log 文件。Elasticsearch 在启动时会记录一些信息，但在完成初始化后，它将继续在前台运行，并且不会进一步记录任何内容，直到发生值得记录的事情。当 Elasticsearch 运行时，您可以通过其 HTTP 接口与其交互，默认情况下该接口位于端口 9200 上。

要停止 Elasticsearch，请按 Ctrl-C。

当Elasticsearch首次启动时，安全自动配置过程将HTTP层绑定到0.0.0.0，但仅将传输层绑定到localhost。这种预期行为确保您可以在默认情况下启用安全性的情况下启动单节点集群，而无需任何额外配置。

在注册新节点之前，通常需要在生产集群中执行一些额外操作，例如绑定到除 localhost 以外的地址或满足引导检查。在此期间，自动生成的注册令牌可能会过期，这就是为什么注册令牌不会自动生成的原因。

此外，只有位于同一主机上的节点可以在无需额外配置的情况下加入集群。如果您希望来自其他主机的节点加入您的集群，您需要将transport.host设置为支持的值（例如取消注释建议的0.0.0.0值），或绑定到其他主机可以访问的接口的IP地址。更多信息请参阅传输设置。

要在集群中注册新节点，请在集群中的任何现有节点上使用elasticsearch-create-enrollment-token工具创建一个注册令牌。然后，您可以使用--enrollment-token参数启动一个新节点，使其加入现有集群。

您可以通过向localhost的9200端口发送HTTPS请求来测试您的Elasticsearch节点是否正在运行：

curl --cacert $ES_HOME/config/certs/http_ca.crt -u elastic:$ELASTIC_PASSWORD https://localhost:9200 

调用返回的响应如下：

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "9.0.0-SNAPSHOT",
    "build_type" : "tar",
    "build_hash" : "f27399d",
    "build_flavor" : "default",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "9.12.0",
    "minimum_wire_compatibility_version" : "1.2.3",
    "minimum_index_compatibility_version" : "1.2.3"
  },
  "tagline" : "You Know, for Search"
}

日志打印到 stdout 可以通过命令行中的 -q 或 --quiet 选项禁用。

要将 Elasticsearch 作为守护进程运行，请在命令行中指定 -d，并使用 -p 选项将进程 ID 记录在文件中：

./bin/elasticsearch -d -p pid

如果您已对 Elasticsearch 密钥库进行了密码保护，系统将提示您输入密钥库的密码。有关更多详细信息，请参阅 安全设置。

日志消息可以在 $ES_HOME/logs/ 目录中找到。

要关闭 Elasticsearch，请终止记录在 pid 文件中的进程 ID：

pkill -F pid

Elasticsearch 默认从 $ES_HOME/config/elasticsearch.yml 文件加载其配置。该配置文件的格式在 配置 Elasticsearch 中进行了解释。

在配置文件中可以指定的任何设置也可以在命令行上指定，使用 -E 语法如下：

./bin/elasticsearch -d -Ecluster.name=my_cluster -Enode.name=node_1

当您首次启动 Elasticsearch 时，TLS 会自动为 HTTP 层配置。CA 证书会生成并存储在磁盘上的以下位置：

$ES_HOME/config/certs/http_ca.crt

此证书的十六进制编码的 SHA-256 指纹也会输出到终端。任何连接到 Elasticsearch 的客户端，例如 Elasticsearch 客户端、 Beats、独立的 Elastic Agents 和 Logstash，都必须验证它们信任 Elasticsearch 用于 HTTPS 的证书。Fleet Server 和 Fleet 管理的 Elastic Agents 会自动配置为信任 CA 证书。其他客户端可以通过使用 CA 证书的指纹或 CA 证书本身来建立信任。

如果自动配置过程已经完成，您仍然可以获取安全证书的指纹。您还可以将CA证书复制到您的机器并配置您的客户端以使用它。

复制Elasticsearch启动时输出到终端的指纹值，并配置您的客户端使用此指纹在连接到Elasticsearch时建立信任。

如果自动配置过程已经完成，您仍然可以通过运行以下命令获取安全证书的指纹。路径是HTTP层自动生成的CA证书的路径。

openssl x509 -fingerprint -sha256 -in config/certs/http_ca.crt

该命令返回安全证书，包括指纹。 issuer 应为 Elasticsearch security auto-configuration HTTP CA。

issuer= /CN=Elasticsearch security auto-configuration HTTP CA
SHA256 Fingerprint=<fingerprint>

如果您的库不支持验证指纹的方法，则自动生成的CA证书将创建在每个Elasticsearch节点上的以下目录中：

$ES_HOME/config/certs/http_ca.crt

将 http_ca.crt 文件复制到您的机器，并配置您的客户端使用此证书在连接到 Elasticsearch 时建立信任。

归档分发是完全自包含的。默认情况下，所有文件和目录都包含在 $ES_HOME 中——解压缩归档文件时创建的目录。

这非常方便，因为您不需要创建任何目录即可开始使用 Elasticsearch，并且卸载 Elasticsearch 就像删除 $ES_HOME 目录一样简单。然而，建议更改配置目录、数据目录和日志目录的默认位置，以免日后删除重要数据。

bin/elasticsearch-keystore show xpack.security.http.ssl.keystore.secure_password

bin/elasticsearch-keystore show xpack.security.transport.ssl.keystore.secure_password

从以下链接下载 Elasticsearch 9.0.0-beta1 的 .zip 归档文件：https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-9.0.0-beta1-windows-x86_64.zip

使用您喜欢的解压工具解压它。这将创建一个名为 elasticsearch-9.0.0-beta1 的文件夹，我们将其称为 %ES_HOME%。在终端窗口中，cd 到 %ES_HOME% 目录，例如：

cd C:\Program Files\elasticsearch-9.0.0-beta1

运行以下命令以从命令行启动 Elasticsearch：

.\bin\elasticsearch.bat

当首次启动 Elasticsearch 时，安全功能默认情况下是启用并配置好的。以下安全配置会自动发生：

用户elastic的密码和Kibana的注册令牌会输出到您的终端。

我们建议将 elastic 密码存储为 shell 中的环境变量。示例：

$ELASTIC_PASSWORD = "your_password"

如果您已对 Elasticsearch 密钥库进行了密码保护，系统将提示您输入密钥库的密码。有关更多详细信息，请参阅 安全设置。

默认情况下，Elasticsearch 将其日志打印到控制台（STDOUT）以及 日志目录中的 <集群名称>.log 文件。Elasticsearch 在启动时会记录一些信息，但在完成初始化后，它将继续在前台运行，并且不会记录更多内容，直到发生值得记录的事情。当 Elasticsearch 运行时，您可以通过其 HTTP 接口与其交互，默认情况下该接口位于端口 9200 上。

要停止 Elasticsearch，请按 Ctrl-C。

当Elasticsearch首次启动时，安全自动配置过程将HTTP层绑定到0.0.0.0，但仅将传输层绑定到localhost。这种预期行为确保您可以在默认情况下启用安全性的情况下启动单节点集群，而无需任何额外配置。

在注册新节点之前，通常需要在生产集群中执行一些额外操作，例如绑定到除 localhost 以外的地址或满足引导检查。在此期间，自动生成的注册令牌可能会过期，这就是为什么注册令牌不会自动生成的原因。

此外，只有位于同一主机上的节点可以在无需额外配置的情况下加入集群。如果您希望来自其他主机的节点加入您的集群，您需要将transport.host设置为支持的值（例如取消注释建议的0.0.0.0值），或绑定到其他主机可以访问的接口的IP地址。更多信息请参阅传输设置。

要在集群中注册新节点，请在集群中的任何现有节点上使用elasticsearch-create-enrollment-token工具创建一个注册令牌。然后，您可以使用--enrollment-token参数启动一个新节点，使其加入现有集群。

Elasticsearch 默认从 %ES_HOME%\config\elasticsearch.yml 文件加载其配置。该配置文件的格式在 配置 Elasticsearch 中进行了解释。

在配置文件中可以指定的任何设置也可以在命令行上指定，使用 -E 语法如下：

.\bin\elasticsearch.bat -Ecluster.name=my_cluster -Enode.name=node_1

您可以通过向localhost的9200端口发送HTTPS请求来测试您的Elasticsearch节点是否正在运行：

curl --cacert %ES_HOME%\config\certs\http_ca.crt -u elastic:$ELASTIC_PASSWORD https://localhost:9200 

调用返回的响应如下：

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "9.0.0-SNAPSHOT",
    "build_type" : "tar",
    "build_hash" : "f27399d",
    "build_flavor" : "default",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "9.12.0",
    "minimum_wire_compatibility_version" : "1.2.3",
    "minimum_index_compatibility_version" : "1.2.3"
  },
  "tagline" : "You Know, for Search"
}

您可以将 Elasticsearch 安装为在后台运行或在启动时自动启动的服务，而无需用户交互。

C:\Program Files\elasticsearch-9.0.0-beta1\bin>elasticsearch-service.bat

Usage: elasticsearch-service.bat install|remove|start|stop|manager [SERVICE_ID]

当您首次启动 Elasticsearch 时，TLS 会自动为 HTTP 层配置。CA 证书会生成并存储在磁盘上的以下位置：

%ES_HOME%\config\certs\http_ca.crt

此证书的十六进制编码的 SHA-256 指纹也会输出到终端。任何连接到 Elasticsearch 的客户端，例如 Elasticsearch 客户端、 Beats、独立的 Elastic Agents 和 Logstash，都必须验证它们信任 Elasticsearch 用于 HTTPS 的证书。Fleet Server 和 Fleet 管理的 Elastic Agents 会自动配置为信任 CA 证书。其他客户端可以通过使用 CA 证书的指纹或 CA 证书本身来建立信任。

如果自动配置过程已经完成，您仍然可以获取安全证书的指纹。您还可以将CA证书复制到您的机器并配置您的客户端以使用它。

复制Elasticsearch启动时输出到终端的指纹值，并配置您的客户端使用此指纹在连接到Elasticsearch时建立信任。

如果自动配置过程已经完成，您仍然可以通过运行以下命令获取安全证书的指纹。路径是HTTP层自动生成的CA证书的路径。

openssl x509 -fingerprint -sha256 -in config/certs/http_ca.crt

该命令返回安全证书，包括指纹。 issuer 应为 Elasticsearch security auto-configuration HTTP CA。

issuer= /CN=Elasticsearch security auto-configuration HTTP CA
SHA256 Fingerprint=<fingerprint>

如果您的库不支持验证指纹的方法，则自动生成的CA证书将创建在每个Elasticsearch节点上的以下目录中：

%ES_HOME%\config\certs\http_ca.crt

将 http_ca.crt 文件复制到您的机器，并配置您的客户端使用此证书在连接到 Elasticsearch 时建立信任。

The .zip 包是完全自包含的。默认情况下，所有文件和目录都包含在 %ES_HOME% — 解压缩存档时创建的目录中。

这非常方便，因为您不需要创建任何目录即可开始使用 Elasticsearch，并且卸载 Elasticsearch 就像删除 %ES_HOME% 目录一样简单。然而，建议更改配置目录、数据目录和日志目录的默认位置，以免日后删除重要数据。

我们使用Elasticsearch签名密钥（PGP密钥 D88E42B4， 可从https://pgp.mit.edu获取）对所有包进行签名，指纹如下：

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4

下载并安装公共签名密钥：

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo gpg --dearmor -o /usr/share/keyrings/elasticsearch-keyring.gpg

在继续之前，您可能需要在Debian上安装apt-transport-https包：

sudo apt-get install apt-transport-https

将仓库定义保存到 /etc/apt/sources.list.d/elastic-9.x.list：

可以从网站下载Elasticsearch v9.0.0-beta1的Debian软件包，并按如下方式安装：

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-9.0.0-beta1-amd64.deb
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-9.0.0-beta1-amd64.deb.sha512
shasum -a 512 -c elasticsearch-9.0.0-beta1-amd64.deb.sha512 
sudo dpkg -i elasticsearch-9.0.0-beta1-amd64.deb

要配置Elasticsearch在系统启动时自动启动，请运行以下命令：

sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable elasticsearch.service

Elasticsearch 可以按如下方式启动和停止：

sudo systemctl start elasticsearch.service
sudo systemctl stop elasticsearch.service

这些命令不会提供Elasticsearch是否成功启动的反馈。相反，这些信息将被记录在位于/var/log/elasticsearch/的日志文件中。

如果您已将 Elasticsearch 密钥库设置为密码保护，您需要使用本地文件和 systemd 环境变量向 systemd 提供密钥库密码。此本地文件在存在时应受到保护，并且在 Elasticsearch 启动并运行后可以安全删除。

echo "keystore_password" > /path/to/my_pwd_file.tmp
chmod 600 /path/to/my_pwd_file.tmp
sudo systemctl set-environment ES_KEYSTORE_PASSPHRASE_FILE=/path/to/my_pwd_file.tmp
sudo systemctl start elasticsearch.service

默认情况下，Elasticsearch 服务不会在 systemd 日志中记录信息。要启用 journalctl 日志记录，必须从 elasticsearch.service 文件中的 ExecStart 命令行中移除 --quiet 选项。

当启用了 systemd 日志记录时，可以使用 journalctl 命令查看日志信息：

要查看日志的尾部：

sudo journalctl -f

列出elasticsearch服务的日志条目：

sudo journalctl --unit elasticsearch

列出从给定时间开始的elasticsearch服务的日志条目：

sudo journalctl --unit elasticsearch --since  "2016-10-30 18:17:16"

查看 man journalctl 或 https://www.freedesktop.org/software/systemd/man/journalctl.html 以获取更多命令行选项。

[2022-01-31T01:22:31,077][INFO ][o.e.n.Node               ] [instance-0000000123] starting ...
...
[2022-01-31T01:37:15,077][INFO ][o.e.n.Node               ] [instance-0000000123] stopping ...

Jan 31 01:22:30 debian systemd[1]: Starting Elasticsearch...
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Start operation timed out. Terminating.
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Main process exited, code=killed, status=15/TERM
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Failed with result 'timeout'.
Jan 31 01:37:15 debian systemd[1]: Failed to start Elasticsearch.

您可以通过向localhost的9200端口发送HTTPS请求来测试您的Elasticsearch节点是否正在运行：

curl --cacert /etc/elasticsearch/certs/http_ca.crt -u elastic:$ELASTIC_PASSWORD https://localhost:9200 

调用返回的响应如下：

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "9.0.0-SNAPSHOT",
    "build_type" : "tar",
    "build_hash" : "f27399d",
    "build_flavor" : "default",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "9.12.0",
    "minimum_wire_compatibility_version" : "1.2.3",
    "minimum_index_compatibility_version" : "1.2.3"
  },
  "tagline" : "You Know, for Search"
}

目录 /etc/elasticsearch 包含 Elasticsearch 的默认运行时配置。在包安装中，此目录及其所有包含文件的所有权设置为 root:elasticsearch。

设置 setgid 标志以确保 Elasticsearch 可以读取 /etc/elasticsearch 目录中的任何文件和子目录，应用组权限。 所有文件和子目录继承 root:elasticsearch 所有权。 从此目录或任何子目录运行命令，例如 elasticsearch-keystore 工具，需要 root:elasticsearch 权限。

Elasticsearch 默认从 /etc/elasticsearch/elasticsearch.yml 文件加载其配置。该配置文件的格式在 配置 Elasticsearch 中进行了解释。

Debian 包还包含一个系统配置文件（/etc/default/elasticsearch），允许您设置以下参数：

当您首次启动 Elasticsearch 时，TLS 会自动为 HTTP 层配置。CA 证书会生成并存储在磁盘上的以下位置：

/etc/elasticsearch/certs/http_ca.crt

此证书的十六进制编码的 SHA-256 指纹也会输出到终端。任何连接到 Elasticsearch 的客户端，例如 Elasticsearch 客户端、 Beats、独立的 Elastic Agents 和 Logstash，都必须验证它们信任 Elasticsearch 用于 HTTPS 的证书。Fleet Server 和 Fleet 管理的 Elastic Agents 会自动配置为信任 CA 证书。其他客户端可以通过使用 CA 证书的指纹或 CA 证书本身来建立信任。

如果自动配置过程已经完成，您仍然可以获取安全证书的指纹。您还可以将CA证书复制到您的机器并配置您的客户端以使用它。

复制Elasticsearch启动时输出到终端的指纹值，并配置您的客户端使用此指纹在连接到Elasticsearch时建立信任。

如果自动配置过程已经完成，您仍然可以通过运行以下命令获取安全证书的指纹。路径是HTTP层自动生成的CA证书的路径。

openssl x509 -fingerprint -sha256 -in config/certs/http_ca.crt

该命令返回安全证书，包括指纹。 issuer 应为 Elasticsearch security auto-configuration HTTP CA。

issuer= /CN=Elasticsearch security auto-configuration HTTP CA
SHA256 Fingerprint=<fingerprint>

如果您的库不支持验证指纹的方法，则自动生成的CA证书将创建在每个Elasticsearch节点上的以下目录中：

/etc/elasticsearch/certs/http_ca.crt

将 http_ca.crt 文件复制到您的机器，并配置您的客户端使用此证书在连接到 Elasticsearch 时建立信任。

Debian 包将配置文件、日志和数据目录放置在基于 Debian 系统的适当位置：

bin/elasticsearch-keystore show xpack.security.http.ssl.keystore.secure_password

bin/elasticsearch-keystore show xpack.security.transport.ssl.keystore.secure_password

我们使用Elasticsearch签名密钥（PGP密钥 D88E42B4， 可从https://pgp.mit.edu获取）对所有包进行签名，指纹如下：

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4

下载并安装公共签名密钥：

rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

在基于RedHat的发行版的/etc/yum.repos.d/目录中创建一个名为elasticsearch.repo的文件，或者在基于OpenSuSE的发行版的/etc/zypp/repos.d/目录中创建该文件，内容如下：

Elasticsearch v9.0.0-beta1 的 RPM 可以从网站下载并按如下方式安装：

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-9.0.0-beta1-x86_64.rpm
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-9.0.0-beta1-x86_64.rpm.sha512
shasum -a 512 -c elasticsearch-9.0.0-beta1-x86_64.rpm.sha512 
sudo rpm --install elasticsearch-9.0.0-beta1-x86_64.rpm

要配置Elasticsearch在系统启动时自动启动，请运行以下命令：

sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable elasticsearch.service

Elasticsearch 可以按如下方式启动和停止：

sudo systemctl start elasticsearch.service
sudo systemctl stop elasticsearch.service

这些命令不会提供Elasticsearch是否成功启动的反馈。相反，这些信息将被记录在位于/var/log/elasticsearch/的日志文件中。

如果您已将 Elasticsearch 密钥库设置为密码保护，您需要使用本地文件和 systemd 环境变量向 systemd 提供密钥库密码。此本地文件在存在时应受到保护，并且在 Elasticsearch 启动并运行后可以安全删除。

echo "keystore_password" > /path/to/my_pwd_file.tmp
chmod 600 /path/to/my_pwd_file.tmp
sudo systemctl set-environment ES_KEYSTORE_PASSPHRASE_FILE=/path/to/my_pwd_file.tmp
sudo systemctl start elasticsearch.service

默认情况下，Elasticsearch 服务不会在 systemd 日志中记录信息。要启用 journalctl 日志记录，必须从 elasticsearch.service 文件中的 ExecStart 命令行中移除 --quiet 选项。

当启用了 systemd 日志记录时，可以使用 journalctl 命令查看日志信息：

要查看日志的尾部：

sudo journalctl -f

列出elasticsearch服务的日志条目：

sudo journalctl --unit elasticsearch

列出从给定时间开始的elasticsearch服务的日志条目：

sudo journalctl --unit elasticsearch --since  "2016-10-30 18:17:16"

查看 man journalctl 或 https://www.freedesktop.org/software/systemd/man/journalctl.html 以获取更多命令行选项。

[2022-01-31T01:22:31,077][INFO ][o.e.n.Node               ] [instance-0000000123] starting ...
...
[2022-01-31T01:37:15,077][INFO ][o.e.n.Node               ] [instance-0000000123] stopping ...

Jan 31 01:22:30 debian systemd[1]: Starting Elasticsearch...
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Start operation timed out. Terminating.
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Main process exited, code=killed, status=15/TERM
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Failed with result 'timeout'.
Jan 31 01:37:15 debian systemd[1]: Failed to start Elasticsearch.

您可以通过向localhost的9200端口发送HTTPS请求来测试您的Elasticsearch节点是否正在运行：

curl --cacert /etc/elasticsearch/certs/http_ca.crt -u elastic:$ELASTIC_PASSWORD https://localhost:9200 

调用返回的响应如下：

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "9.0.0-SNAPSHOT",
    "build_type" : "tar",
    "build_hash" : "f27399d",
    "build_flavor" : "default",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "9.12.0",
    "minimum_wire_compatibility_version" : "1.2.3",
    "minimum_index_compatibility_version" : "1.2.3"
  },
  "tagline" : "You Know, for Search"
}

目录 /etc/elasticsearch 包含 Elasticsearch 的默认运行时配置。在包安装中，此目录及其所有包含文件的所有权设置为 root:elasticsearch。

设置 setgid 标志以确保 Elasticsearch 可以读取 /etc/elasticsearch 目录中的任何文件和子目录，应用组权限。 所有文件和子目录继承 root:elasticsearch 所有权。 从此目录或任何子目录运行命令，例如 elasticsearch-keystore 工具，需要 root:elasticsearch 权限。

Elasticsearch 默认从 /etc/elasticsearch/elasticsearch.yml 文件加载其配置。该配置文件的格式在 配置 Elasticsearch 中进行了解释。

RPM 还有一个系统配置文件（/etc/sysconfig/elasticsearch）， 它允许您设置以下参数：

当您首次启动 Elasticsearch 时，TLS 会自动为 HTTP 层配置。CA 证书会生成并存储在磁盘上的以下位置：

/etc/elasticsearch/certs/http_ca.crt

此证书的十六进制编码的 SHA-256 指纹也会输出到终端。任何连接到 Elasticsearch 的客户端，例如 Elasticsearch 客户端、 Beats、独立的 Elastic Agents 和 Logstash，都必须验证它们信任 Elasticsearch 用于 HTTPS 的证书。Fleet Server 和 Fleet 管理的 Elastic Agents 会自动配置为信任 CA 证书。其他客户端可以通过使用 CA 证书的指纹或 CA 证书本身来建立信任。

如果自动配置过程已经完成，您仍然可以获取安全证书的指纹。您还可以将CA证书复制到您的机器并配置您的客户端以使用它。

复制Elasticsearch启动时输出到终端的指纹值，并配置您的客户端使用此指纹在连接到Elasticsearch时建立信任。

如果自动配置过程已经完成，您仍然可以通过运行以下命令获取安全证书的指纹。路径是HTTP层自动生成的CA证书的路径。

openssl x509 -fingerprint -sha256 -in config/certs/http_ca.crt

该命令返回安全证书，包括指纹。 issuer 应为 Elasticsearch security auto-configuration HTTP CA。

issuer= /CN=Elasticsearch security auto-configuration HTTP CA
SHA256 Fingerprint=<fingerprint>

如果您的库不支持验证指纹的方法，则自动生成的CA证书将创建在每个Elasticsearch节点上的以下目录中：

/etc/elasticsearch/certs/http_ca.crt

将 http_ca.crt 文件复制到您的机器，并配置您的客户端使用此证书在连接到 Elasticsearch 时建立信任。

RPM 将配置文件、日志和数据目录放置在基于 RPM 系统的适当位置：

bin/elasticsearch-keystore show xpack.security.http.ssl.keystore.secure_password

bin/elasticsearch-keystore show xpack.security.transport.ssl.keystore.secure_password

使用 Docker 命令启动用于开发或测试的单节点 Elasticsearch 集群。然后，您可以运行其他 Docker 命令向测试集群添加节点或运行 Kibana。

# Remove the Elastic network
docker network rm elastic

# Remove Elasticsearch containers
docker rm es01
docker rm es02

# Remove the Kibana container
docker rm kib01

使用 Docker Compose 启动一个带有 Kibana 的三节点 Elasticsearch 集群。Docker Compose 允许你通过一个命令启动多个容器。

docker-compose down

docker-compose down -v

以下要求和建议适用于在生产环境中使用Docker运行Elasticsearch时。

grep vm.max_map_count /etc/sysctl.conf
vm.max_map_count=262144

sysctl -w vm.max_map_count=262144

docker-machine ssh
sudo sysctl -w vm.max_map_count=262144

wsl -d docker-desktop -u root
sysctl -w vm.max_map_count=262144

[wsl2]
kernelCommandLine = "sysctl.vm.max_map_count=262144"

wsl -d docker-desktop -u root
vi /etc/sysctl.conf

vm.max_map_count = 262144

mkdir esdatadir
chmod g+rwx esdatadir
chgrp 0 esdatadir

docker run --rm docker.elastic.co/elasticsearch/elasticsearch:9.0.0-beta1 /bin/bash -c 'ulimit -Hn && ulimit -Sn && ulimit -Hu && ulimit -Su'

--ulimit nofile=65535:65535

-e "bootstrap.memory_lock=true" --ulimit memlock=-1:-1

docker run -e ES_JAVA_OPTS="-Xms1g -Xmx1g" -e ENROLLMENT_TOKEN="<token>" --name es01 -p 9200:9200 --net elastic -it docker.elastic.co/elasticsearch/elasticsearch:9.0.0-beta1

当您在 Docker 中运行时，Elasticsearch 配置文件 是从 /usr/share/elasticsearch/config/ 加载的。

要使用自定义配置文件，您可以将文件绑定挂载到镜像中的配置文件上。

您可以使用 Docker 环境变量来设置单个 Elasticsearch 配置参数。 示例 compose 文件 和 单节点示例 使用此方法。您可以直接使用设置名称作为环境变量名称。如果 您无法这样做，例如因为您的编排平台禁止在环境变量名称中使用句点，那么您可以使用以下替代样式来转换设置名称。

例如，-e bootstrap.memory_lock=true 变为 -e ES_SETTING_BOOTSTRAP_MEMORY__LOCK=true。

您可以使用文件的内容来设置 ELASTIC_PASSWORD 或 KEYSTORE_PASSWORD 环境变量的值，方法是在环境变量名称后加上 _FILE。这对于在不直接指定密码的情况下将密码等秘密传递给 Elasticsearch 非常有用。

例如，要从文件设置 Elasticsearch 引导密码，您可以绑定挂载文件并将 ELASTIC_PASSWORD_FILE 环境变量设置为挂载位置。如果您将密码文件挂载到 /run/secrets/bootstrapPassword.txt，请指定：

-e ELASTIC_PASSWORD_FILE=/run/secrets/bootstrapPassword.txt

您可以覆盖图像的默认命令，以命令行选项的形式传递Elasticsearch配置参数。例如：

docker run <various parameters> bin/elasticsearch -Ecluster.name=mynewclustername

虽然通常在生产环境中首选绑定挂载配置文件的方法，但您也可以创建一个包含您配置的自定义Docker镜像。

-v full_path_to/custom_elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml

docker run -it --rm \
-v full_path_to/config:/usr/share/elasticsearch/config \
docker.elastic.co/elasticsearch/elasticsearch:9.0.0-beta1 \
bin/elasticsearch-keystore create -p

docker run -it --rm \
-v full_path_to/config:/usr/share/elasticsearch/config \
docker.elastic.co/elasticsearch/elasticsearch:9.0.0-beta1 \
bin/elasticsearch-keystore \
add my.secure.setting \
my.other.secure.setting

-v full_path_to/config/elasticsearch.keystore:/usr/share/elasticsearch/config/elasticsearch.keystore
-e KEYSTORE_PASSWORD=mypassword

FROM docker.elastic.co/elasticsearch/elasticsearch:9.0.0-beta1
COPY --chown=elasticsearch:elasticsearch elasticsearch.yml /usr/share/elasticsearch/config/

docker build --tag=elasticsearch-custom .
docker run -ti -v /usr/share/elasticsearch/data elasticsearch-custom

Exception in thread "main" org.elasticsearch.bootstrap.BootstrapException: java.io.IOException: Is a directory: SimpleFSIndexInput(path="/usr/share/elasticsearch/config/elasticsearch.keystore") Likely root cause: java.io.IOException: Is a directory

Exception in thread "main" java.nio.file.FileSystemException: /usr/share/elasticsearch/config/elasticsearch.keystore.tmp -> /usr/share/elasticsearch/config/elasticsearch.keystore: Device or resource busy