نام (NAME)

pdns_recursor - فایل باینری سرور بازگشتی PowerDNS

خلاصه دستور (SYNOPSIS)

pdns_recursor [OPTION]...

توضیحات (DESCRIPTION)

pdns_recursor یک سرور نام دامنه بازگشتی امن، ساده و با کارایی بالا است. این نرم‌افزار در حال حاضر به صدها میلیون اتصال اینترنتی خدمات‌رسانی می‌کند.

تنظیمات این سرویس بازگشتی از طریق یک فایل پیکربندی انجام می‌شود، اما هر گزینه در آن فایل می‌تواند از طریق خط فرمان بازنویسی (override) شود.

این راهنما مجموعه‌ای از ویژگی‌های اصلی مورد نیاز برای راه‌اندازی PowerDNS Recursor را فهرست می‌کند؛ برای دریافت اطلاعات کامل و به‌روز به https://doc.powerdns.com مراجعه کنید.

مثال‌ها (EXAMPLES)

برای گوش دادن روی 192.0.2.53 و اجازه بازگشت به زیرشبکه 192.0.2.0/24 و اجرا در پس‌زمینه، دستور زیر را اجرا کنید:

# pdns_recursor --local-address=192.0.2.53 --allow-from=192.0.2.0/24 --daemon

برای متوقف کردن دستی سرویس، اجرا کنید:

# rec_control quit-nicely

با این حال، روش توصیه‌شده برای شروع و متوقف کردن recursor استفاده از systemctl(1) یا اسکریپت init.d است.

گزینه‌ها (OPTIONS)

برای مشاهده فهرست رسمی و معتبر گزینه‌ها، به مستندات آنلاین در https://doc.powerdns.com مراجعه کنید.

--allow-from=<networks>: در صورت تعیین، تنها به این networks که با کاما جدا شده‌اند، همراه با ماسک شبکه اجازه تفکیک بازگشتی داده می‌شود. به عنوان مثال: 192.0.2.0/24,203.0.113.128/25.
--auth-zones=<authzones>: که در آن authzone به صورت <zonename>=<filename> است. پاسخ‌دهی معتبر و موثق به zonename از طریق filename انجام می‌شود. به عنوان مثال: ds9a.nl=/var/zones/ds9a.nl,powerdns.com=/var/zones/powerdns.com.
--chroot=<directory>: تغییر ریشه محیط پردازش (chroot) به directory.
--client-tcp-timeout=<num>: مدت‌زمان انتظار (timeout) به ثانیه هنگام ارتباط با کلاینت‌های TCP.
--config: نمایش پیکربندی فعلی. از نسخه 4.8.0 سه مقدار اختیاری وجود دارد: --config=default برای نمایش پیکربندی پیش‌فرض. --config=diff نمایش گزینه‌های تغییریافته در پیکربندی فعلی. --config=check برای بررسی پیکربندی فعلی از نظر وجود خطا.
--config-dir=<directory>: مسیر دایرکتوری پیکربندی (recursor.conf)؛ مقدار پیش‌فرض به گزینه SYSCONFDIR در زمان کامپایل بستگی دارد که معمولاً /etc/powerdns است. مقدار پیش‌فرض را می‌توان با دستور pdns_recursor --config | grep ' config-dir=' مشاهده کرد.
--daemon: اجرا به صورت یک دیمن (daemon) در پس‌زمینه.
--export-etc-hosts: در صورت تنظیم، این پرچم نام‌های میزبان و آدرس‌های IP ذکرشده در /etc/hosts را صادر می‌کند.
--forward-zones=<forwardzones>: که در آن forwardzone به صورت <zonename>=<address> است. پرس‌وجوها برای zonename به address بازفرستاده (forward) خواهند شد. address باید یک آدرس IP باشد، نه یک نام میزبان (برای جلوگیری از چرخه نامعتبر وابستگی). مثال: forward-zones= ds9a.nl=213.244.168.210, powerdns.com=127.0.0.1.
--forward-zones-file=<filename>: مشابه --forward-zones، اما گزینه‌ها را از filename می‌خواند. فایل filename باید در هر خط یک ناحیه داشته باشد، مانند: ds9a.nl=213.244.168.210.
--help: نمایش خلاصه‌ای از گزینه‌ها.
--hint-file=<filename>: بارگذاری root hints (نشانی‌های ریشه) از این filename
--local-address=<address>: گوش دادن روی address، که با فاصله یا کاما جدا می‌شوند. آدرس‌های مشخص‌شده می‌توانند شامل شماره پورت باشند؛ هر آدرسی که شامل شماره پورت نباشد روی پورت تعیین‌شده با --local-port گوش خواهد داد.
--local-port=<port>: گوش دادن روی port مشخص‌شده.
--log-common-errors: آیا خطاهای رایج و عمومی نیز ثبت شوند یا خیر.
--max-cache-entries=<num>: حداکثر تعداد مدخل‌ها در حافظه نهان (cache) اصلی.
--max-negative-ttl=<num>: حداکثر تعداد ثانیه‌ها برای نگهداری یک مدخل کش منفی (negative cache) در حافظه.
--max-tcp-clients=<num>: حداکثر تعداد کلاینت‌های هم‌زمان TCP.
--max-tcp-per-client=<num>: در صورت تعیین، حداکثر تعداد نشست‌های TCP به ازای هر کلاینت (آدرس IP).
--query-local-address=<address[,address...]>: استفاده از address به عنوان آدرس IP مبدأ در زمان ارسال پرس‌وجوها.
--quiet: جلوگیری از ثبت لاگ مربوط به پرسش‌ها و پاسخ‌ها.
--server-id=<text>: بازگرداندن text در هنگام دریافت پرس‌وجو برای رکورد TXT به نشانی 'id.server'؛ پیش‌فرض نام میزبان (hostname) است.
--serve-rfc1918: به طور پیش‌فرض فعال است؛ این گزینه سرور را به صورت موثق نسبت به دامنه‌های زیر آگاه می‌سازد: 10.in-addr.arpa، 168.192.in-addr.arpa و 16-31.172.in-addr.arpa، که باعث کاهش بار روی سرورهای AS112 می‌شود. بخش‌های مجزای این نواحی همچنان می‌توانند بارگذاری یا فوروارد شوند.
--setgid=<gid>: در صورت تعیین، تغییر شناسه گروه به gid برای امنیت بیشتر.
--setuid=<uid>: در صورت تعیین، تغییر شناسه کاربر به uid برای امنیت بیشتر.
--single-socket: در صورت تنظیم، تنها از یک سوکت منفرد برای پرس‌وجوهای خروجی استفاده می‌شود.
--socket-dir=<directory>: سوکت کنترلی (controlsocket) در directory مستقر خواهد شد.
--spoof-nearmiss-max=<num>: در صورت غیرصفر بودن، پس از این تعداد عدم تطابق نزدیک، فرض بر جعل (spoofing) گذاشته می‌شود.
--trace: ثبت حجم بسیار زیادی از گزارش‌ها و لاگ‌ها.
--version-string=<text>: رشته text در پاسخ به پرس‌وجوهای version.pdns یا version.bind گزارش خواهد شد.

همچنین ببینید (SEE ALSO)

rec_control(1) systemctl(1) https://docs.powerdns.com/recursor

نویسندگان (AUTHORS)

PowerDNS.COM BV

کپی‌رایت و تکثیر (COPYRIGHT)

PowerDNS.COM BV