fail2ban

                         __      _ _ ___ _               
                        / _|__ _(_) |_  ) |__  __ _ _ _  
                       |  _/ _` | | |/ /| '_ \/ _` | ' \ 
                       |_| \__,_|_|_/___|_.__/\__,_|_||_|
                       v1.1.0.dev1            20??/??/??

## Fail2Ban: 封禁导致多次身份验证错误的主机

Fail2Ban 扫描日志文件(如 `/var/log/auth.log`)并封禁进行过多失败登录尝试的 IP 地址。它通过更新系统防火墙规则来拒绝来自这些 IP 地址的新连接,封禁时间可配置。Fail2Ban 开箱即用,可以读取许多标准日志文件,如 sshd 和 Apache 的日志,并且可以轻松配置为读取您选择的任何日志文件,以检测任何错误。

虽然 Fail2Ban 能够降低错误身份验证尝试的频率,但它无法消除弱身份验证带来的风险。如果您真的想保护服务,请将服务设置为仅使用双因素或公钥/私钥身份验证机制。
     
<img src="https://yellow-cdn.veclightyear.com/0a4dffa0/70b04271-27b0-4643-a0ab-5b8910248fdb.svg" height="52pt"/> | 自 v0.10 版本起,fail2ban 支持匹配 IPv6 地址。
------|------

本 README 是 Fail2Ban 的快速介绍。更多文档、FAQ 和 HOWTO 可以在 fail2ban(1) 手册页、[Wiki](https://github.com/fail2ban/fail2ban/wiki)、[开发者文档](https://fail2ban.readthedocs.io/)和网站 https://www.fail2ban.org 上找到。

安装:
-------------

Fail2Ban 很可能已经被打包到您的 Linux 发行版中,[可以通过一个简单的命令安装](https://github.com/fail2ban/fail2ban/wiki/How-to-install-fail2ban-packages)。

如果您的发行版未列出,您可以从 GitHub 安装:

必需:
- [Python >= 3.5](https://www.python.org) 或 [PyPy3](https://pypy.org)
- python-setuptools (或 python3-setuptools) 用于从源代码安装

可选:
- [pyinotify >= 0.8.3](https://github.com/seb-m/pyinotify),可能需要:
  * Linux >= 2.6.13
- [systemd >= 204](http://www.freedesktop.org/wiki/Software/systemd) 和 Python 绑定:
  * [python-systemd 包](https://www.freedesktop.org/software/systemd/python-systemd/index.html)
- [dnspython](http://www.dnspython.org/)
- [pyasyncore](https://pypi.org/project/pyasyncore/) 和 [pyasynchat](https://pypi.org/project/pyasynchat/) (通常bundled在fail2ban中,仅适用于 python 3.12+)

安装步骤:

    tar xvfj fail2ban-master.tar.bz2
    cd fail2ban-master
    sudo python setup.py install
   
或者,您可以将源代码从 GitHub 克隆到您选择的目录,然后从那里进行安装。选择正确的分支,例如 master 或 0.11

    git clone https://github.com/fail2ban/fail2ban.git
    cd fail2ban
    sudo python setup.py install 
    
这将把 Fail2Ban 安装到 Python 库目录中。可执行脚本被放置在 `/usr/bin` 中,配置文件在 `/etc/fail2ban` 中。

现在 Fail2Ban 应该正确安装了。只需输入:

    fail2ban-client -h

来检查一切是否正常。您应该始终使用 fail2ban-client,而不要直接调用 fail2ban-server。
您可以通过以下命令验证是否安装了正确的版本:

    fail2ban-client version

请注意,系统初始化/服务脚本不会自动安装。要将 fail2ban 作为自动服务启用,只需将您的发行版对应的脚本从 `files` 目录复制到 `/etc/init.d`。例如(在基于 Debian 的系统上):

    cp files/debian-initd /etc/init.d/fail2ban
    update-rc.d fail2ban defaults
    service fail2ban start

配置:
--------------

您可以使用 `/etc/fail2ban` 中的文件配置 Fail2Ban。也可以使用 `fail2ban-client` 发送命令来配置服务器。可用命令在 fail2ban-client(1) 手册页中有描述。另请参阅 fail2ban(1) 和 jail.conf(5) 手册页以获取更多参考。

代码状态:
------------

* [![CI](https://yellow-cdn.veclightyear.com/0a4dffa0/b5f0a7bf-cda3-4fd2-a76b-45b5defcea10.svg)](https://github.com/fail2ban/fail2ban/actions/workflows/main.yml)

联系方式:
--------

### 错误、功能请求、讨论?
请参阅 [CONTRIBUTING.md](https://github.com/fail2ban/fail2ban/blob/master/CONTRIBUTING.md)

### 您只是欣赏这个程序:
向原作者 ([Cyril Jaquier](https://github.com/fail2ban/fail2ban/blob/master/mailto:cyril.jaquier@fail2ban.org)) 
或*更好*向[邮件列表](https://lists.sourceforge.net/lists/listinfo/fail2ban-users)
发送赞美,因为 Fail2Ban 多年来一直是"社区驱动"的。

致谢:
-------

参见 [THANKS](https://github.com/fail2ban/fail2ban/blob/master/THANKS) 文件。

许可证:
--------

Fail2Ban 是自由软件;您可以根据自由软件基金会发布的 GNU 通用公共许可证的条款重新分发和/或修改它;许可证的第 2 版,或(由您选择)任何更高版本。

Fail2Ban 的分发是希望它会有用,但没有任何保证;甚至没有对适销性或特定用途适用性的暗示保证。有关更多详细信息,请参阅 GNU 通用公共许可证。

您应该已经收到了随 Fail2Ban 一起发布的 GNU 通用公共许可证副本;如果没有,请写信给自由软件基金会,Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA