.\" 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 "UNBOUND-ANCHOR" "8" "Aug  4, 2026" "1.26.0" "Unbound"
.SH "نام (NAME)"
unbound-anchor \- ابزار راه‌اندازی و به‌روزرسانی لنگر اعتماد (trust anchor) سرور Unbound
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBunbound\-anchor\fP [\fBopts\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامهٔ \fBunbound\-anchor\fP عملیات راه‌اندازی یا به‌روزرسانی لنگر اعتماد ریشه (root trust anchor) را برای اعتبارسنجی DNSSEC انجام می‌دهد\&.
این برنامه هنگامی که به‌روزرسانی عادی بر اساس \fI\%RFC 5011\fP نتواند لنگر اعتماد را به‌روز کند، آن را با استفاده از روش ارائه‌شده در \fI\%RFC 7958\fP دریافت می‌نماید\&.
این ابزار را می‌توان از طریق خط فرمان، یا به عنوان بخشی از اسکریپت‌های راه‌اندازی سیستم پیش از آغاز به کار سرور DNS \fI\%unbound(8)\fP اجرا نمود\&.
.sp
توجه داشته باشید که اگر می‌خواهید از \fI\%RFC 5011\fP در Unbound استفاده کنید (یعنی گزینهٔ \fI\%auto\-trust\-anchor\-file\fP) تا اطلاعات لنگر اعتماد در حین کار به صورت خودکار توسط Unbound ردیابی شود، کاربری که Unbound تحت آن اجرا می‌شود (به‌طور پیش‌فرض \(aqunbound\(aq) باید مجوزهای نوشتن را روی این فایل و پوشه‌ای که فایل در آن قرار دارد (جهت ایجاد فایل‌های موقت) داشته باشد\&.
در این حالت، احتمالاً مایل خواهید بود که این برنامه را با همان کاربر تعیین‌شده برای Unbound اجرا کنید\&.
.sp
نحوهٔ استفاده پیشنهادی:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
# in the init scripts.
# provide or update the root anchor (if necessary)
unbound\-anchor \-a \(dq/etc/trusted-key.key\(dq

# Please note usage of this root anchor is at your own risk
# and under the terms of our LICENSE (see source).
#
# start validating resolver
# the unbound.conf contains:
# auto\-trust\-anchor\-file: \(dq/etc/trusted-key.key\(dq
unbound \-c unbound.conf
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
این ابزار محتوای پیش‌فرض توکار را برای فایل‌های لنگر ریشه و گواهی به‌روزرسانی ریشه فراهم می‌کند\&.
.sp
این برنامه بررسی می‌کند که آیا فایل لنگر ریشه کار می‌کند یا خیر، و اگر کار نکند و امکان به‌روزرسانی وجود داشته باشد، تلاش می‌کند با استفاده از گواهی به‌روزرسانی ریشه، لنگر ریشه را به‌روز کند\&.
این ابزار یک درخواست دریافت https برای فایل
\fI\%root\-anchors.xml\fP
ارسال کرده و نتایج را بررسی می‌کند (\fI\%RFC 7958\fP)؛ در صورت موفقیت‌آمیز بودن تمامی بررسی‌ها، فایل لنگر ریشه را به‌روز می‌نماید\&.
در غیر این صورت، فایل لنگر ریشه دست‌نخورده باقی می‌ماند\&.
همچنین چنانچه اطلاعات DNSSEC در دسترس از طریق سامانه DNS امکان آن را فراهم کند، ردیابی بر اساس \fI\%RFC 5011\fP را انجام می‌دهد\&.
.sp
در صورتی که گواهی منقضی شده باشد، شبکه قطع باشد یا خطاهای دیگری رخ دهند، به‌روزرسانی را انجام نمی‌دهد\&.
.sp
گزینه‌های موجود عبارتند از:
.INDENT 0.0
.TP
.B \-a <file>
فایل کلید لنگر ریشه، که خوانده و نوشته می‌شود\&.
مقدار پیش‌فرض \fB/etc/trusted-key.key\fP است\&.
اگر این فایل وجود نداشته باشد یا خالی باشد، یک کلید ریشه توکار درون آن نوشته می‌شود\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-c <file>
فایل گواهی به‌روزرسانی ریشه، که خوانده می‌شود\&.
مقدار پیش‌فرض \fB/etc/unbound/icannbundle.pem\fP است\&.
اگر فایل وجود نداشته باشد یا خالی باشد، از گواهی توکار استفاده خواهد شد\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-l
فهرست کردن کلید ریشه توکار و گواهی به‌روزرسانی ریشه توکار در خروجی استاندارد (stdout)\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-u <name>
نام سرور، که به \fBhttps://name\fP متصل می‌شود\&.
بدون پیشوند \fBhttps://\fP مشخص کنید\&.
مقدار پیش‌فرض \fB\(dqdata.iana.org\(dq\fP است\&.
به درگاه مشخص‌شده با گزینهٔ \fI\%\-P\fP متصل می‌شود\&.
در صورت تمایل می‌توانید یک نشانی IPv4 یا IPv6 (بدون براکت) وارد کنید\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-S
عدم استفاده از SNI برای اتصال HTTPS\&.
حالت پیش‌فرض استفاده از SNI است\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-b <address>
نشانی مبدأ جهت مقید شدن (bind) برای تحلیل دامنه و ارتباط با سرور از طریق https\&.
می‌تواند یک نشانی IPv4 یا IPv6 (بدون براکت) باشد\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-x <path>
مسیر دسترسی به فایل root\-anchors.xml روی سرور (که همراه با گزینهٔ \fI\%\-u\fP نشانی وب را تشکیل می‌دهد)\&.
مقدار پیش‌فرض \fB/root\-anchors/root\-anchors.xml\fP است\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-s <path>
مسیر دسترسی به فایل root\-anchors.p7s روی سرور (که همراه با گزینهٔ \fI\%\-u\fP نشانی وب را تشکیل می‌دهد)\&.
مقدار پیش‌فرض \fB/root\-anchors/root\-anchors.p7s\fP است\&.
این فایل باید یک امضای PKCS7 روی فایل xml باشد که از فایل pem گزینهٔ (\fI\%\-c\fP) به عنوان لنگر اعتماد استفاده می‌کند\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-n <name>
مقدار emailAddress برای موضوع (Subject) گواهی امضاکننده برگرفته از فایل امضای p7s\&.
تنها امضاهای حاصل از این نام مجاز هستند\&.
مقدار پیش‌فرض \fBdnssec@iana.org\fP است\&.
اگر \fB\(dq\(dq\fP وارد کنید، مقدار emailAddress بررسی نمی‌شود\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-4
استفاده از IPv4 برای تحلیل دامنه و ارتباط با سرور از طریق https\&.
حالت پیش‌فرض، استفاده از هر دو پروتکل IPv4 و IPv6 بر حسب صلاحدید و شرایط است\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-6
استفاده از IPv6 برای تحلیل دامنه و ارتباط با سرور از طریق https\&.
حالت پیش‌فرض، استفاده از هر دو پروتکل IPv4 و IPv6 بر حسب صلاحدید و شرایط است\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-f <resolv.conf>
استفاده از فایل resolv.conf مشخص‌شده\&.
به‌طور پیش‌فرض فعال نیست، اما در برخی سیستم‌ها می‌توانید مسیر \fB/etc/resolv.conf\fP را به آن ارجاع دهید\&.
این فایل حاوی نشانی‌های IP سرورهای بازگشتی نام (recursive nameservers) جهت استفاده است\&.
با این حال، از آنجا که این ابزار ممکن است برای راه‌اندازی اولیه (bootstrap) همان سرور بازگشتی نام استفاده شود، ممکن است مفید واقع نشود (زیرا آن سرور هنوز بالا نیامده است، چرا که در حال راه‌اندازی اولیه‌اش هستیم)\&.
این گزینه می‌تواند در شرایطی که می‌دانید یک حافظه نهان بالادستی (upstream cache) مستقر و در حال اجرا است، و نیز در پورتال‌های درون‌شبکه‌ای (captive portals) مفید باشد\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-r <root.hints>
استفاده از فایل root.hints مشخص‌شده (با همان ساختار نگارشی فایل نکات ریشه در BIND و Unbound) جهت راه‌اندازی اولیه تحلیل دامنه\&.
به‌طور پیش‌فرض، از فهرستی از نکات ریشه (root hints) توکار استفاده می‌شود\&.
ابزار unbound\-anchor خود مستقیماً به شبکه مراجعه می‌کند تا این ریشه‌ها را بررسی کرده، سرور (گزینهٔ \fI\%\-u\fP) را تحلیل نموده و رکوردهای DNSKEY ریشه را بررسی کند\&.
این کار از آن جهت است که وقتی ابزار برای راه‌اندازی اولیه تحلیل‌گر بازگشتی به کار می‌رود، خود نمی‌تواند از آن تحلیل‌گر استفاده کند چون در حال راه‌اندازی اولیه آن است\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-R
امکان بازگشت به حالت احتیاطی (fallback) از فایل \fI\%\-f\fP \fB<resolv.conf>\fP به پرس‌وجوی مستقیم سرورهای ریشه\&.
این گزینه به شما اجازه می‌دهد تحلیل‌گرهای محلی را ترجیح دهید، اما در صورت عدم پاسخگویی آن‌ها یا عدم پشتیبانی‌شان از DNSSEC، به‌طور خودکار به پرس‌وجوی مستقیم از سرورهای ریشه بازگردید\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-v
افزایش جزئیات گزارش (verbose)\&.
یک بار استفاده، پیام‌های اطلاعاتی را چاپ می‌کند؛ استفاده چندباره ممکن است مقادیر زیادی داده اشکال‌زدایی (مانند گواهی‌های کامل یا رونوشت بایت‌های فایل‌های بارگیری‌شده) را نمایش دهد\&.
به‌طور پیش‌فرض تقریباً چیزی چاپ نمی‌کند\&.
همچنین هنگام وقوع خطا نیز به‌طور پیش‌فرض چیزی چاپ نمی‌کند؛ در این حالت فایل اصلی لنگر ریشه دست‌نخورده باقی می‌ماند تا یک سرور بازگشتی بتواند بلافاصله پس از آن راه‌اندازی شود\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-C <unbound.conf>
گزینه اشکال‌زدایی جهت خواندن \fB<unbound.conf>\fP در فرایند تحلیل‌گر مورد استفاده\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-P <port>
تنظیم شماره درگاه برای اتصال https\&.
مقدار پیش‌فرض 443 است\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-F
گزینه اشکال‌زدایی برای اجبار به به‌روزرسانی لنگر ریشه از طریق بارگیری فایل xml و اعتبارسنجی آن با استفاده از گواهی\&.
به‌طور پیش‌فرض ابتدا تلاش می‌کند با ارتباط با سامانه DNS به‌روزرسانی کند که پهنای باند بسیار کمتری مصرف کرده، بسیار سریع‌تر است (۲۰۰ میلی‌ثانیه به جای ۲ ثانیه)، و بار کمتری به زیرساخت مستقر وارد می‌کند\&.
با این گزینه، همچنان تلاش می‌کند این کار را انجام دهد (و ممکن است به صورت مفصل گزارش دهد)، اما سپس نتیجه را نادیده گرفته و به سراغ روش بازگشتی استفاده از xml می‌رود\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-h
نمایش نسخه و راهنمای گزینه‌های خط فرمان\&.
.UNINDENT
.SH "کد خروج (EXIT CODE)"
.sp
این ابزار اگر لنگر ریشه با استفاده از گواهی به‌روزرسانی شده باشد، یا اگر از لنگر ریشه توکار استفاده شده باشد، با مقدار 1 خارج می‌شود\&.
چنانچه هیچ به‌روزرسانی نیاز نبوده باشد، یا به‌روزرسانی با ردیابی \fI\%RFC 5011\fP امکان‌پذیر بوده باشد، یا خطایی رخ داده باشد، با کد 0 خارج می‌شود\&.
.sp
می‌توانید مقدار خروج را به این صورت بررسی کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
unbound\-anchor \-a \(dqroot.key\(dq || logger \(dqPlease check root.key\(dq
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
یا روشی مناسب‌تر برای محیط عملیاتی خود به کار ببرید\&.
.SH "اعتماد (TRUST)"
.sp
کلیدهای ریشه و گواهی به‌روزرسانی ارائه‌شده در این ابزار صرفاً جهت سهولت و بر اساس شرایط مجوز ما فراهم شده‌اند (به فایل LICENSE در توزیع منبع یا \fI\%https://github.com/NLnetLabs/unbound/blob/master/LICENSE\fP مراجعه کنید) و ممکن است منقضی شده یا برای مقصود شما مناسب نباشند\&.
.sp
با اجرای دستور \fI\%unbound\-anchor \-l\fP کلیدها و گواهی‌های پیکربندی‌شده در کد، جهت سهولت شما نمایش داده می‌شوند\&.
.sp
پیکربندی توکار را می‌توان با ارائهٔ یک فایل root\-cert و یک فایل rootkey جایگزین کرد\&.
.SH "فایل‌ها (FILES)"
.INDENT 0.0
.TP
.B /etc/trusted-key.key
فایل لنگر ریشه، که با ردیابی ۵۰۱۱ به‌روزرسانی شده و خوانده و نوشته می‌شود\&.
اگر این فایل وجود نداشته باشد، ایجاد خواهد شد\&.
.TP
.B /etc/unbound/icannbundle.pem
گواهی خودامضاشدهٔ مورد اعتماد که برای راستی‌آزمایی لنگر اعتماد ریشه DNSSEC بارگیری‌شده به کار می‌رود\&.
می‌توانید با دریافت آن از نشانی
\fI\%https://data.iana.org/root\-anchors/icannbundle.pem\fP
آن را به‌روزرسانی کنید (و اعتبارسنجی نمایید)\&.
اگر فایل وجود نداشته باشد یا خالی باشد، از نسخه توکار استفاده می‌شود\&.
.TP
.B \fI\%https://data.iana.org/root\-anchors/root\-anchors.xml\fP
منبع اطلاعات کلید ریشه\&.
.TP
.B \fI\%https://data.iana.org/root\-anchors/root\-anchors.p7s\fP
امضای موجود بر روی اطلاعات کلید ریشه\&.
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fI\%unbound.conf(5)\fP,
\fI\%unbound(8)\fP\&.
.SH "نویسنده (AUTHOR)"
توسعه‌دهندگان Unbound در فایل CREDITS درون توزیع برنامه ذکر شده‌اند\&.
.SH "حق نشر (COPYRIGHT)"
1999-2026, NLnet Labs
.\" Generated by docutils manpage writer.
.