.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH FAIL2BAN-CLIENT "1" "August 2026" "Fail2Ban v1.1.1" "دستورات عمومی کاربر"
.SH "نام (NAME)"
fail2ban-client \- پیکربندی و کنترل کارگزار Fail2Ban
.SH "خلاصه دستور (SYNOPSIS)"
.B fail2ban-client
[\fI\,گزینه‌ها\/\fR] \fI\,<فرمان>\/\fR
.SH "توضیحات (DESCRIPTION)"
برنامه
.B Fail2Ban v1.1.1
فایل‌های گزارشی را که حاوی گزارش شکست‌های احراز هویت (گذرواژه) هستند می‌خواند و نشانی‌های IP متناظر را با استفاده از قوانین دیواره آتش مسدود (ban) می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-c\fR, \fB\-\-conf\fR <DIR>
دایرکتوری پیکربندی
.TP
\fB\-s\fR, \fB\-\-socket\fR <FILE>
مسیر فایل سوکت
.TP
\fB\-p\fR, \fB\-\-pidfile\fR <FILE>
مسیر فایل شناسه فرایند (pidfile)
.TP
\fB\-\-pname\fR <NAME>
نام فرایند (رشته اصلی) برای شناسایی نمونه (پیش‌فرض fail2ban\-server)
.TP
\fB\-\-loglevel\fR <LEVEL>
سطح ثبت گزارش
.TP
\fB\-\-logtarget\fR <TARGET>
مقصد ثبت گزارش؛ استفاده از نام فایل یا stdout، stderr، syslog یا sysout.
.HP
\fB\-\-syslogsocket\fR auto|<FILE>
.TP
\fB\-d\fR
تخلیه پیکربندی؛ جهت اشکال‌زدایی
.TP
\fB\-\-dp\fR, \fB\-\-dump\-pretty\fR
تخلیه پیکربندی با ساختاری خواناتر برای انسان
.TP
\fB\-t\fR, \fB\-\-test\fR
آزمایش پیکربندی (می‌تواند همراه با پارامترهای راه‌اندازی نیز مشخص شود)
.TP
\fB\-i\fR
حالت تعاملی
.TP
\fB\-v\fR
افزایش سطح پرگویی (verbosity)
.TP
\fB\-q\fR
کاهش سطح پرگویی (verbosity)
.TP
\fB\-x\fR
اجرای اجباری کارگزار (حذف فایل سوکت پیشین)
.TP
\fB\-b\fR
اجرای کارگزار در پس‌زمینه (پیش‌فرض)
.TP
\fB\-f\fR
اجرای کارگزار در پیش‌زمینه
.TP
\fB\-\-async\fR
اجرای کارگزار در حالت ناهمگام (صرفاً برای استفاده داخلی، پیکربندی را نمی‌خواند)
.TP
\fB\-\-timeout\fR
مدت‌زمان انتظار برای کارگزار (صرفاً برای استفاده داخلی، پیکربندی را نمی‌خواند)
.TP
\fB\-\-str2sec\fR <STRING>
تبدیل قالب اختصاری زمان به ثانیه
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این پیام راهنما
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ نسخه برنامه (گزینه
.B \-V
قالب کوتاه ماشین‌خوان را برمی‌گرداند)
.SH "فرمان‌ها (COMMANDS)"
.IP
پایه (BASIC)
.TP
\fBstart\fR
کارگزار و تمام زندان‌ها را راه‌اندازی می‌کند
.TP
\fBrestart\fR
کارگزار را مجدداً راه‌اندازی می‌کند
.TP
\fBrestart [\-\-unban] [\-\-if\-exists] <JAIL>\fR
زندان <JAIL> را مجدداً راه‌اندازی می‌کند (نام مستعاری برای 'reload \fB\-\-restart\fR ... <JAIL>')
.TP
\fBreload [\-\-restart] [\-\-unban] [\-\-all]\fR
پیکربندی را بدون راه‌اندازی مجدد کارگزار بازخوانی می‌کند؛ گزینه
.B \-\-restart
راه‌اندازی مجدد کامل زندان‌های متأثر را فعال می‌کند و در نتیجه می‌تواند نشانی‌های IP را رفع مسدودیت (unban) کند (اگر گزینه
.B \-\-unban
مشخص شده باشد)
.TP
\fBreload [\-\-restart] [\-\-unban] [\-\-if\-exists] <JAIL>\fR
زندان <JAIL> را بازخوانی کرده، یا آن را مجدداً راه‌اندازی می‌کند (اگر گزینه
.B \-\-restart
مشخص شده باشد)
.TP
\fBstop\fR
تمام زندان‌ها را متوقف کرده و به کار کارگزار خاتمه می‌دهد
.TP
\fBunban \fB\-\-all\fR\fR
رفع مسدودیت تمام نشانی‌های IP (در تمام زندان‌ها و پایگاه داده)
.TP
\fBunban <IP> ... <IP>\fR
رفع مسدودیت <IP> (در تمام زندان‌ها و پایگاه داده)
.TP
\fBbanned\fR
زندان‌های دارای نشانی‌های IP مسدودشده را به صورت یک دیکشنری برمی‌گرداند
.TP
\fBbanned <IP> ... <IP>]\fR
فهرستی از زندان‌هایی را که IPهای داده‌شده در آن‌ها مسدود هستند برمی‌گرداند
.TP
\fBstatus\fR
وضعیت کنونی کارگزار را دریافت می‌کند
.TP
\fBstatus \fB\-\-all\fR [FLAVOR]\fR
وضعیت کنونی تمام زندان‌ها را با سبک خروجی اختیاری [FLAVOR] دریافت می‌کند. سبک‌ها: 'basic' (پیش‌فرض)، 'cymru'، 'short'، و 'stats'
.TP
\fBstat[istic]s\fR
آمار کنونی تمام زندان‌ها را در قالب یک جدول دریافت می‌کند
.TP
\fBping\fR
بررسی می‌کند که آیا کارگزار فعال و پاسخگو است یا خیر
.TP
\fBecho\fR
برای استفاده داخلی؛ رشته داده‌شده را بازگردانده و در خروجی چاپ می‌کند
.TP
\fBversion\fR
نسخه کارگزار را برمی‌گرداند
.IP
ثبت گزارش (LOGGING)
.TP
\fBset loglevel <LEVEL>\fR
سطح ثبت گزارش را روی <LEVEL> تنظیم می‌کند. سطوح: CRITICAL، ERROR، WARNING، NOTICE، INFO، DEBUG، TRACEDEBUG، HEAVYDEBUG یا مقدار عددی متناظر (50\-5)
.TP
\fBget loglevel\fR
سطح فعلی ثبت گزارش را دریافت می‌کند
.TP
\fBset logtarget <TARGET>\fR
مقصد ثبت گزارش را روی <TARGET> تنظیم می‌کند. می‌تواند STDOUT، STDERR، SYSLOG، SYSTEMD\-JOURNAL یا یک فایل باشد
.TP
\fBget logtarget\fR
مقصد فعلی ثبت گزارش را دریافت می‌کند
.TP
\fBset syslogsocket auto|<SOCKET>\fR
مسیر سوکت syslog را روی auto یا <SOCKET> تنظیم می‌کند. تنها زمانی استفاده می‌شود که مقصد ثبت گزارش SYSLOG باشد
.TP
\fBget syslogsocket\fR
مسیر سوکت syslog را دریافت می‌کند
.TP
\fBflushlogs\fR
در صورتی که مقصد ثبت گزارش یک فایل باشد، آن را تخلیه کرده و مجدداً باز می‌کند؛ جهت چرخش گزارش‌ها (log rotation)
.IP
پایگاه داده (DATABASE)
.TP
\fBset dbfile <FILE>\fR
محل ذخیره‌گاه داده‌های ماندگار fail2ban را مشخص می‌کند. برای غیرفعال‌سازی، آن را روی "None" تنظیم کنید
.TP
\fBget dbfile\fR
محل ذخیره‌گاه داده‌های ماندگار fail2ban را دریافت می‌کند
.TP
\fBset dbmaxmatches <INT>\fR
حداکثر تعداد تطابق‌های ذخیره‌شده در پایگاه داده به ازای هر بلیت (ticket) را تنظیم می‌کند
.TP
\fBget dbmaxmatches\fR
حداکثر تعداد تطابق‌های ذخیره‌شده در پایگاه داده به ازای هر بلیت (ticket) را دریافت می‌کند
.TP
\fBset dbpurgeage <SECONDS>\fR
حداکثر زمان به ثانیه (<SECONDS>) را برای نگهداری تاریخچه مسدودیت‌ها تنظیم می‌کند
.TP
\fBget dbpurgeage\fR
حداکثر زمان به ثانیه را برای نگهداری تاریخچه مسدودیت‌ها دریافت می‌کند
.IP
کنترل زندان (JAIL CONTROL)
.TP
\fBadd <JAIL> <BACKEND>\fR
زندان <JAIL> را با استفاده از موتور پس‌زمینه <BACKEND> ایجاد می‌کند
.TP
\fBstart <JAIL>\fR
زندان <JAIL> را راه‌اندازی می‌کند
.TP
\fBstop <JAIL>\fR
زندان <JAIL> را متوقف می‌کند؛ زندان مربوطه حذف می‌شود
.TP
\fBstatus <JAIL> [FLAVOR]\fR
وضعیت کنونی زندان <JAIL> را با سبک خروجی اختیاری [FLAVOR] دریافت می‌کند. سبک‌ها: 'basic' (پیش‌فرض)، 'cymru'، 'short'، و 'stats'
.IP
پیکربندی زندان (JAIL CONFIGURATION)
.TP
\fBset <JAIL> idle on|off\fR
وضعیت بیکاری (idle) زندان <JAIL> را تنظیم می‌کند
.TP
\fBset <JAIL> ignoreself true|false\fR
امکان نادیده گرفتن نشانی‌های IP خودی را فراهم می‌کند
.TP
\fBset <JAIL> addignoreip <IP>\fR
نشانی <IP> را به فهرست نادیده‌گرفته‌های زندان <JAIL> اضافه می‌کند
.TP
\fBset <JAIL> delignoreip <IP>\fR
نشانی <IP> را از فهرست نادیده‌گرفته‌های زندان <JAIL> حذف می‌کند
.TP
\fBset <JAIL> ignorecommand <VALUE>\fR
دستور نادیده‌گیری (ignorecommand) مربوط به زندان <JAIL> را تنظیم می‌کند
.TP
\fBset <JAIL> ignorecache <VALUE>\fR
کش نادیده‌گیری (ignorecache) مربوط به زندان <JAIL> را تنظیم می‌کند
.TP
\fBset <JAIL> addlogpath <FILE> ['tail']\fR
فایل <FILE> را به فهرست نظارت زندان <JAIL> اضافه می‌کند؛ به صورت اختیاری از انتهای فایل ('tail') شروع به خواندن می‌کند (پیش‌فرض 'head' است).
.TP
\fBset <JAIL> dellogpath <FILE>\fR
فایل <FILE> را از فهرست نظارت زندان <JAIL> حذف می‌کند
.TP
\fBset <JAIL> logencoding <ENCODING>\fR
کدگذاری (<ENCODING>) فایل‌های گزارش زندان <JAIL> را تنظیم می‌کند
.TP
\fBset <JAIL> addjournalmatch <MATCH>\fR
عبارت تطابق <MATCH> را به فیلتر ژورنال زندان <JAIL> اضافه می‌کند
.TP
\fBset <JAIL> deljournalmatch <MATCH>\fR
عبارت تطابق <MATCH> را از فیلتر ژورنال زندان <JAIL> حذف می‌کند
.TP
\fBset <JAIL> addfailregex <REGEX>\fR
عبارت باقاعده <REGEX> را که باید با شکست‌ها در زندان <JAIL> تطابق یابد اضافه می‌کند
.TP
\fBset <JAIL> delfailregex <INDEX>\fR
عبارت باقاعده موجود در نمایه <INDEX> را برای failregex حذف می‌کند
.TP
\fBset <JAIL> addignoreregex <REGEX>\fR
عبارت باقاعده <REGEX> را برای تطابق با الگوهایی که باید برای زندان <JAIL> نادیده گرفته شوند اضافه می‌کند
.TP
\fBset <JAIL> delignoreregex <INDEX>\fR
عبارت باقاعده موجود در نمایه <INDEX> را برای ignoreregex حذف می‌کند
.TP
\fBset <JAIL> findtime <TIME>\fR
مدت‌زمان به ثانیه (<TIME>) را که فیلتر برای بررسی رخدادها به گذشته می‌نگرد برای زندان <JAIL> تنظیم می‌کند
.TP
\fBset <JAIL> bantime <TIME>\fR
مدت‌زمان به ثانیه (<TIME>) را که یک میزبان برای زندان <JAIL> مسدود می‌ماند تنظیم می‌کند
.TP
\fBset <JAIL> datepattern <PATTERN>\fR
الگوی <PATTERN> مورد استفاده برای تطابق تاریخ و زمان را برای زندان <JAIL> تنظیم می‌کند
.TP
\fBset <JAIL> usedns <VALUE>\fR
حالت usedns را برای زندان <JAIL> تعیین می‌کند
.TP
\fBset <JAIL> attempt <IP> [<failure1> ... <failureN>]\fR
اعلام دستی رخداد شکست برای نشانی <IP>
.TP
\fBset <JAIL> banip <IP> ... <IP>\fR
مسدودسازی دستی نشانی <IP> برای زندان <JAIL>
.TP
\fBset <JAIL> unbanip [\-\-report\-absent] <IP> ... <IP>\fR
رفع مسدودیت دستی نشانی <IP> در زندان <JAIL>
.TP
\fBset <JAIL> maxretry <RETRY>\fR
تعداد شکست‌های مجاز (<RETRY>) را پیش از مسدود شدن میزبان برای زندان <JAIL> تنظیم می‌کند
.TP
\fBset <JAIL> maxmatches <INT>\fR
حداکثر تعداد تطابق‌های ذخیره‌شده در حافظه به ازای هر بلیت در زندان <JAIL> را تنظیم می‌کند
.TP
\fBset <JAIL> maxlines <LINES>\fR
تعداد خطوط (<LINES>) بافر برای جستجوی عبارت باقاعده در زندان <JAIL> را تنظیم می‌کند
.TP
\fBset <JAIL> addaction <ACT>[ <PYTHONFILE> <JSONKWARGS>]\fR
یک اقدام جدید به نام <ACT> برای زندان <JAIL> اضافه می‌کند. به صورت اختیاری برای یک اقدام مبتنی بر پایتون، می‌توان <PYTHONFILE> و <JSONKWARGS> را مشخص کرد؛ در غیر این صورت یک اقدام دستوری (Command Action) خواهد بود
.TP
\fBset <JAIL> delaction <ACT>\fR
اقدام <ACT> را از زندان <JAIL> حذف می‌کند
.IP
پیکربندی دستور اقدام (COMMAND ACTION CONFIGURATION)
.TP
\fBset <JAIL> action <ACT> actionstart <CMD>\fR
دستور شروع (<CMD>) اقدام <ACT> را برای زندان <JAIL> تنظیم می‌کند
.TP
\fBset <JAIL> action <ACT> actionstop <CMD>\fR
دستور توقف (<CMD>) اقدام <ACT> را برای زندان <JAIL> تنظیم می‌کند
.TP
\fBset <JAIL> action <ACT> actioncheck <CMD>\fR
دستور بررسی (<CMD>) اقدام <ACT> را برای زندان <JAIL> تنظیم می‌کند
.TP
\fBset <JAIL> action <ACT> actionban <CMD>\fR
دستور مسدودسازی (<CMD>) اقدام <ACT> را برای زندان <JAIL> تنظیم می‌کند
.TP
\fBset <JAIL> action <ACT> actionunban <CMD>\fR
دستور رفع مسدودیت (<CMD>) اقدام <ACT> را برای زندان <JAIL> تنظیم می‌کند
.TP
\fBset <JAIL> action <ACT> timeout <TIMEOUT>\fR
مهلت زمانی اجرای دستور (<TIMEOUT>) به ثانیه را برای اقدام <ACT> در زندان <JAIL> تعیین می‌کند
.IP
پیکربندی عمومی اقدام (GENERAL ACTION CONFIGURATION)
.TP
\fBset <JAIL> action <ACT> <PROPERTY> <VALUE>\fR
مقدار <VALUE> ویژگی <PROPERTY> را برای اقدام <ACT> در زندان <JAIL> تنظیم می‌کند
.TP
\fBset <JAIL> action <ACT> <METHOD>[ <JSONKWARGS>]\fR
متد <METHOD> را با آرگومان‌های <JSONKWARGS> برای اقدام <ACT> در زندان <JAIL> فراخوانی می‌کند
.IP
اطلاعات زندان (JAIL INFORMATION)
.TP
\fBget <JAIL> banned\fR
نشانی‌های IP مسدودشده زندان <JAIL> را برمی‌گرداند
.TP
\fBget <JAIL> banned <IP> ... <IP>]\fR
اگر نشانی IP در زندان <JAIL> مسدود باشد مقدار 1 و در غیر این صورت 0، یا فهرستی از 1/0 را برای چندین IP برمی‌گرداند
.TP
\fBget <JAIL> logpath\fR
فهرست فایل‌های تحت نظارت را برای زندان <JAIL> دریافت می‌کند
.TP
\fBget <JAIL> logencoding\fR
کدگذاری فایل‌های گزارش را برای زندان <JAIL> دریافت می‌کند
.TP
\fBget <JAIL> journalmatch\fR
تطابق فیلتر ژورنال را برای زندان <JAIL> دریافت می‌کند
.TP
\fBget <JAIL> ignoreself\fR
مقدار کنونی نادیده‌گیری نشانی‌های IP خودی را دریافت می‌کند
.TP
\fBget <JAIL> ignoreip\fR
فهرست نشانی‌های IP نادیده‌گرفته‌شده را برای زندان <JAIL> دریافت می‌کند
.TP
\fBget <JAIL> ignorecommand\fR
دستور نادیده‌گیری (ignorecommand) مربوط به زندان <JAIL> را دریافت می‌کند
.TP
\fBget <JAIL> failregex\fR
فهرست عبارات باقاعده‌ای را که با شکست‌ها در زندان <JAIL> مطابقت دارند دریافت می‌کند
.TP
\fBget <JAIL> ignoreregex\fR
فهرست عبارات باقاعده‌ای را که با الگوهای نادیده‌گیری در زندان <JAIL> مطابقت دارند دریافت می‌کند
.TP
\fBget <JAIL> findtime\fR
مدت‌زمانی را که فیلتر برای یافتن شکست‌ها در زندان <JAIL> به عقب بررسی می‌کند دریافت می‌کند
.TP
\fBget <JAIL> bantime\fR
مدت‌زمانی را که یک میزبان در زندان <JAIL> مسدود می‌ماند دریافت می‌کند
.TP
\fBget <JAIL> datepattern\fR
الگوی مورد استفاده برای مطابقت تاریخ و زمان در زندان <JAIL> را دریافت می‌کند
.TP
\fBget <JAIL> usedns\fR
تنظیمات usedns را برای زندان <JAIL> دریافت می‌کند
.TP
\fBget <JAIL> banip [<SEP>|\-\-with\-time]\fR
فهرست نشانی‌های IP مسدودشده را برای زندان <JAIL> دریافت می‌کند. به صورت اختیاری می‌توان نویسه جداکننده ('<SEP>'، پیش‌فرض فاصله است) یا گزینه
.B \-\-with\-time
(جهت چاپ زمان‌های مسدودیت) را مشخص کرد. نشانی‌های IP بر اساس زمان پایان مسدودیت مرتب می‌شوند.
.TP
\fBget <JAIL> maxretry\fR
تعداد شکست‌های مجاز برای زندان <JAIL> را دریافت می‌کند
.TP
\fBget <JAIL> maxmatches\fR
حداکثر تعداد تطابق‌های ذخیره‌شده در حافظه به ازای هر بلیت در زندان <JAIL> را دریافت می‌کند
.TP
\fBget <JAIL> maxlines\fR
تعداد خطوط بافر برای زندان <JAIL> را دریافت می‌کند
.TP
\fBget <JAIL> actions\fR
فهرستی از اقدام‌های تعریف‌شده برای زندان <JAIL> را دریافت می‌کند
.IP
اطلاعات دستور اقدام (COMMAND ACTION INFORMATION)
.TP
\fBget <JAIL> action <ACT> actionstart\fR
دستور شروع اقدام <ACT> را برای زندان <JAIL> دریافت می‌کند
.TP
\fBget <JAIL> action <ACT> actionstop\fR
دستور توقف اقدام <ACT> را برای زندان <JAIL> دریافت می‌کند
.TP
\fBget <JAIL> action <ACT> actioncheck\fR
دستور بررسی اقدام <ACT> را برای زندان <JAIL> دریافت می‌کند
.TP
\fBget <JAIL> action <ACT> actionban\fR
دستور مسدودسازی اقدام <ACT> را برای زندان <JAIL> دریافت می‌کند
.TP
\fBget <JAIL> action <ACT> actionunban\fR
دستور رفع مسدودیت اقدام <ACT> را برای زندان <JAIL> دریافت می‌کند
.TP
\fBget <JAIL> action <ACT> timeout\fR
مهلت زمانی اجرای دستور را به ثانیه برای اقدام <ACT> در زندان <JAIL> دریافت می‌کند
.IP
اطلاعات عمومی اقدام (GENERAL ACTION INFORMATION)
.TP
\fBget <JAIL> actionproperties <ACT>\fR
فهرستی از ویژگی‌های اقدام <ACT> را برای زندان <JAIL> دریافت می‌کند
.TP
\fBget <JAIL> actionmethods <ACT>\fR
فهرستی از متدهای اقدام <ACT> را برای زندان <JAIL> دریافت می‌کند
.TP
\fBget <JAIL> action <ACT> <PROPERTY>\fR
مقدار ویژگی <PROPERTY> را برای اقدام <ACT> در زندان <JAIL> دریافت می‌کند
.SH "فایل‌ها (FILES)"
\fI/etc/fail2ban/*\fR
.SH "گزارش خطاها (REPORTING BUGS)"
گزارش اشکالات و خطاها را به نشانی زیر ارسال کنید:
.br
<https://github.com/fail2ban/fail2ban/issues>
.SH "همچنین ببینید (SEE ALSO)"
.BR fail2ban-server (1)،
.BR jail.conf (5)