.\" $OpenBSD: ntpd.conf.5,v 1.49 2023/03/02 17:09:53 jmc Exp $ .\" .\" Copyright (c) 2003, 2004 Henning Brauer .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER IN .\" AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT .\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .Dd $Mdocdate: March 2 2023 $ .Dt NTPD.CONF 5 .Os .Sh "نام (NAME)" .Nm ntpd.conf .Nd فایل پیکربندی دیمون پروتکل زمان شبکه OpenNTPD .Sh "توضیحات (DESCRIPTION)" این صفحه راهنما قالب فایل پیکربندی .Xr ntpd 8 را شرح می‌دهد. .Pp قالب .Nm به صورت زیر است: .Pp خطوط خالی و خطوطی که با نویسه .Sq # آغاز می‌شوند نادیده گرفته می‌شوند. .Pp کلمات کلیدی ممکن است چندین بار در فایل پیکربندی مشخص شوند. گزینه‌های اصلی پیکربندی به شرح زیر هستند: .Bl -tag -width Ds .It Xo Ic listen on Ar address .Op Ic rtable Ar table-id .Xc دیمون .Xr ntpd 8 توانایی همگام‌سازی ساعت محلی با سرورهای راه دور NTP را دارد و در صورتی که این دستورالعمل مشخص شده باشد، می‌تواند خودش نیز به عنوان یک سرور NTP عمل کرده و ساعت محلی را بازتوزیع کند. .Pp یک نشانی IP محلی یا نام میزبان را مشخص می‌کند که دیمون .Xr ntpd 8 باید روی آن گوش فرا دهد تا همگام‌سازی کلاینت‌های راه دور فعال شود. اگر این دستور چندین بار تکرار شود، .Xr ntpd 8 روی هر یک از نشانی‌های داده‌شده گوش فرا خواهد داد. اگر .Sq * به عنوان نشانی داده شود، .Xr ntpd 8 با استفاده از جدول مسیریابی مشخص‌شده روی تمام نشانی‌های محلی گوش فرا خواهد داد. .Xr ntpd 8 به‌طور پیش‌فرض روی هیچ نشانی گوش فرا نمی‌دهد. کلمه کلیدی اختیاری .Ic rtable در صورتی که سیستم‌عامل از دامنه‌های مسیریابی (rdomainها) پشتیبانی کند، جدول مسیریابی مورد نظر برای گوش دادن را مشخص می‌کند. به‌طور پیش‌فرض .Xr ntpd 8 با استفاده از جدول مسیریابی فعلی گوش فرا می‌دهد. برای نمونه: .Bd -literal -offset indent listen on * .Ed .Pp یا .Bd -literal -offset indent listen on 127.0.0.1 listen on ::1 listen on 127.0.0.1 rtable 4 .Ed .It Ic query from Ar sourceaddr نشانی IP محلی‌ای را مشخص می‌کند که دیمون .Xr ntpd 8 باید برای پرس‌وجوهای ارسالی به سرورهایی که در ادامه مشخص می‌شوند استفاده کند؛ این گزینه در دستگاه‌هایی با چندین رابط شبکه کاربرد دارد. برای نمونه: .Bd -literal -offset indent query from 192.0.2.1 query from 2001:db8::1 .Ed .It Xo Ic sensor Ar device .Op Ic correction Ar microseconds .Op Ic refid Ar ID-string .Op Ic stratum Ar stratum-value .Op Ic trusted .Op Ic weight Ar weight-value .Xc در صورتی که سیستم‌عامل از حسگرها پشتیبانی کند، یک دستگاه حسگر تفاضل زمانی (timedelta) را مشخص می‌کند که .Xr ntpd 8 باید استفاده کند. حسگر می‌تواند چندین بار مشخص شود؛ .Xr ntpd 8 از هر حسگر داده‌شده‌ای که واقعاً وجود داشته باشد استفاده خواهد کرد. حسگرهای ناموجود نادیده گرفته می‌شوند. اگر .Sq * به عنوان نام دستگاه داده شود، .Xr ntpd 8 از تمام حسگرهای تفاضل زمانی که می‌یابد استفاده خواهد کرد. .Xr ntpd 8 به‌طور پیش‌فرض از هیچ حسگر تفاضل زمانی استفاده نمی‌کند. برای نمونه: .Bd -literal -offset indent sensor * sensor nmea0 .Ed .Pp یک مقدار تصحیح .Ic correction بر حسب میکروثانیه می‌تواند برای جبران انحراف حسگر تعیین شود. حداکثر مقدار تصحیح ۱۲۷ ثانیه است. برای نمونه، اگر یک گیرنده DCF77 به اندازه ۷۰ میلی‌ثانیه از زمان واقعی عقب باشد: .Bd -literal -offset indent sensor udcf0 correction 70000 .Ed .Pp یک شناسه .Ic refid .Ar ID-string حداکثر تا ۴ نویسه اسکی (ASCII) می‌تواند برای اعلام نوع حسگر به کلاینت‌ها مشخص شود. سند RFC 2030 شناسه‌های مرجع متداولی را پیشنهاد می‌کند، اما شناسه‌های جدید نیز «می‌توانند بر حسب نیاز ابداع شوند». اگر .Ar ID-string مشخص نشود، .Xr ntpd 8 از یک شناسه مرجع عمومی استفاده خواهد کرد. برای نمونه: .Bd -literal -offset indent sensor nmea0 refid GPS .Ed .Pp کلمه کلیدی .Ic stratum می‌تواند برای تغییر مقدار لایه (stratum) از مقدار پیش‌فرض ۱ استفاده شود. .Pp کلمه کلیدی .Ic trusted نشان می‌دهد که زمان دریافت شده امن، قابل اعتماد و در برابر حملات مرد میانی آسیب‌پذیر نیست، بنابراین اعتبارسنجی محدودیت‌ها .Pq Ic constraints نادیده گرفته می‌شود. این گزینه برای تصحیح زمان در هنگام راه‌اندازی سیستم در محیط‌هایی که امکان استفاده از .Ic constraints وجود ندارد، مفید است. .Pp کلمه کلیدی .Ic weight امکان کنترل دقیق‌تر روی اهمیت نسبی منابع زمان (سرورها یا دستگاه‌های حسگر) را فراهم می‌کند. وزن‌ها در بازه ۱ تا ۱۰ تعیین می‌شوند؛ اگر وزنی مشخص نشود، مقدار پیش‌فرض ۱ است. به عنوان نمونه، سروری با وزن ۵، پنج برابر بیشتر از سروری با وزن ۱ روی محاسبه انحراف زمان تأثیر خواهد داشت. .It Xo Ic server Ar address .Op Ic trusted .Op Ic weight Ar weight-value .Xc نشانی IP یا نام میزبان یک سرور NTP را برای همگام‌سازی با آن مشخص می‌کند. اگر این گزینه چندین بار ذکر شود، .Xr ntpd 8 تلاش خواهد کرد با تمام سرورهای مشخص‌شده همگام شود. اگر یک نام میزبان به چندین نشانی IPv4 و/یا IPv6 تفکیک شود، .Xr ntpd 8 از نخستین نشانی استفاده می‌کند. اگر پاسخی دریافت نکند، .Xr ntpd 8 با نشانی بعدی تلاش مجدد می‌کند و این کار را تا زمانی که نشانی کارآمدی پیدا شود ادامه می‌دهد. برای نمونه: .Bd -literal -offset indent server 10.0.0.2 weight 5 server ntp.example.org weight 1 .Ed .Pp برای ایجاد افزونگی (redundancy)، پیکربندی چندین سرور روش مناسبی است. به‌طور کلی، بیشترین دقت با استفاده از سرورهایی به دست می‌آید که تأخیر شبکه پایینی دارند. .It Xo Ic servers Ar address .Op Ic trusted .Op Ic weight Ar weight-value .Xc همانند .Cm server , نشانی IP یا نام میزبان یک سرور NTP را برای همگام‌سازی با آن مشخص می‌کند. اگر چندین بار ذکر شود، .Xr ntpd 8 تلاش خواهد کرد با تمام سرورهای مشخص‌شده همگام شود. چنانچه نام میزبان به چندین نشانی IP تفکیک شود، .Xr ntpd 8 تلاش خواهد کرد با تمامی آن‌ها همگام‌سازی را انجام دهد. برای نمونه: .Bd -literal -offset indent servers pool.ntp.org servers pool.ntp.org weight 5 .Ed .El .Sh "محدودیت‌ها (CONSTRAINTS)" دیمون .Xr ntpd 8 می‌تواند پیکربندی شود تا هدر .Sq Date را از سرورهای مورد اعتماد HTTPS از طریق TLS استعلام کند. این اطلاعات زمانی برای دقت بالا استفاده نمی‌شود، بلکه به عنوان یک محدودیت اعتبارسنجی‌شده عمل می‌کند و در نتیجه اثرات حملات مرد میانی در NTP بدون احراز هویت را کاهش می‌دهد. بسته‌های NTP دریافتی با اطلاعات زمانی که خارج از محدوده نزدیک به این محدودیت قرار گیرند نادیده گرفته شده و این سرورهای NTP به عنوان نامعتبر علامت‌گذاری می‌شوند. .Pp پشتیبانی از محدودیت‌ها تنها در صورتی در دسترس است که .Xr ntpd 8 با کتابخانه libtls از LibreSSL پیوند (link) خورده باشد. پیکربندی یک محدودیت بدون libtls باعث می‌شود .Xr ntpd 8 هنگام راه‌اندازی پیامی هشدارآمیز را ثبت کند. .Bl -tag -width Ds .It Ic constraint from Ar url [ip...] نشانی اینترنتی (URL)، نشانی IP یا نام میزبان یک سرور HTTPS را برای ارائه محدودیت زمانی مشخص می‌کند. اگر پس از نشانی اینترنتی یک یا چند نشانی IP بیاید، نشانی اینترنتی و این IPها به نوبت آزمایش می‌شوند تا یک مورد کارآمد پیدا شود. مسیر URL و نام گواهی مورد انتظار همواره از URL مشخص‌شده استخراج می‌شود. اگر .Ic constraint from بیش از یک بار استفاده شود، .Xr ntpd 8 یک مقدار میانه را از تمام سرورهای مشخص‌شده برای محدودیت محاسبه خواهد کرد. .Bd -literal -offset indent server ntp.example.org constraint from www.example.com constraint from "https://9.9.9.9" "2620:fe::9" .Ed .It Ic constraints from Ar url همانند .Ic constraint from , نشانی اینترنتی (URL)، نشانی IP یا نام میزبان یک سرور HTTPS را برای ارائه محدودیت زمانی مشخص می‌کند. چنانچه نام میزبان به چندین نشانی IP تفکیک شود، .Xr ntpd 8 یک محدودیت میانه از تمامی آن‌ها محاسبه خواهد کرد. برای نمونه: .Bd -literal -offset indent servers pool.ntp.org constraints from "https://www.google.com" .Ed .El .Sh "فایل‌ها (FILES)" .Bl -tag -width /etc/ntpd.conf -compact .It Pa /etc/ntpd.conf فایل پیکربندی پیش‌فرض .Xr ntpd 8 . .El .Sh "همچنین ببینید (SEE ALSO)" .Xr ntpctl 8 , .Xr ntpd 8 , .Xr sysctl 8 .Sh "تاریخچه (HISTORY)" قالب فایل .Nm نخستین بار در .Ox 3.6 ظاهر شد.