在 Windows 上使用 .zip 安装 Elasticsearch

从以下位置下载 Elasticsearch 8.17.0 的 .zip 归档文件：https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.17.0-windows-x86_64.zip

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

cd C:\Program Files\elasticsearch-8.17.0

运行以下命令从命令行启动 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://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"
}

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

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

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

当您首次启动 Elasticsearch 时，会自动为 HTTP 层配置 TLS。将生成一个 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>

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

%ES_HOME%\config\certs\http_ca.crt

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

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

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