Синхронизация времени на FreeBSD: различия между версиями
Bas (обсуждение | вклад) Инструкция по настройке штатного ntpd и диагностике синхронизации |
Bas (обсуждение | вклад) Инструкция для IPv4: уточнены DNS, пример пула и локальная диагностика |
||
| (не показаны 4 промежуточные версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
Штатный демон '''ntpd''' синхронизирует системные часы FreeBSD. После включения он запускается при загрузке, опрашивает несколько источников и подстраивает ход часов. | |||
== | == Настройка с чистой установки == | ||
На FreeBSD с полным набором базовой системы демон, утилита диагностики и штатная конфигурация уже входят в систему. Команды, изменяющие настройки или запускающие службу, выполняйте от <code>root</code>. | |||
=== Проверка компонентов и сети === | |||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
sysrc | ls -l /usr/sbin/ntpd /usr/bin/ntpq /etc/rc.d/ntpd /etc/ntp.conf | ||
command -v sysrc | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Если отсутствуют компоненты NTP и база установлена пакетами, см. [[#Минимальная установка pkgbase|минимальную установку pkgbase]]. Если отсутствует только <code>sysrc</code>, можно задать параметры вручную на шаге [[#Включение службы|включения службы]]. | |||
Проверьте, что FreeBSD разрешает имя одного из выбранных источников времени. Для штатного пула подойдёт такая команда: | |||
| <code> | |||
<syntaxhighlight lang="bash"> | |||
getent hosts 0.freebsd.pool.ntp.org | |||
</syntaxhighlight> | |||
Если | Если используется другой пул, подставьте его имя. Убедитесь, что в выводе есть IPv4-адрес. Для синхронизации хосту нужен сетевой маршрут к источникам, а межсетевой экран должен пропускать исходящие запросы на UDP/123 и ответные пакеты. Открывать UDP/123 для входящих запросов от произвольных клиентов не требуется. | ||
== Источники времени == | === Источники времени === | ||
Оставьте штатный <code>/etc/ntp.conf</code>, если подходят пулы FreeBSD. Для российского пула замените только активные строки <code>pool</code> в существующем файле строками из примера ниже. Сохраните остальные настройки, включая <code>restrict source</code> и <code>leapfile</code>. | |||
<syntaxhighlight lang="text"> | <syntaxhighlight lang="text"> | ||
pool 0.ru.pool.ntp.org iburst | pool 0.ru.pool.ntp.org iburst | ||
pool | pool 1.ru.pool.ntp.org iburst | ||
</syntaxhighlight> | |||
=== Включение службы === | |||
<syntaxhighlight lang="bash"> | |||
sysrc ntpd_enable=YES ntpd_sync_on_start=YES | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Если <code>sysrc</code> отсутствует, добавьте следующие строки в <code>/etc/rc.conf</code> или замените уже имеющиеся значения этих параметров: | |||
<syntaxhighlight lang="bash"> | |||
ntpd_enable="YES" | |||
ntpd_sync_on_start="YES" | |||
</syntaxhighlight> | |||
<code>ntpd_enable</code> включает запуск демона при загрузке. <code>ntpd_sync_on_start</code> передаёт ему <code>-g</code> и разрешает однократную начальную коррекцию при расхождении более 1000 секунд. Остальные службы при этом продолжают загружаться без ожидания синхронизации. | |||
Если | === Запуск и проверка === | ||
Запустите службу. Если <code>ntpd</code> уже работает, для применения изменённой конфигурации используйте <code>service ntpd restart</code>. | |||
<syntaxhighlight lang="bash"> | |||
service ntpd start | |||
</syntaxhighlight> | |||
Дайте демону получить первые ответы. Затем выполните: | |||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
service ntpd status | service ntpd status | ||
ntpq -pn | ntpq -pn | ||
ntpq -c 'rv 0' | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Синхронизация с сетевым источником подтверждена, когда выполняются все три условия: | |||
# <code>service ntpd status</code> показывает запущенный процесс. | |||
# В <code>ntpq -pn</code> один из конкретных серверов отмечен <code>*</code>. | |||
# В системном статусе <code>ntpq -c 'rv 0'</code> есть <code>sync_ntp</code>, <code>stratum</code> от <code>1</code> до <code>15</code> и нет <code>leap_alarm</code>. Обычный статус без объявленной високосной секунды содержит <code>leap_none, sync_ntp</code>. | |||
Если звёздочка ещё не появилась, повторите проверку через несколько минут. <code>reach=377</code> означает восемь успешных опросов подряд. Для подтверждения первой синхронизации ждать этого значения не требуется. | |||
При штатных <code>minpoll</code> и <code>maxpoll</code> | При штатных <code>minpoll</code> и <code>maxpoll</code> демон опрашивает каждый сервер с интервалом от 64 до 1024 секунд. Между опросами рассчитанная поправка к скорости хода часов продолжает действовать. Небольшие расхождения устраняются плавно, при большом расхождении возможна коррекция скачком. | ||
== Минимальная установка pkgbase == | |||
На минимальной FreeBSD 15.1 с пакетной базой компонент NTP может отсутствовать. Если <code>pkg</code> настроен и доступен штатный репозиторий базовой системы <code>FreeBSD-base</code>, выполните от <code>root</code>: | |||
<syntaxhighlight lang="bash"> | |||
pkg install -r FreeBSD-base FreeBSD-ntp | |||
</syntaxhighlight> | |||
Пакет содержит <code>ntpd</code>, <code>ntpq</code>, <code>/etc/rc.d/ntpd</code> и штатный <code>/etc/ntp.conf</code>. Если также отсутствует <code>sysrc</code>, задайте параметры через <code>/etc/rc.conf</code> или установите <code>FreeBSD-bsdconfig</code> из того же репозитория. После этого вернитесь к [[#Проверка компонентов и сети|проверке компонентов и сети]]. | |||
Если загрузка пакетов по HTTPS завершается ошибкой о сроке действия сертификата, проверьте вывод <code>date -u</code>. При грубой ошибке часов сначала выставьте приблизительное время по доверенному источнику и повторите установку. | |||
== Как читать ntpq -pn == | == Как читать ntpq -pn == | ||
| Строка 97: | Строка 134: | ||
== Если синхронизация не начинается == | == Если синхронизация не начинается == | ||
* Если служба не запускается, проверьте эффективные | * Если служба не запускается, проверьте параметры в <code>/etc/rc.conf</code> и <code>/etc/rc.conf.d/ntpd</code>, если этот файл есть. При наличии <code>sysrc</code> эффективные значения покажет <code>sysrc -s ntpd ntpd_enable ntpd_sync_on_start ntpd_config ntpd_flags</code>. Также проверьте сообщения <code>ntpd</code> в системном журнале, обычно <code>/var/log/messages</code>. Команда <code>sockstat -4 -l -P udp -p 123</code> покажет, какой процесс слушает локальный UDP-порт 123 по IPv4. | ||
* Если у всех конкретных серверов сохраняется <code>reach=0</code>, проверьте разрешение имён пулов, маршрут и прохождение NTP-запросов и ответов через межсетевой экран. Если разрешение имён и сеть работают, но <code>ntpq</code> не получает ответ от локального демона, проверьте ограничения запросов с <code>127.0.0. | * Если у всех конкретных серверов сохраняется <code>reach=0</code>, проверьте разрешение имён пулов, маршрут и прохождение NTP-запросов и ответов через межсетевой экран. Если разрешение имён и сеть работают, но <code>ntpq</code> не получает ответ от локального демона, проверьте ограничения запросов с <code>127.0.0.1</code> в <code>ntp.conf</code>. | ||
* Если источники отвечают, но <code>*</code> ещё нет, проверьте состояние повторно после нескольких опросов и посмотрите <code>ntpq -c 'rv 0'</code>. При большой разнице между системным временем и источниками проверьте, включён ли <code>ntpd_sync_on_start</code>, и есть ли сообщение о превышении порога в журнале. | * Если источники отвечают, но <code>*</code> ещё нет, проверьте состояние повторно после нескольких опросов и посмотрите <code>ntpq -c 'rv 0'</code>. При большой разнице между системным временем и источниками проверьте, включён ли <code>ntpd_sync_on_start</code>, и есть ли сообщение о превышении порога в журнале. | ||
* Если приложению нужны точные часы к моменту запуска, предусмотрите явное ожидание синхронизации при запуске этого приложения. <code>ntpd_sync_on_start</code> сам по себе такого ожидания не задаёт. | * Если приложению нужны точные часы к моменту запуска, предусмотрите явное ожидание синхронизации при запуске этого приложения. <code>ntpd_sync_on_start</code> сам по себе такого ожидания не задаёт. | ||
| Строка 106: | Строка 143: | ||
* [https://docs.freebsd.org/en/books/handbook/network-servers/#network-ntp FreeBSD Handbook: синхронизация часов по NTP] | * [https://docs.freebsd.org/en/books/handbook/network-servers/#network-ntp FreeBSD Handbook: синхронизация часов по NTP] | ||
* [https://man.freebsd.org/cgi/man.cgi?query=rc.conf&sektion=5 rc.conf(5)] и [https://man.freebsd.org/cgi/man.cgi?query=ntpd&sektion=8 ntpd(8)] | * [https://man.freebsd.org/cgi/man.cgi?query=rc.conf&sektion=5 rc.conf(5)] и [https://man.freebsd.org/cgi/man.cgi?query=ntpd&sektion=8 ntpd(8)] | ||
* [https://man.freebsd.org/cgi/man.cgi?manpath=FreeBSD+15.1-RELEASE&query=ntpq&sektion=8 ntpq(8)] | * [https://man.freebsd.org/cgi/man.cgi?manpath=FreeBSD+15.1-RELEASE+and+Ports&query=ntpq&sektion=8 ntpq(8)] | ||
* [https://www.ntp.org/documentation/4.2.8-series/poll/ Интервалы опроса] и [https://www.ntp.org/documentation/4.2.8-series/decode/#peer-status-word Метки источников ntpq] | * [https://www.ntp.org/documentation/4.2.8-series/poll/ Интервалы опроса] и [https://www.ntp.org/documentation/4.2.8-series/decode/#peer-status-word Метки источников ntpq] | ||
* [https://man.freebsd.org/cgi/man.cgi?manpath=FreeBSD+15.1-RELEASE&query=freebsd-base&sektion=7 freebsd-base(7)] и [https://github.com/freebsd/freebsd-src/blob/releng/15.1/usr.sbin/ntp/ntpd/ntp.conf штатный ntp.conf для FreeBSD 15.1] | |||
* [https://www.ntp.org/documentation/4.2.8-series/decode/#system-status-word Системные статусы NTP] | |||
[[Категория:FreeBSD]] | [[Категория:FreeBSD]] | ||
Текущая версия от 22:44, 15 ноября 2026
Штатный демон ntpd синхронизирует системные часы FreeBSD. После включения он запускается при загрузке, опрашивает несколько источников и подстраивает ход часов.
Настройка с чистой установки
На FreeBSD с полным набором базовой системы демон, утилита диагностики и штатная конфигурация уже входят в систему. Команды, изменяющие настройки или запускающие службу, выполняйте от root.
Проверка компонентов и сети
ls -l /usr/sbin/ntpd /usr/bin/ntpq /etc/rc.d/ntpd /etc/ntp.conf
command -v sysrc
Если отсутствуют компоненты NTP и база установлена пакетами, см. минимальную установку pkgbase. Если отсутствует только sysrc, можно задать параметры вручную на шаге включения службы.
Проверьте, что FreeBSD разрешает имя одного из выбранных источников времени. Для штатного пула подойдёт такая команда:
getent hosts 0.freebsd.pool.ntp.org
Если используется другой пул, подставьте его имя. Убедитесь, что в выводе есть IPv4-адрес. Для синхронизации хосту нужен сетевой маршрут к источникам, а межсетевой экран должен пропускать исходящие запросы на UDP/123 и ответные пакеты. Открывать UDP/123 для входящих запросов от произвольных клиентов не требуется.
Источники времени
Оставьте штатный /etc/ntp.conf, если подходят пулы FreeBSD. Для российского пула замените только активные строки pool в существующем файле строками из примера ниже. Сохраните остальные настройки, включая restrict source и leapfile.
pool 0.ru.pool.ntp.org iburst
pool 1.ru.pool.ntp.org iburst
Включение службы
sysrc ntpd_enable=YES ntpd_sync_on_start=YES
Если sysrc отсутствует, добавьте следующие строки в /etc/rc.conf или замените уже имеющиеся значения этих параметров:
ntpd_enable="YES"
ntpd_sync_on_start="YES"
ntpd_enable включает запуск демона при загрузке. ntpd_sync_on_start передаёт ему -g и разрешает однократную начальную коррекцию при расхождении более 1000 секунд. Остальные службы при этом продолжают загружаться без ожидания синхронизации.
Запуск и проверка
Запустите службу. Если ntpd уже работает, для применения изменённой конфигурации используйте service ntpd restart.
service ntpd start
Дайте демону получить первые ответы. Затем выполните:
service ntpd status
ntpq -pn
ntpq -c 'rv 0'
Синхронизация с сетевым источником подтверждена, когда выполняются все три условия:
service ntpd statusпоказывает запущенный процесс.- В
ntpq -pnодин из конкретных серверов отмечен*. - В системном статусе
ntpq -c 'rv 0'естьsync_ntp,stratumот1до15и нетleap_alarm. Обычный статус без объявленной високосной секунды содержитleap_none, sync_ntp.
Если звёздочка ещё не появилась, повторите проверку через несколько минут. reach=377 означает восемь успешных опросов подряд. Для подтверждения первой синхронизации ждать этого значения не требуется.
При штатных minpoll и maxpoll демон опрашивает каждый сервер с интервалом от 64 до 1024 секунд. Между опросами рассчитанная поправка к скорости хода часов продолжает действовать. Небольшие расхождения устраняются плавно, при большом расхождении возможна коррекция скачком.
Минимальная установка pkgbase
На минимальной FreeBSD 15.1 с пакетной базой компонент NTP может отсутствовать. Если pkg настроен и доступен штатный репозиторий базовой системы FreeBSD-base, выполните от root:
pkg install -r FreeBSD-base FreeBSD-ntp
Пакет содержит ntpd, ntpq, /etc/rc.d/ntpd и штатный /etc/ntp.conf. Если также отсутствует sysrc, задайте параметры через /etc/rc.conf или установите FreeBSD-bsdconfig из того же репозитория. После этого вернитесь к проверке компонентов и сети.
Если загрузка пакетов по HTTPS завершается ошибкой о сроке действия сертификата, проверьте вывод date -u. При грубой ошибке часов сначала выставьте приблизительное время по доверенному источнику и повторите установку.
Как читать ntpq -pn
| Столбец | Значение |
|---|---|
remote |
Имя или адрес источника. Длинное имя может обрезаться. |
refid |
Идентификатор источника удалённого сервера. Например, .PPS. означает, что удалённый сервер сообщает об источнике с импульсами точного времени.
|
st |
Уровень NTP (stratum) удалённого сервера. 1 означает первичный сервер, 2 и выше обозначают последующие уровни. У обычного сетевого источника 16 обозначает отсутствие синхронизации.
|
t |
Тип ассоциации. u — сетевой сервер unicast, p — запись пула.
|
when |
Время после последнего полученного пакета. Число без суффикса указано в секундах. |
poll |
Текущий интервал опроса сервера в секундах. |
reach |
История последних восьми опросов в восьмеричной записи. 3 означает два последних успешных опроса, 377 — восемь успешных подряд, 0 — отсутствие успешных ответов в этом окне.
|
delay |
Оценка задержки запроса и ответа вместе, в миллисекундах. |
offset |
Оценка разницы между временем источника и локальным временем в миллисекундах. При отрицательном значении локальные часы опережают источник. |
jitter |
Оценка разброса измерений смещения времени, в миллисекундах. |
| Знак | Состояние источника |
|---|---|
* |
Выбранный системный источник (system peer). |
+ |
Измерения источника участвуют в расчёте общей поправки. |
- |
Источник исключён на этапе сравнения группы кандидатов. Он может продолжать отвечать на запросы. |
# |
Резервный источник при превышении числа источников, заданного tos maxclock.
|
. |
Историческая метка переполнения таблицы отбора, в современной версии не используется. |
x |
Измерения отброшены как несогласованные по результатам алгоритма отбора. |
o |
Выбран источник PPS. |
| Пробел | Источник в данный момент не участвует в отборе или не прошёл проверки пригодности. У строки пула такой статус штатный. |
Строки с .POOL. и t=p служат для обнаружения серверов. У них штатно отображаются st=16 и reach=0. Для оценки доступности смотрите строки конкретных серверов с t=u.
Если синхронизация не начинается
- Если служба не запускается, проверьте параметры в
/etc/rc.confи/etc/rc.conf.d/ntpd, если этот файл есть. При наличииsysrcэффективные значения покажетsysrc -s ntpd ntpd_enable ntpd_sync_on_start ntpd_config ntpd_flags. Также проверьте сообщенияntpdв системном журнале, обычно/var/log/messages. Командаsockstat -4 -l -P udp -p 123покажет, какой процесс слушает локальный UDP-порт 123 по IPv4. - Если у всех конкретных серверов сохраняется
reach=0, проверьте разрешение имён пулов, маршрут и прохождение NTP-запросов и ответов через межсетевой экран. Если разрешение имён и сеть работают, ноntpqне получает ответ от локального демона, проверьте ограничения запросов с127.0.0.1вntp.conf. - Если источники отвечают, но
*ещё нет, проверьте состояние повторно после нескольких опросов и посмотритеntpq -c 'rv 0'. При большой разнице между системным временем и источниками проверьте, включён лиntpd_sync_on_start, и есть ли сообщение о превышении порога в журнале. - Если приложению нужны точные часы к моменту запуска, предусмотрите явное ожидание синхронизации при запуске этого приложения.
ntpd_sync_on_startсам по себе такого ожидания не задаёт.