easzlab/chrony

chrony Docker镜像文档

概述

本镜像为基于Alpine Linux构建的chrony时间同步服务镜像，主要用于kubeasz项目（https://github.com/easzlab/kubeasz%EF%BC%89%E7%9A%84%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%E6%B5%81%E7%A8%8B%EF%BC%8C%E6%8F%90%E4%BE%9B%E8%BD%BB%E9%87%8F%E7%BA%A7%E3%80%81%E9%AB%98%E6%95%88%E7%9A%84%E7%BD%91%E7%BB%9C%E6%97%B6%E9%97%B4%E5%8D%8F%E8%AE%AE%EF%BC%88NTP%EF%BC%89%E6%9C%8D%E5%8A%A1%EF%BC%8C%E7%A1%AE%E4%BF%9D%E5%AE%B9%E5%99%A8%E5%8C%96%E7%8E%AF%E5%A2%83%E4%B8%AD%E7%9A%84%E6%97%B6%E9%97%B4%E5%87%86%E7%A1%AE%E6%80%A7%E3%80%82

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 时间同步服务：集成chrony工具，支持NTP客户端和服务器模式
• 自动构建支持：专为kubeasz项目设计，满足其自动构建镜像需求
• 环境兼容性：适用于各类容器化环境，尤其适合Kubernetes集群部署

使用场景

• kubeasz项目部署的Kubernetes集群节点时间同步
• 需要精确时间同步的容器化应用场景
• 作为轻量级NTP服务器为局域网提供时间服务

使用方法

基本运行命令

bash
docker run -d --name chrony --restart always --cap-add SYS_TIME easzlab/chrony:latest

自定义配置

通过挂载配置文件实现自定义chrony配置：

bash
docker run -d --name chrony --restart always --cap-add SYS_TIME \
  -v /path/to/chrony.conf:/etc/chrony/chrony.conf \
  easzlab/chrony:latest

docker-compose配置示例

yaml
version: '3'
services:
  chrony:
    image: easzlab/chrony:latest
    container_name: chrony
    restart: always
    cap_add:
      - SYS_TIME  # 必需权限，允许调整系统时间
    volumes:
      - ./chrony.conf:/etc/chrony/chrony.conf  # 自定义配置文件
    ports:
      - "123:123/udp"  # NTP服务默认端口

注意事项

• 运行容器时必须添加--cap-add SYS_TIME权限，以允许容器调整系统时间
• 建议根据实际网络环境修改chrony配置文件中的NTP服务器列表
• 镜像版本标签请参考kubeasz项目官方文档获取最新稳定版本
• 如需持久化配置，建议通过卷挂载方式管理chrony配置文件