lfkeitel/ntpd

ntpd Server Docker镜像

镜像概述

lfkeitel/ntpd是一个用于快速部署NTP（网络时间协议）服务器的Docker镜像，支持灵活配置NTP服务器、统计日志管理及对等服务器权限设置，帮助用户在各种环境中搭建可靠的时间同步服务。

核心功能

• 提供标准NTP服务，暴露123/udp端口
• 支持通过环境变量自定义NTP服务器列表（含iburst选项）
• 默认启用loopstats、peerstats、clockstats统计日志，并支持日志轮换
• 可配置允许的对等服务器列表
• 支持通过卷挂载或自定义镜像修改NTP配置文件

使用场景

• 本地局域网内需要统一时间同步的企业或家庭网络
• 开发测试环境中需要稳定时间源的应用部署
• 对时间精度有要求的系统（如日志审计、分布式系统）

配置说明

基础部署

使用以下命令快速启动NTP服务器：

bash
docker run --name ntp -d -p 123:123/udp lfkeitel/ntpd

镜像默认暴露123/udp端口（NTP服务端口）。

默认配置

默认配置文件/etc/ntp.conf包含以下内容：

interface listen all
driftfile /var/lib/ntp/ntp.drift

statsdir /var/log/ntpstats/

statistics loopstats peerstats clockstats
filegen loopstats file loopstats type day enable
filegen peerstats file peerstats type day enable
filegen clockstats file clockstats type day enable

restrict default kod notrap nomodify nopeer
restrict -6 default kod notrap nomodify nopeer

restrict 127.0.0.1
restrict ::1

server 127.127.1.0 # local clock
fudge 127.127.1.0 stratum 10

logfile /dev/stdout

server 0.pool.ntp.org iburst
server 1.pool.ntp.org iburst
server 2.pool.ntp.org iburst
server 3.pool.ntp.org iburst

自定义NTP服务器

通过环境变量SERVERS和SERVERS_IBURST设置自定义NTP服务器（服务器列表以空格分隔，需用引号包裹）：

bash
docker run \
    --name ntp \
    -e SERVERS_IBURST='0.pool.ntp.org 1.pool.ntp.org' \
    lfkeitel/ntpd:latest

SERVERS_IBURST会为服务器添加iburst选项；若未指定服务器，将使用全球NTP池服务器。

统计日志配置

默认启用统计日志并存储于/var/log/ntpstats（已作为卷暴露）。可通过以下环境变量控制：

• STATS_ENABLED：是否启用统计（默认true）
• CRON_ENABLED：是否启用日志轮换（默认与STATS_ENABLED一致） 若需禁用统计，设置STATS_ENABLED=false（此时日志轮换也会自动禁用）。

对等服务器配置

默认不允许任何服务器对等，可通过ALLOWED_PEERS环境变量指定允许的对等服务器列表（空格分隔），将生成格式为restrict $SERVER kod notrap nomodify的配置行。