PDNS_RECURSOR(1)               PowerDNS Recursor              PDNS_RECURSOR(1)

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

                               September 2, 2026              PDNS_RECURSOR(1)