温馨提示×

debian如何给filebeat加证书

小樊
34
2026-10-09 09:10:15
栏目: 智能运维

在 Debian 上给 Filebeat 配置证书,通常是为了:

  • 和 Elasticsearch / Logstash 之间使用 TLS 加密
  • 或使用 HTTPS 输出
  • 或启用 Filebeat 自身 HTTPS 服务(较少见)

下面按最常见场景说明。


一、准备证书文件(Debian 上)

通常你需要三类文件:

  1. CA 证书(用于验证服务端)
  2. 客户端证书(filebeat.crt,可选,双向认证时需要)
  3. 客户端私钥(filebeat.key)

例如放在:

/etc/filebeat/certs/
├── ca.crt
├── filebeat.crt
└── filebeat.key

设置权限(非常重要):

sudo chown -R root:root /etc/filebeat/certs
sudo chmod 600 /etc/filebeat/certs/*

二、Filebeat 连接 Elasticsearch(TLS)

编辑配置文件:

sudo nano /etc/filebeat/filebeat.yml

1️⃣ 基础 TLS(仅验证服务端)

output.elasticsearch:
  hosts: ["https://es-node1:9200"]
  username: "filebeat_writer"
  password: "your_password"
  ssl.certificate_authorities: ["/etc/filebeat/certs/ca.crt"]

2️⃣ 双向认证(客户端证书)

output.elasticsearch:
  hosts: ["https://es-node1:9200"]
  ssl.certificate_authorities: ["/etc/filebeat/certs/ca.crt"]
  ssl.certificate: "/etc/filebeat/certs/filebeat.crt"
  ssl.key: "/etc/filebeat/certs/filebeat.key"

三、Filebeat 连接 Logstash(TLS)

output.logstash:
  hosts: ["logstash:5044"]
  ssl.certificate_authorities: ["/etc/filebeat/certs/ca.crt"]
  ssl.certificate: "/etc/filebeat/certs/filebeat.crt"
  ssl.key: "/etc/filebeat/certs/filebeat.key"

Logstash 端需对应开启:

input {
  beats {
    port => 5044
    ssl => true
    ssl_certificate => "/etc/logstash/certs/logstash.crt"
    ssl_key => "/etc/logstash/certs/logstash.key"
    ssl_certificate_authorities => ["/etc/logstash/certs/ca.crt"]
  }
}

四、验证配置 & 重启

sudo filebeat test config
sudo filebeat test output

重启服务:

sudo systemctl restart filebeat
sudo systemctl status filebeat

五、常见问题(Debian)

❌ permission denied

  • filebeat 以 root 或 filebeat 用户运行
  • key 文件不能对其他用户可读
ls -l /etc/filebeat/certs/

❌ x509: certificate signed by unknown authority

  • ca.crt 路径错误
  • 证书链不完整

❌ cannot load certificate

  • crt / key 不匹配
  • PEM 格式错误

六、证书来源建议

  • Elasticsearch:使用 elasticsearch-certutil
  • 自建 CA:openssl
  • Let’s Encrypt(仅 HTTPS 场景)

如果你能告诉我:

  • ✅ 是 Elasticsearch 还是 Logstash
  • ✅ 单向还是双向认证
  • ✅ Debian 版本 & Filebeat 版本

我可以给你精确到行的配置示例。

0 踩