mirror of
https://github.com/fail2ban/fail2ban.git
synced 2026-03-11 08:55:31 +00:00
03f6c42352
* commit '0.8.8-160-g74e76e0': (65 commits) TST+BF: Use separate coveragerc for Travis CI RF+TST: bring inBanList back from private to protected and enabled its rudimentary unittests TST: coverage ignore Travis CI python virtual environments ENH: increase waiting to 4 sec for gamin/pyinotify TST+BF: Fix incorrect commands for coveralls support TST: Add support for coveralls for python 2.6 and python 2.7 ENH: deleted trailing spaces in fail2ban- cmdline tools DOC: minor change -- refer to the fail2ban manpage TST: be more aggressive in cleanup of temp files + use mktemp instead of mkstemp ENH(BF?): overload open() (for buffering) within filtertestcase to guarantee atomic writing BF: delay check for the existence of config directory until read() DOC: minor fix ups of manpages. fixes #159 non-static (get|set)BaseDir for Configurator. fixes #160 ENH: Slight tune ups for fresh SOGo filter + comment into the sample log file ENH: postfix filter -- react also on (450 4.7.1) with empty from/to. fixes #126 TST: basic testing of reading the shipped jail.conf (forcing all jails to be enabled) ENH: allow to force enable all jails (for testing), do not crash for jails without actions (just warn) ENH: minor -- add default value into the warning if option had none provided ENH: _copy_lines_between_files -- read all needed, and only then write/flush at once ENH: move pyinotify callback debug message into callback + delay string interpolations ... Conflicts: fail2ban-testcases testcases/clientreadertestcase.py -- fix for setBaseDir will follow
97 lines
3.2 KiB
Text
97 lines
3.2 KiB
Text
__ _ _ ___ _
|
|
/ _|__ _(_) |_ ) |__ __ _ _ _
|
|
| _/ _` | | |/ /| '_ \/ _` | ' \
|
|
|_| \__,_|_|_/___|_.__/\__,_|_||_|
|
|
|
|
================================================================================
|
|
Fail2Ban (version 0.9.0a0) 20??/??/??
|
|
================================================================================
|
|
|
|
Fail2Ban scans log files like /var/log/pwdfail and bans IP that makes too many
|
|
password failures. It updates firewall rules to reject the IP address. These
|
|
rules can be defined by the user. Fail2Ban can read multiple log files such as
|
|
sshd or Apache web server ones.
|
|
|
|
This README is a quick introduction to Fail2ban. More documentation, FAQ, HOWTOs
|
|
are available on the project website: http://www.fail2ban.org
|
|
|
|
Installation:
|
|
-------------
|
|
|
|
Required:
|
|
>=python-2.3 (http://www.python.org)
|
|
|
|
Optional:
|
|
pyinotify:
|
|
>=linux-2.6.13
|
|
>=python-2.4
|
|
>=pyinotify-0.8.3 (https://github.com/seb-m/pyinotify)
|
|
Gamin:
|
|
>=gamin-0.0.21 (http://www.gnome.org/~veillard/gamin)
|
|
|
|
To install, just do:
|
|
|
|
> tar xvfj fail2ban-0.8.8.tar.bz2
|
|
> cd fail2ban-0.8.8
|
|
> python setup.py install
|
|
|
|
This will install Fail2Ban into /usr/share/fail2ban. The executable scripts are
|
|
placed into /usr/bin.
|
|
|
|
It is possible that Fail2ban is already packaged for your distribution. In this
|
|
case, you should use it.
|
|
|
|
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.
|
|
|
|
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) manpage for further
|
|
references and find even more documentation on the website:
|
|
http://www.fail2ban.org
|
|
|
|
Contact:
|
|
--------
|
|
|
|
Website: http://www.fail2ban.org
|
|
|
|
You need some new features, you found bugs: visit
|
|
https://github.com/fail2ban/fail2ban/issues
|
|
and if your issue is not yet known -- file a bug report.
|
|
|
|
If you would like to troubleshoot or discuss: join the mailing list
|
|
https://lists.sourceforge.net/lists/listinfo/fail2ban-users
|
|
|
|
If you just appreciate this program: send kudos to the original author
|
|
(Cyril Jaquier: <cyril.jaquier@fail2ban.org>) or the mailing list
|
|
https://lists.sourceforge.net/lists/listinfo/fail2ban-users
|
|
|
|
|
|
Thanks:
|
|
-------
|
|
|
|
See 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
|