.\" 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 "IXFRDIST.YML" "5" "Aug 05, 2026" "" "PowerDNS Authoritative Server"
.SH "نام (NAME)"
ixfrdist.yml \- فایل پیکربندی ixfrdist
.SH "خلاصه دستور (SYNOPSIS)"
.sp
ixfrdist.yml
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه
\fBixfrdist\fP
پیکربندی خود را از یک فایل YAML می‌خواند.
به‌طور پیش‌فرض، نام این فایل
\fIixfrdist.yml\fP
است و از دایرکتوری‌ای خوانده می‌شود که هنگام ساخت نرم‌افزار به عنوان
\fISYSCONFDIR\fP
پیکربندی شده است.
این دایرکتوری معمولاً یکی از مسیرهای
\fI/etc/pdns\fP
یا
\fI/etc/powerdns\fP\&
است.
برای مشاهده مقدار پیش‌فرض، دستور
\fIixfrdist \-\-help\fP
را اجرا کنید.
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
listen:
  \- 192.0.2.2
  \- \(aq[2001:DB8:ABCD::2]:5300\(aq
  \- 127.0.0.1

acl:
  \- 127.0.0.1
  \- \(aq192.0.2.0/24\(aq
  \- \(aq2001:DB8:ABCD:1234::/64\(aq

work\-dir: /var/lib/ixfrdist

uid: ixfrdist
gid: ixfrdist

domains:
  \- domain: example.com
    master: 192.0.2.18:5301
    max\-soa\-refresh: 1800
    notify:
      \- 192.0.3.1
      \- 192.0.3.2:5301
  \- domain: example.net
    master: 2001:DB8:ABCD::2
.EE
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B listen
فهرست نشانی‌هایی که باید روی آن‌ها گوش فرا داده شود.
\fBixfrdist\fP
روی هر دو پروتکل TCP و UDP گوش می‌دهد.
در صورتی که درگاهی (پورت) مشخص نشود، از 53 استفاده می‌شود. هنگام تعیین پورت برای IPv6، از علامت براکت (\(dq[\(dq و \(dq]\(dq) استفاده کنید.
به‌طور پیش‌فرض،
\fBixfrdist\fP
روی
\fB127.0.0.1:53\fP
و
\fB[::1]:53\fP\&
گوش می‌دهد.
.TP
.B acl
فهرستی از ماسک‌های شبکه (netmasks) که مجاز به ارسال پرس‌وجو به
\fBixfrdist\fP
و درخواست AXFR و IXFR هستند.
ورودی‌های بدون ماسک شبکه به عنوان یک نشانی منفرد در نظر گرفته می‌شوند.
به‌طور پیش‌فرض، فهرست کنترل دسترسی (ACL) بر روی
\fB127.0.0.0/8\fP
و
\fB::1/128\fP\&
تنظیم شده است.
.TP
.B axfr\-max\-records
حداکثر تعداد رکوردهای مجاز در یک تراکنش AXFR که توسط
\fBixfrdist\fP\&
درخواست شده است.
این گزینه می‌تواند از مصرف تمام حافظه فرآیند توسط منابع نامعتبر جلوگیری کند.
به‌طور پیش‌فرض، این مقدار برابر با
\fB0\fP
است که به معنای «نامحدود» (\(dqunlimited\(dq) می‌باشد.
.TP
.B axfr\-timeout
مهلت زمانی (به ثانیه) برای یک تراکنش AXFR درخواستی توسط
\fBixfrdist\fP\&.
در صورتی که ارتباط شبکه با سرورهای معتبر (authoritative) کند باشد یا دامنه‌ها بسیار بزرگ باشند و با اتمام مهلت زمانی مواجه شوید، این مقدار را افزایش دهید.
مقدار پیش‌فرض 20 است.
.TP
.B failed\-soa\-retry
مدت زمان بر حسب ثانیه بین تلاش‌های مجدد برای پرس‌وجوی SOA برای ناحیه‌ای (zone) که هرگز انتقال داده نشده است. مقدار پیش‌فرض 30 است.
.TP
.B compress
مشخص می‌کند که آیا فشرده‌سازی رکوردها فعال باشد یا خیر؛ این کار منجر به پاسخ‌های کوچک‌تر به بهای افزایش مصرف پردازنده و حافظه می‌شود.
مقدار پیش‌فرض false است.
.TP
.B work\-dir
دایرکتوری محل ذخیره داده‌های دامنه.
در صورت عدم تنظیم، از دایرکتوری کاری جاری استفاده می‌شود.
این دایرکتوری کاری ساختار زیر را دارد:
\fBwork\-dir/ZONE/SERIAL\fP،
مانند
\fBwork\-dir/rpz.example./2018011902\fP\&.
تنظیم این گزینه اکیداً توصیه می‌شود، زیرا ممکن است دایرکتوری کاری جاری بین فراخوانی‌ها تغییر کند.
این دایرکتوری باید برای کاربر یا گروهی که
\fBixfrdist\fP
تحت آن اجرا می‌شود، قابل نوشتن باشد.
.TP
.B keep
تعداد رونوشت‌های قدیمی‌تر/تفاوت‌های IXFR (diffs) که برای هر دامنه نگهداری می‌شوند.
این مقدار به‌طور پیش‌فرض روی 20 تنظیم شده است.
.TP
.B tcp\-in\-threads
تعداد ریسه‌هایی (threads) که برای اتصالات TCP (درخواست‌های AXFR) از میزبان‌های پایین‌دستی ایجاد می‌شوند.
این گزینه تعداد AXFRهای هم‌زمان به کلاینت‌ها را محدود می‌کند.
به‌طور پیش‌فرض روی 10 تنظیم شده است.
.TP
.B gid
نام گروه یا شناسه عددی (ID) برای کاهش سطح دسترسی پس از متصل شدن به سوکت‌های شنود.
به‌طور پیش‌فرض،
\fBixfrdist\fP
با همان کاربری که فرآیند را آغاز کرده اجرا می‌شود.
.TP
.B uid
نام کاربر یا شناسه عددی (ID) برای کاهش سطح دسترسی پس از متصل شدن به سوکت‌های شنود.
به‌طور پیش‌فرض،
\fBixfrdist\fP
با همان کاربری که فرآیند را آغاز کرده اجرا می‌شود.
.TP
.B domains
فهرستی از دامنه‌ها برای توزیع مجدد.
این گزینه الزامی است.
.INDENT 7.0
.TP
.B domain
نام دامنه‌ای که باید از
\fBmaster\fP\&
انتقال داده شود.
الزامی.
.TP
.B master
نشانی IP سروری که این دامنه باید از آن منتقل شود.
الزامی.
.TP
.B max\-soa\-refresh
محدود کردن زمان بازآوری (refresh time) به حداکثر مشخص‌شده (به ثانیه).
اختیاری.
.TP
.B notify
فهرست مقصدهایی که پیام NOTIFY باید به آن‌ها ارسال شود.
اختیاری.
.UNINDENT
.TP
.B webserver\-address
نشانی IP برای گوش دادن وب‌سرور داخلی.
در صورت عدم تنظیم، هیچ وب‌سروری راه‌اندازی نمی‌شود.
.TP
.B webserver\-acl
فهرستی از شبکه‌هایی که مجاز به دسترسی به وب‌سرور
\fBixfrdist\fP
هستند.
ورودی‌های بدون ماسک شبکه به عنوان یک نشانی منفرد در نظر گرفته می‌شوند.
به‌طور پیش‌فرض، این فهرست روی
\fB127.0.0.0/8\fP
و
\fB::1/128\fP\&
تنظیم شده است.
.TP
.B webserver\-loglevel
میزان ثبت گزارش (لاگ) وب‌سرور:
\(aqnone\(aq، \(aqnormal\(aq
یا
\(aqdetailed\(aq.
هنگام ثبت وقایع، هر سطر لاگ حاوی UUID درخواست است؛ این امر امکان یافتن خطاهای ناشی از درخواست‌های خاص را فراهم می‌سازد.
با
\(aqnone\(aq،
هیچ رویدادی به جز خطاها ثبت نمی‌شود.
با
\(aqnormal\(aq
(پیش‌فرض)، به ازای هر درخواست یک سطر به سبک قالب لاگ معمول (common log format) ثبت می‌شود:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
[NOTICE] [webserver] 46326eef\-b3ba\-4455\-8e76\-15ec73879aa3 127.0.0.1:57566 \(dqGET /metrics HTTP/1.1\(dq 200 1846
.EE
.UNINDENT
.UNINDENT
.sp
با
\(aqdetailed\(aq،
درخواست‌ها و پاسخ‌های کامل (شامل سرآیندها) به همراه سطر لاگ معمولی از
\(aqnormal\(aq
ثبت می‌شوند.
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBixfrdist(1)\fP
.SH "نویسنده (AUTHOR)"
PowerDNS.COM BV
.SH "حق نشر (COPYRIGHT)"
PowerDNS.COM BV
.\" Generated by docutils manpage writer.
.