现场机器上 HTTP 服务被安全软件/系统优化禁用或卡在 STOP_PENDING 时, HttpListener.Start() 抛「句柄无效(6)」,HTTP 17300 与 WS 17301 会同时起不来 (2026-10-23 升级 1.0.113 后的现场故障)。 - 新增 LoopbackHttpServer:TcpListener 直接监听 127.0.0.1 + ::1,自己解析 HTTP/1.1 请求, Host 不是回环地址的直接断开;不需要 urlacl / 管理员权限 - LocalHttpServer 改用它,请求处理不再直接摸 HttpListener 类型 - LocalWsServer 在同一层自己完成 WebSocket 握手(Sec-WebSocket-Accept), 再交给 WebSocket.CreateFromStream;关闭时 CloseReceived 也回一帧 Close, 避免浏览器报「未完成关闭握手」 - 启动失败的提示改成按 SocketError 判断(端口占用 / 无权限) - 已回过响应后不再兜底写 500(否则一条连接上会出现两个响应头) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
422 lines
17 KiB
C#
422 lines
17 KiB
C#
using System;
|
||
using System.Text;
|
||
using System.Text.Json;
|
||
using System.Threading.Tasks;
|
||
|
||
namespace YuncangTrace.LocalService.Services;
|
||
|
||
/// <summary>
|
||
/// 本机 HTTP 服务(只监听 127.0.0.1)
|
||
///
|
||
/// 给浏览器里的页面调用(我们的 `/local` 公共页、以及任何想取数据的前端):
|
||
/// - <c>GET /api/query/{code}</c> 查信息;**同时把服务/登录状态一起返回**(没登录回 401 `state:need-login`),
|
||
/// 页面一次请求就能决定「展示结果」还是「提示唤起」,不再需要单独的探活接口;
|
||
/// - <c>POST /api/activate-login</c> 把登录窗/主界面叫到前台。
|
||
///
|
||
/// ⚠️ 两个坑(都在这里处理好了):
|
||
/// 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`,否则预检失败。
|
||
///
|
||
/// 监听用 <see cref="LoopbackHttpServer"/>(自建 TcpListener,127.0.0.1 + ::1)。
|
||
/// **不要改回 <see cref="HttpListener"/>**:它依赖 HTTP.sys,现场机器上 HTTP 服务被禁用/卡住时
|
||
/// 会抛「句柄无效(6)」,本机服务直接起不来(2026-10-23 升级 1.0.113 后的现场故障)。
|
||
/// </summary>
|
||
public sealed class LocalHttpServer : IDisposable
|
||
{
|
||
/// <summary>监听端口(前端/插件里写死的 17300;可用 <c>YUNCANG_LOCAL_PORT</c> 临时覆盖,便于自测)</summary>
|
||
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;
|
||
|
||
/// <summary>
|
||
/// 「按运单下载录像」服务(网页查件页也会调)
|
||
///
|
||
/// 不注入时为 null → 接口回 503(老版本/没装 ffmpeg 的环境)。
|
||
/// </summary>
|
||
public PlaybackDownloadService? PlaybackDownload { get; set; }
|
||
|
||
/// <summary>日志回调(服务线程 → UI 线程的桥,UI 那边自己 Dispatcher.Invoke)</summary>
|
||
public event Action<string>? Log;
|
||
|
||
/// <summary>网页请求唤起登录(`POST /api/activate-login`);服务线程触发,订阅方自己切 UI 线程</summary>
|
||
public event Action? LoginRequested;
|
||
|
||
/// <summary>当前是否已登录(由 App 提供,随 `/api/query` 一起返回)</summary>
|
||
public Func<bool>? IsLoggedInProvider { get; set; }
|
||
|
||
/// <summary>当前登录用户显示名(由 App 提供,随 `/api/query` 一起返回)</summary>
|
||
public Func<string?>? UserNameProvider { get; set; }
|
||
|
||
/// <summary>当前后端地址(由 App 提供,随 `/api/query` 一起返回,排障用)</summary>
|
||
public Func<string?>? ServerBaseUrlProvider { get; set; }
|
||
|
||
public LocalHttpServer(OrderQueryService queryService)
|
||
{
|
||
_queryService = queryService;
|
||
_listener = new LoopbackHttpServer(Port, HandleAsync, message => Log?.Invoke(message));
|
||
}
|
||
|
||
/// <summary>是否已登录(网页靠它判断要不要唤起登录)</summary>
|
||
public bool IsLoggedIn => IsLoggedInProvider?.Invoke() ?? false;
|
||
|
||
/// <summary>浏览器里可直接打开的地址</summary>
|
||
public string BaseUrl => $"http://localhost:{Port}";
|
||
|
||
public bool IsRunning => _listener.IsRunning;
|
||
|
||
/// <summary>启动监听;端口被占/被拦抛 <see cref="System.Net.Sockets.SocketException"/></summary>
|
||
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<byte>()).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 = """
|
||
<!doctype html><meta charset="utf-8">
|
||
<title>云仓视频溯源软件(本机服务)</title>
|
||
<style>body{font:14px/1.7 "Microsoft YaHei UI",sans-serif;margin:40px;color:#1f2430}
|
||
code{background:#f3f4f6;padding:1px 6px;border-radius:5px}a{color:#2563eb}</style>
|
||
<h2>云仓视频溯源软件(本机服务)</h2>
|
||
<p>服务运行中,只监听本机(127.0.0.1:17300)。</p>
|
||
<ul>
|
||
<li><code>/api/query/{运单号}</code> 查询(同时返回服务/登录状态;没登录回 401)</li>
|
||
<li><code>POST /api/activate-login</code> 把登录窗叫到前台</li>
|
||
<li><code>POST /api/playback/download</code> 按运单下载录像</li>
|
||
</ul>
|
||
<p>拉通道 / 实时预览 / 云台 / 满帧率窗口走 WebSocket:<code>ws://127.0.0.1:17301</code></p>
|
||
""";
|
||
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
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// 按运单下载录像:<c>POST /api/playback/download</c>,body <c>{ "code": "运单号" }</c>
|
||
///
|
||
/// 网页查件页(`/local?code=`)用:**任何装了本机软件的电脑**都能查件并下载录像,
|
||
/// 存到**这台电脑自己设置的目录**(`~/packVideo/年/月/日/`),跟"是不是设备服务器"无关。
|
||
/// </summary>
|
||
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;
|
||
|
||
/// <summary>CORS + 私有网络访问(PNA)头</summary>
|
||
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();
|
||
}
|
||
}
|