socheatsok78/chrony

关于

这是一个基于Alpine Linux运行chrony的容器镜像，支持SYS_TIME和IPC_LOCK Linux能力。

该容器运行chrony和https://alpinelinux.org/%E3%80%82

https://github.com/socheatsok78/docker-chrony | https://hub.docker.com/r/socheatsok78/chrony | https://github.com/socheatsok78/docker-chrony/pkgs/container/chrony

什么是Chrony？

chrony是网络时间协议（NTP）的多功能实现。它可以将系统时钟与NTP服务器、参考时钟（如GPS接收器）同步，也可通过手动输入（手表和键盘）同步；还能作为NTPv4（RFC 5905）服务器或对等节点，为网络中的其他计算机提供时间服务。

镜像信息

支持的平台：

bash
$ docker run --rm mplatform/mquery socheatsok78/chrony:latest

# Image: socheatsok78/chrony:latest
#  * Manifest List: Yes (Image type: application/vnd.oci.image.index.v1+json)
#  * Supported platforms:
#    - linux/amd64
#    - linux/arm64

版本发布

版本方案基于Alpine发行版，与基础镜像版本保持一致，通过https://github.com/marketplace/actions/alpine-matrix-action%E7%94%9F%E6%88%90%E6%9E%84%E5%BB%BA%E7%9F%A9%E9%98%B5%E3%80%82

当前可用版本：

• latest
• edge
• 3.20
• 3.19

[!IMPORTANT] 版本每周自动更新，若基础镜像有新版本，将跟随构建并推送对应版本。

使用方法

bash
# 单容器运行
docker run --name=chrony \
    --publish=123:123/udp \
    --cap-add=SYS_TIME \
    --cap-add=IPC_LOCK \
  docker.xuanyuan.run/socheatsok78/chrony:3.20

# Docker Swarm集群部署
docker service create --name=chrony \
    --publish=123:123/udp \
    --cap-add=SYS_TIME \
    --cap-add=IPC_LOCK \
    --mode=global \
  socheatsok78/chrony:3.20

配置Chrony

可通过以下环境变量配置chrony：

NTP服务器配置

默认使用DEFAULT_NTP_POOL_ADDR环境变量设置NTP服务器，也可通过以下变量配置多个服务器：

• NTP_SERVER_COUNT：使用的NTP服务器数量（默认未设置）
• NTP_SERVER_#_ADDR：第#个NTP服务器地址（若NTP_SERVER_COUNT>0则必填）
• NTP_SERVER_#_NTS：是否为第#个服务器启用NTS（可选，值为true/false）

[!WARNING] 若设置NTP_SERVER_COUNT，DEFAULT_NTP_POOL_ADDR将被忽略。

Chronyd选项

• LOGLEVEL：日志级别（默认0，可选0=信息、1=警告、2=非致命错误、3=致命错误）
• NOCLIENTLOG：禁用客户端请求/响应日志（默认false，禁用后也会关闭NTP interleaved模式支持）

高级配置

部分高级配置未在此文档列出，可参考以下文件：

• https://github.com/socheatsok78/docker-chrony/raw/main/rootfs/etc/s6-overlay/scripts/chronyd-init
• https://github.com/socheatsok78/docker-chrony/raw/main/rootfs/etc/s6-overlay/s6-rc.d/chronyd/run

NTP Pool项目

默认情况下，容器从NTP Pool Project提供的pool.ntp.org同步时间，可通过DEFAULT_NTP_POOL_ADDR修改默认服务器。

使用NTP Pool时，将根据位置连接Stratum 1到Stratum 4的服务器。

公共NTP服务器

其他NTP服务器：

[!NOTE] 若需Stratum One服务器，可参考：

• [***]
• [***]

监控

指标由https://github.com/SuperQ/chrony_exporter%E6%8F%90%E4%BE%9B%EF%BC%8C%E9%80%9A%E8%BF%87%609123%60%E7%AB%AF%E5%8F%A3%E7%9A%84%60/metrics%60%E8%AE%BF%E9%97%AE%EF%BC%88%E5%A6%82%60http://localhost:9123/metrics%60%EF%BC%89%E3%80%82

Grafana仪表盘可参考https://grafana.com/grafana/dashboards/***-chrony/%E3%80%82

容器能力

容器支持以下可选能力：

更新系统时间

SYS_TIME能力允许容器更新系统时间，默认未设置。添加--cap-add SYS_TIME后，chrony可按需更新系统时间；可通过SKIP_SETCAP_SYS_TIME=true禁用此功能。

锁定内存

IPC_LOCK能力允许容器锁定内存（防止交换），默认未设置。添加--cap-add IPC_LOCK后生效；可通过SKIP_SETCAP_IPC_LOCK=true禁用。

[!NOTE] 更多关于Linux能力的信息请参考https://docs.docker.com/engine/containers/run/#runtime-privilege-and-linux-capabilities%E3%80%82

重要说明

需禁用主机的“自动日期和时间”设置，避免主机自行同步时间，由容器处理时间同步。例如在Ubuntu上：

sh
# 查看NTP服务状态
timedatectl status

# 禁用NTP服务
sudo timedatectl set-ntp 0

# 启用NTP服务
sudo timedatectl set-ntp 1

许可证

基于GNU General Public License v3.0许可，详情见https://github.com/socheatsok78/docker-chrony/raw/main/LICENSE%E3%80%82