从 Linux 或 MacOS 上的归档文件安装 Elasticsearch

可以如下下载和安装适用于 Elasticsearch v8.17.0 的 Linux 归档文件

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

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

可以如下下载和安装适用于 Elasticsearch v8.17.0 的 MacOS 归档文件

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

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

./bin/elasticsearch

首次启动 Elasticsearch 时，默认情况下会启用并配置安全功能。会自动执行以下安全配置

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

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

export ELASTIC_PASSWORD="your_password"

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

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

要停止 Elasticsearch，请按 Ctrl-C。

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

在注册新节点之前，通常需要在生产集群中执行其他操作，例如绑定到 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://127.0.0.1:9200 

调用返回如下响应

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "8.17.0",
    "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"
}

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

要将 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 时，会自动为 HTTP 层配置 TLS。CA 证书会生成并存储在磁盘上，位置如下

$ES_HOME/config/certs/http_ca.crt

此证书的十六进制编码的 SHA-256 指纹也会输出到终端。任何连接到 Elasticsearch 的客户端（如 Elasticsearch 客户端、Beats、独立 Elastic Agent 和 Logstash）都必须验证它们是否信任 Elasticsearch 用于 HTTPS 的证书。Fleet Server 和 Fleet 管理的 Elastic Agent 会自动配置为信任 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