timesyncd.conf 中文手册

名称

timesyncd.conf, timesyncd.conf.d — 网络时间同步配置文件

大纲

/etc/systemd/timesyncd.conf

/etc/systemd/timesyncd.conf.d/*.conf

/run/systemd/timesyncd.conf.d/*.conf

/usr/lib/systemd/timesyncd.conf.d/*.conf

描述

这些配置文件控制着NTP网络时间同步。参见systemd.syntax(5)以了解通用配置语法。

配置目录及其优先级

默认设置是在编译期间确定的，所以仅在确实需要修改默认设置的情况下，才需要使用配置文件。位于/etc/systemd/ 目录中的初始配置文件，仅包含了展示选项默认值的注释，目的在于方便系统管理员查看和直接修改。

如果软件包想要自定义某些默认设置，那么必须将自定义的配置文件安装到/usr/lib/systemd/*.conf.d/ 目录中。/etc/ 目录仅供系统管理员使用。系统管理员可以利用下面的逻辑来覆盖默认设置：主配置文件最先被读取，优先级也最低。所有 *.conf.d/ 中的配置文件都会覆盖主配置文件中的设置。所有 *.conf.d/ 中的配置文件(无论位于哪个目录中)，统一按照文件名的字典顺序处理。当多个配置文件都设置了同一个选项的时候：(1)如果该选项仅接受一个单一值，那么仅以文件名最靠后(字典顺序)的那一个为准；(2)如果该选项可接受一个值列表，那么将会按照文件名的字典顺序将所有值列表拼接起来。为了便于排序，建议给所有 *.conf.d/ 中的配置文件都加上两位十进制数字的文件名前缀。

如果系统管理员想要屏蔽 /usr/lib/ 目录中的某个配置文件，那么最佳做法是在 /etc/ 目录中创建一个指向 /dev/null 的同名符号链接，即可彻底屏蔽 /usr/lib/ 目录中的同名文件。

选项

下面的配置选项必须位于 "[Time]" 小节：

NTP=

一个空格分隔的NTP服务器列表，可以使用主机名，也可以使用IP地址。在运行时，此处设置的列表将与 systemd-networkd.service(8) 中已配置的NTP服务器列表合并在一起。systemd-timesyncd 将会依次尝试列表中的每个NTP服务器，直到同步成功为止。如果为此选项设置一个空字符串，那么表示清空所有此选项先前已设置的NTP服务器列表。此选项的默认值为空。

FallbackNTP=

一个空格分隔的NTP服务器列表，用作备用NTP服务器。可以使用主机名，也可以使用IP地址。如果所有已配置在 systemd-networkd.service(8) 中的NTP服务器以及上述 NTP= 中设置的NTP服务器都尝试失败，那么将尝试此处设置的备用NTP服务器。如果为此选项设置一个空字符串，那么表示清空所有此选项先前已设置的NTP服务器列表。若未设置此选项，则使用编译时设置的默认备用NTP服务器。

RootDistanceMaxSec=

最大可接受的"root distance"秒数(最大误差)。默认值为 5 秒。

PollIntervalMinSec=, PollIntervalMaxSec=

NTP消息的 最小/最大轮询间隔秒数。PollIntervalMinSec= 必须不小于 16 秒。PollIntervalMaxSec= 必须大于 PollIntervalMinSec= 。PollIntervalMinSec= 默认为 32 秒，PollIntervalMaxSec= 默认为 2048 秒。

参见

systemd(1),systemd-timesyncd.service(8),systemd-networkd.service(8)