falcosecurity/rules

GitHub: falcosecurity/rules

Falco 官方维护的运行时安全检测规则集,覆盖系统调用与容器事件的威胁检测、异常行为监控及合规审计。

Stars: 157 | Forks: 86

# Falco 规则 [![Latest release](https://img.shields.io/github/v/release/falcosecurity/rules?label=Latest%20Rules%20Release&style=for-the-badge)](https://github.com/falcosecurity/rules/releases/latest) [![Compatible Falco release](https://img.shields.io/github/v/release/falcosecurity/falco?label=Compatible%20Falco%20Release&style=for-the-badge)](https://github.com/falcosecurity/falco/releases/latest) [![文档](https://img.shields.io/badge/docs-latest-green.svg?style=for-the-badge)](https://falco.org/docs/rules) [![规则概览](https://img.shields.io/badge/docs-latest-green.svg?label=Rules%20Overview&style=for-the-badge)](https://falcosecurity.github.io/rules/) [![风格指南](https://img.shields.io/badge/docs-latest-green.svg?label=Style%20Guide&style=for-the-badge)](https://falco.org/docs/rules/style-guide/) [![支持的字段](https://img.shields.io/badge/docs-latest-green.svg?label=Supported%20Fields&style=for-the-badge)](https://falco.org/docs/reference/rules/supported-fields/) [![支持的 EVT ARG 字段](https://img.shields.io/badge/docs-latest-green.svg?label=Supported%20Evt%20Arg%20Fields&style=for-the-badge)](https://github.com/falcosecurity/libs/blob/master/driver/event_table.c) [![Falco 核心仓库](https://github.com/falcosecurity/evolution/blob/main/repos/badges/falco-core-blue.svg)](https://github.com/falcosecurity/evolution/blob/main/REPOSITORIES.md#core-scope) [![稳定版](https://img.shields.io/badge/status-stable-brightgreen?style=for-the-badge)](https://github.com/falcosecurity/evolution/blob/main/REPOSITORIES.md#stable) [![许可证](https://img.shields.io/github/license/falcosecurity/rules?style=for-the-badge)](./LICENSE) [![Github Pages](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/69378bdd0a200054.svg)](https://falcosecurity.github.io/rules/) 本仓库是根据此 [提案](https://github.com/falcosecurity/falco/blob/master/proposals/20221129-artifacts-distribution.md#move-falco-rules-to-their-own-repo) 创建的,包含由 The Falco Project 官方管理的 [Falco 规则](#falco-rules),以及 [Falco 规则文件注册表](#falco-rules-files-registry)。 ## Falco 规则 规则告诉 [Falco](https://github.com/falcosecurity/falco) 该做什么。这些规则是针对各种安全威胁、异常行为和合规性相关监控的预定义检测。

Image   Explore the Official Documentation for a starting point and better understanding of rule concepts. Users can modify the community-contributed Falco rules to fit their needs or use them as examples. In most cases, users also create their own custom rules. Keep in mind that the rules in this repository are related to Falco's primary monitoring functions, specifically for syscalls and container events. Meanwhile, Falco plugin rules are stored within the respective subfolders of the Plugins repository.

Image   Because Falco rules, especially Sandbox and Incubating rules, are dynamic, it's crucial to stay updated. As threats and systems evolve, Falco evolves with each release. Therefore, regularly check the Rules Overview Document, Falco's Supported Fields, and Falco's release notes with every new release. It is recommended to consistently use the most recent Falco Release to avoid compatibility issues.

Image   Important: The Falco Project only guarantees that the most recent rules releases are compatible with the latest Falco release. Discover all rule files in the rules/ folder. Refer to our Release Process and Rules Maturity Framework for rule categorization, release procedures, and usage guidelines. Published upon tagging a new release, the maturity_stable rules in the falco_rules.yaml file are included in the Falco release package. Other maturity-level rules are released separately, requiring explicit installation and possible customization for effective Adoption.

Image   Beginning with rules version 3.0.0, the required_engine_version follows Semantic Versioning and requires Falco version 0.37.0 or higher. Since rules version 2.0.0, we've modified our rules' shipping and distribution process. With Falco >= 0.37.0, Selective Rules Overrides aim to further streamline the customization of rules. Since Falco 0.36.0, you can use the rule_matching config to resolve issues with rules overlapping, which is caused by the default "first match wins" principle. Starting from Falco 0.35.0, you have precise control over the syscalls that are being monitored, see base_syscalls. Lastly, keep in mind that the Rules Maturity Framework is a best effort on the part of the community, and ultimately, you have to decide if any rules are useful for your use cases.

Image   Be cautious: The main branch has the latest development. Before using rules from the main branch, check for compatibility. Changes like new output fields might cause incompatibilities with the latest stable Falco release. The Falco Project recommends using rules only from the release branches. Lastly, we'd like to highlight the importance of regular engineering effort to effectively adopt Falco rules. Considering that each adopter's system and monitoring needs are unique, it's advisable to view the rules as examples.

Image   Debugging: Historically, we've noted that issues often arise either from incorrect configurations or genuine bugs, acknowledging that no software is entirely bug-free. The Falco Project continually updates its Install and Operate and Troubleshooting guides. We kindly suggest reviewing these guides. In the context of Falco rules, missing fields, such as container images, may be anticipated within our imperfection tolerances under certain circumstances. We are committed to addressing and resolving issues within our control.


## Falco 规则文件注册表 Falco 规则文件注册表包含有关 The Falco Project 分发的规则文件的元数据和信息。该注册表是向社区提供规则文件的一种额外方式,作为从此仓库获取规则文件过程的补充。 注意:_目前,注册表仅包含 syscall 数据源的规则;有关其他数据源,请参阅 [Plugins](https://github.com/falcosecurity/plugins) 仓库。_ ### 命名约定 规则文件必须位于本仓库的 [/rules](rules) 文件夹中,并按照以下约定命名:`_rules.yaml`。 `` 部分代表 _规则集_ 名称,它必须是一个字母数字字符串,用 `-` 分隔,全部小写,并以字母开头。 规则文件随后使用 Git 标签发布。标签名称应遵循模式 `-rules-`,其中 `` 遵守 [语义化版本控制](https://semver.org/)。有关我们发布过程的更多详细信息,请参阅 [RELEASE](RELEASE.md) 文档。 例如,_falco_ 规则集存储在 [/rules/falco_rules.yaml](rules/falco_rules.yaml) 下,其版本 _1.0.0_ 是使用 [falco-rules-1.0.0](https://github.com/falcosecurity/rules/releases/tag/falco-rules-1.0.0) 标签发布的。 注意:_此约定仅适用于本仓库。Falco 应用程序不强制要求任何规则文件命名约定。_