RSPAMC(1)                                                            RSPAMC(1)

نام (NAME)
       rspamc - کلاینت خط فرمان rspamd

خلاصه دستور (SYNOPSIS)
       rspamc [گزینه‌ها] [دستور] [فایل-ورودی]...

       rspamc –help

توضیحات (DESCRIPTION)
       rspamc یک کلاینت ساده برای rspamd است که عمدتاً برای دسته‌بندی یا آموزش
       پیام‌ها به کار می‌رود.  rspamc از دستورات زیر پشتیبانی می‌کند:

       • دستورات اسکن:

         • symbols: اسکن پیام و نمایش نمادها (دستور پیش‌فرض)

       • دستورات کنترلی:

         • learn_spam: آموزش پیام به عنوان هرزنامه (spam)

         • learn_ham: آموزش پیام به عنوان پیام معتبر (ham)

         • fuzzy_add: افزودن پیام به حافظه فازی (گزینه‌های -f و -w را برای این
           دستور بررسی کنید)

         • fuzzy_del: حذف پیام از حافظه فازی (گزینه -f را برای این دستور بررسی
           کنید)

         • stat: نمایش آمار rspamd

         • stat_reset: نمایش و بازنشانی آمار rspamd (مفید برای نمودارها)

         • counters: نمایش آمار نمادهای rspamd

         • uptime: نمایش مدت‌زمان فعال بودن rspamd

         • add_symbol: افزودن یا تغییر تنظیمات نماد در rspamd

         • add_action: افزودن یا تغییر تنظیمات اقدام (action)

       دستورات کنترلی که وضعیت rspamd را تغییر می‌دهند دارای دسترسی ویژه محسوب
       شده و نیازمند مشخص کردن رمز عبور با گزینه -P هستند (برای جزئیات بیشتر
       به بخش گزینه‌ها (OPTIONS) در ادامه مراجعه کنید).
       این موضوع به تنظیمات کنترل‌کننده بستگی دارد و در صفحه rspamd-workers
       مورد بحث قرار گرفته است (برای جزئیات بیشتر به بخش همچنین ببینید (SEE
       ALSO) در ادامه مراجعه کنید).

       فایل‌های ورودی می‌توانند فایل(های) معمولی یا یک دایرکتوری برای اسکن
       باشند.  اگر هیچ فایلی مشخص نشود، rspamc از ورودی استاندارد می‌خواند.
       دستورات کنترل‌کننده معمولاً هیچ ورودی نمی‌پذیرند، اما دستورات *learn و
       *fuzzy نیازمند ورودی هستند.

گزینه‌ها (OPTIONS)
       -h host[:port], --connect=host[:port]
              مشخص کردن میزبان و پورت

       -P password, --password=password
              مشخص کردن رمز عبور کنترلی. می‌تواند یک مسیر مطلق یا نسبی باشد که
              در این صورت رمز عبور از آن فایل خوانده خواهد شد.

       -c name, --classifier=name
              دسته‌بندی‌کننده برای آموزش هرزنامه یا پیام معتبر (به طور پیش‌فرض از
              bayes استفاده می‌شود)

       -w weight, --weight=weight
              وزن برای عملیات فازی

       -f number, --flag=number
              فلگ برای عملیات فازی

       -p, --pass
              عبور از تمام فیلترها

       -v, --verbose
              خروجی با جزئیات بیشتر

       -i ip address, --ip=ip address
              شبیه‌سازی دریافت پیام از آدرس IP مشخص‌شده

       -u username, --user=username
              شبیه‌سازی دریافت پیام از کاربر احراز هویت‌شده مشخص

       -d user@domain, --deliver=user@domain
              شبیه‌سازی تحویل پیام به کاربر مشخص‌شده (برای LDA/آمار)

       -F user@domain, --from=user@domain
              شبیه‌سازی اینکه پیام دارای آدرس مشخص‌شده SMTP FROM است

       -r user@domain, --rcpt=user@domain
              شبیه‌سازی اینکه پیام دارای آدرس مشخص‌شده SMTP RCPT است

       --helo=helo_string
              شبیه‌سازی ارسال SMTP HELO از سوی MTA

       --hostname=hostname
              شبیه‌سازی ارسال نام میزبان از سوی MTA (برنامه rspamd فرض می‌کند که
              این مقدار توسط MTA تأیید شده است)

       -t seconds, --timeout=seconds
              مهلت زمانی انتظار برای پاسخ (می‌تواند عدد ممیز شناور باشد، مانند
              0.1)

       -b host:port, --bind=host:port
              متصل شدن به آدرس IP مشخص‌شده

       -R, --human
              نمایش گزارش خوانا برای انسان.  خط اول خروجی شامل امتیاز پیام و
              سه امتیاز آستانه با این قالب است:

                  score/greylist/addheader/reject,action=N:ACTION,spam=0|1,skipped=0|1

       -j, --json
              خروجی به صورت JSON فرمت‌شده

       --ucl  خروجی به صورت UCL

       --raw  خروجی داده‌های خام دریافت‌شده از rspamd (به صورت JSON فشرده)

       --headers
              خروجی هدرهای HTTP از یک پاسخ

       --extended-urls
              نمایش URLها در قالب گسترش‌یافته، شامل نشانی کامل اینترنتی، میزبان
              و بخشی از میزبان که توسط ماژول surbl استفاده شده است (در صورت
              فعال بودن).

       -n parallel_count, --max-requests=parallel_count
              حداکثر تعداد درخواست‌های موازی ارسال‌شده به rspamd (پیش‌فرض: 8)

       -e command, --execute=command
              اجرای دستور مشخص‌شده همراه با خروجی mime (در صورتی که گزینه mime
              نیز مشخص شده باشد) یا خروجی فرمت‌شده rspamd

       --mime خروجی کل پیام mime به جای فقط نتایج اسکن

       --header=header
              افزودن هدر سفارشی HTTP برای یک درخواست.  می‌توانید هدر را در قالب
              name=value یا فقط name برای هدر خالی مشخص کنید.  این گزینه
              می‌تواند چندین بار تکرار شود.

       --sort=type
              مرتب‌سازی خروجی بر اساس یک فیلد خاص.  برای دستور counters مقادیر
              مجاز برای این کلید عبارتند از: name، weight، frequency و hits.
              افزودن :asc به هر یک از این مقادیر، ترتیب مرتب‌سازی را معکوس
              می‌کند.

       --commands
              فهرست کردن دستورات موجود

کد خروجی (RETURN VALUE)
       در زمان خروج، اگر عملیات با موفقیت انجام شده باشد rspamc مقدار 0 و در
       غیر این صورت یک کد خطا بازمی‌گرداند.

مثال‌ها (EXAMPLES)
       بررسی ورودی استاندارد (stdin):

              rspamc < some_file

       بررسی فایل‌ها:

              rspamc symbols file1 file2 file3

       آموزش فایل‌ها:

              rspamc -P pass learn_spam file1 file2 file3

       افزودن هش فازی به مجموعه ۲:

              rspamc -P pass -f 2 -w 10 fuzzy_add file1 file2

       حذف هش فازی از سرور دیگر:

              rspamc -P pass -h hostname:11334 -f 2 fuzzy_del file1 file2

       دریافت آمار:

              rspamc stat

       دریافت مدت‌زمان فعال بودن (uptime):

              rspamc uptime

       افزودن وزن قانون سفارشی:

              rspamc add_symbol test 1.5

       افزودن وزن اقدام سفارشی:

              rspamc add_action reject 7.1

همچنین ببینید (SEE ALSO)
       مستندات و کد منبع Rspamd را می‌توان از نشانی زیر دریافت کرد:
       <https://rspamd.com>.

Rspamd User Manual                                                   RSPAMC(1)