一个安全可靠的NTP时间同步库，支持多服务器故障转移。
License
—
Deps
0
Install Size
—
Vulns
✓ 0
Published
Jun 20, 2025
Get Started
$ dotnet add package NtpSecureSyncReadme
NtpSecureSync
English Version: README.en.md
一个安全、高性能的NTP客户端库，支持NTPv3和NTPv4协议。
特性
- 支持NTPv3和NTPv4协议
- 支持多服务器故障转移
- 支持网络延迟补偿
- 支持全球时区
- 提供详细的时间同步信息
- 支持时间误差估算
- 支持NTS（计划中）
安装
dotnet add package NtpSecureSync
基本用法
// 使用默认配置（系统本地时区）
var client = new NtpClient();
var networkTime = await client.GetNetworkTimeAsync();
// 使用特定服务器
var timeFromServer = await client.GetNetworkTimeAsync("pool.ntp.org");
// 使用多个服务器（故障转移）
var servers = new[] { "time.windows.com", "time.nist.gov", "pool.ntp.org" };
var timeWithFailover = await client.GetNetworkTimeAsync(servers);
高级用法
时区支持
// 1. 使用特定时区
var options = new NtpClientOptions
{
Version = NtpVersion.Version4,
EnableNetworkDelayCompensation = true,
TargetTimeZoneId = "China Standard Time" // 中国标准时间
};
var client = new NtpClient(options);
var timeInfo = await client.GetDetailedTimeAsync("pool.ntp.org");
Console.WriteLine($"北京时间: {timeInfo.ServerTime:yyyy-MM-dd HH:mm:ss.fff}");
Console.WriteLine($"时区: {timeInfo.TimeZone.DisplayName}");
// 2. 获取可用时区列表
foreach (var tz in TimeZoneInfo.GetSystemTimeZones())
{
Console.WriteLine($"ID: {tz.Id}, 显示名称: {tz.DisplayName}");
}
// 3. 常用时区ID
// - "China Standard Time" (中国标准时间)
// - "Eastern Standard Time" (美国东部时间)
// - "UTC" (协调世界时)
// - "Tokyo Standard Time" (东京标准时间)
// - "Pacific Standard Time" (太平洋标准时间)
自定义配置
var options = new NtpClientOptions
{
Version = NtpVersion.Version4,
EnableNetworkDelayCompensation = true,
Timeout = 5000,
RetryCount = 3,
EnableNts = true,
AutoDowngrade = true,
DefaultServers = new[]
{
"time.windows.com",
"time.nist.gov"
}
};
var client = new NtpClient(options);
获取详细时间信息
var timeInfo = await client.GetDetailedTimeAsync("pool.ntp.org");
Console.WriteLine($"服务器时间: {timeInfo.ServerTime}");
Console.WriteLine($"本地时间: {timeInfo.LocalTime}");
Console.WriteLine($"时间偏移: {timeInfo.TimeOffset.TotalMilliseconds:F2}ms");
Console.WriteLine($"往返延迟: {timeInfo.RoundTripDelay.TotalMilliseconds:F2}ms");
Console.WriteLine($"估计误差: {timeInfo.EstimatedError:F2}ms");
Console.WriteLine($"服务器层次: {timeInfo.Stratum}");
Console.WriteLine($"时区: {timeInfo.TimeZone.DisplayName}");
时间缓存最佳实践
基本缓存实现
public class TimeService
{
private readonly INtpClient _ntpClient;
private NtpTimeInfo _lastTimeInfo;
private readonly object _lock = new object();
private readonly double _maxErrorThreshold; // 最大可接受误差（毫秒）
public TimeService(INtpClient ntpClient, double maxErrorThreshold = 10000)
{
_ntpClient = ntpClient;
_maxErrorThreshold = maxErrorThreshold;
}
public async Task<DateTime> GetCurrentTimeAsync()
{
try
{
// 尝试从NTP服务器获取时间
var timeInfo = await _ntpClient.GetDetailedTimeAsync("pool.ntp.org");
lock (_lock)
{
_lastTimeInfo = timeInfo;
}
return timeInfo.ServerTime;
}
catch (Exception)
{
// 如果网络不可用，使用缓存的时间信息
lock (_lock)
{
if (_lastTimeInfo != null)
{
var elapsed = DateTime.UtcNow - _lastTimeInfo.LastSyncTime;
var estimatedError = _lastTimeInfo.EstimatedError + elapsed.TotalMilliseconds;
if (estimatedError > _maxErrorThreshold)
{
throw new NtpException("缓存时间误差超过阈值");
}
// 使用缓存的时区信息
return TimeZoneInfo.ConvertTime(
DateTime.UtcNow.Add(_lastTimeInfo.TimeOffset),
TimeZoneInfo.Utc,
_lastTimeInfo.TimeZone
);
}
}
throw;
}
}
}