.\" 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 "PDNSUTIL" "1" "Aug 05, 2026" "" "PowerDNS Authoritative Server"
.SH "نام (NAME)"
pdnsutil \- مدیریت و کنترل رکوردها و DNSSEC در PowerDNS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBpdnsutil\fP [OPTION]... \fICOMMAND\fP
.SH "توضیحات (DESCRIPTION)"
.sp
\fBpdnsutil\fP (با نام پیشین \fBpdnssec\fP) دستوری قدرتمند و درگاهی کاربرپسند برای مدیران سیستم جهت مدیریت زون‌ها (zone) و DNSSEC در PowerDNS است.
در پشت صحنه، \fBpdnsutil\fP پایگاه‌داده‌ی backend مربوط به PowerDNS را دستکاری می‌کند؛ بدین معنی که برای بسیاری از پایگاه‌های داده، \fBpdnsutil\fP می‌تواند از راه دور اجرا شده و داده‌های کلید را روی سرورهای مختلف پیکربندی کند.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B  \-h\fP,\fB  \-\-help
نمایش خلاصه‌ای از گزینه‌ها
.TP
.B  \-v\fP,\fB  \-\-verbose
نمایش جزئیات بیشتر
.TP
.B  \-f\fP,\fB  \-\-force
اجبار در انجام یک عملیات
.TP
.B  \-q\fP,\fB  \-\-quiet
حالت بی‌صدا
.TP
.B  \-s\fP,\fB  \-\-sort
مرتب‌سازی خروجی در صورت امکان
.TP
.BI \-\-config\-name \ <NAME>
نام پیکربندی مجازی
.TP
.BI \-\-config\-dir \ <DIR>
محل pdns.conf. پیش‌فرض /etc/powerdns است.
.UNINDENT
.SH "دستورها (COMMANDS)"
.sp
دستورهای متعددی در دسترس هستند. بیشتر دستورها از الگوی
\fBpdnsutil <object> <action> [arguments...]\fP پیروی می‌کنند، که در آن \fB<object>\fP یک اسم و \fB<action>\fP یک فعل است؛ تعداد کمی از دستورها که به شیء خاصی اعمال نمی‌شوند، تنها از فعل استفاده می‌کنند.
.SH "دستورهای AUTOPRIMARY (AUTOPRIMARY COMMANDS)"
.sp
autoprimary add \fIIP\fP \fINAMESERVER\fP [\fIACCOUNT\fP]
.INDENT 0.0
.INDENT 3.5
افزودن یک مدخل autoprimary به backend. این کار دریافت به‌روزرسانی‌های زون از سرورهای دیگر را فعال می‌کند.
.UNINDENT
.UNINDENT
.sp
autoprimary list
.INDENT 0.0
.INDENT 3.5
فهرست کردن تمام autoprimaryها.
.UNINDENT
.UNINDENT
.sp
autoprimary remove \fIIP\fP \fINAMESERVER\fP
.INDENT 0.0
.INDENT 3.5
حذف یک autoprimary از backend. در backend مربوط به BIND پشتیبانی نمی‌شود.
.UNINDENT
.UNINDENT.SH "دستورات ناحیه کاتالوگ (CATALOG ZONE COMMANDS)"
.sp
catalog list\-members \fICATALOG\fP
.INDENT 0.0
.INDENT 3.5
فهرست کردن تمام اعضای ناحیه کاتالوگ \fICATALOG\fP\&.
.UNINDENT
.UNINDENT
.sp
catalog set \fIZONE\fP [\fICATALOG\fP]
.INDENT 0.0
.INDENT 3.5
تغییر کاتالوگ \fIZONE\fP به \fICATALOG\fP\&. اگر \fICATALOG\fP مشخص نشود،
\fIZONE\fP را از کاتالوگی که در آن قرار دارد حذف می‌کند.
.UNINDENT
.UNINDENT
.SH "دستورات متاداده ناحیه (ZONE METADATA COMMANDS)"
.sp
metadata add \fIZONE\fP \fIKIND\fP \fIVALUE\fP [\fIVALUE\fP]...
.INDENT 0.0
.INDENT 3.5
الحاق مقدار \fIVALUE\fP به متاداده‌های موجود از نوع \fIKIND\fP برای \fIZONE\fP\&.
اگر \fIKIND\fP از مقادیر چندگانه پشتیبانی نکند، خطایی بازگردانده می‌شود؛ برای
این مقادیر از \fBmetadata set\fP استفاده کنید.
.UNINDENT
.UNINDENT
.sp
metadata get \fIZONE\fP [\fIKIND\fP]...
.INDENT 0.0
.INDENT 3.5
دریافت متاداده ناحیه. اگر نوع \fIKIND\fP داده نشود، همه موارد شناخته‌شده را فهرست می‌کند.
.UNINDENT
.UNINDENT
.sp
metadata set \fIZONE\fP \fIKIND\fP [\fIVALUE\fP]...
.INDENT 0.0
.INDENT 3.5
تنظیم متاداده ناحیه \fIKIND\fP برای \fIZONE\fP به \fIVALUE\fP، که جایگزین تمام مقادیر
موجود \fIKIND\fP می‌شود. مشخص نکردن مقدار، آن را پاک می‌کند.
.UNINDENT
.UNINDENT
.SH "دستورات شبکه (NETWORK COMMANDS)"
.sp
network list
.INDENT 0.0
.INDENT 3.5
فهرست کردن تمام شبکه‌های تعریف‌شده به همراه نماهای (views) منتخب آن‌ها.
.UNINDENT
.UNINDENT
.sp
network set \fINET\fP [\fIVIEW\fP]
.INDENT 0.0
.INDENT 3.5
تنظیم \fIVIEW\fP برای شبکه \fINET\fP، یا در صورت نبود آرگومان \fIVIEW\fP، حذف آن.
.UNINDENT
.UNINDENT
.SH "دستورات رکوردهای ناحیه (ZONE RECORD COMMANDS)"
.sp
در این دستورات، نام شیء \fBrrset\fP را می‌توان به صورت \fBrecord\fP نیز نوشت.
.sp
rrset add \fIZONE\fP \fINAME\fP \fITYPE\fP [\fITTL\fP] \fICONTENT\fP
.INDENT 0.0
.INDENT 3.5
افزودن یک یا چند رکورد با نام \fINAME\fP و نوع \fITYPE\fP به ناحیه \fIZONE\fP با محتوای \fICONTENT\fP
و مقدار اختیاری \fITTL\fP\&. اگر \fITTL\fP تنظیم نشود، مقدار پیکربندی‌شده‌ی \fIdefault\-ttl\fP استفاده خواهد شد.
\fINAME\fP باید مطلق (absolute) باشد.
.UNINDENT
.UNINDENT
.sp
rrset delete \fIZONE\fP \fINAME\fP \fITYPE\fP
.INDENT 0.0
.INDENT 3.5
حذف RRSET مشخص‌شده از ناحیه.
\fINAME\fP باید مطلق باشد.
.UNINDENT
.UNINDENT
.sp
rrset hash \fIZONE\fP \fIRNAME\fP
.INDENT 0.0
.INDENT 3.5
این دستور کمکی نام \fIRNAME\fP را مطابق با تنظیمات NSEC3 ناحیه \fIZONE\fP هش می‌کند.
از هش کردن برای ناحیه‌های فاقد تنظیمات NSEC3 خودداری می‌کند.
.UNINDENT
.UNINDENT
.sp
rrset replace \fIZONE\fP \fINAME\fP \fITYPE\fP [\fITTL\fP] \fICONTENT\fP [\fICONTENT\fP\&...]
.INDENT 0.0
.INDENT 3.5
جایگزینی \fINAME\fP موجود در ناحیه \fIZONE\fP با یک مجموعه جدید.
.UNINDENT
.UNINDENT.SH "دستورهای مرتبط با TSIG (TSIG RELATED COMMANDS)"
.sp
این دستورها اطلاعات کلید TSIG را در پایگاه داده دستکاری می‌کنند. برخی از
دستورها به یک \fIALGORITHM\fP نیاز دارند که می‌تواند یکی از موارد زیر باشد:
.INDENT 0.0
.IP \(bu 2
hmac\-md5
.IP \(bu 2
hmac\-sha1
.IP \(bu 2
hmac\-sha224
.IP \(bu 2
hmac\-sha256
.IP \(bu 2
hmac\-sha384
.IP \(bu 2
hmac\-sha512
.UNINDENT
.sp
tsigkey activate \fIZONE\fP \fINAME\fP {\fBprimary\fP,\fBsecondary\fP,\fBproducer\fP,\fBconsumer\fP}
.INDENT 0.0
.INDENT 3.5
فعال‌سازی AXFR احرازهویت‌شده با TSIG با استفاده از کلید \fINAME\fP برای ناحیهٔ \fIZONE\fP\&.
این دستور متاداده‌های ناحیهٔ \fBTSIG\-ALLOW\-AXFR\fP (برای primary/producer) یا \fBAXFR\-MASTER\-TSIG\fP
(برای secondary/consumer) را تنظیم می‌کند.
.UNINDENT
.UNINDENT
.sp
tsigkey deactivate \fIZONE\fP \fINAME\fP {\fBprimary\fP,\fBsecondary\fP,\fBproducer\fP,\fBconsumer\fP}
.INDENT 0.0
.INDENT 3.5
غیرفعال‌سازی AXFR احرازهویت‌شده با TSIG با استفاده از کلید \fINAME\fP برای ناحیهٔ
\fIZONE\fP\&.
.UNINDENT
.UNINDENT
.sp
tsigkey delete \fINAME\fP
.INDENT 0.0
.INDENT 3.5
حذف کلید TSIG با نام \fINAME\fP\&. هشدار: این کار کلید مذکور را غیرفعال نمی‌کند.
.UNINDENT
.UNINDENT
.sp
tsigkey generate \fINAME\fP \fIALGORITHM\fP
.INDENT 0.0
.INDENT 3.5
تولید کلید TSIG جدید با نام \fINAME\fP و الگوریتم مشخص‌شده.
.UNINDENT
.UNINDENT
.sp
tsigkey import \fINAME\fP \fIALGORITHM\fP \fIKEY\fP
.INDENT 0.0
.INDENT 3.5
وارد کردن \fIKEY\fP با الگوریتم مشخص‌شده به‌عنوان \fINAME\fP\&.
.UNINDENT
.UNINDENT
.sp
tsigkey list
.INDENT 0.0
.INDENT 3.5
نمایش فهرستی از تمامی کلیدهای TSIG پیکربندی‌شده.
.UNINDENT
.UNINDENT
.SH "دستورهای نماها (VIEWS COMMANDS)"
.sp
views add\-zone \fIVIEW\fP \fIZONE..VARIANT\fP
.INDENT 0.0
.INDENT 3.5
افزودن \fIZONE\fP \fIVARIANT\fP داده‌شده به یک \fIVIEW\fP\&.
.UNINDENT
.UNINDENT
.sp
views del\-zone \fIVIEW\fP \fIZONE..VARIANT\fP
.INDENT 0.0
.INDENT 3.5
حذف یک \fIZONE\fP \fIVARIANT\fP از یک \fIVIEW\fP\&.
.UNINDENT
.UNINDENT
.sp
views list \fIVIEW\fP
.INDENT 0.0
.INDENT 3.5
فهرست کردن تمام ناحیه‌های درون \fIVIEW\fP\&.
.UNINDENT
.UNINDENT
.sp
views list\-all
.INDENT 0.0
.INDENT 3.5
فهرست کردن نام تمام نماها (views).
.UNINDENT
.UNINDENT.SH "دستورهای دستکاری ناحیه (ZONE MANIPULATION COMMANDS)"
.sp
zone check \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
بررسی درستی ناحیهٔ \fIZONE\fP\&.
.UNINDENT
.UNINDENT
.sp
zone check\-all [exit\-on\-error]
.INDENT 0.0
.INDENT 3.5
بررسی درستی تمام ناحیه‌ها؛ در صورت مشخص شدن \(dqexit\-on\-error\(dq، با یافتن نخستین خطا در هر ناحیه‌ای متوقف می‌شود.
.UNINDENT
.UNINDENT
.sp
zone clear \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
پاک کردن رکوردهای موجود در ناحیهٔ \fIZONE\fP، بدون تغییر خود ناحیه و تنظیمات آن.
.UNINDENT
.UNINDENT
.sp
zone copy \fIZONE\fP \fINEW\-ZONE\fP
.INDENT 0.0
.INDENT 3.5
رونوشت محتویات \fIZONE\fP (رکوردها، یادداشت‌ها، متادیتا و کلیدها) به ناحیهٔ جدید \fINEW\-ZONE\fP\&. ناحیهٔ جدید نباید از قبل وجود داشته باشد و در قالب عملیات رونوشت، در همان backend مربوط به \fIZONE\fP ایجاد می‌شود\&.
.UNINDENT
.UNINDENT
.sp
zone create \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
ایجاد یک ناحیهٔ خالی با نام \fIZONE\fP\&.
.UNINDENT
.UNINDENT
.sp
zone delete \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
حذف ناحیه با نام \fIZONE\fP\&.
.UNINDENT
.UNINDENT
.sp
zone edit \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
باز کردن \fIZONE\fP در قالب zonefile (صرف‌نظر از backendی که از آن بارگذاری شده است) در ویرایشگر تعیین‌شده در متغیر محیطی \fBEDITOR\fP\&. در صورتی که \fBEDITOR\fP خالی باشد، \fIpdnsutil\fP به استفاده از \fIeditor\fP بازمی‌گردد\&.
.UNINDENT
.UNINDENT
.sp
zone increase\-serial \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
افزایش مقدار SOA\-serial به اندازهٔ ۱ واحد. از SOA\-EDIT استفاده می‌کند.
.UNINDENT
.UNINDENT
.sp
zone list \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
نمایش تمام رکوردهای \fIZONE\fP\&. ارسال \-\-sort یا \-s رکوردها را بر اساس نامشان مرتب می‌کند، اما ممکن است در ناحیه‌های عظیم به حافظه و زمان پردازش زیادی نیاز داشته باشد.
.UNINDENT
.UNINDENT
.sp
zone list\-all \fIKIND\fP
.INDENT 0.0
.INDENT 3.5
فهرست کردن نام همهٔ ناحیه‌های فعال از نوع (\fIKIND\fP) داده‌شده (primary،‏ secondary،‏ native،‏ producer،‏ consumer) یا همهٔ آن‌ها در صورت مشخص نشدن نوع. ارسال \-\-verbose یا \-v ناحیه‌های غیرفعال یا خالی را نیز در بر می‌گیرد.
.UNINDENT
.UNINDENT
.sp
zone load \fIZONE\fP \fIFILE\fP
.INDENT 0.0
.INDENT 3.5
بارگذاری رکوردهای \fIZONE\fP از \fIFILE\fP\&. اگر \fIZONE\fP از قبل وجود داشته باشد، تمام رکوردها بازنویسی می‌شوند؛ این عملیات اتمیک (atomic) است. اگر \fIZONE\fP وجود نداشته باشد، ایجاد می‌شود.
.UNINDENT
.UNINDENT
.sp
zone set\-account \fIZONE\fP \fIACCOUNT\fP
.INDENT 0.0
.INDENT 3.5
تغییر حساب (مالک) \fIZONE\fP به \fIACCOUNT\fP\&.
.UNINDENT
.UNINDENT
.sp
zone set\-kind \fIZONE\fP \fIKIND\fP
.INDENT 0.0
.INDENT 3.5
تغییر نوعِ ناحیهٔ \fIZONE\fP به \fIKIND\fP (شامل primary،‏ secondary،‏ native،‏ producer یا consumer).
.UNINDENT
.UNINDENT
.sp
zone set\-option \fIZONE\fP [\fIproducer\fP | \fIconsumer\fP] [\fIcoo\fP | \fIunique\fP | \fIgroup\fP] \fIVALUE\fP [\fIVALUE\fP ...]
.INDENT 0.0
.INDENT 3.5
تنظیم یا حذف یک گزینه برای \fIZONE\fP\&. ارائهٔ یک مقدار خالی، گزینه را حذف می‌کند.
.UNINDENT
.UNINDENT
.sp
zone set\-options\-json \fIZONE\fP \fIJSONFILE\fP
.INDENT 0.0
.INDENT 3.5
تغییر گزینه‌های \fIZONE\fP به محتوای \fIJSONFILE\fP\&.
.UNINDENT
.UNINDENT
.sp
zone zonemd\-verify\-file \fIZONE\fP \fIFILE\fP
.INDENT 0.0
.INDENT 3.5
اعتبارسنجی ZONEMD برای \fIZONE\fP خوانده‌شده از \fIFILE\fP\&.
.UNINDENT
.UNINDENT.SH "دستورهای ناحیه ثانویه (SECONDARY ZONE COMMANDS)"
.sp
zone change\-primary \fIZONE\fP \fIPRIMARY\fP [\fIPRIMARY\fP]...
.INDENT 0.0
.INDENT 3.5
تغییر کارسازهای اصلی برای ناحیهٔ ثانویهٔ \fIZONE\fP به کارسازهای اصلی جدید \fIPRIMARY\fP\&. همهٔ
\fIPRIMARY\fPها باید آدرس‌های IP جداشده با فاصله به همراه پورت اختیاری باشند.
.UNINDENT
.UNINDENT
.sp
zone create\-secondary \fIZONE\fP \fIPRIMARY\fP [\fIPRIMARY\fP]...
.INDENT 0.0
.INDENT 3.5
ایجاد یک ناحیهٔ ثانویهٔ جدید \fIZONE\fP با کارسازهای اصلی \fIPRIMARY\fP\&. همهٔ \fIPRIMARY\fPها
باید آدرس‌های IP جداشده با فاصله به همراه پورت اختیاری باشند.
.UNINDENT
.UNINDENT
.SH "دستورهای مرتبط با DNSSEC (DNSSEC-RELATED COMMANDS)"
.sp
چندین دستور کلیدها و گزینه‌های DNSSEC را برای نواحی دستکاری می‌کنند. برخی
از این دستورها نیازمند تنظیم یک \fIALGORITHM\fP هستند. الگوریتم‌های زیر
پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
rsasha1
.IP \(bu 2
rsasha1\-nsec3\-sha1
.IP \(bu 2
rsasha256
.IP \(bu 2
rsasha512
.IP \(bu 2
ecdsa256
.IP \(bu 2
ecdsa384
.IP \(bu 2
ed25519
.IP \(bu 2
ed448
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.IP "نکته"
.sp
الگوریتم‌های ed25519 و ed448 تنها در صورتی در دسترس خواهند بود که کتابخانه‌های رمزنگاری
کافی هنگام کامپایل PowerDNS روی سیستم خاص شما موجود بوده باشند.
.UNINDENT
.UNINDENT
.sp
علاوه بر الگوریتم، برخی از دستورهای زیر ممکن است اندازهٔ کلید را بر حسب بیت درخواست کنند.
اندازهٔ کلید را می‌توان برای الگوریتم‌های ECC نادیده گرفت، زیرا آنها تنها از یک اندازهٔ معتبر به ازای
هر الگوریتم پشتیبانی می‌کنند؛ برای ECDSA256 و ED25519 این مقدار 256 است؛
برای ECDSA384 برابر با 384؛ و برای ED448 برابر با... 456 است.
.sp
zone dnssec\-disable \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
غیرفعال کردن تمام کلیدها و لغو وضعیت PRESIGNED در \fIZONE\fP\&.
.UNINDENT
.UNINDENT
.sp
zone export\-dnskey \fIZONE\fP \fIKEY_ID\fP
.INDENT 0.0
.INDENT 3.5
برون‌بری DNSKEY و DS مربوط به کلید با شناسهٔ کلید \fIKEY_ID\fP در ناحیهٔ \fIZONE\fP در
خروجی استاندارد.
.UNINDENT
.UNINDENT
.sp
zone export\-ds \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
برون‌بری تمام رکوردهای KSK DS برای \fIZONE\fP در خروجی استاندارد.
.UNINDENT
.UNINDENT
.sp
zone list\-keys [\fIZONE\fP]
.INDENT 0.0
.INDENT 3.5
فهرست کردن اطلاعات DNSSEC برای تمام کلیدها یا تنها برای \fIZONE\fP\&. ارسال
\-\-verbose یا \-v همچنین کلیدهای مربوط به نواحی غیرفعال یا خالی را شامل می‌شود.
.UNINDENT
.UNINDENT
.sp
zone rectify \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
فیلدهای \(aqordername\(aq و \(aqauth\(aq را برای ناحیه‌ای به نام
\fIZONE\fP محاسبه می‌کند تا با تنظیمات DNSSEC مطابقت داشته باشند. می‌تواند برای تصحیح
داده‌های مهاجرت‌یافته استفاده شود.
.UNINDENT
.UNINDENT
.sp
zone rectify\-all
.INDENT 0.0
.INDENT 3.5
فیلدهای \(aqordername\(aq و \(aqauth\(aq را برای تمام نواحی محاسبه می‌کند تا با
تنظیمات DNSSEC مطابقت داشته باشند. می‌تواند برای تصحیح داده‌های مهاجرت‌یافته استفاده شود.
.UNINDENT
.UNINDENT
.sp
zone secure \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
ناحیه‌ای به نام \fIZONE\fP را با تنظیمات معقول DNSSEC پیکربندی می‌کند. پس از آن
باید \(aqpdnsutil zone rectify\(aq را به صورت دستی اجرا کنید.
.UNINDENT
.UNINDENT
.sp
zone secure\-all [\fBincrease\-serial\fP]
.INDENT 0.0
.INDENT 3.5
تمام نواحی که در حال حاضر امضا نشده‌اند را با تنظیمات معقول
DNSSEC پیکربندی می‌کند. تنظیم \fBincrease\-serial\fP شماره سریال
آن نواحی را نیز افزایش می‌دهد. پس از آن باید \(aqpdnsutil
zone rectify\-all\(aq را به صورت دستی اجرا کنید.
.UNINDENT
.UNINDENT
.sp
zone set\-nsec3 \fIZONE\fP [\(aq\fIHASH\-ALGORITHM\fP \fIFLAGS\fP \fIITERATIONS\fP \fISALT\fP\(aq] [\fBnarrow\fP]
.INDENT 0.0
.INDENT 3.5
پارامترهای NSEC3 را برای این ناحیه تنظیم می‌کند. پارامترهای داخل نقل‌قول ۴
مقداری هستند که برای رکورد NSEC3PARAM استفاده می‌شوند و تعیین می‌کنند رکوردهای
NSEC3 چگونه ایجاد شوند. پارامترهای NSEC3 در خط فرمان باید داخل نقل‌قول باشند.
\fIHASH\-ALGORITHM\fP باید 1 (SHA\-1) باشد. تنظیم \fIFLAGS\fP روی 1، عملکرد
NSEC3 opt\-out را فعال می‌کند. این کار را فقط در صورتی انجام دهید که می‌دانید به آن نیاز دارید.
برای \fIITERATIONS\fP، لطفاً به
\X'tty: link https://datatracker.ietf.org/doc/html/rfc5155.html#section-10.3'\fI\%RFC 5155\fP\X'tty: link'\& مراجعه کنید.
.sp
همچنین آگاه باشید که یک مقدار بزرگ ممکن است بار زیادی به resolverهای اعتبارسنج
تحمیل کند و می‌توان با \fBmax\-nsec3\-iterations\fP در \fBpdns.conf\fP\& برای آن
حد تعیین کرد. مقدار \fISALT\fP یک رشتهٔ هگزادسیمال شامل بیت‌های کدگذاری‌شده
برای salt است، یا \- برای استفاده نکردن از salt.
.sp
تنظیم \fBnarrow\fP باعث می‌شود PowerDNS برای جلوگیری از شمارش ناحیه (zone enumeration)، «دروغ‌های مصلحتی» (\X'tty: link https://datatracker.ietf.org/doc/html/rfc7129.html'\fI\%RFC 7129\fP\X'tty: link')
دربارهٔ رکورد امن بعدی ارسال کند. به جای جستجوی آن در پایگاه داده، مقدار hash + 1 را به عنوان رکورد
امن بعدی ارسال می‌کند. حالت narrow نیازمند قابلیت‌های امضای برخط (online signing) توسط
nameserver است و بنابراین انتقال‌های ناحیه (zone transfers) رد می‌شوند.
.sp
اگر فقط ناحیه به عنوان آرگومان داده شود، رشتهٔ دارای ۴ پارامتر داخل نقل‌قول به صورت پیش‌فرض
برابر با \fB\(aq1 0 0 \-\(aq\fP خواهد بود، همان‌گونه که توسط \X'tty: link https://datatracker.ietf.org/doc/html/rfc9276.html'\fI\%RFC 9276\fP\X'tty: link'\& توصیه شده است.
.sp
یک نمونه خط فرمان عبارت است از:
.sp
\fBpdnsutil zone set\-nsec3 powerdnssec.org \(aq1 1 1 ab\(aq narrow\fP
.sp
\fBهشدار\fP: در صورت اجرا در حالت RSASHA1 (الگوریتم 5 یا 7)، تغییر
از NSEC به NSEC3 نیازمند به‌روزرسانی DS در ناحیهٔ والد (parent zone) خواهد بود.
.UNINDENT
.UNINDENT
.sp
zone set\-presigned \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
ناحیهٔ \fIZONE\fP را به حالت عملیاتی از پیش امضاشده تغییر می‌دهد و از RRSIGهای درون ناحیه استفاده می‌کند.
.UNINDENT
.UNINDENT
.sp
zone set\-publish\-cdnskey \fIZONE\fP [\fBdelete\fP]
.INDENT 0.0
.INDENT 3.5
تنظیم \fIZONE\fP برای انتشار رکوردهای CDNSKEY\&. مقدار \(aqdelete\(aq را برای انتشار یک CDNSKEY
با یک الگوریتم حذف DNSSEC اضافه کنید.
.UNINDENT
.UNINDENT
.sp
zone set\-publish\-cds \fIZONE\fP [\fIDIGESTALGOS\fP]
.INDENT 0.0
.INDENT 3.5
تنظیم \fIZONE\fP برای پاسخ‌دهی به پرس‌وجوهای رکوردهای CDS خود. آرگومان
اختیاری \fIDIGESTALGOS\fP باید یک فهرست جداشده با کاما از الگوریتم‌های DS
مورد استفاده باشد. به صورت پیش‌فرض، این مقدار 2 (SHA\-256) است. مقدار 0 یک
CDS با الگوریتم حذف DNSSEC منتشر می‌کند.
.UNINDENT
.UNINDENT
.sp
zone show \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
جزئیات گوناگون ناحیه‌ای با نام \fIZONE\fP، از جمله تنظیمات مرتبط با
DNSSEC آن را نمایش می‌دهد.
.UNINDENT
.UNINDENT.sp
zone unset\-nsec3 \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
ناحیهٔ \fIZONE\fP را به عملیات NSEC تبدیل می‌کند. \fBهشدار\fP: در صورت اجرا در حالت RSASHA1 (الگوریتم ۵ یا ۷)، تغییر از NSEC به NSEC3 نیازمند به‌روزرسانی DS در ناحیهٔ والد (parent zone) خواهد بود!
.UNINDENT
.UNINDENT
.sp
zone unset\-presigned \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
عملیات پیش‌امضاشده (presigned) را برای \fIZONE\fP\& غیرفعال می‌کند.
.UNINDENT
.UNINDENT
.sp
zone unset\-publish\-cdnskey \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
ناحیهٔ \fIZONE\fP را طوری تنظیم می‌کند که انتشار رکوردهای CDNSKEY را متوقف کند.
.UNINDENT
.UNINDENT
.sp
zone unset\-publish\-cds \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
ناحیهٔ \fIZONE\fP را طوری تنظیم می‌کند که پاسخ‌دهی به پرس‌وجوهای رکوردهای CDS خود را متوقف کند.
.UNINDENT
.UNINDENT
.SH "دستورهای کلید ناحیه (ZONE KEY COMMANDS)"
.sp
zone activate\-key \fIZONE\fP \fIKEY_ID\fP
.INDENT 0.0
.INDENT 3.5
فعال‌سازی یک کلید با شناسهٔ \fIKEY_ID\fP در ناحیه‌ای به نام \fIZONE\fP\&.
.UNINDENT
.UNINDENT
.sp
zone add\-key \fIZONE\fP [\fBKSK\fP,\fBZSK\fP] [\fBactive\fP,\fBinactive\fP] [\fBpublished\fP,\fBunpublished\fP] \fIALGORITHM\fP [\fIKEYBITS\fP]
.INDENT 0.0
.INDENT 3.5
ایجاد یک کلید جدید برای ناحیهٔ \fIZONE\fP و تنظیم آن به‌عنوان KSK (پیش‌فرض) یا ZSK، با \fIALGORITHM\fP و \fIKEYBITS\fP مشخص‌شده. اگر \fIKEYBITS\fP مشخص نشود، از مقدار \fI\%default\-ksk\-size\fP یا \fI\%default\-zsk\-size\fP استفاده می‌شود.
.sp
کلید به‌طور پیش‌فرض غیرفعال است؛ آن را روی \fBactive\fP تنظیم کنید تا بلافاصله برای امضای \fIZONE\fP\& استفاده شود. کلید به‌طور پیش‌فرض در ناحیه منتشر می‌شود؛ آن را روی \fBunpublished\fP تنظیم کنید تا از بازگردانده شدن آن در پاسخ پرس‌وجوی DNSKEY جلوگیری شود، که برای جابه‌جایی الگوریتم (algorithm rollover) مفید است.
.sp
شناسهٔ کلید اضافه‌شده را چاپ می‌کند.
.UNINDENT
.UNINDENT
.sp
zone deactivate\-key \fIZONE\fP \fIKEY_ID\fP
.INDENT 0.0
.INDENT 3.5
غیرفعال‌سازی کلیدی با شناسهٔ KEY_ID در ناحیه‌ای به نام \fIZONE\fP\&.
.UNINDENT
.UNINDENT
.sp
zone export\-key \fIZONE\fP \fIKEY_ID\fP
.INDENT 0.0
.INDENT 3.5
برون‌بری کلید کامل (خصوصی) با شناسهٔ کلید \fIKEY_ID\fP در ناحیهٔ \fIZONE\fP به خروجی استاندارد. قالب استفاده‌شده با BIND و NSD/LDNS سازگار است.
.UNINDENT
.UNINDENT
.sp
zone export\-key\-pem \fIZONE\fP \fIKEY_ID\fP
.INDENT 0.0
.INDENT 3.5
برون‌بری کلید کامل (خصوصی) با شناسهٔ کلید \fIKEY_ID\fP در ناحیهٔ \fIZONE\fP به خروجی استاندارد در قالب فایل PEM. این قالب با بسیاری از محصولات نرم‌افزاری غیر\-DNS سازگار است.
.UNINDENT
.UNINDENT
.sp
zone generate\-key {\fBKSK\fP,\fBZSK\fP} [\fIALGORITHM\fP] [\fIKEYBITS\fP]
.INDENT 0.0
.INDENT 3.5
تولید یک ZSK یا KSK با الگوریتم و بیت‌های مشخص‌شده و چاپ آن در خروجی استاندارد. اگر \fIALGORITHM\fP تعیین نشده باشد، ECDSA256 استفاده می‌شود. اگر \fIKEYBITS\fP مشخص نشده باشد، اندازهٔ کلید مناسبی برای \fIALGORITHM\fP انتخاب می‌شود: برای کلیدهای RSA، مقدار ۲۰۴۸ بیت برای KSK و ۱۰۲۴ بیت برای ZSK؛ برای کلیدهای ECC، اندازهٔ مورد نیاز الگوریتم به‌طوری که در بالا ذکر شد.
.UNINDENT
.UNINDENT
.sp
zone import\-key \fIZONE\fP \fIFILE\fP [\fBKSK\fP,\fBZSK\fP] [\fBactive\fP,\fBinactive\fP] [\fBpublished\fP,\fBunpublished\fP]
.INDENT 0.0
.INDENT 3.5
درون‌ریزی کلید کامل (خصوصی) از \fIFILE\fP برای ناحیهٔ \fIZONE\fP\&. قالب استفاده‌شده با BIND و NSD/LDNS سازگار است. \fBKSK\fP یا \fBZSK\fP پرچم‌هایی را که این کلید باید هنگام درون‌ریزی داشته باشد مشخص می‌کند. به‌طور پیش‌فرض KSK، فعال (active) و منتشرشده (published) است. شناسهٔ کلید اضافه‌شده را چاپ می‌کند.
.UNINDENT
.UNINDENT
.sp
zone import\-key\-pem \fIZONE\fP \fIFILE\fP \fIALGORITHM\fP {\fBKSK\fP,\fBZSK\fP}
.INDENT 0.0
.INDENT 3.5
درون‌ریزی کلید کامل (خصوصی) از \fIFILE\fP با قالب PEM برای ناحیهٔ \fIZONE\fP با \fIALGORITHM\fP مشخص‌شده. قالب استفاده‌شده با بسیاری از محصولات نرم‌افزاری غیر\-DNS سازگار است. \fBKSK\fP یا \fBZSK\fP پرچم‌هایی را که این کلید باید هنگام درون‌ریزی داشته باشد مشخص می‌کند. شناسهٔ کلید اضافه‌شده را چاپ می‌کند.
.UNINDENT
.UNINDENT
.sp
zone publish\-key \fIZONE\fP \fIKEY_ID\fP
.INDENT 0.0
.INDENT 3.5
انتشار کلید با شناسهٔ \fIKEY_ID\fP در ناحیهٔ \fIZONE\fP\&.
.UNINDENT
.UNINDENT
.sp
zone remove\-key \fIZONE\fP \fIKEY_ID\fP
.INDENT 0.0
.INDENT 3.5
حذف کلیدی با شناسهٔ \fIKEY_ID\fP از ناحیهٔ \fIZONE\fP\&.
.UNINDENT
.UNINDENT
.sp
zone unpublish\-key \fIZONE\fP \fIKEY_ID\fP
.INDENT 0.0
.INDENT 3.5
لغو انتشار کلید با شناسهٔ \fIKEY_ID\fP در ناحیهٔ \fIZONE\fP\&.
.UNINDENT
.UNINDENT.SH "دستورهای دیگر/متفرقه (OTHER/MISCELLANEOUS COMMANDS)"
.sp
b2b\-migrate \fIOLD\fP \fINEW\fP
.INDENT 0.0
.INDENT 3.5
مهاجرت داده‌ها از یک backend به دیگری.
نیازمند \fBlaunch=OLD,NEW\fP در پیکربندی است.
.UNINDENT
.UNINDENT
.sp
backend\-cmd \fIBACKEND\fP \fICMD\fP [\fICMD...\fP]
.INDENT 0.0
.INDENT 3.5
ارسال یک دستور متنی به یک backend برای اجرا. backendهای GSQL
دستورهای SQL را می‌پذیرند، backendهای دیگر ممکن است موارد دیگری را بپذیرند.
مراقب باشید!
.UNINDENT
.UNINDENT
.sp
backend\-lookup \fIBACKEND\fP \fINAME\fP [\fITYPE\fP [\fICLIENT_IP_SUBNET\fP]]
.INDENT 0.0
.INDENT 3.5
انجام جستجوی رکورد در backend.
.UNINDENT
.UNINDENT
.sp
bench\-db [\fIFILE\fP]
.INDENT 0.0
.INDENT 3.5
انجام ارزیابی کارایی (benchmark) برای پایگاه‌دادهٔ backend.
\fIFILE\fP می‌تواند فایلی شامل فهرستی از نام‌های zone در هر سطر باشد که برای این کار استفاده می‌شود.
اگر \fIFILE\fP مشخص نشود، از powerdns.com استفاده خواهد شد.
.UNINDENT
.UNINDENT
.sp
create\-bind\-db \fIFILENAME\fP
.INDENT 0.0
.INDENT 3.5
ایجاد پایگاه‌دادهٔ DNSSEC (از نوع sqlite3) در \fIFILENAME\fP برای backend مربوط به BIND.
به‌خاطر داشته باشید که \fBbind\-dnssec\-db=*FILE*\fP را در \fBpdns.conf\fP خود تنظیم کنید\&.
.UNINDENT
.UNINDENT
.sp
hash\-password [\fIWORK_FACTOR\fP]
.INDENT 0.0
.INDENT 3.5
این دستور کاربردی یک گذرواژه را (بدون نمایش نویسه‌ها) از ورودی استاندارد
می‌خواند و نسخه‌ای درهم‌سازی‌شده (hashed) و نمک‌زده (salted) را برای
استفاده به‌عنوان گذرواژهٔ وب‌سرور یا کلید api برمی‌گرداند.
یک ضریب کاری اختیاری برای scrypt می‌تواند به‌صورت توان‌هایی از دو مشخص شود،
در غیر این صورت مقدار پیش‌فرض آن 1024 است.
.UNINDENT
.UNINDENT
.sp
ipdecrypt \fIIP_ADDRESS\fP PASSPHRASE_OR_KEY [\fBkey\fP]
.INDENT 0.0
.INDENT 3.5
رمزگشایی یک نشانی IP بر اساس استاندارد \(aqipcipher\(aq. اگر
عبارت عبور یک کلید base64 است، کلمهٔ \(dqkey\(dq را پس از آن اضافه کنید.
.UNINDENT
.UNINDENT
.sp
ipencrypt \fIIP_ADDRESS\fP PASSPHRASE_OR_KEY [\fBkey\fP]
.INDENT 0.0
.INDENT 3.5
رمزنگاری یک نشانی IP بر اساس استاندارد \(aqipcipher\(aq. اگر
عبارت عبور یک کلید base64 است، کلمهٔ \(dqkey\(dq را پس از آن اضافه کنید.
.UNINDENT
.UNINDENT
.sp
list\-algorithms [with\-backend]
.INDENT 0.0
.INDENT 3.5
فهرست کردن تمام الگوریتم‌های پشتیبانی‌شدهٔ DNSSEC؛ در صورت تعیین \(dqwith\-backend\(dq،
کتابخانهٔ رمزنگاری مورداستفاده نیز به‌صورت اختیاری فهرست می‌شود.
.UNINDENT
.UNINDENT
.sp
test\-schema \fIZONE\fP
.INDENT 0.0
.INDENT 3.5
آزمایش طرحوارهٔ (schema) پایگاه‌داده؛ این دستور ناحیهٔ \fIZONE\fP را ایجاد می‌کند.
.UNINDENT
.UNINDENT
.sp
raw\-lua\-from\-content \fITYPE\fP \fICONTENT\fP
.INDENT 0.0
.INDENT 3.5
نمایش محتوای رکورد در قالبی مناسب برای دستور \fISpoofRawAction\fP در dnsdist\&.
.UNINDENT
.UNINDENT.SH "همچنین ببینید (SEE ALSO)"
.sp
pdns_server (1), pdns_control (1)
.SH "نویسندگان (AUTHORS)"
PowerDNS.COM BV
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
PowerDNS.COM BV
.\" Generated by docutils manpage writer.
.