.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "RAZOR-AGENT.CONF 1" .TH RAZOR-AGENT.CONF 1 2026-04-06 "perl v5.42.2" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" razor\-agent.conf \- فایل پیکربندی برای کارگزارهای Razor .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" \&\f(CW\*(C`razor\-agent.conf\*(C'\fR یک فایل پیکربندی است که توسط کارگزارهای razor خوانده می‌شود، شامل \fBrazor\-check\fR\|(1)، \fBrazor\-admin\fR\|(1)، \fBrazor\-report\fR\|(1) و \&\fBrazor\-revoke\fR\|(1). قالب این فایل به صورت جفت‌های "attribute = value" است، یک جفت در هر خط. خطوطی که با \`#\*(Aq شروع می‌شوند به عنوان توضیح (کامنت) در نظر گرفته می‌شوند. .SH "ویژگی‌ها (ATTRIBUTES)" .IX Header "ATTRIBUTES" ویژگی‌های زیر را می‌توان تعیین کرد: .IP \fBrazorhome\fR 4 .IX Item "razorhome" دایرکتوری که کارگزارهای Razor فایل‌ها را در آن جستجو می‌کنند. تمام فایل‌های موجود در \f(CW\*(C`razor\-agent.conf\*(C'\fR بدون مسیر کامل، نسبت به \f(CW\*(C`razorhome\*(C'\fR سنجیده خواهند شد. مقدار پیش‌فرض برای کاربر root برابر \f(CW\*(C`/etc/razor/\*(C'\fR و برای سایر کاربران \f(CW\*(C`~/.razor/\*(C'\fR است. اگر \f(CW\*(C`razorhome\*(C'\fR وجود نداشته باشد، ایجاد خواهد شد. .IP \fBlogfile\fR 4 .IX Item "logfile" فایل لاگ برای کارگزارهای Razor. مقدار پیش‌فرض \f(CW\*(C`razor\-agent.log\*(C'\fR است. .IP \fBdebuglevel\fR 4 .IX Item "debuglevel" میزان پیام‌های نوشته‌شده در فایل لاگ را کنترل می‌کند. این مقدار یک عدد صحیح بین 0 تا 20 است. برای مثال، مقدار \f(CW1\fR تنها پیام‌های راه‌اندازی و خطاها را ثبت می‌کند، \f(CW5\fR شامل تمام تراکنش‌ها با سرور است، و \f(CW14\fR اطلاعات بسیار باجزئیات و پرحجم است که فقط برای اشکال‌زدایی در نظر گرفته شده است. نکته: مقادیر \f(CW15\fR و بالاتر فایل‌های اشکال‌زدایی روی سیستم‌فایل شما ایجاد می‌کنند \-\- از آن‌ها استفاده نکنید مگر اینکه دقیقاً بدانید چه می‌کنید. مقدار پیش‌فرض \f(CW5\fR است. .IP \fBidentity\fR 4 .IX Item "identity" یک فایل شناسه (identity) را جهت ذخیره شناسه تازه ثبت‌شده در حین اجرای \fBrazor\-admin\fR\|(1) مشخص می‌کند. برای \fBrazor\-report\fR\|(1) و \fBrazor\-revoke\fR\|(1)، از این شناسه هنگام احراز هویت با سرورهای Razor استفاده می‌شود. اگر مشخص نشود، از \f(CW\*(C`/identity\-\*(C'\fR استفاده خواهد شد. .IP \fBlistfile_nomination\fR 4 .IX Item "listfile_nomination" فایلی که در آن سرورهای معرفی Razor (Razor Nomination Servers) به ترتیب نزدیک‌ترین زمان پینگ TCP فهرست شده‌اند. سرورهای معرفی توسط \fBrazor\-report\fR\|(1) و \fBrazor\-revoke\fR\|(1) استفاده می‌شوند. این فایل به صورت خودکار ایجاد می‌شود. مقدار پیش‌فرض \f(CW\*(C`servers.nomination.lst\*(C'\fR است. .IP \fBlistfile_catalogue\fR 4 .IX Item "listfile_catalogue" فایلی که در آن سرورهای کاتالوگ Razor (Razor Catalogue Servers) به ترتیب نزدیک‌ترین زمان پینگ TCP فهرست شده‌اند. سرورهای کاتالوگ توسط \fBrazor\-check\fR\|(1) استفاده می‌شوند. این فایل به صورت خودکار ایجاد می‌شود. مقدار پیش‌فرض \f(CW\*(C`servers.catalogue.lst\*(C'\fR است. .IP \fBlistfile_discovery\fR 4 .IX Item "listfile_discovery" فایلی که در آن سرورهای کشف Razor (Razor Discovery Servers) با ترتیبی تصادفی فهرست شده‌اند. این فایل به صورت خودکار با استفاده از DNS ایجاد می‌شود. مقدار پیش‌فرض \f(CW\*(C`servers.discovery.lst\*(C'\fR است. .IP \fBrediscovery_wait_dns\fR 4 .IX Item "rediscovery_wait_dns" حداکثر زمان به ثانیه که کارگزارهای Razor پیش از محاسبه یک \f(CW\*(C`listfile_discovery\*(C'\fR جدید با استفاده از DNS منتظر می‌مانند. مقدار پیش‌فرض \f(CW604800\fR (۷ روز) است. .IP \fBrediscovery_wait\fR 4 .IX Item "rediscovery_wait" حداکثر زمان به ثانیه که کارگزارهای Razor پیش از محاسبه مجدد \f(CW\*(C`listfile_nomination\*(C'\fR جدید و \f(CW\*(C`listfile_catalogue\*(C'\fR جدید منتظر می‌مانند. مقدار پیش‌فرض \f(CW172800\fR (۲ روز) است. .IP \fBturn_off_discovery\fR 4 .IX Item "turn_off_discovery" کشف نزدیک‌ترین میزبان را غیرفعال می‌کند. هنگامی که روی 1 تنظیم شود، \f(CW\*(C`listfile_catalogue\*(C'\fR و \f(CW\*(C`listfile_nomination\*(C'\fR به‌روزرسانی نخواهند شد و \f(CW\*(C`listfile_discovery\*(C'\fR خوانده یا به‌روزرسانی نمی‌شود. مقدار پیش‌فرض \f(CW0\fR است. .IP \fBignorelist\fR 4 .IX Item "ignorelist" نادیده‌گرفتن خودکار پیام‌های فهرست‌های پستی (mailing list). اگر روی \f(CW0\fR تنظیم شود، با پیام‌های فهرست‌های پستی مانند سایر ایمیل‌ها رفتار خواهد شد. مقدار پیش‌فرض \f(CW0\fR است. .IP \fBwhitelist\fR 4 .IX Item "whitelist" نام فایل فهرست سفید (whitelist). کارگزارهای Razor می‌توانند پیش از بررسی یک ایمیل با سرورهای Razor، به یک فهرست سفید از آدرس‌ها و هش‌های SHA1 مراجعه کنند. اگر آدرس/هش در فهرست سفید یافت شود، ایمیل بدون بررسی در برابر سرور به عنوان \`not spam\*(Aq علامت‌گذاری می‌شود. قالب فهرست سفید را می‌توانید در صفحه راهنمای \fBrazor\-whitelist\fR\|(5) بیابید. مقدار پیش‌فرض \f(CW\*(C`razor\-whitelist\*(C'\fR است. .IP \fBmin_cf\fR 4 .IX Item "min_cf" هنگام بررسی هرزنامه، سرور می‌تواند مقداری برای میزان اطمینان از هرزنامه بودن در بازه 0 (عدم اطمینان) تا 100 (اطمینان کامل یا ۱۰۰٪) بازگرداند. برای اینکه پیامی هرزنامه تلقی شود، مقدار اطمینان سرور از هرزنامه بودن باید بزرگتر یا مساوی با \f(CW\*(C`min_cf\*(C'\fR باشد. \f(CW\*(C`min_cf\*(C'\fR می‌تواند یک عدد یا عبارتی شامل ac (میانگین اطمینان منتشر شده توسط یک سرور Razor) باشد. مثال‌ها: 0, 60, 100, ac, ac + 10, ac \- 20. اگر مقدار یک عبارت کمتر از 0 ارزیابی شود برابر با 0 خواهد بود، و به همین ترتیب مقادیر بیشتر از 100 به 100 تبدیل می‌شوند. مقدار پیش‌فرض \f(CW\*(C`ac\*(C'\fR است. .IP \fBreport_headers\fR 4 .IX Item "report_headers" هنگام گزارش هرزنامه، کل ایمیل (سرآیندها و بدنه) به یک سرور معرفی Razor ارسال می‌شود. هنگامی که روی \f(CW0\fR تنظیم شود، پیش از ارسال، تمام سرآیندها به جز مواردی که با \f(CW\*(C`Content\-\*(C'\fR آغاز می‌شوند حذف شده و یک سرآیند ویژه که با \f(CW\*(C`X\-Razor2\*(C'\fR شروع می‌شود برای ثبت این اقدام اضافه می‌گردد. مقدار پیش‌فرض \f(CW1\fR است. .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" Vipul Ved Prakash, و Chad Norwood .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBrazor\-agents\fR\|(1)، \fBrazor\-check\fR\|(1)، \fBrazor\-admin\fR\|(1)، \&\fBrazor\-report\fR\|(1)، \fBrazor\-revoke\fR\|(1)، \fBrazor\-whitelist\fR\|(5)