cturra/ntp Docker Image
在Docker容器中运行的NTP服务器,无需特权模式即可提供网络时间同步服务。
cturra/ntp Docker镜像文档
镜像概述
本镜像在 https://alpinelinux.org/ 上运行 chrony 网络时间协议(NTP)实现。
主要用途:提供轻量级、容器化的NTP服务,用于网络中计算机的时间同步。可作为NTP客户端同步外部时间源,或作为NTP服务器为局域网内其他设备提供时间服务。
核心功能与特性
- 时间同步:支持通过NTP服务器、参考时钟(如GPS接收器)及手动输入(如手表和键盘)同步系统时钟。
- NTP服务端:实现NTPv4(RFC 5905)服务器功能,为网络中其他计算机提供时间服务。
- 轻量级基础:基于Alpine Linux,镜像体积小,资源占用低。
- 灵活配置:支持自定义NTP服务器、日志级别、时区及网络时间安全(NTS)等参数。
- 多架构支持:适配多种硬件架构,无需手动指定架构类型。
支持的架构
本Docker镜像官方支持以下架构,直接从https://hub.docker.com/r/cturra/ntp拉取即可自动获取对应架构的镜像:
使用场景与适用范围
- 局域网时间同步:在企业内部网络中部署,为所有设备提供统一时间源。
- 开发/测试环境:快速搭建独立的NTP服务,确保测试环境时间一致性。
- 边缘计算节点:在资源受限的边缘设备上提供轻量级时间服务。
- 容器化基础设施:与Kubernetes、Docker Swarm等容器编排平台集成,作为集群时间服务组件。
使用方法
Docker CLI
拉取镜像
bashdocker pull docker.xuanyuan.run/cturra/ntp
基础运行
bashdocker run --name=ntp \ --restart=always \ --detach \ --publish=123:123/udp \ docker.xuanyuan.run/cturra/ntp
高安全性运行
启用只读文件系统及临时目录挂载,增强容器安全性:
bashdocker run --name=ntp \ --restart=always \ --detach \ --publish=123:123/udp \ --read-only \ --tmpfs=/etc/chrony:rw,mode=1750 \ --tmpfs=/run/chrony:rw,mode=1750 \ --tmpfs=/var/lib/chrony:rw,mode=1750 \ docker.xuanyuan.run/cturra/ntp
Docker Compose
使用项目中的docker-compose.yml文件部署(需Docker Engine 19.03.0+,支持Compose格式3.9):
启动服务
bashdocker compose up -d ntp
查看日志(可选)
bashdocker compose logs ntp
Docker Swarm
在已配置的Swarm集群中部署:
部署栈
bashdocker stack deploy -c docker-compose.yml cturra
检查服务状态
bashdocker stack services cturra
查看日志(可选)
bashdocker service logs -f cturra_ntp
本地命令行
通过项目中的vars文件配置环境变量,执行构建和运行脚本:
构建镜像
bash./build.sh
运行容器
bash./run.sh
配置说明
NTP服务器配置
默认使用CloudFlare时间服务器(time.cloudflare.com)。可通过NTP_SERVERS环境变量指定自定义服务器,支持多个服务器(逗号分隔,无空格)。
配置方式
- Docker run:
--env=NTP_SERVERS="服务器1,服务器2,..." - Docker Compose:在
environment中添加NTP_SERVERS: "服务器1,服务器2,..."
示例
bash# CloudFlare(默认) NTP_SERVERS="time.cloudflare.com" # Google NTP_SERVERS="time1.google.com,time2.google.com,time3.google.com,time4.google.com" # 阿里云 NTP_SERVERS="ntp1.aliyun.com,ntp2.aliyun.com,ntp3.aliyun.com,ntp4.aliyun.com" # 本地离线模式(使用系统时钟) NTP_SERVERS="127.127.1.1"
Chronyd选项
禁用客户端日志(noclientlog)
默认启用客户端访问日志。设置NOCLIENTLOG=true可禁用日志,同时禁用NTP交错模式支持。
配置方式:--env=NOCLIENTLOG=true
日志级别
通过LOG_LEVEL环境变量设置日志详细程度,对应chrony的-L选项,支持级别:
0:信息(默认)1:警告2:非致命错误3:致命错误
配置方式:--env=LOG_LEVEL=级别
时区设置
默认使用UTC时区。通过TZ环境变量指定时区(遵循标准TZ数据格式)。
示例(温哥华时区):
yamlenvironment: - TZ=America/Vancouver
启用网络时间安全(NTS)
当所有配置的NTP_SERVERS均支持NTS时,设置ENABLE_NTS=true启用NTS。
示例:
yamlenvironment: - NTP_SERVERS=time.cloudflare.com - ENABLE_NTS=true
注意:若任何服务器不支持NTS,启动时会提示超时错误(如
NTS-KE session with ... timed out)。
测试与验证
验证NTP服务可用性
使用ntpdate工具查询容器提供的时间服务(替换<DOCKER_HOST_IP>为容器主机IP):
bashntpdate -q <DOCKER_HOST_IP>
示例输出
server 10.13.13.9, stratum 4, offset 0.000642, delay 0.02805 14 Mar 19:21:29 ntpdate[26834]: adjust time server 10.13.13.9 offset 0.000642 sec
查看chrony状态
通过容器内chronyc命令获取详细信息:
时间同步状态
bashdocker exec ntp chronyc tracking
对等服务器列表
bashdocker exec ntp chronyc sources
服务器统计信息
bashdocker exec ntp chronyc sourcestats
常见日志说明
若日志中出现Could not step system clock,是因为chrony以-x选项运行,不修改宿主机时钟(设计如此,需通过NTP客户端从容器同步时间)。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务