packServer/desktop/Services/LocalHttpServer.cs
liufumingren fe8c0d62a1 chore(ports): 本机服务与边缘代理端口整体迁出 173xx
- 桌面端本机 HTTP/WS:17300/17301 → 16000/16001(前端、浏览器扩展、文档同步)
- 后台服务局域网:UDP 17310/TCP 17311 → UDP 16100/TCP 16101(16010 被向日葵占用,统一避开 160xx)
- 防火墙规则随端口更新,安装/升级时清理旧 17xxx 规则,避免继续占用别人的端口
- 桌面端版本升到 1.0.162

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-18 15:51:41 +08:00

422 lines
17 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.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>监听端口(前端/插件里写死的 16000;可用 <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 : 16000;
}
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 16001(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 16001)
await WriteJsonAsync(response, 404, new
{
ok = false,
state = "not-found",
message = "接口不存在(拉通道 / 预览 / 云台已迁到 WebSocket 16001)",
}).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:16000)。</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:16001</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();
}
}