把海康取流从扫码服务主进程拆到 --hik-worker 子进程,原生 SDK 崩溃
不再连带扫码收码;新增局域网询问-应答与跨网下载通道。
隔离与守护
- 新增 HikWorker(子进程):独占 HCNetSDK 与 NVR 会话池
- 新增 HikWorkerSupervisor(主进程):懒启动、管道通信、
5 分钟内失败 3 次熔断 10 分钟
- 管道协议为 [4 字节长度][JSON],进程退出即知,不占端口
- ServiceInstaller 复制 native(HCNetSDK/ffmpeg),先删后拷,
避免 SDK 升级残留旧 DLL;安装时放行 TCP 17311 / UDP 17310
局域网询问-应答(不是主动公告)
- UDP 17310 收询问,只回同 subjectId;带了 nvrHosts 时先实测可达,
连不上就不应答,让查询机继续走本机
- 应答带 TCP 17311,查询机一次连接即可判定是否同 LAN
跨网下载
- TCP 17311 提供 /health、/probe、/download、/download/{id}
- 除 /health 外均要求 X-Edge-Subject 且与配置主体一致
- 成片在传输完成后立即删除,另有 done 10 分钟 / failed 15 分钟
TTL 兜底,避免现场磁盘被临时文件吃满
桌面端选路
- DownloadAsync 先探 NVR 8000(600ms):通则沿用原有本机直连,
不通才广播找取流服务,取回后落到本机录像目录
- DownloadByPlanAsync 拆分:不查库、不需要用户令牌,
供只有设备令牌的服务端复用
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
282 lines
9.6 KiB
C#
282 lines
9.6 KiB
C#
using System;
|
||
using System.Collections.Generic;
|
||
using System.IO;
|
||
using System.Text.Json;
|
||
|
||
namespace YuncangTrace.LocalService.Services;
|
||
|
||
/// <summary>后台服务的配置(`%ProgramData%\YuncangTrace\agent.json`,由桌面端写入)</summary>
|
||
public sealed class AgentConfig
|
||
{
|
||
/// <summary>后端根地址(例如 http://127.0.0.1:7300)</summary>
|
||
public string ServerBaseUrl { get; set; } = "";
|
||
|
||
/// <summary>设备**长期 JWT**(默认 365 天,服务上报扫码用)</summary>
|
||
public string DeviceToken { get; set; } = "";
|
||
|
||
/// <summary>刷新令牌(服务在访问令牌快过期时自动续期)</summary>
|
||
public string RefreshToken { get; set; } = "";
|
||
|
||
public string DeviceSn { get; set; } = "";
|
||
public int DeviceId { get; set; }
|
||
public int SubjectId { get; set; }
|
||
|
||
// ---------------- NTP(服务以 LocalSystem 运行,改系统时间不需要 UAC) ----------------
|
||
|
||
public bool NtpEnabled { get; set; } = true;
|
||
public string NtpServer { get; set; } = "ntp.aliyun.com";
|
||
public int NtpIntervalMinutes { get; set; } = 30;
|
||
|
||
/// <summary>写入时间(排查用)</summary>
|
||
public DateTime UpdatedAt { get; set; } = DateTime.Now;
|
||
}
|
||
|
||
/// <summary>后台服务的令牌文件(`agent-token.json`;服务自动续期后更新)</summary>
|
||
public sealed class AgentToken
|
||
{
|
||
public string DeviceToken { get; set; } = "";
|
||
public string RefreshToken { get; set; } = "";
|
||
public DateTime? ExpiresAt { get; set; }
|
||
public DateTime? RefreshExpiresAt { get; set; }
|
||
public DateTime UpdatedAt { get; set; } = DateTime.Now;
|
||
}
|
||
|
||
/// <summary>后台服务的运行状态(桌面端只读展示)</summary>
|
||
public sealed class AgentStatus
|
||
{
|
||
public bool Running { get; set; }
|
||
public string Version { get; set; } = "";
|
||
public string DeviceSn { get; set; } = "";
|
||
public int SubjectId { get; set; }
|
||
|
||
public string UploadStatus { get; set; } = "";
|
||
public string ChannelSyncStatus { get; set; } = "";
|
||
public int PendingRecords { get; set; }
|
||
|
||
public List<AgentChannelStatus> Channels { get; set; } = new();
|
||
|
||
public string? LastError { get; set; }
|
||
|
||
/// <summary>取流子进程(--hik-worker)状态;没有取流能力时 <see cref="AgentHikStatus.Available"/> 为 false</summary>
|
||
public AgentHikStatus Hik { get; set; } = new();
|
||
|
||
public string NtpLastSyncAt { get; set; } = "";
|
||
public double NtpLastOffsetSeconds { get; set; }
|
||
public double NtpRoundTripMs { get; set; }
|
||
public DateTime? NtpServerTime { get; set; }
|
||
|
||
/// <summary>当前访问令牌到期时间</summary>
|
||
public DateTime? TokenExpiresAt { get; set; }
|
||
|
||
/// <summary>刷新令牌到期时间</summary>
|
||
public DateTime? RefreshTokenExpiresAt { get; set; }
|
||
|
||
/// <summary>最近一次续期时间</summary>
|
||
public DateTime? LastTokenRefreshAt { get; set; }
|
||
|
||
/// <summary>最近一次续期失败原因(成功则 null)</summary>
|
||
public string? LastTokenRefreshError { get; set; }
|
||
|
||
/// <summary>最近一次成功心跳时间</summary>
|
||
public DateTime? LastHeartbeatAt { get; set; }
|
||
|
||
/// <summary>最近一次心跳失败原因(成功则 null)</summary>
|
||
public string? LastHeartbeatError { get; set; }
|
||
|
||
public DateTime UpdatedAt { get; set; } = DateTime.Now;
|
||
}
|
||
|
||
/// <summary>服务里某条通道的**运行时状态**(连接/最近条码),桌面端据此显示在线离线</summary>
|
||
public sealed class AgentChannelStatus
|
||
{
|
||
public string Mac { get; set; } = "";
|
||
public bool Connected { get; set; }
|
||
public string LastIp { get; set; } = "";
|
||
public string LastCode { get; set; } = "";
|
||
public DateTime? LastCodeAt { get; set; }
|
||
}
|
||
|
||
/// <summary>
|
||
/// 取流子进程的运行时状态(桌面端/客服排障用)。
|
||
///
|
||
/// <see cref="Available"/> 为 false 只表示"取不到视频",**扫码/上报照常工作**。
|
||
/// </summary>
|
||
public sealed class AgentHikStatus
|
||
{
|
||
/// <summary>SDK 与 ffmpeg 是否就位(自检结果)</summary>
|
||
public bool Available { get; set; }
|
||
|
||
/// <summary>worker 进程当前是否已连接</summary>
|
||
public bool Connected { get; set; }
|
||
|
||
/// <summary>HCNetSDK.dll 所在目录(找不到为 null)</summary>
|
||
public string? SdkDir { get; set; }
|
||
|
||
/// <summary>ffmpeg.exe 路径(找不到为 null)</summary>
|
||
public string? FfmpegPath { get; set; }
|
||
|
||
/// <summary>成片根目录</summary>
|
||
public string VideoRoot { get; set; } = "";
|
||
|
||
/// <summary>连续失败熔断到什么时候(null = 未熔断)</summary>
|
||
public DateTime? BlockedUntil { get; set; }
|
||
|
||
/// <summary>最近一次失败原因</summary>
|
||
public string? LastError { get; set; }
|
||
|
||
/// <summary>最近一次自检时间</summary>
|
||
public DateTime? ProbedAt { get; set; }
|
||
}
|
||
|
||
/// <summary>桌面端 → 后台服务的一次性命令(写文件,服务每秒轮询)</summary>
|
||
public sealed class AgentCommand
|
||
{
|
||
public DateTime? TriggerUploadAt { get; set; }
|
||
public DateTime? ClearRecordsAt { get; set; }
|
||
public string? ClearChannelId { get; set; }
|
||
public DateTime? ReloadChannelsAt { get; set; }
|
||
public DateTime? NtpSyncAt { get; set; }
|
||
public string? NtpServer { get; set; }
|
||
|
||
/// <summary>请求后台服务立即用刷新令牌续期访问令牌(测试/排障用)</summary>
|
||
public DateTime? RefreshTokenAt { get; set; }
|
||
}
|
||
|
||
/// <summary>服务发现到的设备(写文件供桌面端展示;只保留必要字段)</summary>
|
||
public sealed class AgentDiscoveredDevice
|
||
{
|
||
public string Mac { get; set; } = "";
|
||
public string Ip { get; set; } = "";
|
||
public string HostName { get; set; } = "";
|
||
public string Model { get; set; } = "";
|
||
public string Firmware { get; set; } = "";
|
||
public DateTime UpdatedAt { get; set; } = DateTime.Now;
|
||
}
|
||
|
||
/// <summary>
|
||
/// agent.json / agent-status.json / agent-command.json 的读写。
|
||
///
|
||
/// 两个进程(桌面端 + 服务)会同时读写这些文件,所以:
|
||
/// - 读:<c>FileShare.ReadWrite</c>,读到一半也不会抛;
|
||
/// - 写:先写 <c>.tmp</c> 再原子替换,避免对方读到半截 JSON。
|
||
/// </summary>
|
||
public static class AgentFiles
|
||
{
|
||
private static readonly JsonSerializerOptions Options = new()
|
||
{
|
||
WriteIndented = true,
|
||
Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
|
||
};
|
||
|
||
public static AgentConfig? LoadConfig() => Read<AgentConfig>(AgentPaths.ConfigFile);
|
||
|
||
public static void SaveConfig(AgentConfig config)
|
||
{
|
||
config.UpdatedAt = DateTime.Now;
|
||
Write(AgentPaths.ConfigFile, config);
|
||
}
|
||
|
||
public static AgentToken? LoadToken() => Read<AgentToken>(AgentPaths.TokenFile);
|
||
|
||
public static void SaveToken(AgentToken token)
|
||
{
|
||
token.UpdatedAt = DateTime.Now;
|
||
Write(AgentPaths.TokenFile, token);
|
||
}
|
||
|
||
public static void ClearToken()
|
||
{
|
||
try
|
||
{
|
||
if (File.Exists(AgentPaths.TokenFile)) File.Delete(AgentPaths.TokenFile);
|
||
}
|
||
catch
|
||
{
|
||
// 删不掉不影响下次开启(会覆盖写)
|
||
}
|
||
}
|
||
|
||
public static AgentStatus? LoadStatus() => Read<AgentStatus>(AgentPaths.StatusFile);
|
||
public static void SaveStatus(AgentStatus status)
|
||
{
|
||
status.UpdatedAt = DateTime.Now;
|
||
Write(AgentPaths.StatusFile, status);
|
||
}
|
||
|
||
public static AgentCommand? LoadCommand() => Read<AgentCommand>(AgentPaths.CommandFile);
|
||
|
||
public static void SaveCommand(AgentCommand command) => Write(AgentPaths.CommandFile, command);
|
||
|
||
/// <summary>追加一条命令(保留还没被服务取走的其它命令)</summary>
|
||
public static void QueueCommand(Action<AgentCommand> apply)
|
||
{
|
||
var command = LoadCommand() ?? new AgentCommand();
|
||
apply(command);
|
||
SaveCommand(command);
|
||
}
|
||
|
||
/// <summary>服务执行完命令后清掉文件(下一条命令不会重复执行)</summary>
|
||
public static void ClearCommand()
|
||
{
|
||
try
|
||
{
|
||
if (File.Exists(AgentPaths.CommandFile)) File.Delete(AgentPaths.CommandFile);
|
||
}
|
||
catch
|
||
{
|
||
// 删不掉下次也只是重复执行一遍(幂等)
|
||
}
|
||
}
|
||
|
||
public static List<AgentDiscoveredDevice> LoadDiscovered()
|
||
=> Read<List<AgentDiscoveredDevice>>(AgentPaths.DiscoveredFile) ?? new List<AgentDiscoveredDevice>();
|
||
|
||
public static void SaveDiscovered(List<AgentDiscoveredDevice> devices)
|
||
=> Write(AgentPaths.DiscoveredFile, devices);
|
||
|
||
public static DateTime? FileTime(string path)
|
||
{
|
||
try
|
||
{
|
||
return File.Exists(path) ? File.GetLastWriteTimeUtc(path) : null;
|
||
}
|
||
catch
|
||
{
|
||
return null;
|
||
}
|
||
}
|
||
|
||
private static T? Read<T>(string path) where T : class
|
||
{
|
||
try
|
||
{
|
||
if (!File.Exists(path)) return null;
|
||
using var stream = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
|
||
using var reader = new StreamReader(stream);
|
||
var text = reader.ReadToEnd();
|
||
return string.IsNullOrWhiteSpace(text) ? null : JsonSerializer.Deserialize<T>(text, Options);
|
||
}
|
||
catch
|
||
{
|
||
return null;
|
||
}
|
||
}
|
||
|
||
private static void Write<T>(string path, T value)
|
||
{
|
||
try
|
||
{
|
||
var dir = Path.GetDirectoryName(path);
|
||
if (!string.IsNullOrEmpty(dir)) Directory.CreateDirectory(dir);
|
||
|
||
var temp = path + ".tmp";
|
||
File.WriteAllText(temp, JsonSerializer.Serialize(value, Options));
|
||
File.Move(temp, path, overwrite: true);
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
AppLog.Write($"[agent] 写文件失败({path}):{ex.Message}");
|
||
}
|
||
}
|
||
}
|