mirror of https://github.com/fail2ban/fail2ban
119 lines
5.0 KiB
Markdown
119 lines
5.0 KiB
Markdown
__ _ _ ___ _
|
|
/ _|__ _(_) |_ ) |__ __ _ _ _
|
|
| _/ _` | | |/ /| '_ \/ _` | ' \
|
|
|_| \__,_|_|_/___|_.__/\__,_|_||_|
|
|
v0.10.3.dev1 20??/??/??
|
|
|
|
## Fail2Ban: ban hosts that cause multiple authentication errors
|
|
|
|
Fail2Ban scans log files like `/var/log/auth.log` and bans IP addresses conducting
|
|
too many failed login attempts. It does this by updating system firewall rules
|
|
to reject new connections from those IP addresses, for a configurable amount
|
|
of time. Fail2Ban comes out-of-the-box ready to read many standard log files,
|
|
such as those for sshd and Apache, and is easily configured to read any log
|
|
file of your choosing, for any error you wish.
|
|
|
|
Though Fail2Ban is able to reduce the rate of incorrect authentication
|
|
attempts, it cannot eliminate the risk presented by weak authentication.
|
|
Set up services to use only two factor, or public/private authentication
|
|
mechanisms if you really want to protect services.
|
|
|
|
<img src="http://www.worldipv6launch.org/wp-content/themes/ipv6/downloads/World_IPv6_launch_logo.svg" height="52pt"/> | Since v0.10 fail2ban supports the matching of the IPv6 addresses.
|
|
------|------
|
|
|
|
This README is a quick introduction to Fail2Ban. More documentation, FAQ, and HOWTOs
|
|
to be found on fail2ban(1) manpage, [Wiki](https://github.com/fail2ban/fail2ban/wiki)
|
|
and the website: https://www.fail2ban.org
|
|
|
|
Installation:
|
|
-------------
|
|
|
|
**It is possible that Fail2Ban is already packaged for your distribution. In
|
|
this case, you should use that instead.**
|
|
|
|
Required:
|
|
- [Python2 >= 2.6 or Python >= 3.2](https://www.python.org) or [PyPy](https://pypy.org)
|
|
|
|
Optional:
|
|
- [pyinotify >= 0.8.3](https://github.com/seb-m/pyinotify), may require:
|
|
* Linux >= 2.6.13
|
|
- [gamin >= 0.0.21](http://www.gnome.org/~veillard/gamin)
|
|
- [systemd >= 204](http://www.freedesktop.org/wiki/Software/systemd) and python bindings:
|
|
* [python-systemd package](https://www.freedesktop.org/software/systemd/python-systemd/index.html)
|
|
- [dnspython](http://www.dnspython.org/)
|
|
|
|
|
|
To install:
|
|
|
|
tar xvfj fail2ban-0.10.3.tar.bz2
|
|
cd fail2ban-0.10.3
|
|
python setup.py install
|
|
|
|
This will install Fail2Ban into the python library directory. The executable
|
|
scripts are placed into `/usr/bin`, and configuration in `/etc/fail2ban`.
|
|
|
|
Fail2Ban should be correctly installed now. Just type:
|
|
|
|
fail2ban-client -h
|
|
|
|
to see if everything is alright. You should always use fail2ban-client and
|
|
never call fail2ban-server directly.
|
|
|
|
Please note that the system init/service script is not automatically installed.
|
|
To enable fail2ban as an automatic service, simply copy the script for your
|
|
distro from the `files` directory to `/etc/init.d`. Example (on a Debian-based
|
|
system):
|
|
|
|
cp files/debian-initd /etc/init.d/fail2ban
|
|
update-rc.d fail2ban defaults
|
|
service fail2ban start
|
|
|
|
Configuration:
|
|
--------------
|
|
|
|
You can configure Fail2Ban using the files in `/etc/fail2ban`. It is possible to
|
|
configure the server using commands sent to it by `fail2ban-client`. The
|
|
available commands are described in the fail2ban-client(1) manpage. Also see
|
|
fail2ban(1) and jail.conf(5) manpages for further references.
|
|
|
|
Code status:
|
|
------------
|
|
|
|
* [![tests status](https://secure.travis-ci.org/fail2ban/fail2ban.png?branch=0.10)](https://travis-ci.org/fail2ban/fail2ban?branch=0.10) travis-ci.org (0.10 branch) / [![tests status](https://secure.travis-ci.org/fail2ban/fail2ban.png?branch=master)](https://travis-ci.org/fail2ban/fail2ban) travis-ci.org (master branch)
|
|
|
|
* [![Coverage Status](https://coveralls.io/repos/fail2ban/fail2ban/badge.png?branch=0.10)](https://coveralls.io/github/fail2ban/fail2ban?branch=0.10)
|
|
|
|
* [![codecov.io](https://codecov.io/gh/fail2ban/fail2ban/coverage.svg?branch=0.10)](https://codecov.io/gh/fail2ban/fail2ban/branch/0.10)
|
|
|
|
Contact:
|
|
--------
|
|
|
|
### Bugs, feature requests, discussions?
|
|
See [CONTRIBUTING.md](https://github.com/fail2ban/fail2ban/blob/master/CONTRIBUTING.md)
|
|
|
|
### You just appreciate this program:
|
|
Send kudos to the original author ([Cyril Jaquier](mailto:cyril.jaquier@fail2ban.org))
|
|
or *better* to the [mailing list](https://lists.sourceforge.net/lists/listinfo/fail2ban-users)
|
|
since Fail2Ban is "community-driven" for years now.
|
|
|
|
Thanks:
|
|
-------
|
|
|
|
See [THANKS](https://github.com/fail2ban/fail2ban/blob/master/THANKS) file.
|
|
|
|
License:
|
|
--------
|
|
|
|
Fail2Ban is free software; you can redistribute it and/or modify it under the
|
|
terms of the GNU General Public License as published by the Free Software
|
|
Foundation; either version 2 of the License, or (at your option) any later
|
|
version.
|
|
|
|
Fail2Ban is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
|
|
PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License along with
|
|
Fail2Ban; if not, write to the Free Software Foundation, Inc., 51 Franklin
|
|
Street, Fifth Floor, Boston, MA 02110, USA
|