geoffh1977/chrony

Chrony Docker镜像

!https://raw.githubusercontent.com/geoffh1977/docker-chrony/master/files/logo.png

!Docker Cloud Build Status

镜像概述

本Docker镜像提供一个小型chrony（NTP）服务，用于同步本地硬件时钟并对外提供NTP时间服务。若未提供环境变量，镜像将自动配置一系列合理的默认参数。

核心功能与特性

• 时钟同步：同步运行容器的机器/实例的实时时钟（RTC）
• NTP服务：对外提供NTP时间服务，支持客户端连接获取时间
• 灵活配置：通过环境变量自定义服务行为，或使用预编写的配置文件
• 默认参数：内置合理的默认配置，无需额外设置即可快速启动

使用场景

• 需要在Docker环境中部署NTP服务的场景
• 需同步多台设备时间的服务器环境
• 开发或测试环境中需要准确时间同步的场景
• 对NTP服务资源占用有要求的轻量级部署需求

配置说明

运行时环境变量

启动容器时可通过以下环境变量修改默认行为：

• CMD_CIDR：允许向chrony守护进程发送命令的CIDR。默认值为127/8（仅本地主机）
• ALLOW_CIDR：允许NTP客户端连接获取时间的CIDR。默认不允许外部客户端连接
• SYNC_RTC：是否同步运行服务的机器/实例的实时时钟。默认启用
• NTP_SERVER：用于获取时间的NTP服务器。默认值为pool.ntp.org

自定义配置文件

可将预编写的配置文件映射到容器内的/etc/chrony.conf路径。若该文件存在，将使用自定义配置并跳过自动配置流程。

使用方法

基本运行命令

为确保chrony服务正常运行，需要授予容器SYS-TIME权限。以下命令启动容器并允许外部客户端访问NTP服务：

bash
docker run -d --rm --cap-add SYS_TIME -e ALLOW_CIDR=0.0.0.0/0 -p 123:123/udp geoffh1977/chrony

交互模式运行

将-d（后台运行）参数替换为-it（交互模式）即可进入容器交互界面：

bash
docker run -it --rm --cap-add SYS_TIME -e ALLOW_CIDR=0.0.0.0/0 -p 123:123/udp geoffh1977/chrony

参数说明

• -d：后台运行容器
• --rm：容器退出后自动删除
• --cap-add SYS_TIME：授予容器系统时间操作权限（必需）
• -e：设置环境变量（如ALLOW_CIDR=0.0.0.0/0允许所有客户端连接）
• -p 123:123/udp：映射NTP服务默认UDP端口123

问题反馈

如发现容器问题或有改进建议，可通过GitHub提交issue或Pull Request进行反馈。