.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "SSHGUARD" "8" "January 1, 2025" "2.5.1" "SSHGuard Manual"
.SH "نام (NAME)"
sshguard \- مسدودسازی حملات بروت‌فورس با تجمیع لاگ‌های سیستم
.\" Copyright (c) 2007,2008,2009,2010 Mij <mij@sshguard.net>
.
.\" Permission to use, copy, modify, and distribute this software for any
.
.\" purpose with or without fee is hereby granted, provided that the above
.
.\" copyright notice and this permission notice appear in all copies.
.
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBsshguard\fP [\fB\-hv\fP]
[\fB\-a\fP \fIthreshold\fP]
[\fB\-b\fP \fIthreshold\fP:\fIblacklist_file\fP]
[\fB\-i\fP \fIpidfile\fP]
[\fB\-p\fP \fIblocktime\fP]
[\fB\-s\fP \fIdetection_time\fP]
[\fB\-w\fP \fIaddress\fP | \fIwhitelist_file\fP]
[\fIfile\fP ...]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور
\fBsshguard\fP
از میزبان‌ها در برابر حملات بروت‌فورس علیه SSH و سایر سرویس‌ها محافظت می‌کند. این برنامه لاگ‌های سیستم را تجمیع کرده و با استفاده از یکی از چندین بک‌اند فایروال، متخلفان مکرر را مسدود می‌سازد.
.sp
\fBsshguard\fP
می‌تواند فایل‌های لاگ و خروجی استاندارد حاصل از اجرای یک دستور پوسته را پایش کند. پیام‌های لاگ خط‌به‌خط برای یافتن الگوهای حمله شناخته‌شده تجزیه می‌شوند. مهاجمان هنگامی مسدود می‌شوند که الگوهای حمله به تعداد کافی در یک بازه زمانی قابل‌پیکربندی شناسایی شوند. مهاجمان به صورت موقت مسدود می‌شوند اما با استفاده از گزینه لیست سیاه می‌توان آن‌ها را به طور دائم نیز مسدود کرد.
.sp
\fBsshguard\fP
باید پیش از نخستین اجرای خود پیکربندی شود. به
\fBsshguard\-setup(7)\fP\&
مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \fB\-a\fP \fIthreshold\fP (پیش‌فرض: 30)
هر حمله شناسایی‌شده، امتیاز حمله مهاجم را معمولاً ۱۰ واحد افزایش می‌دهد. هنگامی که امتیاز حمله مهاجم از
\fIthreshold\fP
فراتر رود، مهاجم مسدود می‌شود.
.TP
.B \fB\-b\fP \fIthreshold\fP:\fIblacklist_file\fP
هنگامی که امتیاز حمله یک مهاجم از
\fIthreshold\fP
بیشتر شود، آن را در لیست سیاه قرار می‌دهد. نشانی‌های مسدودشده در لیست سیاه در
\fIblacklist_file\fP
نوشته می‌شوند و حتی پس از راه‌اندازی مجدد
\fBsshguard\fP
هرگز رفع مسدودیت نمی‌شوند.
.TP
.B \fB\-i\fP \fIpidfile\fP
شناسه فرایند (PID) مربوط به
\fBsshguard\fP
را در
\fIpidfile\fP
می‌نویسد. پس از خروج
\fBsshguard\fP
فایل
\fIpidfile\fP
حذف می‌شود.
.TP
.B \fB\-p\fP \fIblocktime\fP (پیش‌فرض: 120)
مهاجمانی را که برای نخستین بار حمله می‌کنند به مدت
\fIblocktime\fP
ثانیه مسدود می‌کند. مدت زمان مسدودسازی‌های بعدی با ضریب ۲ افزایش می‌یابد. از آنجا که
\fBsshguard\fP
مهاجمان را در فواصل زمانی تصادفی رفع مسدودیت می‌کند، زمان واقعی انسداد ممکن است تا حدی طولانی‌تر باشد.
.TP
.B \fB\-s\fP \fIdetection_time\fP (پیش‌فرض: 1800)
امتیاز حمله مهاجم را پس از سپری شدن
\fIdetection_time\fP
ثانیه از آخرین حمله بازنشانی می‌کند. این بدان معناست که مهاجمانی که هر
\fIdetection_time\fP
ثانیه یک بار حمله می‌کنند، هرگز توسط
\fBsshguard\fP
مسدود نمی‌شوند. با این حال، افزایش مقدار
\fIdetection_time\fP
ممکن است بر روی کاربران مجاز نیز تأثیر بگذارد.
.TP
.B [\fB\-w\fP \fIaddress\fP | \fIwhitelist_file\fP]
یک نشانی مجزا، نام میزبان یا بلوک نشانی ارائه‌شده در
\fIaddress\fP
را در لیست سفید قرار می‌دهد. این گزینه را می‌توان چندین بار مشخص کرد. همچنین می‌توان مسیر مطلق به یک
\fIwhitelist_file\fP
شامل نشانی‌های مجاز ارائه داد. بخش
«لیست سفید» (WHITELISTING)
را ببینید.
.TP
.B \fB\-h\fP
نمایش اطلاعات نحوه استفاده و خروج.
.TP
.B \fB\-v\fP
نمایش اطلاعات نسخه و خروج.
.UNINDENT
.SH "محیط (ENVIRONMENT)"
.INDENT 0.0
.TP
.B SSHGUARD_USER
در صورت تعیین، فرایندهای درون محیط ایزوله (سندباکس) با تغییر هویت به این کاربر، سطح دسترسی خود را کاهش می‌دهند. این مقدار معمولاً در
\fIsshguard.conf\fP
با استفاده از متغیر SSHGUARD_USER تعیین شده و بازنویسی می‌شود.
.TP
.B SSHGUARD_DEBUG
برای فعال‌سازی خروجی با جزئیات کامل از
\fBsshg\-blocker\fP
تنظیم می‌شود.
.TP
.B SSHGUARD_STATS_DIR
در صورت تنظیم، آمارهای سازگار با سامانه پرومتئوس (Prometheus) هر دقیقه در قالب فایل‌های ‎.prom‎ در این دایرکتوری نوشته می‌شوند. متغیر STATS_DIR در فایل
\fIsshguard.conf\fP
این متغیر محیطی را تنظیم کرده و بر آن اولویت خواهد داشت.
.UNINDENT
.SH "فایل‌ها (FILES)"
.INDENT 0.0
.TP
.B %PREFIX%/etc/sshguard.conf
فایل نمونه پیکربندی را ببینید.
.UNINDENT
.SH "لیست سفید (WHITELISTING)"
.sp
نشانی‌های موجود در لیست سفید هرگز مسدود نمی‌شوند. نشانی‌ها را می‌توان در خط فرمان مشخص کرد یا در یک فایل ذخیره نمود.
.sp
در خط فرمان، گزینه
\fB\-w\fP
را یک یا چند بار همراه با یک نشانی IP، بلوک نشانی CIDR یا نام میزبان به عنوان آرگومان وارد کنید. نام‌های میزبان یک بار هنگام راه‌اندازی ارزیابی و حل می‌شوند. اگر یک نام میزبان به چند نشانی ارجاع داده شود، تمامی آن‌ها در لیست سفید قرار می‌گیرند. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sshguard \-w 192.168.1.10 \-w 192.168.0.0/24 \-w friend.example.com
    \-w 2001:0db8:85a3:0000:0000:8a2e:0370:7334
    \-w 2002:836b:4179::836b:0000/126
.EE
.UNINDENT
.UNINDENT
.sp
اگر آرگومان ارائه‌شده به
\fB\-w\fP
با یک اسلش (\(aq/\(aq) یا نقطه (\(aq.\(aq) آغاز شود، به عنوان مسیر فایل لیست سفید در نظر گرفته می‌شود.
.sp
فایل لیست سفید شامل توضیحات (خطوطی که با \(aq#\(aq آغاز می‌شوند)، نشانی‌ها، بلوک‌های نشانی یا نام‌های میزبان به صورت هر مورد در یک خط است.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBsshguard\-setup\fP(7)
.\" Generated by docutils manpage writer.
.