نام (NAME)

unbound-host - ابزار جست‌وجوی DNS در Unbound نسخه 1.26.0.

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

unbound-host [-C configfile] [-vdhr46D] [-c class] [-t type] [-y key] [-f keyfile] [-F namedkeyfile] hostname

توضیحات (DESCRIPTION)

ابزار unbound-host از تحلیل‌گر اعتبارسنج Unbound برای پرس‌وجوی نام میزبان (hostname) و نمایش نتایج استفاده می‌کند. با گزینهٔ -v وضعیت اعتبارسنجی را نمایش می‌دهد: امن (secure)، ناامن (insecure)، نامعتبر/جعلی (bogus، شکست امنیتی).

به‌طور پیش‌فرض هیچ فایل پیکربندی‌ای خوانده نمی‌شود. این ابزار تلاش می‌کند با سرورهای ریشهٔ اینترنت ارتباط برقرار کند. با استفاده از -C یک فایل پیکربندی unbound و با -r فایل resolv.conf قابل خواندن است.

گزینه‌های موجود عبارتند از:

hostname: این نام تحلیل می‌شود (در DNS جست‌وجو می‌گردد). اگر یک نشانی IPv4 یا IPv6 داده شود، یک جست‌وجوی معکوس (reverse lookup) انجام می‌گیرد.

-h: نمایش نسخه و راهنمای گزینه‌های خط فرمان.

-v: فعال‌سازی خروجی پرگو (verbose) و نمایش نتایج اعتبارسنجی در هر خط. امن (Secure) به این معنی است که پاسخ NXDOMAIN (عدم وجود دامنه)، nodata (عدم وجود داده) یا پاسخ دادهٔ مثبت به درستی با یکی از کلیدها اعتبارسنجی شده است. ناامن (Insecure) یعنی هیچ تنظیمات امنیتی‌ای برای آن نام دامنه انجام نشده است. نامعتبر/جعلی (Bogus، شکست امنیتی) به این معنی است که پاسخ در یک یا چند بررسی ناموفق بوده است؛ به احتمال زیاد نادرست، منسوخ‌شده، دست‌کاری‌شده یا خراب است.

-d: فعال‌سازی خروجی اشکال‌زدایی در stderr. یک بار استفاده از -d نشان می‌دهد که تحلیل‌گر و اعتبارسنج چه کاری انجام می‌دهند و می‌تواند مشخص کند چه اتفاقی در حال رخ دادن است. استفادهٔ چندباره، -d -d، خروجی‌های بسیار زیادی با جزئیات تمام بسته‌های ارسالی و دریافتی ارائه می‌دهد.

-c <class>: مشخص کردن کلاسی که باید جست‌وجو شود؛ پیش‌فرض IN (کلاس اینترنت) است.

-t <type>: مشخص کردن نوع داده برای جست‌وجو. پیش‌فرض به دنبال داده‌های IPv4، IPv6 و کارگزار ایمیل، یا اشاره‌گرهای نام دامنه برای پرس‌وجوهای معکوس می‌گردد.

-y <key>: مشخص کردن یک کلید عمومی برای استفاده به‌عنوان لنگر اعتماد (trust anchor). این مبنای یک زنجیرهٔ اعتماد است که از لنگر اعتماد تا پاسخ ساخته می‌شود تا پیام پاسخ اعتبارسنجی گردد. می‌تواند به‌صورت یک رکورد DS یا DNSKEY ارائه شود. برای مثال:

-y "example.com DS 31560 5 1 1CFED84787E6E19CCF9372C1187325972FE546CD"

-D: اعتبارسنجی DNSSEC را فعال می‌کند. لنگر ریشه را از لنگر ریشهٔ پیکربندی‌شدهٔ پیش‌فرض در مسیر پیش‌فرض /etc/trusted-key.key می‌خواند.

-f <keyfile>: کلیدها را از یک فایل می‌خواند. هر خط شامل یک رکورد DS یا DNSKEY با قالبی همانند گزینهٔ -y است. قالب فایل ناحیه (zone file)، همانند خروجی ابزارهای dig و drill است.

-F <namedkeyfile>: کلیدها را از یک فایل named.conf به سبک BIND می‌خواند. تنها ورودی‌های trusted-key {}; خوانده می‌شوند.

-C <configfile>: از unbound.conf مشخص‌شده برای آماده‌سازی libunbound(3) استفاده می‌کند. اگر می‌خواهید برخی گزینه‌های فایل پیکربندی را با آرگومان‌های بعدی در خط فرمان بازنویسی کنید، آن را به عنوان اولین آرگومان ارسال نمایید.

-r: فایل /etc/resolv.conf را می‌خواند و از سرورهای فوروارد DNS موجود در آن (که ممکن است توسط DHCP تنظیم شده باشند) استفاده می‌کند. اطلاعات بیشتر در resolv.conf(5). در صورتی که آن سرورها از DNSSEC پشتیبانی نکنند، اعتبارسنجی با خطا روبه‌رو خواهد شد.

-4: صرفاً از شبکهٔ IPv4 برای ارسال بسته‌ها استفاده می‌کند.

-6: صرفاً از شبکهٔ IPv6 برای ارسال بسته‌ها استفاده می‌کند.

مثال‌ها (EXAMPLES)

چند مثال از نحوهٔ استفاده. کلیدهای نشان داده شده در زیر ساختگی هستند، بنابراین خطای امنیتی رخ خواهد داد.

$ unbound-host www.example.com
$ unbound-host -v -y "example.com DS 31560 5 1 1CFED84787E6E19CCF9372C1187325972FE546CD" www.example.com
$ unbound-host -v -y "example.com DS 31560 5 1 1CFED84787E6E19CCF9372C1187325972FE546CD" 192.0.2.153

وضعیت خروج (EXIT STATUS)

برنامهٔ unbound-host در صورت بروز خطا با کد وضعیت 1، و در صورت عدم وجود خطا با 0 خارج می‌شود. ممکن است با وجود کد وضعیت خروج 0 نیز داده‌ها در دسترس نباشند؛ کد خروج 1 به این معنی است که جست‌وجو با خطایی مهلک مواجه شده است.

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

unbound.conf(5), unbound(8).

نویسندگان (AUTHORS)

توسعه‌دهندگان Unbound در فایل CREDITS درون بستهٔ توزیع معرفی شده‌اند.

کپی‌رایت و تکثیر (COPYRIGHT)

1999-2026, NLnet Labs

August 4, 2026

1.26.0