نام (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.