cwadley/alpine-chrony

基于Alpine Linux的Chrony NTP服务器

镜像概述和主要用途

本镜像基于Alpine Linux构建，集成了Chrony网络时间协议(NTP)服务器。Alpine Linux的轻量级特性使镜像体积小、资源占用低，而Chrony作为高性能的NTP客户端和服务器，能够提供精确的时间同步服务，适用于需要保持系统时间准确性的各种场景。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，启动快速，资源消耗低
• 完整NTP功能：集成Chrony，支持NTP服务器和客户端模式
• 灵活配置：支持默认配置直接运行，也可通过挂载自定义配置文件进行高级设置
• 日志管理：日志输出到stdout，便于通过Docker日志功能查看
• 必要权限：包含运行Chrony所需的系统权限(SYS_NICE、SYS_TIME、SYS_RESOURCE)

使用场景和适用范围

• 服务器集群时间同步
• 嵌入式系统时间校准
• 开发测试环境时间一致性保障
• 网络设备时间同步服务
• 对资源占用敏感的环境（如边缘计算节点）

获取镜像

Docker Hub

可直接从Docker Hub拉取镜像：

bash
docker pull cwadley/alpine-chrony

本地构建

若需自定义构建，可通过以下步骤：

bash
git pull https://github.com/cwadley/alpine-chrony.git
docker build --tag cwadley/alpine-chrony .

使用方法

默认配置

使用默认配置启动Chrony NTP服务器：

bash
docker run -d                       \
            --name chrony           \
            -p 123:123/udp          \  # NTP服务默认UDP端口
            --cap-add SYS_NICE      \  # 允许调整进程优先级
            --cap-add SYS_TIME      \  # 允许修改系统时间
            --cap-add SYS_RESOURCE  \  # 允许设置资源限制
            cwadley/alpine-chrony

自定义配置

如需使用自定义配置文件，可通过挂载本地chrony.conf文件实现：

bash
docker run -d                                                       \
            --name chrony                                           \
            -p 123:123/udp                                          \
            --cap-add SYS_NICE                                      \
            --cap-add SYS_TIME                                      \
            --cap-add SYS_RESOURCE                                  \
            -v <本地chrony.conf路径>:/etc/chrony/chrony.conf:ro     \  # 挂载自定义配置文件，只读模式
            cwadley/alpine-chrony

注：自定义配置文件需符合Chrony的配置规范，详情可参考Chrony官方文档。

日志查看

本镜像中Chrony以非分离模式运行，日志直接输出到标准输出(stdout)，而非容器内文件。查看日志可使用Docker日志命令：

bash
docker logs chrony

测试方法

可使用ntpdate工具测试NTP服务器是否正常工作：

端口映射到主机时

若已将容器123端口映射到主机，可在主机执行：

bash
ntpdate -q localhost

同一Docker网络中的其他容器

若测试容器与Chrony容器在同一Docker网络，可使用Chrony容器的IP地址：

bash
ntpdate -q <chrony容器IP>