packServer/desktop/Services/Edge/EdgeDiscoveryClient.cs
liufumingren 46e4f12802 desktop: 取流子进程隔离 + 局域网询问应答 + 跨网下载
把海康取流从扫码服务主进程拆到 --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>
2026-10-21 22:48:09 +08:00

199 lines
7.0 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Sockets;
using System.Text;
using System.Text.Json;
using System.Threading;
using System.Threading.Tasks;
using YuncangTrace.LocalService.Services.Scan;
namespace YuncangTrace.LocalService.Services.Edge;
/// <summary>局域网里发现到的一台「取流服务」(即扫码服务拉起的 hik-worker)。</summary>
/// <param name="Sn">设备序列号(与 scanners.sn 对应,用于去重与排障)</param>
/// <param name="Reachable">这次询问里它实测能连通的 NVR 主机(空 = 没带 NVR 询问)</param>
public sealed record EdgePeer(
string Sn,
string Host,
int Port,
int SubjectId,
IReadOnlyList<string> Reachable,
string Version)
{
public string BaseUrl => $"http://{Host}:{Port}";
public string Display => $"{Sn}({Host}:{Port})";
}
/// <summary>
/// 局域网询问-应答的客户端(查询机这一侧)。
///
/// **只问不喊**:发一次广播询问,在同 socket 上收应答 —— 这样回包的源地址天然就是
/// 「从哪块网卡能到它」,多网卡机器不用自己猜用哪个 IP。
///
/// 询问可以带 <c>nvrHosts</c>:对面的服务会先实测能不能连到这些 NVR,
/// 连不上就不应答。所以「收到应答」= 对端确实能替你取流,而不是单纯在线。
/// </summary>
public static class EdgeDiscoveryClient
{
/// <summary>带 NVR 时给对端留出探测时间(对端最多 800ms 探测)</summary>
private static readonly TimeSpan ProbeWait = TimeSpan.FromSeconds(3);
/// <summary>不带 NVR 时只需等应答返回</summary>
private static readonly TimeSpan QuickWait = TimeSpan.FromSeconds(1);
/// <summary>
/// 找一台能处理这些 NVR 的取流服务。
/// </summary>
/// <param name="subjectId">当前主体(对端只回同主体的询问)</param>
/// <param name="nvrs">要问的 NVR(host/port);传空表示只问「有没有服务」</param>
/// <returns>多台应答时取第一台(同一 LAN 通常只有一台)</returns>
public static async Task<EdgePeer?> FindAsync(int subjectId,
IReadOnlyList<(string Host, int Port)>? nvrs,
CancellationToken ct = default)
{
if (subjectId <= 0) return null;
using var udp = new UdpClient(AddressFamily.InterNetwork);
udp.EnableBroadcast = true;
var payload = BuildQuery(subjectId, nvrs);
var bytes = Encoding.UTF8.GetBytes(payload);
foreach (var target in DeviceScanner.BroadcastTargets())
{
try
{
await udp.SendAsync(bytes, bytes.Length, new IPEndPoint(target, HikWorkerPorts.UdpQuery))
.WaitAsync(ct).ConfigureAwait(false);
}
catch (Exception ex)
{
AppLog.Write($"[edge] 广播到 {target} 失败:{ex.Message}");
}
}
var wait = nvrs is { Count: > 0 } ? ProbeWait : QuickWait;
using var timeout = CancellationTokenSource.CreateLinkedTokenSource(ct);
timeout.CancelAfter(wait);
var peers = new List<EdgePeer>();
while (!timeout.IsCancellationRequested)
{
UdpReceiveResult received;
try
{
received = await udp.ReceiveAsync(timeout.Token).ConfigureAwait(false);
}
catch (OperationCanceledException)
{
break;
}
catch (Exception ex)
{
AppLog.Write($"[edge] 接收应答失败:{ex.Message}");
break;
}
var peer = TryParseReply(received.Buffer, received.RemoteEndPoint.Address, subjectId);
if (peer is null) continue;
// 带了 NVR 询问时,对端必须确认能连通其中至少一台(它已经自己筛过,这里再兜一层)
if (nvrs is { Count: > 0 } && !HasAnyReachable(peer, nvrs)) continue;
peers.Add(peer);
}
if (peers.Count == 0) return null;
return peers.OrderBy(item => item.Sn, StringComparer.Ordinal).First();
}
private static bool HasAnyReachable(EdgePeer peer, IReadOnlyList<(string Host, int Port)> nvrs)
{
if (peer.Reachable.Count == 0) return false;
var set = new HashSet<string>(peer.Reachable, StringComparer.OrdinalIgnoreCase);
return nvrs.Any(item => set.Contains(item.Host));
}
private static string BuildQuery(int subjectId, IReadOnlyList<(string Host, int Port)>? nvrs)
{
if (nvrs is not { Count: > 0 })
{
return JsonSerializer.Serialize(new
{
type = HikWorkerDiscovery.QueryType,
subjectId,
}, HikWorkerJson.Options);
}
return JsonSerializer.Serialize(new
{
type = HikWorkerDiscovery.QueryType,
subjectId,
nvrHosts = nvrs.Select(item => new { host = item.Host, port = item.Port }).ToArray(),
}, HikWorkerJson.Options);
}
private static EdgePeer? TryParseReply(byte[] buffer, IPAddress from, int expectedSubject)
{
try
{
var text = Encoding.UTF8.GetString(buffer).TrimStart();
if (text.Length == 0 || text[0] != '{') return null;
using var doc = JsonDocument.Parse(text);
var root = doc.RootElement;
if (!root.TryGetProperty("type", out var type) || type.GetString() != HikWorkerDiscovery.ReplyType)
{
return null;
}
// 应答必须同主体:防止同 LAN 里别的主体广播回来
if (!root.TryGetProperty("subjectId", out var subjectElement)
|| !subjectElement.TryGetInt32(out var subjectId)
|| subjectId != expectedSubject)
{
return null;
}
var port = root.TryGetProperty("port", out var portElement) && portElement.TryGetInt32(out var p)
? p
: HikWorkerPorts.Http;
var reachable = new List<string>();
if (root.TryGetProperty("reachable", out var reachableElement)
&& reachableElement.ValueKind == JsonValueKind.Array)
{
foreach (var item in reachableElement.EnumerateArray())
{
var value = item.GetString();
if (!string.IsNullOrWhiteSpace(value)) reachable.Add(value);
}
}
return new EdgePeer(
GetString(root, "sn") ?? "",
from.ToString(),
port,
subjectId,
reachable,
GetString(root, "version") ?? "");
}
catch
{
return null;
}
}
private static string? GetString(JsonElement element, string name)
=> element.TryGetProperty(name, out var value) && value.ValueKind == JsonValueKind.String
? value.GetString()
: null;
}