文档 Grafana Alloy 参考 配置块 http

http 块

http 是一个可选的配置块，用于自定义 Alloy HTTP 服务器的功能。http 没有标签，每个配置文件只能提供一次。

示例

alloy 复制

http {
  tls {
    cert_file = sys.env("TLS_CERT_FILE_PATH")
    key_file  = sys.env("TLS_KEY_FILE_PATH")
  }
}

参数

http 块不支持任何参数，完全通过内部块进行配置。

块

http 定义中支持以下块

tls 块

tls 块配置 HTTP 服务器的 TLS 设置。

指定 tls 块时，需要提供 TLS 证书（使用 cert_pem 或 cert_file）和 TLS 密钥（使用 key_pem 或 key_file）的参数。

以下参数对互斥，一次只能配置其中一个

• cert_pem 和 cert_file
• key_pem 和 key_file
• client_ca_pem 和 client_ca_file

client_auth_type 参数决定是否验证客户端证书。默认值 NoClientCert 表示不验证客户端证书。client_ca_pem 和 client_ca_file 参数只能在 client_auth_type 不是 NoClientCert 时配置。

client_auth_type 接受以下值

• NoClientCert: 既不请求也不验证客户端证书。
• RequestClientCert: 请求客户端发送可选证书。客户端提供的证书不被验证。
• RequireAnyClientCert: 要求客户端至少提供一个证书。客户端提供的证书不被验证。
• VerifyClientCertIfGiven: 请求客户端发送可选证书。如果发送了证书，则必须有效。
• RequireAndVerifyClientCert: 要求客户端发送有效证书。

可以使用 client_ca_pem 或 client_ca_file 参数执行客户端证书验证。这些参数只能在 client_auth_type 未设置为 NoClientCert 时提供。

cipher_suites 参数决定使用哪些密码套件。如果您不提供密码套件，将使用默认列表。指定的密码套件集合可以来自以下列表

curve_preferences 参数决定在握手期间优先使用的椭圆曲线集合，按偏好顺序排列。如果未提供，将使用默认列表。指定的椭圆曲线集合可以来自以下列表

min_version 和 max_version 参数决定客户端连接可接受的最低和最高 TLS 版本。如果您不提供最低和最高 TLS 版本，将使用默认值。

识别以下版本

• TLS13 代表 TLS 1.3
• TLS12 代表 TLS 1.2
• TLS11 代表 TLS 1.1
• TLS10 代表 TLS 1.0

windows certificate filter 块

windows_certificate_filter 块用于配置从内置 Windows 证书存储中检索证书。当使用 windows_certificate_filter 块时，以下 TLS 设置将被覆盖，如果定义了它们将导致错误。

• cert_pem
• cert_file
• key_pem
• key_file
• client_ca
• client_ca_file

server 块

server 块用于查找要检查签名者的证书。如果找到多个证书，windows_certificate_filter 将选择到期日期最远的证书。

client 块

client 块用于检查提供给服务器的证书。