using System; using System.Text; using System.Text.Json; using System.Threading.Tasks; namespace YuncangTrace.LocalService.Services; /// /// 本机 HTTP 服务(只监听 127.0.0.1) /// /// 给浏览器里的页面调用(我们的 `/local` 公共页、以及任何想取数据的前端): /// - GET /api/query/{code} 查信息;**同时把服务/登录状态一起返回**(没登录回 401 `state:need-login`), /// 页面一次请求就能决定「展示结果」还是「提示唤起」,不再需要单独的探活接口; /// - POST /api/activate-login 把登录窗/主界面叫到前台。 /// /// ⚠️ 两个坑(都在这里处理好了): /// 1. **CORS**:页面同源是站点域名,请求本机属于跨域,必须回 /// `Access-Control-Allow-Origin` 等头,否则浏览器直接拦掉(表现像「服务没启动」); /// 2. **Private Network Access**:公网 https 页面访问 localhost 时,Chrome 会先发 /// 带 `Access-Control-Request-Private-Network: true` 的预检,必须回 /// `Access-Control-Allow-Private-Network: true`,否则预检失败。 /// /// 监听用 (自建 TcpListener,127.0.0.1 + ::1)。 /// **不要改回 **:它依赖 HTTP.sys,现场机器上 HTTP 服务被禁用/卡住时 /// 会抛「句柄无效(6)」,本机服务直接起不来(2026-10-23 升级 1.0.113 后的现场故障)。 /// public sealed class LocalHttpServer : IDisposable { /// 监听端口(前端/插件里写死的 17300;可用 YUNCANG_LOCAL_PORT 临时覆盖,便于自测) public static int Port { get; } = ResolvePort(); private static int ResolvePort() { var raw = Environment.GetEnvironmentVariable("YUNCANG_LOCAL_PORT"); return int.TryParse(raw, out var port) && port is > 0 and < 65536 ? port : 17300; } private readonly LoopbackHttpServer _listener; private readonly OrderQueryService _queryService; /// /// 「按运单下载录像」服务(网页查件页也会调) /// /// 不注入时为 null → 接口回 503(老版本/没装 ffmpeg 的环境)。 /// public PlaybackDownloadService? PlaybackDownload { get; set; } /// 日志回调(服务线程 → UI 线程的桥,UI 那边自己 Dispatcher.Invoke) public event Action? Log; /// 网页请求唤起登录(`POST /api/activate-login`);服务线程触发,订阅方自己切 UI 线程 public event Action? LoginRequested; /// 当前是否已登录(由 App 提供,随 `/api/query` 一起返回) public Func? IsLoggedInProvider { get; set; } /// 当前登录用户显示名(由 App 提供,随 `/api/query` 一起返回) public Func? UserNameProvider { get; set; } /// 当前后端地址(由 App 提供,随 `/api/query` 一起返回,排障用) public Func? ServerBaseUrlProvider { get; set; } public LocalHttpServer(OrderQueryService queryService) { _queryService = queryService; _listener = new LoopbackHttpServer(Port, HandleAsync, message => Log?.Invoke(message)); } /// 是否已登录(网页靠它判断要不要唤起登录) public bool IsLoggedIn => IsLoggedInProvider?.Invoke() ?? false; /// 浏览器里可直接打开的地址 public string BaseUrl => $"http://localhost:{Port}"; public bool IsRunning => _listener.IsRunning; /// 启动监听;端口被占/被拦抛 public void Start() { if (IsRunning) return; // 127.0.0.1 和 ::1 都监听:前端默认写 localhost,换 VITE_LOCAL_SERVICE 用 127.0.0.1 时也得能连 _listener.Start(); Log?.Invoke($"服务已启动:{BaseUrl}"); } public void Stop() { if (!IsRunning) return; try { _listener.Stop(); } catch (Exception ex) { Log?.Invoke($"停止服务时出错:{ex.Message}"); } finally { Log?.Invoke("服务已停止"); } } private async Task HandleAsync(LocalHttpRequest request, LocalHttpResponse response) { try { WriteCorsHeaders(request, response); // 预检请求(含 PNA 预检)直接放行 if (request.Method.Equals("OPTIONS", StringComparison.OrdinalIgnoreCase)) { await response.WriteBytesAsync(204, null, Array.Empty()).ConfigureAwait(false); return; } var path = request.Path; Log?.Invoke($"{request.Method} {path} ← {request.RemoteAddress}"); // 网页请求唤起登录(POST,避免被浏览器的链接预取误触发) if (path.Equals("/api/activate-login", StringComparison.OrdinalIgnoreCase)) { if (!request.Method.Equals("POST", StringComparison.OrdinalIgnoreCase)) { await WriteJsonAsync(response, 405, new { ok = false, message = "请用 POST" }).ConfigureAwait(false); return; } Log?.Invoke("网页请求唤起登录"); LoginRequested?.Invoke(); await WriteJsonAsync(response, 200, new { ok = true, loggedIn = IsLoggedIn, message = IsLoggedIn ? "已登录,已把主界面唤到前台" : "已请求本机软件显示登录窗口", }).ConfigureAwait(false); return; } // ⚠️ 海康相关(拉通道 / 实时预览 / 云台 / 满帧率窗口)已全部迁到 WS 17301(LocalWsServer),这里不再提供。 // 按运单下载录像:POST /api/playback/download { code } // 网页查件页(/local?code=)用 —— 任何装了本机软件的电脑都能下,存到本机设置的目录 if (path.Equals("/api/playback/download", StringComparison.OrdinalIgnoreCase)) { await HandlePlaybackDownloadAsync(request, response).ConfigureAwait(false); return; } if (!request.Method.Equals("GET", StringComparison.OrdinalIgnoreCase)) { // 只剩 GET 接口了;旧的 POST /api/hik/* 会走到这里(预览/云台/拉通道已迁到 WS 17301) await WriteJsonAsync(response, 404, new { ok = false, state = "not-found", message = "接口不存在(拉通道 / 预览 / 云台已迁到 WebSocket 17301)", }).ConfigureAwait(false); return; } const string queryPrefix = "/api/query/"; if (path.StartsWith(queryPrefix, StringComparison.OrdinalIgnoreCase)) { // 一个接口把「软件在跑吗 / 登录了吗 / 查到什么」全返回 —— // 网页只发一次请求就能决定展示结果还是提示“唤起”,不会出现“探活通过、真正查询时软件已退出”的错位。 var code = Uri.UnescapeDataString(path[queryPrefix.Length..]).Trim(); var loggedIn = IsLoggedIn; var user = UserNameProvider?.Invoke(); var env = BuildInfo.Environment; var server = ServerBaseUrlProvider?.Invoke(); if (!loggedIn) { await WriteJsonAsync(response, 401, new { ok = false, state = "need-login", code, loggedIn = false, user, env, server, message = "本机软件未登录,请先在软件里登录", }).ConfigureAwait(false); return; } var result = (await _queryService.QueryAsync(code).ConfigureAwait(false)).Http; if (result.Ok) { await WriteJsonAsync(response, 200, new { ok = true, state = "ok", code, loggedIn, user, env, server, data = result.Data, }).ConfigureAwait(false); return; } var state = result.StatusCode switch { 400 => "bad-request", 404 => "not-found", 401 => "need-login", _ => "error", }; await WriteJsonAsync(response, result.StatusCode, new { ok = false, state, code, loggedIn, user, env, server, message = result.Message, }).ConfigureAwait(false); return; } // 浏览器直接打开本机服务时给一个说明页(方便排查、也是手工测试入口) if (path == "/" || path.Equals("/index.html", StringComparison.OrdinalIgnoreCase)) { var html = """ 云仓视频溯源软件(本机服务)

云仓视频溯源软件(本机服务)

服务运行中,只监听本机(127.0.0.1:17300)。

  • /api/query/{运单号} 查询(同时返回服务/登录状态;没登录回 401)
  • POST /api/activate-login 把登录窗叫到前台
  • POST /api/playback/download 按运单下载录像

拉通道 / 实时预览 / 云台 / 满帧率窗口走 WebSocket:ws://127.0.0.1:17301

"""; await WriteHtmlAsync(response, 200, html).ConfigureAwait(false); return; } await WriteJsonAsync(response, 404, new { ok = false, message = "接口不存在" }).ConfigureAwait(false); } catch (Exception ex) { Log?.Invoke($"处理请求出错:{ex.Message}"); try { // 已经回过响应就不要再写一遍(会变成两个响应头拼在一条连接上) if (!response.Sent) { await WriteJsonAsync(response, 500, new { ok = false, message = "本机服务内部错误" }).ConfigureAwait(false); } } catch { // 响应已经发出去 / 连接断了,忽略 } } finally { // 连接由 LoopbackHttpServer 在响应写完后关闭;这里不需要(也不应该)再 Close } } /// /// 按运单下载录像:POST /api/playback/download,body { "code": "运单号" } /// /// 网页查件页(`/local?code=`)用:**任何装了本机软件的电脑**都能查件并下载录像, /// 存到**这台电脑自己设置的目录**(`~/packVideo/年/月/日/`),跟"是不是设备服务器"无关。 /// private async Task HandlePlaybackDownloadAsync(LocalHttpRequest request, LocalHttpResponse response) { if (!request.Method.Equals("POST", StringComparison.OrdinalIgnoreCase)) { await WriteJsonAsync(response, 405, new { ok = false, message = "请用 POST" }).ConfigureAwait(false); return; } if (!IsLoggedIn) { await WriteJsonAsync(response, 401, new { ok = false, state = "need-login", loggedIn = false, message = "本机软件未登录,请先在软件里登录", }).ConfigureAwait(false); return; } var service = PlaybackDownload; if (service is null) { await WriteJsonAsync(response, 503, new { ok = false, state = "unsupported", message = "本机软件没有启用录像下载(请升级到 1.0.54+)", }).ConfigureAwait(false); return; } string code; try { var body = Encoding.UTF8.GetString(request.Body); using var document = JsonDocument.Parse(string.IsNullOrWhiteSpace(body) ? "{}" : body); code = ReadJsonString(document.RootElement, "code") ?? string.Empty; } catch (JsonException) { await WriteJsonAsync(response, 400, new { ok = false, message = "请求体不是合法 JSON" }).ConfigureAwait(false); return; } if (string.IsNullOrWhiteSpace(code)) { await WriteJsonAsync(response, 400, new { ok = false, message = "缺少运单号(code)" }).ConfigureAwait(false); return; } var started = DateTime.UtcNow; Log?.Invoke($"网页请求下载录像:{code}"); try { var result = await service.DownloadAsync(code.Trim()).ConfigureAwait(false); await WriteJsonAsync(response, 200, new { ok = true, state = "ok", code, folder = result.Folder, merged = result.Merged, segments = result.Segments, warnings = result.Warnings, elapsedMs = (int)(DateTime.UtcNow - started).TotalMilliseconds, }).ConfigureAwait(false); } catch (InvalidOperationException ex) { // 「没有可下载的流 / 未登录 / 密码没填」这类,直接把话说清楚 await WriteJsonAsync(response, 400, new { ok = false, state = "bad-request", message = ex.Message, }).ConfigureAwait(false); } catch (Exception ex) { Log?.Invoke($"下载录像失败:{ex.Message}"); await WriteJsonAsync(response, 500, new { ok = false, state = "error", message = ex.Message, }).ConfigureAwait(false); } } private static string? ReadJsonString(JsonElement root, string name) => root.TryGetProperty(name, out var element) && element.ValueKind == JsonValueKind.String ? element.GetString() : null; /// CORS + 私有网络访问(PNA)头 private static void WriteCorsHeaders(LocalHttpRequest request, LocalHttpResponse response) { // 回显 Origin(比写死 * 更稳:以后要带 cookie/凭据也能用) var origin = request.Header("Origin"); response.Headers["Access-Control-Allow-Origin"] = string.IsNullOrEmpty(origin) ? "*" : origin; response.Headers["Vary"] = "Origin"; // 只剩 GET / POST;漏了 POST 会导致预检直接失败(现象:网页报 CORS、实际服务在跑) response.Headers["Access-Control-Allow-Methods"] = "GET, POST, OPTIONS"; response.Headers["Access-Control-Allow-Headers"] = "Content-Type, Accept"; response.Headers["Access-Control-Max-Age"] = "600"; // 公网页面访问 localhost 时,Chrome 会带 Access-Control-Request-Private-Network: true if (string.Equals(request.Header("Access-Control-Request-Private-Network"), "true", StringComparison.OrdinalIgnoreCase)) { response.Headers["Access-Control-Allow-Private-Network"] = "true"; } } private static async Task WriteJsonAsync(LocalHttpResponse response, int statusCode, object? payload) { var body = JsonUtil.ToJson(payload); await WriteTextAsync(response, statusCode, "application/json; charset=utf-8", body).ConfigureAwait(false); } private static async Task WriteHtmlAsync(LocalHttpResponse response, int statusCode, string html) { await WriteTextAsync(response, statusCode, "text/html; charset=utf-8", html).ConfigureAwait(false); } private static async Task WriteTextAsync(LocalHttpResponse response, int statusCode, string contentType, string body) { response.Headers["Cache-Control"] = "no-store"; await response.WriteTextAsync(statusCode, contentType, body).ConfigureAwait(false); } public void Dispose() { Stop(); _listener.Dispose(); } }