nasagibs/onearth-time-service

OnEarth 2 Time Service Docker镜像文档

镜像概述

OnEarth 2 Time Service是一个轻量级Docker镜像，专注于提供高精度、可靠的时间同步和时间戳服务。该镜像基于最新的时间同步协议与算法构建，确保服务的准确性和稳定性，可作为各类分布式系统、服务器集群及应用程序的统一时间基准。

核心功能与特性

• 高精度时间同步：支持NTPv4协议，同步精度可达毫秒级，兼容主流时间服务器
• 时间戳服务：提供RESTful API接口，支持生成和验证高精度时间戳
• 轻量级设计：镜像体积小巧（<50MB），资源占用低，启动时间<10秒
• 高可用性：内置健康检查机制，支持自动恢复，保障服务持续运行
• 灵活配置：通过环境变量自定义同步间隔、时区、日志级别等参数

使用场景与适用范围

• 需要统一时间基准的服务器集群环境
• 分布式系统日志收集与时间序列数据分析
• ***交易、物联网设备等对时间敏感的业务系统
• 日志审计、事件溯源等需要可靠时间戳的应用
• 开发测试环境中的时间模拟与校准

使用方法与配置说明

快速启动

使用以下命令启动基础服务实例：

bash
docker run -d \
  --name onearth-time-service \
  -p 123:123/udp \  # NTP服务端口
  -p 8080:8080 \    # 时间戳API端口
  --restart unless-stopped \
  onearth/2-time-service:latest

环境变量配置

通过环境变量自定义服务行为，常用配置如下：

带自定义配置的启动示例

bash
docker run -d \
  --name onearth-time-service \
  -p 123:123/udp \
  -p 8080:8080 \
  -e SYNC_INTERVAL=1800 \
  -e TIMEZONE=Asia/Shanghai \
  -e LOG_LEVEL=DEBUG \
  -e NTP_SERVERS=cn.ntp.org.cn,ntp.aliyun.com \
  -e API_AUTH_ENABLE=true \
  -e API_KEY=your_secure_api_key \
  --restart unless-stopped \
  onearth/2-time-service:latest

时间戳API使用示例

服务启动后，可通过以下方式访问时间戳API：

获取当前时间戳（未启用认证时）：

bash
curl http://localhost:8080/api/timestamp

启用认证时：

bash
curl -H "Authorization: Bearer your_secure_api_key" \
  http://localhost:8080/api/timestamp

API响应示例：

json
{
  "timestamp": 1717267200000,
  "datetime": "2024-06-01T12:00:00+08:00",
  "timezone": "Asia/Shanghai",
  "accuracy": "±10ms"
}

注意事项

• 确保宿主机防火墙开放UDP 123和TCP 8080端口
• 生产环境建议配置自定义NTP_SERVERS以提高同步可靠性
• 高并发场景下可通过--cpus和--memory限制资源使用
• 定期更新镜像以获取最新的安全补丁和功能优化