نام (NAME)

fail2ban-regex - آزمودن گزینه “failregex” در Fail2ban

خلاصه دستور (SYNOPSIS)

fail2ban-regex [OPTIONS] <LOG> <REGEX> [IGNOREREGEX]

توضیحات (DESCRIPTION)

نرم‌افزار Fail2Ban فایل لاگی را که حاوی گزارش‌های شکست در گذرواژه است می‌خواند و آدرس‌های IP متناظر را با استفاده از قوانین فایروال مسدود می‌کند.

این ابزار می‌تواند عبارات باقاعده را برای “fail2ban” بیازماید.

LOG:

string: رشته‌ای که نشان‌دهنده یک خط لاگ است
filename: مسیر یک فایل لاگ (/var/log/auth.log)
systemd-journal: جستجو در ژورنال systemd (به systemd-python نیاز دارد)، اختیاراً همراه با پارامترهای backend؛ برای نحوه استفاده و مثال‌ها به `man jail.conf` مراجعه کنید (systemd-journal[journalflags=1]).

REGEX:

string: رشته‌ای که نشان‌دهنده یک “failregex” است
filter: نام jail یا فیلتر، اختیاراً همراه با گزینه‌ها (sshd[mode=aggressive])
filename: مسیر یک فایل فیلتر (filter.d/sshd.conf)

IGNOREREGEX:

string: رشته‌ای که نشان‌دهنده یک “ignoreregex” است

گزینه‌ها (OPTIONS)

--version: نمایش شماره نسخه برنامه و خروج
-h, --help: نمایش این پیام راهنما و خروج
-c CONFIG, --config=CONFIG: تنظیم دایرکتوری پیکربندی جایگزین
-d DATEPATTERN, --datepattern=DATEPATTERN: تنظیم الگوی سفارشی مورد استفاده برای تطبیق تاریخ/زمان
--timezone=TIMEZONE, --TZ=TIMEZONE: تنظیم منطقه زمانی مورد استفاده جهت تبدیل قالب زمان
-e ENCODING, --encoding=ENCODING: کدگذاری فایل. پیش‌فرض: محلی سیستم (system locale)
-r, --raw: میزبان‌های خام، آدرس‌های DNS را تحلیل (resolve) نمی‌کند
--usedns=USEDNS: جایگزینی تعیین‌شده توسط DNS برای برچسب‌های <HOST> در عبارت باقاعده ('yes' - با تمام اشکال میزبان‌ها منطبق می‌شود، 'no' - فقط نشانی‌های IP)
-L MAXLINES, --maxlines=MAXLINES: حداکثر تعداد خطوط (maxlines) برای عبارات باقاعده چندخطی.
-m JOURNALMATCH, --journalmatch=JOURNALMATCH: تطبیق‌های به سبک journalctl که فایل فیلتر را بازنویسی (override) می‌کنند. فقط “systemd-journal”
-l LOG_LEVEL, --log-level=LOG_LEVEL: سطح لاگ برای استفاده توسط ثبت‌کننده لاگ Fail2Ban
-V: دریافت نسخه در قالب کوتاه و ماشین‌خوان
-v, --verbose: افزایش پرگویی (جزئیات خروجی)
--verbosity=VERBOSE: تنظیم سطح عددی پرگویی (۰..۴)
--verbose-date, --VD: الگوها/عبارات باقاعده تاریخ پرگو در خروجی
-D, --debuggex: تولید نشانی‌های اینترنتی debuggex.com جهت اشکال‌زدایی در آن سامانه
--no-check-all: غیرفعال‌سازی بررسی برای تمام عبارات باقاعده
-o OUT, --out=OUT: تنظیم نشانه برای چاپ تنها اطلاعات شکست (row, id, ip, msg, host, ip4, ip6, dns, matches, ...)
-i, --invert: معکوس کردن جهت تطبیق، برای نمایش خطوط غیرمنطبق در خروجی.
--print-no-missed: هیچ خط منطبق‌نشده‌ای چاپ نشود
--print-no-ignored: هیچ خط نادیده‌گرفته‌شده‌ای چاپ نشود
--print-all-matched: چاپ تمام خطوط منطبق‌شده
--print-all-missed: چاپ تمام خطوط منطبق‌نشده، بدون در نظر گرفتن تعداد
--print-all-ignored: چاپ تمام خطوط نادیده‌گرفته‌شده، بدون در نظر گرفتن تعداد
-t, --log-traceback: غنی‌سازی پیام‌های لاگ با گزارش ردگیری خطای فشرده (traceback)
--full-traceback: کامل کردن ردگیری خطاها، نه به صورت فشرده (برخلاف حالت پیش‌فرض)

نویسندگان (AUTHORS)

نوشته‌شده توسط Cyril Jaquier <cyril.jaquier@fail2ban.org>. با مشارکت‌های فراوان از Yaroslav O. Halchenko، Steven Hiscocks و Sergey G. Brester (sebres).

گزارش باگ‌ها (BUGS)

گزارش باگ‌ها را به https://github.com/fail2ban/fail2ban/issues ارسال کنید.

کپی‌رایت و تکثیر (COPYRIGHT)

حق نشر © 2004-2008 Cyril Jaquier، 2008- مشارکت‌کنندگان Fail2Ban.
حق نشر تغییرات متعلق به نویسندگان مربوطه آن‌ها است. تحت مجوز عمومی همگانی گنو نسخه ۲ (GPL) منتشر شده است.

همچنین ببینید (SEE ALSO)

fail2ban-client(1) fail2ban-server(1) jail.conf(5)