نام (NAME)

ixfrdist.yml - فایل پیکربندی ixfrdist

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

ixfrdist.yml

توضیحات (DESCRIPTION)

برنامه ixfrdist پیکربندی خود را از یک فایل YAML می‌خواند. به‌طور پیش‌فرض، نام این فایل ixfrdist.yml است و از دایرکتوری‌ای خوانده می‌شود که هنگام ساخت نرم‌افزار به عنوان SYSCONFDIR پیکربندی شده است. این دایرکتوری معمولاً یکی از مسیرهای /etc/pdns یا /etc/powerdns است. برای مشاهده مقدار پیش‌فرض، دستور ixfrdist --help را اجرا کنید.

مثال‌ها (EXAMPLES)

listen:
  - 192.0.2.2
  - '[2001:DB8:ABCD::2]:5300'
  - 127.0.0.1
acl:
  - 127.0.0.1
  - '192.0.2.0/24'
  - '2001:DB8:ABCD:1234::/64'
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

گزینه‌ها (OPTIONS)

listen: فهرست نشانی‌هایی که باید روی آن‌ها گوش فرا داده شود. ixfrdist روی هر دو پروتکل TCP و UDP گوش می‌دهد. در صورتی که درگاهی (پورت) مشخص نشود، از 53 استفاده می‌شود. هنگام تعیین پورت برای IPv6، از علامت براکت ("[" و "]") استفاده کنید. به‌طور پیش‌فرض، ixfrdist روی 127.0.0.1:53 و [::1]:53 گوش می‌دهد.
acl: فهرستی از ماسک‌های شبکه (netmasks) که مجاز به ارسال پرس‌وجو به ixfrdist و درخواست AXFR و IXFR هستند. ورودی‌های بدون ماسک شبکه به عنوان یک نشانی منفرد در نظر گرفته می‌شوند. به‌طور پیش‌فرض، فهرست کنترل دسترسی (ACL) بر روی 127.0.0.0/8 و ::1/128 تنظیم شده است.
axfr-max-records: حداکثر تعداد رکوردهای مجاز در یک تراکنش AXFR که توسط ixfrdist درخواست شده است. این گزینه می‌تواند از مصرف تمام حافظه فرآیند توسط منابع نامعتبر جلوگیری کند. به‌طور پیش‌فرض، این مقدار برابر با 0 است که به معنای «نامحدود» ("unlimited") می‌باشد.
axfr-timeout: مهلت زمانی (به ثانیه) برای یک تراکنش AXFR درخواستی توسط ixfrdist. در صورتی که ارتباط شبکه با سرورهای معتبر (authoritative) کند باشد یا دامنه‌ها بسیار بزرگ باشند و با اتمام مهلت زمانی مواجه شوید، این مقدار را افزایش دهید. مقدار پیش‌فرض 20 است.
failed-soa-retry: مدت زمان بر حسب ثانیه بین تلاش‌های مجدد برای پرس‌وجوی SOA برای ناحیه‌ای (zone) که هرگز انتقال داده نشده است. مقدار پیش‌فرض 30 است.
compress: مشخص می‌کند که آیا فشرده‌سازی رکوردها فعال باشد یا خیر؛ این کار منجر به پاسخ‌های کوچک‌تر به بهای افزایش مصرف پردازنده و حافظه می‌شود. مقدار پیش‌فرض false است.
work-dir: دایرکتوری محل ذخیره داده‌های دامنه. در صورت عدم تنظیم، از دایرکتوری کاری جاری استفاده می‌شود. این دایرکتوری کاری ساختار زیر را دارد: work-dir/ZONE/SERIAL، مانند work-dir/rpz.example./2018011902. تنظیم این گزینه اکیداً توصیه می‌شود، زیرا ممکن است دایرکتوری کاری جاری بین فراخوانی‌ها تغییر کند. این دایرکتوری باید برای کاربر یا گروهی که ixfrdist تحت آن اجرا می‌شود، قابل نوشتن باشد.
keep: تعداد رونوشت‌های قدیمی‌تر/تفاوت‌های IXFR (diffs) که برای هر دامنه نگهداری می‌شوند. این مقدار به‌طور پیش‌فرض روی 20 تنظیم شده است.
tcp-in-threads: تعداد ریسه‌هایی (threads) که برای اتصالات TCP (درخواست‌های AXFR) از میزبان‌های پایین‌دستی ایجاد می‌شوند. این گزینه تعداد AXFRهای هم‌زمان به کلاینت‌ها را محدود می‌کند. به‌طور پیش‌فرض روی 10 تنظیم شده است.
gid: نام گروه یا شناسه عددی (ID) برای کاهش سطح دسترسی پس از متصل شدن به سوکت‌های شنود. به‌طور پیش‌فرض، ixfrdist با همان کاربری که فرآیند را آغاز کرده اجرا می‌شود.
uid: نام کاربر یا شناسه عددی (ID) برای کاهش سطح دسترسی پس از متصل شدن به سوکت‌های شنود. به‌طور پیش‌فرض، ixfrdist با همان کاربری که فرآیند را آغاز کرده اجرا می‌شود.
domains: فهرستی از دامنه‌ها برای توزیع مجدد. این گزینه الزامی است.

domain: نام دامنه‌ای که باید از master انتقال داده شود. الزامی.
master: نشانی IP سروری که این دامنه باید از آن منتقل شود. الزامی.
max-soa-refresh: محدود کردن زمان بازآوری (refresh time) به حداکثر مشخص‌شده (به ثانیه). اختیاری.
notify: فهرست مقصدهایی که پیام NOTIFY باید به آن‌ها ارسال شود. اختیاری.

webserver-address: نشانی IP برای گوش دادن وب‌سرور داخلی. در صورت عدم تنظیم، هیچ وب‌سروری راه‌اندازی نمی‌شود.
webserver-acl: فهرستی از شبکه‌هایی که مجاز به دسترسی به وب‌سرور ixfrdist هستند. ورودی‌های بدون ماسک شبکه به عنوان یک نشانی منفرد در نظر گرفته می‌شوند. به‌طور پیش‌فرض، این فهرست روی 127.0.0.0/8 و ::1/128 تنظیم شده است.
webserver-loglevel: میزان ثبت گزارش (لاگ) وب‌سرور: 'none'، 'normal' یا 'detailed'. هنگام ثبت وقایع، هر سطر لاگ حاوی UUID درخواست است؛ این امر امکان یافتن خطاهای ناشی از درخواست‌های خاص را فراهم می‌سازد. با 'none'، هیچ رویدادی به جز خطاها ثبت نمی‌شود. با 'normal' (پیش‌فرض)، به ازای هر درخواست یک سطر به سبک قالب لاگ معمول (common log format) ثبت می‌شود:

[NOTICE] [webserver] 46326eef-b3ba-4455-8e76-15ec73879aa3 127.0.0.1:57566 "GET /metrics HTTP/1.1" 200 1846

با 'detailed'، درخواست‌ها و پاسخ‌های کامل (شامل سرآیندها) به همراه سطر لاگ معمولی از 'normal' ثبت می‌شوند.

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

ixfrdist(1)

نویسنده (AUTHOR)

PowerDNS.COM BV

حق نشر (COPYRIGHT)

PowerDNS.COM BV