Синхронизация времени на FreeBSD: различия между версиями

Материал из Bas Wiki
Перейти к навигации Перейти к поиску
Инструкция по настройке штатного ntpd и диагностике синхронизации
 
Инструкция для IPv4: уточнены DNS, пример пула и локальная диагностика
 
(не показаны 4 промежуточные версии этого же участника)
Строка 1: Строка 1:
Для постоянной синхронизации системных часов на FreeBSD используйте штатный демон '''ntpd'''. Он запускается при загрузке, опрашивает несколько источников времени и подстраивает ход часов. Для такой схемы запуск <code>ntpdate</code> из cron не требуется.
Штатный демон '''ntpd''' синхронизирует системные часы FreeBSD. После включения он запускается при загрузке, опрашивает несколько источников и подстраивает ход часов.


== Включение службы ==
== Настройка с чистой установки ==


Выполните от <code>root</code>:
На FreeBSD с полным набором базовой системы демон, утилита диагностики и штатная конфигурация уже входят в систему. Команды, изменяющие настройки или запускающие службу, выполняйте от <code>root</code>.
 
=== Проверка компонентов и сети ===


<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
sysrc ntpd_enable=YES ntpd_sync_on_start=YES ntpdate_enable=NO
ls -l /usr/sbin/ntpd /usr/bin/ntpq /etc/rc.d/ntpd /etc/ntp.conf
command -v sysrc
</syntaxhighlight>
</syntaxhighlight>


{| class="wikitable"
Если отсутствуют компоненты NTP и база установлена пакетами, см. [[#Минимальная установка pkgbase|минимальную установку pkgbase]]. Если отсутствует только <code>sysrc</code>, можно задать параметры вручную на шаге [[#Включение службы|включения службы]].
! Параметр !! Что делает
 
|-
Проверьте, что FreeBSD разрешает имя одного из выбранных источников времени. Для штатного пула подойдёт такая команда:
| <code>ntpd_enable="YES"</code> || Запускает <code>ntpd</code> при загрузке системы.
 
|-
<syntaxhighlight lang="bash">
| <code>ntpd_sync_on_start="YES"</code> || Добавляет <code>-g</code>. Демон может однократно выполнить начальную коррекцию при отклонении более 1000 секунд. При <code>NO</code> демон по-прежнему синхронизирует время в пределах этого порога. Запуск службы с <code>-g</code> не блокирует загрузку до получения точного времени.
getent hosts 0.freebsd.pool.ntp.org
|-
</syntaxhighlight>
| <code>ntpdate_enable="NO"</code> || Отключает отдельную разовую установку времени через <code>ntpdate</code> при загрузке.
|}


Если в <code>/etc/rc.conf</code> есть старая строка <code>ntpdate_hosts</code>, удалите её. Она задаёт источники только для загрузочного <code>ntpdate</code>. Если в crontab от <code>root</code> есть задание с <code>ntpdate</code>, проверьте его через <code>crontab -l</code> и удалите только эту запись через <code>crontab -e</code>. Например, <code>05 * * * * …</code> означает запуск каждый час в <code>:05</code>. Перенаправление <code>&gt; /dev/null 2&gt;&amp;1</code> скрывает вывод и ошибки. При работающем <code>ntpd</code> обычный вызов <code>ntpdate</code> может завершиться ошибкой из-за занятого сокета NTP.
Если используется другой пул, подставьте его имя. Убедитесь, что в выводе есть IPv4-адрес. Для синхронизации хосту нужен сетевой маршрут к источникам, а межсетевой экран должен пропускать исходящие запросы на UDP/123 и ответные пакеты. Открывать UDP/123 для входящих запросов от произвольных клиентов не требуется.


== Источники времени ==
=== Источники времени ===


Источники <code>ntpd</code> задаются в <code>/etc/ntp.conf</code>. Обычно достаточно штатных пулов FreeBSD. Если нужен российский пул, замените активные штатные строки <code>pool</code> следующими:
Оставьте штатный <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 2.ru.pool.ntp.org iburst
pool 1.ru.pool.ntp.org iburst
</syntaxhighlight>
 
=== Включение службы ===
 
<syntaxhighlight lang="bash">
sysrc ntpd_enable=YES ntpd_sync_on_start=YES
</syntaxhighlight>
</syntaxhighlight>


Оставьте действующие настройки <code>tos</code>, <code>restrict</code>, <code>restrict source</code> и <code>leapfile</code>. Директива <code>pool</code> позволяет демону получить адреса нескольких серверов через DNS. Опция <code>iburst</code> ускоряет начальную синхронизацию серией быстрых запросов. Если в <code>ntpd_config</code> задан другой путь, меняйте файл по этому пути.
Если <code>sysrc</code> отсутствует, добавьте следующие строки в <code>/etc/rc.conf</code> или замените уже имеющиеся значения этих параметров:


Разрешите DNS и обмен с выбранными источниками по UDP/123. Для хоста, который только получает время, достаточно разрешить исходящие запросы и ответы на них. Открывать UDP/123 для произвольных входящих запросов из Интернета не требуется.
<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>service ntpd start</code> от <code>root</code>. Если служба уже работает и вы изменили конфигурацию, выполните <code>service ntpd restart</code>.
=== Запуск и проверка ===
 
Запустите службу. Если <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>ntpq -c 'rv 0'</code>.
Синхронизация с сетевым источником подтверждена, когда выполняются все три условия:
 
# <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> обычный интервал опроса каждого сервера составляет от 64 до 1024 секунд. Демон сам меняет интервал по мере стабилизации часов, а между опросами продолжает действовать рассчитанная поправка к скорости их хода. Небольшие расхождения устраняются плавно. Большое расхождение может потребовать коррекции скачком.
При штатных <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>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 -6 -P udp -p 123</code> покажет, какой процесс слушает UDP/123.
* Если служба не запускается, проверьте параметры в <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.1</code> и <code>::1</code> в <code>ntp.conf</code>.
* Если у всех конкретных серверов сохраняется <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'

Синхронизация с сетевым источником подтверждена, когда выполняются все три условия:

  1. service ntpd status показывает запущенный процесс.
  2. В ntpq -pn один из конкретных серверов отмечен *.
  3. В системном статусе 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 сам по себе такого ожидания не задаёт.

Источники