packServer/desktop/Services/Edge/EdgeDiscoveryClient.cs
liufumingren 11ebb33966 feat(extension): 插件配置集中管理 + 桌面端策略安装 + 跨网下载修复
- 后端:sys_config 存插件配置(识别前缀/生效站点/模板),平台管理员 GET/PUT /api/web/admin/extension;
  插件读取 GET /api/web/extension/config(Redis 缓存 1 小时,保存即失效)
- 前端:平台管理 → 插件配置页(只维护前缀,单号正则由服务端生成)
- 插件:改为只拉取执行(每 5 分钟 + 手动同步),移除规则编辑/试跑/导入导出;安装包地址自动取最新发布
- 桌面端:工具 → 安装/卸载谷歌插件(生成 .reg + reg import 写 HKLM 策略,读注册表验证);
  跨网下载改走云端中转;局域网探测补排障日志;自动更新按包类型取 md5Exe/sizeExe
- 发布:npm run extension:publish(crx + updates.xml)、extension:zip(商店上传包),
  nginx 对 /download/extension/updates.xml 关缓存

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:16:26 +08:00

299 lines
12 KiB
C#
Raw Permalink 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="server">当前后端地址(对端只回同环境的询问)</param>
/// <param name="nvrs">要问的 NVR(host/port);传空表示只问「有没有服务」</param>
/// <returns>多台应答时优先本机、再按 SN 取第一台</returns>
public static async Task<EdgePeer?> FindAsync(int subjectId, string? server,
IReadOnlyList<(string Host, int Port)>? nvrs,
CancellationToken ct = default)
{
if (subjectId <= 0) return null;
var ownServer = HikWorkerDiscovery.NormalizeServer(server);
if (ownServer.Length == 0)
{
AppLog.Write($"[edge] 本机后端地址未知(设置里的服务器地址是「{server}」),跳过局域网询问");
return null;
}
using var udp = new UdpClient(AddressFamily.InterNetwork);
udp.EnableBroadcast = true;
var payload = BuildQuery(subjectId, ownServer, nvrs);
var bytes = Encoding.UTF8.GetBytes(payload);
var targets = DeviceScanner.BroadcastTargets();
var wait = nvrs is { Count: > 0 } ? ProbeWait : QuickWait;
// 排障用:对端只回「同主体 + 同后端地址 + 能连上 NVR」的询问,
// 三条里任何一条不满足都是**静默丢弃**,现场根本看不出为什么找不到。
AppLog.Write($"[edge] 局域网询问:主体 {subjectId},后端 {ownServer},"
+ $"NVR {(nvrs is { Count: > 0 } ? string.Join("、", nvrs.Select(item => $"{item.Host}:{item.Port}")) : "(不带)")}"
+ $" → UDP {HikWorkerPorts.UdpQuery} 广播 {string.Join("、", targets)},等 {wait.TotalSeconds:0.#} 秒");
var sent = 0;
foreach (var target in targets)
{
try
{
await udp.SendAsync(bytes, bytes.Length, new IPEndPoint(target, HikWorkerPorts.UdpQuery))
.WaitAsync(ct).ConfigureAwait(false);
sent++;
}
catch (Exception ex)
{
AppLog.Write($"[edge] 广播到 {target} 失败:{ex.Message}");
}
}
using var timeout = CancellationTokenSource.CreateLinkedTokenSource(ct);
timeout.CancelAfter(wait);
var peers = new List<EdgePeer>();
var logged = new HashSet<string>(StringComparer.Ordinal);
var datagrams = 0;
var ignored = 0;
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;
}
datagrams++;
var peer = TryParseReply(received.Buffer, received.RemoteEndPoint.Address, subjectId, ownServer,
out var reason);
if (peer is null)
{
ignored++;
AppLog.Write($"[edge] 忽略 {received.RemoteEndPoint.Address} 的报文:{reason}");
continue;
}
// 带了 NVR 询问时,对端必须确认能连通其中至少一台(它已经自己筛过,这里再兜一层)
if (nvrs is { Count: > 0 } && !HasAnyReachable(peer, nvrs))
{
ignored++;
AppLog.Write($"[edge] 忽略 {peer.Sn}({peer.Host})的应答:它连不上询问的 NVR"
+ $"(它能连:{(peer.Reachable.Count == 0 ? "无" : string.Join("、", peer.Reachable))})");
continue;
}
// 同一台机器会因为「广播 + 定向广播」回多次,日志只记第一次
if (logged.Add(peer.Sn + "|" + peer.Host))
{
AppLog.Write($"[edge] 收到应答:{peer.Sn}({peer.Host}:{peer.Port}),"
+ $"可服务 {(peer.Reachable.Count == 0 ? "(未询问 NVR)" : string.Join("、", peer.Reachable))}");
}
peers.Add(peer);
}
if (peers.Count == 0)
{
AppLog.Write($"[edge] 局域网询问无结果:发出 {sent}/{targets.Count} 个广播,"
+ $"收到 {datagrams} 个报文(被忽略 {ignored} 个)");
return null;
}
// 同一台机器会因为我们发了「广播 + 各网段定向广播」而回多次,先按 (SN, 主机) 去重
var best = peers
.GroupBy(item => item.Sn + "|" + item.Host, StringComparer.Ordinal)
.Select(group => group.First())
// 多台都能服务时优先本机(自己就在这台机器上,省一次跨机转发)
.OrderByDescending(item => IsLocalAddress(item.Host))
.ThenBy(item => item.Sn, StringComparer.Ordinal)
.First();
AppLog.Write($"[edge] 局域网询问结果:选 {best.Display}(收到 {datagrams} 个报文)");
return best;
}
private static bool IsLocalAddress(string host)
{
if (IPAddress.TryParse(host, out var address) && IPAddress.IsLoopback(address)) return true;
try
{
return System.Net.NetworkInformation.NetworkInterface.GetAllNetworkInterfaces()
.SelectMany(item => item.GetIPProperties().UnicastAddresses)
.Any(item => item.Address.Equals(address ?? IPAddress.None));
}
catch
{
return false;
}
}
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, string server, IReadOnlyList<(string Host, int Port)>? nvrs)
{
if (nvrs is not { Count: > 0 })
{
return JsonSerializer.Serialize(new
{
type = HikWorkerDiscovery.QueryType,
subjectId,
server,
}, HikWorkerJson.Options);
}
return JsonSerializer.Serialize(new
{
type = HikWorkerDiscovery.QueryType,
subjectId,
server,
nvrHosts = nvrs.Select(item => new { host = item.Host, port = item.Port }).ToArray(),
}, HikWorkerJson.Options);
}
/// <param name="reason">被丢弃的原因(成功时为空)——现场排障只靠它</param>
private static EdgePeer? TryParseReply(byte[] buffer, IPAddress from, int expectedSubject, string expectedServer,
out string reason)
{
reason = string.Empty;
try
{
var text = Encoding.UTF8.GetString(buffer).TrimStart();
if (text.Length == 0 || text[0] != '{')
{
reason = $"不是 JSON:{Brief(text)}";
return null;
}
using var doc = JsonDocument.Parse(text);
var root = doc.RootElement;
if (!root.TryGetProperty("type", out var type) || type.GetString() != HikWorkerDiscovery.ReplyType)
{
reason = $"不是 {HikWorkerDiscovery.ReplyType} 报文:{Brief(text)}";
return null;
}
// 应答必须同主体:防止同 LAN 里别的主体广播回来
if (!root.TryGetProperty("subjectId", out var subjectElement)
|| !subjectElement.TryGetInt32(out var subjectId)
|| subjectId != expectedSubject)
{
reason = root.TryGetProperty("subjectId", out var rawSubject)
? $"主体不同:应答 {rawSubject.GetRawText()} ≠ 本机 {expectedSubject}"
: $"应答里没有 subjectId:{Brief(text)}";
return null;
}
// 还要同环境:主体 id 在各环境都从 1 开始,光比主体会把别环境的机器招进来
var replyServer = GetString(root, "server");
if (!string.Equals(replyServer, expectedServer, StringComparison.Ordinal))
{
reason = $"环境不同:应答 {replyServer} ≠ 本机 {expectedServer}"
+ "(设置里的「服务器地址」要和对方完全一致:协议/域名/端口)";
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 (Exception ex)
{
reason = $"解析失败:{ex.Message}";
return null;
}
}
/// <summary>报文摘要:日志只要一眼能认出来,不要整段刷屏</summary>
private static string Brief(string text)
=> text.Length <= 120 ? text : text[..120] + "…";
private static string? GetString(JsonElement element, string name)
=> element.TryGetProperty(name, out var value) && value.ValueKind == JsonValueKind.String
? value.GetString()
: null;
}