? ServerBaseUrlProvider { get; set; }
public LocalHttpServer(OrderQueryService queryService)
{
_queryService = queryService;
}
/// 是否已登录(网页靠它判断要不要唤起登录)
public bool IsLoggedIn => IsLoggedInProvider?.Invoke() ?? false;
/// 浏览器里可直接打开的地址
public string BaseUrl => $"http://localhost:{Port}";
public bool IsRunning => _listener.IsListening;
/// 启动监听;失败抛 (端口被占 / 没权限)
public void Start()
{
if (IsRunning) return;
_listener.Prefixes.Clear();
// 两个都监听:前端页面默认用 localhost,但改 VITE_LOCAL_SERVICE 用 127.0.0.1 时也得能连
// (HttpListener 只接受 "注册过的 host",否则直接 400)
_listener.Prefixes.Add($"{BaseUrl}/");
_listener.Prefixes.Add($"http://127.0.0.1:{Port}/");
_listener.Start();
_cts = new CancellationTokenSource();
_loop = Task.Run(() => AcceptLoopAsync(_cts.Token));
Log?.Invoke($"服务已启动:{BaseUrl}");
}
public void Stop()
{
if (!IsRunning) return;
try
{
_cts?.Cancel();
_listener.Stop();
_listener.Close();
}
catch (Exception ex)
{
Log?.Invoke($"停止服务时出错:{ex.Message}");
}
finally
{
Log?.Invoke("服务已停止");
}
}
private async Task AcceptLoopAsync(CancellationToken token)
{
while (!token.IsCancellationRequested && _listener.IsListening)
{
HttpListenerContext context;
try
{
context = await _listener.GetContextAsync().ConfigureAwait(false);
}
catch (Exception)
{
// Stop()/Close() 会让 GetContextAsync 抛异常,属于正常退出路径
break;
}
_ = Task.Run(() => HandleAsync(context), CancellationToken.None);
}
}
private async Task HandleAsync(HttpListenerContext context)
{
var request = context.Request;
var response = context.Response;
try
{
WriteCorsHeaders(request, response);
// 预检请求(含 PNA 预检)直接放行
if (request.HttpMethod.Equals("OPTIONS", StringComparison.OrdinalIgnoreCase))
{
response.StatusCode = 204;
response.Close();
return;
}
var path = request.Url?.AbsolutePath ?? "/";
Log?.Invoke($"{request.HttpMethod} {path} ← {request.RemoteEndPoint?.Address}");
// 网页请求唤起登录(POST,避免被浏览器的链接预取误触发)
if (path.Equals("/api/activate-login", StringComparison.OrdinalIgnoreCase))
{
if (!request.HttpMethod.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.HttpMethod.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
{
await WriteJsonAsync(response, 500, new { ok = false, message = "本机服务内部错误" }).ConfigureAwait(false);
}
catch
{
// 响应已经发出去 / 连接断了,忽略
}
}
finally
{
try
{
response.Close();
}
catch
{
// 忽略
}
}
}
///
/// 按运单下载录像:POST /api/playback/download,body { "code": "运单号" }
///
/// 网页查件页(`/local?code=`)用:**任何装了本机软件的电脑**都能查件并下载录像,
/// 存到**这台电脑自己设置的目录**(`~/packVideo/年/月/日/`),跟"是不是设备服务器"无关。
///
private async Task HandlePlaybackDownloadAsync(HttpListenerRequest request, HttpListenerResponse response)
{
if (!request.HttpMethod.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
{
using var reader = new StreamReader(request.InputStream, request.ContentEncoding ?? Encoding.UTF8);
var body = await reader.ReadToEndAsync().ConfigureAwait(false);
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(HttpListenerRequest request, HttpListenerResponse response)
{
// 回显 Origin(比写死 * 更稳:以后要带 cookie/凭据也能用)
var origin = request.Headers["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.Headers["Access-Control-Request-Private-Network"], "true", StringComparison.OrdinalIgnoreCase))
{
response.Headers["Access-Control-Allow-Private-Network"] = "true";
}
}
private static async Task WriteJsonAsync(HttpListenerResponse 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(HttpListenerResponse response, int statusCode, string html)
{
await WriteTextAsync(response, statusCode, "text/html; charset=utf-8", html).ConfigureAwait(false);
}
private static async Task WriteTextAsync(HttpListenerResponse response, int statusCode, string contentType, string body)
{
var bytes = Encoding.UTF8.GetBytes(body);
response.StatusCode = statusCode;
response.ContentType = contentType;
response.ContentEncoding = Encoding.UTF8;
response.Headers["Cache-Control"] = "no-store";
response.ContentLength64 = bytes.Length;
await response.OutputStream.WriteAsync(bytes).ConfigureAwait(false);
}
public void Dispose()
{
Stop();
_cts?.Dispose();
_listener.Close();
}
}