.\" 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 "PDNS_RECURSOR" "1" "Sep 02, 2026" "" "PowerDNS Recursor" .SH "نام (NAME)" pdns_recursor \- فایل باینری سرور بازگشتی PowerDNS .SH "خلاصه دستور (SYNOPSIS)" .sp \fBpdns_recursor\fP [\fIOPTION\fP]... .SH "توضیحات (DESCRIPTION)" .sp \fBpdns_recursor\fP یک سرور نام دامنه بازگشتی امن، ساده و با کارایی بالا است. این نرم‌افزار در حال حاضر به صدها میلیون اتصال اینترنتی خدمات‌رسانی می‌کند. .sp تنظیمات این سرویس بازگشتی از طریق یک فایل پیکربندی انجام می‌شود، اما هر گزینه در آن فایل می‌تواند از طریق خط فرمان بازنویسی (override) شود. .sp این راهنما مجموعه‌ای از ویژگی‌های اصلی مورد نیاز برای راه‌اندازی PowerDNS Recursor را فهرست می‌کند؛ برای دریافت اطلاعات کامل و به‌روز به \fI\%https://doc.powerdns.com\fP مراجعه کنید.\& .SH "مثال‌ها (EXAMPLES)" .sp برای گوش دادن روی 192.0.2.53 و اجازه بازگشت به زیرشبکه 192.0.2.0/24 و اجرا در پس‌زمینه، دستور زیر را اجرا کنید: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C # pdns_recursor \-\-local\-address=192.0.2.53 \-\-allow\-from=192.0.2.0/24 \-\-daemon .ft P .fi .UNINDENT .UNINDENT .sp برای متوقف کردن دستی سرویس، اجرا کنید: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C # rec_control quit\-nicely .ft P .fi .UNINDENT .UNINDENT .sp با این حال، روش توصیه‌شده برای شروع و متوقف کردن recursor استفاده از \fBsystemctl(1)\fP یا اسکریپت init.d است. .SH "گزینه‌ها (OPTIONS)" .sp برای مشاهده فهرست رسمی و معتبر گزینه‌ها، به مستندات آنلاین در \fI\fP مراجعه کنید. .INDENT 0.0 .TP .BI \-\-allow\-from\fB= در صورت تعیین، تنها به این \fInetworks\fP که با کاما جدا شده‌اند، همراه با ماسک شبکه اجازه تفکیک بازگشتی داده می‌شود. به عنوان مثال: 192.0.2.0/24,203.0.113.128/25. .TP .BI \-\-auth\-zones\fB= که در آن \fIauthzone\fP به صورت = است. پاسخ‌دهی معتبر و موثق به \fIzonename\fP از طریق \fIfilename\fP انجام می‌شود. به عنوان مثال: ds9a.nl=/var/zones/ds9a.nl,powerdns.com=/var/zones/powerdns.com. .TP .BI \-\-chroot\fB= تغییر ریشه محیط پردازش (chroot) به \fIdirectory\fP\&. .TP .BI \-\-client\-tcp\-timeout\fB= مدت‌زمان انتظار (timeout) به ثانیه هنگام ارتباط با کلاینت‌های TCP. .TP .B \-\-config نمایش پیکربندی فعلی. از نسخه 4.8.0 سه مقدار اختیاری وجود دارد: \fB\-\-config=default\fP برای نمایش پیکربندی پیش‌فرض. \fB\-\-config=diff\fP نمایش گزینه‌های تغییریافته در پیکربندی فعلی. \fB\-\-config=check\fP برای بررسی پیکربندی فعلی از نظر وجود خطا. .TP .BI \-\-config\-dir\fB= مسیر دایرکتوری پیکربندی (recursor.conf)؛ مقدار پیش‌فرض به گزینه SYSCONFDIR در زمان کامپایل بستگی دارد که معمولاً /etc/powerdns است. مقدار پیش‌فرض را می‌توان با دستور \fBpdns_recursor \-\-config | grep \(aq config\-dir=\(aq\fP مشاهده کرد.\& .TP .B \-\-daemon اجرا به صورت یک دیمن (daemon) در پس‌زمینه. .TP .B \-\-export\-etc\-hosts در صورت تنظیم، این پرچم نام‌های میزبان و آدرس‌های IP ذکرشده در /etc/hosts را صادر می‌کند. .TP .BI \-\-forward\-zones\fB= که در آن \fIforwardzone\fP به صورت =
است. پرس‌وجوها برای \fIzonename\fP به \fIaddress\fP بازفرستاده (forward) خواهند شد.\& \fIaddress\fP باید یک آدرس IP باشد، نه یک نام میزبان (برای جلوگیری از چرخه نامعتبر وابستگی). مثال: forward\-zones= ds9a.nl=213.244.168.210, powerdns.com=127.0.0.1. .TP .BI \-\-forward\-zones\-file\fB= مشابه \fI\-\-forward\-zones\fP، اما گزینه‌ها را از \fIfilename\fP می‌خواند.\& فایل \fIfilename\fP باید در هر خط یک ناحیه داشته باشد، مانند: ds9a.nl=213.244.168.210. .TP .B \-\-help نمایش خلاصه‌ای از گزینه‌ها. .TP .BI \-\-hint\-file\fB= بارگذاری root hints (نشانی‌های ریشه) از این \fIfilename\fP .TP .BI \-\-local\-address\fB=
گوش دادن روی \fIaddress\fP، که با فاصله یا کاما جدا می‌شوند. آدرس‌های مشخص‌شده می‌توانند شامل شماره پورت باشند؛ هر آدرسی که شامل شماره پورت نباشد روی پورت تعیین‌شده با \fI\-\-local\-port\fP گوش خواهد داد.\& .TP .BI \-\-local\-port\fB= گوش دادن روی \fIport\fP مشخص‌شده.\& .TP .B \-\-log\-common\-errors آیا خطاهای رایج و عمومی نیز ثبت شوند یا خیر. .TP .BI \-\-max\-cache\-entries\fB= حداکثر تعداد مدخل‌ها در حافظه نهان (cache) اصلی. .TP .BI \-\-max\-negative\-ttl\fB= حداکثر تعداد ثانیه‌ها برای نگهداری یک مدخل کش منفی (negative cache) در حافظه. .TP .BI \-\-max\-tcp\-clients\fB= حداکثر تعداد کلاینت‌های هم‌زمان TCP. .TP .BI \-\-max\-tcp\-per\-client\fB= در صورت تعیین، حداکثر تعداد نشست‌های TCP به ازای هر کلاینت (آدرس IP). .TP .BI \-\-query\-local\-address\fB= استفاده از \fIaddress\fP به عنوان آدرس IP مبدأ در زمان ارسال پرس‌وجوها. .TP .B \-\-quiet جلوگیری از ثبت لاگ مربوط به پرسش‌ها و پاسخ‌ها. .TP .BI \-\-server\-id\fB= بازگرداندن \fItext\fP در هنگام دریافت پرس‌وجو برای رکورد TXT به نشانی \(aqid.server\(aq؛ پیش‌فرض نام میزبان (hostname) است. .TP .B \-\-serve\-rfc1918 به طور پیش‌فرض فعال است؛ این گزینه سرور را به صورت موثق نسبت به دامنه‌های زیر آگاه می‌سازد: 10.in\-addr.arpa، 168.192.in\-addr.arpa و 16\-31.172.in\-addr.arpa، که باعث کاهش بار روی سرورهای AS112 می‌شود. بخش‌های مجزای این نواحی همچنان می‌توانند بارگذاری یا فوروارد شوند. .TP .BI \-\-setgid\fB= در صورت تعیین، تغییر شناسه گروه به \fIgid\fP برای امنیت بیشتر. .TP .BI \-\-setuid\fB= در صورت تعیین، تغییر شناسه کاربر به \fIuid\fP برای امنیت بیشتر. .TP .B \-\-single\-socket در صورت تنظیم، تنها از یک سوکت منفرد برای پرس‌وجوهای خروجی استفاده می‌شود. .TP .BI \-\-socket\-dir\fB= سوکت کنترلی (controlsocket) در \fIdirectory\fP مستقر خواهد شد.\& .TP .BI \-\-spoof\-nearmiss\-max\fB= در صورت غیرصفر بودن، پس از این تعداد عدم تطابق نزدیک، فرض بر جعل (spoofing) گذاشته می‌شود. .TP .B \-\-trace ثبت حجم بسیار زیادی از گزارش‌ها و لاگ‌ها. .TP .BI \-\-version\-string\fB= رشته \fItext\fP در پاسخ به پرس‌وجوهای version.pdns یا version.bind گزارش خواهد شد. .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp \fBrec_control(1)\fP \fBsystemctl(1)\fP \fI\%https://docs.powerdns.com/recursor\fP .SH "نویسندگان (AUTHORS)" PowerDNS.COM BV .SH "کپی‌رایت و تکثیر (COPYRIGHT)" PowerDNS.COM BV .\" Generated by docutils manpage writer. .