using System; using System.Linq; using System.Net; using System.Net.Sockets; using System.Threading; using System.Threading.Tasks; namespace YuncangTrace.LocalService.Services; /// 一次 SNTP 查询的结果 /// 使用的 NTP 服务器(用户填的地址) /// 服务器给出的当前时间(本地时区表示) /// 服务器时间 - 本机时间(正数表示本机慢了) /// 一次 UDP 往返耗时 public sealed record NtpResult(string Server, DateTimeOffset ServerTime, TimeSpan Offset, TimeSpan RoundTrip); /// /// 极简 SNTP 客户端(UDP 123,RFC 2030 / 4330),不依赖 Windows 时间服务。 /// /// 为什么自己实现:现场很多电脑的 Windows Time 服务根本没启动(`w32tm` 报 0x80070426), /// 时间慢慢漂到差十秒;而回放是按录像机时间定位的,差几秒就会把面单截掉。 /// 这里直接向 NTP 服务器取时间,由本软件写回系统时钟;写时钟需要管理员权限, /// 非管理员时由 拉起提权 helper 完成。 /// public static class NtpClient { /// NTP 的 1900-01-01 到 1970-01-01 之间的秒数 private const uint NtpEpochOffset = 2208988800u; /// 默认端口 public const int NtpPort = 123; /// /// 查询 NTP 服务器时间。 /// /// 域名或 IP(如 ntp.aliyun.com / 112.124.21.102) /// 超时(毫秒) public static async Task QueryAsync(string server, int timeoutMs = 3000, CancellationToken ct = default) { var host = (server ?? string.Empty).Trim(); if (host.Length == 0) throw new ArgumentException("请填写 NTP 服务器地址"); var addresses = await Dns.GetHostAddressesAsync(host, ct).ConfigureAwait(false); var address = addresses.FirstOrDefault(item => item.AddressFamily == AddressFamily.InterNetwork) ?? addresses.FirstOrDefault() ?? throw new InvalidOperationException($"解析不到 NTP 服务器:{host}"); using var udp = new UdpClient(address.AddressFamily); udp.Connect(address, NtpPort); // LI = 0(无闰秒警告),VN = 3,Mode = 3(客户端) var request = new byte[48]; request[0] = 0x1B; using var timeout = CancellationTokenSource.CreateLinkedTokenSource(ct); timeout.CancelAfter(timeoutMs); try { var t1 = DateTime.UtcNow; await udp.SendAsync(request.AsMemory(), timeout.Token).ConfigureAwait(false); var response = await udp.ReceiveAsync(timeout.Token).ConfigureAwait(false); var t4 = DateTime.UtcNow; var data = response.Buffer; if (data.Length < 48) throw new InvalidOperationException("NTP 响应格式不正确(长度不足 48 字节)"); // 服务器发包时间(Transmit Timestamp,bytes 40~47) var seconds = ((uint)data[40] << 24 | (uint)data[41] << 16 | (uint)data[42] << 8 | data[43]) - NtpEpochOffset; var fraction = ((uint)data[44] << 24 | (uint)data[45] << 16 | (uint)data[46] << 8 | data[47]) / 4294967296.0; var serverUtc = DateTime.UnixEpoch.AddSeconds(seconds + fraction); // 用「本机发送/接收的中点」估算单程延迟,得到偏差 var midpoint = t1.AddTicks((t4 - t1).Ticks / 2); var offset = serverUtc - midpoint; var result = new NtpResult(host, new DateTimeOffset(serverUtc, TimeSpan.Zero).ToLocalTime(), offset, t4 - t1); return result; } catch (OperationCanceledException) when (!ct.IsCancellationRequested) { throw new TimeoutException($"连接 NTP 服务器超时({host}:{NtpPort},{timeoutMs} ms)"); } } }