如何安装Debian Filebeat

下面给你一份在 Debian 系统上安装 Filebeat 的完整步骤，适用于 Debian 10 / 11 / 12，并且假设你最终要把日志发送到 Elasticsearch 或 Logstash。

一、安装前准备

1. 系统要求

• Debian 10（Buster）及以上
• root 或 sudo 权限
• 网络可访问 Elasticsearch / Logstash

2. 检查系统架构

uname -m

常见：

• x86_64 → amd64
• aarch64 → arm64

二、方式一（推荐）：使用 Elastic 官方 APT 仓库安装

1. 安装依赖

sudo apt update
sudo apt install curl gnupg apt-transport-https -y

2. 导入 Elastic GPG 密钥

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

3. 添加 Elastic APT 仓库

echo "deb [signed-by=/usr/share/keyrings/elastic-keyring.gpg] \
https://artifacts.elastic.co/packages/8.x/apt stable main" | \
sudo tee /etc/apt/sources.list.d/elastic-8.x.list

✅ 如果你想安装 7.x，把 8.x 改成 7.x

4. 更新并安装 Filebeat

sudo apt update
sudo apt install filebeat -y

5. 查看版本

filebeat version

三、方式二：手动下载 .deb 包安装（离线环境）

wget https://artifacts.elastic.co/downloads/beats/filebeat/filebeat-8.12.0-amd64.deb
sudo dpkg -i filebeat-8.12.0-amd64.deb

如有依赖问题：

sudo apt -f install

四、配置 Filebeat（重点）

1. 主配置文件

sudo vim /etc/filebeat/filebeat.yml

2. 示例：读取系统日志并发送到 Elasticsearch

filebeat.inputs:
  - type: filestream
    enabled: true
    paths:
      - /var/log/*.log
      - /var/log/syslog

output.elasticsearch:
  hosts: ["http://127.0.0.1:9200"]

3. 示例：发送到 Logstash

output.logstash:
  hosts: ["127.0.0.1:5044"]

五、启动并设置开机自启

sudo systemctl enable filebeat
sudo systemctl start filebeat

查看状态：

sudo systemctl status filebeat

六、测试配置是否正确

sudo filebeat test config
sudo filebeat test output

七、查看 Filebeat 日志

journalctl -u filebeat -f

或：

cat /var/log/filebeat/filebeat

八、常见问题

1. Elasticsearch 连不上？

• 检查 hosts
• 检查防火墙
• 检查 ES 是否启用 HTTP

2. 没有采集到日志？

• 确认 paths 正确
• 确认文件权限
• 查看 Filebeat 日志

九、卸载 Filebeat

sudo systemctl stop filebeat
sudo apt remove filebeat -y
sudo rm -rf /etc/filebeat /var/lib/filebeat

如果你愿意，我可以帮你：

• ✅ 写 完整 filebeat.yml
• ✅ 对接 Elasticsearch / Logstash / Kafka
• ✅ 采集 Nginx / Docker / Java / 自定义日志
• ✅ 调试 Filebeat 不生效问题

直接告诉我你的使用场景即可。