# 使用 Homebrew, chocolatey, Nix 安装 filebeat

查看 filebeat 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:filebeat
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install filebeat
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#filebeat
```

  证据: nixpkgs package indexes: filebeat from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix

### Windows

- Chocolatey (92%):

```sh
choco install filebeat
```

  证据: Chocolatey community package catalog: filebeat from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','everythingpowertoys'

## 软件包事实

- **软件包键:** brew:filebeat
- **软件包管理器:** Homebrew
- **版本:** 9.4.4
- **来源摘要:** File harvester to ship log files to Elasticsearch or Logstash
- **主页:** <https://www.elastic.co/products/beats/filebeat>
- **仓库:** <https://github.com/elastic/beats>
- **最后更新:** 2026-07-23T07:28:30Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- filebeat (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 9.4.4
## 项目历史与用法

Filebeat is Elastic's lightweight log shipper in the Beats family: a small agent installed near application and system logs, harvesting files and forwarding events to Elasticsearch or Logstash.

In package-manager terms, Filebeat matters because it turned log shipping into a standard single-purpose daemon: install the formula or package, edit filebeat.yml, enable modules or inputs, and wire it to an Elastic Stack endpoint.

### 项目历史

The Beats repository began in 2014 as the home of lightweight shippers for Elasticsearch and Logstash. Early public tags were Packetbeat-focused, and the shared libbeat framework became the substrate for later Beats, including Filebeat.

Filebeat emerged as the file-log member of that family. Elastic's documentation describes its runtime model as inputs discovering log data, harvesters reading individual files, libbeat aggregating events, and configured outputs forwarding them to Elasticsearch or Logstash.

By the 5.x era, Filebeat was established enough for Elastic to document modules, which bundle input configuration, ingest pipelines, and dashboards for common log sources. Modern Elastic documentation still supports Filebeat modules, while recommending newer Elastic Agent integrations for streamlined data collection.

### 采用历史

Filebeat adoption tracks Elastic Stack adoption: it became the default lightweight answer for users who wanted to avoid running a heavier Logstash instance on every host while still centralizing log files.

Its packaging footprint across Homebrew, Chocolatey, and Nix, together with Elastic's own packages and documentation, reflects cross-platform use by developers, operators, and observability teams.

Elastic's current docs place Filebeat inside the broader Beats and Elastic Agent story: existing Filebeat deployments remain supported, but greenfield Elastic collection is increasingly guided toward Fleet-managed integrations.

### 使用方式

Typical usage starts with filebeat.yml, where users configure inputs or modules, output credentials, and path settings. Filebeat then runs as a foreground command during testing or as a service on servers.

Operators care about path.config, path.data, and the Filebeat keystore because those paths determine where configuration, registry state, logs, and stored secrets live. The keystore lets credentials be referenced from configuration without writing the raw secret in filebeat.yml.

For package users, the everyday workflow is small but operationally important: install Filebeat, point it at logs, verify output connectivity, and let it continuously tail files with registry state so restarts do not resend the whole world.

### 为什么软件包爱好者会关心

Filebeat is a classic example of a package-manager-friendly observability agent: one executable, one YAML config, a daemon/service mode, and enough defaults for automated installation.

It also illustrates how upstream package structure matters. The formula installs a single Beat, but the source lives in Elastic's monorepo alongside Metricbeat, Heartbeat, Auditbeat, Winlogbeat, and libbeat.

### 时间线

- 2014: Elastic Beats repository created and early Packetbeat releases published.
- 2015: Beats 1.0 release candidates published from the shared repository.
- 2016: Beats 5.0.0 release line shipped as Elastic Stack 5-era Beats matured.
- 2017: Filebeat modules documented for Elasticsearch 5.2 or later.
- 2022: Beats 8.0.0 release line published.
- 2025: Beats 9.0.0 release line published.

### Related projects

- Filebeat is part of Elastic Beats and shares libbeat infrastructure with Metricbeat, Heartbeat, Auditbeat, Packetbeat, and Winlogbeat.
- It commonly appears with Elasticsearch, Logstash, Kibana, Elastic Agent, and Fleet integrations.

### 来源

- <https://github.com/elastic/beats>
- <https://github.com/elastic/beats/releases/tag/v0.1.0>
- <https://github.com/elastic/beats/releases/tag/v5.0.0>
- <https://github.com/elastic/beats/releases/tag/v8.0.0>
- <https://github.com/elastic/beats/releases/tag/v9.0.0>
- <https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-overview.html>
- <https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-modules.html>
- <https://www.elastic.co/guide/en/beats/filebeat/current/configuration-path.html>
- <https://www.elastic.co/guide/en/beats/filebeat/current/keystore.html>


## 安全说明

formula declares a Homebrew service.

- **Geiger 风险:** orange / 中
- formula declares a Homebrew service


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: /etc/filebeat/filebeat.yml
- Unix: {path.config}/filebeat.yml

## Credential files

- Unix: {path.config}/filebeat.keystore
## 其他软件包管理器记录

- Nix - filebeat: normalized package name match | nixpkgs package indexes: filebeat from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix
- Chocolatey - filebeat: normalized package name match | Chocolatey community package catalog: filebeat from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','everythingpowertoys'


## Combined YAML source

View the package source record on GitHub. [combined/filebeat.yml](https://github.com/mxcl/pkgdb/blob/main/combined/filebeat.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
