diff --git a/desktop/App.xaml.cs b/desktop/App.xaml.cs
index 352a509..b8af8d3 100644
--- a/desktop/App.xaml.cs
+++ b/desktop/App.xaml.cs
@@ -2,7 +2,7 @@ using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Linq;
-using System.Net;
+using System.Net.Sockets;
using System.Threading.Tasks;
using System.Windows;
using YuncangTrace.LocalService.Services;
@@ -534,12 +534,12 @@ public partial class App : Application
{
_server.Start();
}
- catch (HttpListenerException ex)
+ catch (SocketException ex)
{
- var hint = ex.ErrorCode switch
+ var hint = ex.SocketErrorCode switch
{
- 5 => "没有绑定端口的权限。用管理员执行一次:netsh http add urlacl url=http://localhost:17300/ user=%USERNAME%",
- 32 => "端口 17300 已被占用(可能还有一个本程序实例在跑)。",
+ SocketError.AddressAlreadyInUse => $"端口 {LocalHttpServer.Port} 已被占用(可能还有一个本程序实例在跑)。",
+ SocketError.AccessDenied => $"没有绑定端口 {LocalHttpServer.Port} 的权限(可能被安全软件拦截)。",
_ => $"启动本机服务失败:{ex.Message}",
};
AppLog.Write(hint);
@@ -551,7 +551,7 @@ public partial class App : Application
MessageBox.Show(ex.Message, "本机服务启动失败", MessageBoxButton.OK, MessageBoxImage.Warning);
}
- // WS 出问题不弹窗:网页会自动退回 HTTP 预览
+ // WS 出问题不弹窗(HTTP 侧已经弹过/记过日志了),预览与云台会不可用,只记日志
if (_wsServer is not null)
{
try
@@ -561,7 +561,7 @@ public partial class App : Application
}
catch (Exception ex)
{
- AppLog.Write($"[ws] 启动失败(网页将退回 HTTP 预览):{ex.Message}");
+ AppLog.Write($"[ws] 启动失败(网页预览/云台不可用):{ex.Message}");
}
}
diff --git a/desktop/README.md b/desktop/README.md
index 9e9fc37..960db08 100644
--- a/desktop/README.md
+++ b/desktop/README.md
@@ -23,7 +23,8 @@ desktop/
├── LoginWindow.xaml / .xaml.cs # 账号 / 密码 / 记住账号 / 自动恢复登录(不展示服务地址)
├── MainWindow.xaml / .xaml.cs # 服务状态、测试查询、菜单、退出登录
└── Services/
- ├── LocalHttpServer.cs # HttpListener(17300):查询 / 唤起登录 / 下载录像
+ ├── LocalHttpServer.cs # 本机 HTTP(17300):查询 / 唤起登录 / 下载录像
+ ├── LoopbackHttpServer.cs # 回环 HTTP/1.1 服务端(TcpListener 自实现,不依赖 HTTP.sys)
├── LocalWsServer.cs # WebSocket(17301):拉通道 / 预览推帧 / 云台 / 满帧率窗口
├── OrderQueryService.cs # ★ 按运单号查数据(接真实数据源的地方)
├── ApiClient.cs # 登录 / 校验令牌(用到的全部后端接口)
@@ -362,8 +363,12 @@ cd desktop\installer
### HTTP 17300(前端 `/local` 页用的就是这两个)
服务固定监听 `http://localhost:17300`(端口写在前端页面与插件里)。
-代码里**同时注册了 `http://127.0.0.1:17300/`** 前缀 —— `HttpListener` 只接受「注册过的 host」,
-不注册的话用 127.0.0.1 访问会直接被回 400(前端改 `VITE_LOCAL_SERVICE` 时就会碰到)。
+`LoopbackHttpServer` 直接监听 **127.0.0.1 和 ::1**,所以 `localhost` / `127.0.0.1` 两种写法都能连
+(前端改 `VITE_LOCAL_SERVICE` 时不会碰到「回 400」)。请求的 `Host` 不是回环地址会被直接断开。
+
+> ⚠️ **别改回 `HttpListener`**:它依赖 HTTP.sys。现场机器上 HTTP 服务被安全软件/系统优化禁用,
+> 或者卡在 STOP_PENDING 时,`HttpListener.Start()` 会抛 `句柄无效(6)`,HTTP 与 WS 会**同时**起不来
+> (2026-10-23 升级 1.0.113 后的现场故障就是它)。自建 TcpListener 不需要 HTTP.sys / urlacl / 管理员权限。
浏览器直接打开 会看到一个说明页(列了接口,方便排查)。
@@ -592,8 +597,9 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command"
| 现象 | 处理 |
| --- | --- |
-| 启动报「没有绑定端口的权限」/ `Access is denied (5)` | 管理员执行 `netsh http add urlacl url=http://localhost:17300/ user=%USERNAME%`,或改成以当前用户身份运行 |
-| 报端口被占用(错误 32) | 已经开了一个实例(单实例会把参数转过去);检查任务管理器里的残留进程 |
+| 启动报「句柄无效」/ `句柄无效 (6)` | 老版本用 `HttpListener`(HTTP.sys)才会这样:系统的 HTTP 服务被禁用或卡在 STOP_PENDING。本次修复起本机服务改成自建 TcpListener,不再依赖 HTTP.sys;老版本临时处理可 `net start http` 或重启电脑 |
+| 启动报「没有绑定端口的权限」/ `Access is denied (5)` | 端口被安全软件拦了;换端口(`YUNCANG_LOCAL_PORT`)或加白名单 |
+| 报端口被占用(`AddressAlreadyInUse`) | 已经开了一个实例(单实例会把参数转过去);检查任务管理器里的残留进程 |
| 网页提示服务不可用,但软件在跑 | 先用浏览器直接打开 `http://localhost:17300/api/query/`(会回 400 但带登录状态):打不开→防火墙/端口;打得开→多半是 CORS 头没回。预览类问题则看 `ws://127.0.0.1:17301/` 能不能打开(直接浏览器访问应该返回一小段 JSON) |
| 点网页「启动本机软件」没反应 | 协议没注册(界面看「启动协议」状态);或浏览器拦了自动跳转(必须用户点击) |
| 唤起时弹「You must install .NET Desktop Runtime」 | 唤起的是 `bin\Debug` 这类 framework-dependent 的 exe(拿不到 `DOTNET_ROOT`)。用自包含发布产物,并让它启动一次以校正注册表 |
diff --git a/desktop/Services/LocalHttpServer.cs b/desktop/Services/LocalHttpServer.cs
index 77ffd2d..04aeb76 100644
--- a/desktop/Services/LocalHttpServer.cs
+++ b/desktop/Services/LocalHttpServer.cs
@@ -1,9 +1,6 @@
using System;
-using System.IO;
-using System.Net;
using System.Text;
using System.Text.Json;
-using System.Threading;
using System.Threading.Tasks;
namespace YuncangTrace.LocalService.Services;
@@ -23,9 +20,9 @@ namespace YuncangTrace.LocalService.Services;
/// 带 `Access-Control-Request-Private-Network: true` 的预检,必须回
/// `Access-Control-Allow-Private-Network: true`,否则预检失败。
///
-/// 用 (HTTP.sys):绑定 `http://localhost:端口/` 一般不需要管理员权限;
-/// 若报「拒绝访问(5)」,用管理员执行一次:
-/// netsh http add urlacl url=http://localhost:17300/ user=%USERNAME%
+/// 监听用 (自建 TcpListener,127.0.0.1 + ::1)。
+/// **不要改回 **:它依赖 HTTP.sys,现场机器上 HTTP 服务被禁用/卡住时
+/// 会抛「句柄无效(6)」,本机服务直接起不来(2026-10-23 升级 1.0.113 后的现场故障)。
///
public sealed class LocalHttpServer : IDisposable
{
@@ -38,10 +35,8 @@ public sealed class LocalHttpServer : IDisposable
return int.TryParse(raw, out var port) && port is > 0 and < 65536 ? port : 17300;
}
- private readonly HttpListener _listener = new();
+ private readonly LoopbackHttpServer _listener;
private readonly OrderQueryService _queryService;
- private CancellationTokenSource? _cts;
- private Task? _loop;
///
/// 「按运单下载录像」服务(网页查件页也会调)
@@ -68,6 +63,7 @@ public sealed class LocalHttpServer : IDisposable
public LocalHttpServer(OrderQueryService queryService)
{
_queryService = queryService;
+ _listener = new LoopbackHttpServer(Port, HandleAsync, message => Log?.Invoke(message));
}
/// 是否已登录(网页靠它判断要不要唤起登录)
@@ -76,23 +72,16 @@ public sealed class LocalHttpServer : IDisposable
/// 浏览器里可直接打开的地址
public string BaseUrl => $"http://localhost:{Port}";
- public bool IsRunning => _listener.IsListening;
+ public bool IsRunning => _listener.IsRunning;
- /// 启动监听;失败抛 (端口被占 / 没权限)
+ /// 启动监听;端口被占/被拦抛
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}/");
+ // 127.0.0.1 和 ::1 都监听:前端默认写 localhost,换 VITE_LOCAL_SERVICE 用 127.0.0.1 时也得能连
_listener.Start();
- _cts = new CancellationTokenSource();
- _loop = Task.Run(() => AcceptLoopAsync(_cts.Token));
-
Log?.Invoke($"服务已启动:{BaseUrl}");
}
@@ -102,9 +91,7 @@ public sealed class LocalHttpServer : IDisposable
try
{
- _cts?.Cancel();
_listener.Stop();
- _listener.Close();
}
catch (Exception ex)
{
@@ -116,49 +103,26 @@ public sealed class LocalHttpServer : IDisposable
}
}
- private async Task AcceptLoopAsync(CancellationToken token)
+ private async Task HandleAsync(LocalHttpRequest request, LocalHttpResponse response)
{
- 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))
+ if (request.Method.Equals("OPTIONS", StringComparison.OrdinalIgnoreCase))
{
- response.StatusCode = 204;
- response.Close();
+ await response.WriteBytesAsync(204, null, Array.Empty()).ConfigureAwait(false);
return;
}
- var path = request.Url?.AbsolutePath ?? "/";
- Log?.Invoke($"{request.HttpMethod} {path} ← {request.RemoteEndPoint?.Address}");
+ var path = request.Path;
+ Log?.Invoke($"{request.Method} {path} ← {request.RemoteAddress}");
// 网页请求唤起登录(POST,避免被浏览器的链接预取误触发)
if (path.Equals("/api/activate-login", StringComparison.OrdinalIgnoreCase))
{
- if (!request.HttpMethod.Equals("POST", StringComparison.OrdinalIgnoreCase))
+ if (!request.Method.Equals("POST", StringComparison.OrdinalIgnoreCase))
{
await WriteJsonAsync(response, 405, new { ok = false, message = "请用 POST" }).ConfigureAwait(false);
return;
@@ -186,7 +150,7 @@ public sealed class LocalHttpServer : IDisposable
return;
}
- if (!request.HttpMethod.Equals("GET", StringComparison.OrdinalIgnoreCase))
+ if (!request.Method.Equals("GET", StringComparison.OrdinalIgnoreCase))
{
// 只剩 GET 接口了;旧的 POST /api/hik/* 会走到这里(预览/云台/拉通道已迁到 WS 17301)
await WriteJsonAsync(response, 404, new
@@ -293,7 +257,11 @@ public sealed class LocalHttpServer : IDisposable
Log?.Invoke($"处理请求出错:{ex.Message}");
try
{
- await WriteJsonAsync(response, 500, new { ok = false, message = "本机服务内部错误" }).ConfigureAwait(false);
+ // 已经回过响应就不要再写一遍(会变成两个响应头拼在一条连接上)
+ if (!response.Sent)
+ {
+ await WriteJsonAsync(response, 500, new { ok = false, message = "本机服务内部错误" }).ConfigureAwait(false);
+ }
}
catch
{
@@ -302,14 +270,7 @@ public sealed class LocalHttpServer : IDisposable
}
finally
{
- try
- {
- response.Close();
- }
- catch
- {
- // 忽略
- }
+ // 连接由 LoopbackHttpServer 在响应写完后关闭;这里不需要(也不应该)再 Close
}
}
@@ -319,9 +280,9 @@ public sealed class LocalHttpServer : IDisposable
/// 网页查件页(`/local?code=`)用:**任何装了本机软件的电脑**都能查件并下载录像,
/// 存到**这台电脑自己设置的目录**(`~/packVideo/年/月/日/`),跟"是不是设备服务器"无关。
///
- private async Task HandlePlaybackDownloadAsync(HttpListenerRequest request, HttpListenerResponse response)
+ private async Task HandlePlaybackDownloadAsync(LocalHttpRequest request, LocalHttpResponse response)
{
- if (!request.HttpMethod.Equals("POST", StringComparison.OrdinalIgnoreCase))
+ if (!request.Method.Equals("POST", StringComparison.OrdinalIgnoreCase))
{
await WriteJsonAsync(response, 405, new { ok = false, message = "请用 POST" }).ConfigureAwait(false);
return;
@@ -354,8 +315,7 @@ public sealed class LocalHttpServer : IDisposable
string code;
try
{
- using var reader = new StreamReader(request.InputStream, request.ContentEncoding ?? Encoding.UTF8);
- var body = await reader.ReadToEndAsync().ConfigureAwait(false);
+ var body = Encoding.UTF8.GetString(request.Body);
using var document = JsonDocument.Parse(string.IsNullOrWhiteSpace(body) ? "{}" : body);
code = ReadJsonString(document.RootElement, "code") ?? string.Empty;
}
@@ -418,10 +378,10 @@ public sealed class LocalHttpServer : IDisposable
: null;
/// CORS + 私有网络访问(PNA)头
- private static void WriteCorsHeaders(HttpListenerRequest request, HttpListenerResponse response)
+ private static void WriteCorsHeaders(LocalHttpRequest request, LocalHttpResponse response)
{
// 回显 Origin(比写死 * 更稳:以后要带 cookie/凭据也能用)
- var origin = request.Headers["Origin"];
+ var origin = request.Header("Origin");
response.Headers["Access-Control-Allow-Origin"] = string.IsNullOrEmpty(origin) ? "*" : origin;
response.Headers["Vary"] = "Origin";
// 只剩 GET / POST;漏了 POST 会导致预检直接失败(现象:网页报 CORS、实际服务在跑)
@@ -430,40 +390,32 @@ public sealed class LocalHttpServer : IDisposable
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))
+ 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(HttpListenerResponse response, int statusCode, object? payload)
+ 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(HttpListenerResponse response, int statusCode, string html)
+ 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(HttpListenerResponse response, int statusCode, string contentType, string body)
+ private static async Task WriteTextAsync(LocalHttpResponse 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);
+ await response.WriteTextAsync(statusCode, contentType, body).ConfigureAwait(false);
}
public void Dispose()
{
Stop();
- _cts?.Dispose();
- _listener.Close();
+ _listener.Dispose();
}
}
diff --git a/desktop/Services/LocalWsServer.cs b/desktop/Services/LocalWsServer.cs
index 0472f2a..5228df6 100644
--- a/desktop/Services/LocalWsServer.cs
+++ b/desktop/Services/LocalWsServer.cs
@@ -2,8 +2,8 @@ using System;
using System.Collections.Concurrent;
using System.Collections.Generic;
using System.IO;
-using System.Net;
using System.Net.WebSockets;
+using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
using System.Threading;
@@ -43,12 +43,14 @@ public sealed class LocalWsServer : IDisposable
return int.TryParse(raw, out var port) && port is > 0 and < 65536 ? port : 17301;
}
- private readonly HttpListener _listener = new();
+ /// RFC 6455 规定的握手固定串
+ private const string WebSocketGuid = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
+
+ private readonly LoopbackHttpServer _listener;
private readonly HikDeviceService _hik;
private readonly HikPreviewService _preview;
private readonly HikNativePreviewService? _native;
private CancellationTokenSource? _cts;
- private Task? _loop;
private bool _disposed;
public LocalWsServer(HikDeviceService hik, HikPreviewService preview, HikNativePreviewService? native = null)
@@ -56,6 +58,7 @@ public sealed class LocalWsServer : IDisposable
_hik = hik;
_preview = preview;
_native = native;
+ _listener = new LoopbackHttpServer(Port, HandleContextAsync, message => Log?.Invoke(message));
}
/// 日志回调(服务线程 → UI 线程的桥)
@@ -69,38 +72,41 @@ public sealed class LocalWsServer : IDisposable
public string Url => $"ws://127.0.0.1:{Port}/";
- public bool IsRunning => _listener.IsListening;
+ public bool IsRunning => _listener.IsRunning;
- /// 启动监听;端口被占/没权限会抛 (调用方只记日志,HTTP 仍可用)
+ /// 启动监听;端口被占/被拦会抛 (调用方只记日志)
public void Start()
{
if (IsRunning) return;
- _listener.Prefixes.Clear();
- _listener.Prefixes.Add($"http://localhost:{Port}/");
- _listener.Prefixes.Add($"http://127.0.0.1:{Port}/");
- _listener.Start();
-
+ // 自建 TCP 监听(127.0.0.1 + ::1)后自己完成 WebSocket 握手:不依赖 HTTP.sys
+ // 先建令牌再开监听:早到的连接也能拿到可取消的令牌
_cts = new CancellationTokenSource();
- _loop = Task.Run(() => AcceptLoopAsync(_cts.Token));
+ try
+ {
+ _listener.Start();
+ }
+ catch
+ {
+ _cts.Dispose();
+ _cts = null;
+ throw;
+ }
Log?.Invoke($"WS 服务已启动:{Url}");
}
public void Stop()
{
- if (!IsRunning) return;
+ var wasRunning = IsRunning;
try { _cts?.Cancel(); } catch { /* 忽略 */ }
-
try { _listener.Stop(); } catch { /* 忽略 */ }
- try { _listener.Close(); } catch { /* 忽略 */ }
_cts?.Dispose();
_cts = null;
- _loop = null;
- Log?.Invoke("WS 服务已停止");
+ if (wasRunning) Log?.Invoke("WS 服务已停止");
}
public void Dispose()
@@ -108,53 +114,34 @@ public sealed class LocalWsServer : IDisposable
if (_disposed) return;
_disposed = true;
Stop();
- _listener.Close();
+ _listener.Dispose();
}
// ==================== 接受连接 ====================
- private async Task AcceptLoopAsync(CancellationToken ct)
+ private async Task HandleContextAsync(LocalHttpRequest request, LocalHttpResponse response)
{
- while (!ct.IsCancellationRequested && _listener.IsListening)
+ // 非 WS 请求:给网页/排障一个轻量探活(浏览器直接打开 ws://127.0.0.1:17301/ 就看这个)
+ if (!request.IsWebSocketRequest)
{
- HttpListenerContext context;
- try
- {
- context = await _listener.GetContextAsync().ConfigureAwait(false);
- }
- catch
- {
- break; // 监听被 Stop/Close
- }
-
- _ = Task.Run(() => HandleContextAsync(context, ct), CancellationToken.None);
- }
- }
-
- private async Task HandleContextAsync(HttpListenerContext context, CancellationToken ct)
- {
- // 非 WS 请求:给网页/排障一个轻量探活
- if (!context.Request.IsWebSocketRequest)
- {
- await WriteProbeAsync(context).ConfigureAwait(false);
+ await WriteProbeAsync(response).ConfigureAwait(false);
return;
}
+ var ct = _cts?.Token ?? CancellationToken.None;
WebSocket socket;
try
{
- var wsContext = await context.AcceptWebSocketAsync(null).ConfigureAwait(false);
- socket = wsContext.WebSocket;
+ socket = await AcceptWebSocketAsync(request, response).ConfigureAwait(false);
}
catch (Exception ex)
{
Log?.Invoke($"[ws] 建立连接失败:{ex.Message}");
- try { context.Response.StatusCode = 400; context.Response.Close(); } catch { /* 忽略 */ }
return;
}
var conn = new Connection(socket);
- Log?.Invoke($"[ws] 网页已连接({context.Request.RemoteEndPoint})");
+ Log?.Invoke($"[ws] 网页已连接({request.RemoteAddress})");
try
{
@@ -181,25 +168,53 @@ public sealed class LocalWsServer : IDisposable
}
}
- private static async Task WriteProbeAsync(HttpListenerContext context)
+ ///
+ /// 在裸 TCP 连接上完成 WebSocket 握手,再交给
+ ///
+ /// (HttpListener 会替我们做这一步,但它依赖 HTTP.sys;现在自己算 Sec-WebSocket-Accept)
+ ///
+ private static async Task AcceptWebSocketAsync(LocalHttpRequest request, LocalHttpResponse response)
+ {
+ var key = request.Header("Sec-WebSocket-Key");
+ if (string.IsNullOrWhiteSpace(key))
+ {
+ await response.WriteTextAsync(400, "text/plain; charset=utf-8", "缺少 Sec-WebSocket-Key").ConfigureAwait(false);
+ throw new InvalidOperationException("缺少 Sec-WebSocket-Key");
+ }
+
+ var accept = Convert.ToBase64String(SHA1.HashData(Encoding.ASCII.GetBytes(key.Trim() + WebSocketGuid)));
+
+ var handshake =
+ "HTTP/1.1 101 Switching Protocols\r\n" +
+ "Upgrade: websocket\r\n" +
+ "Connection: Upgrade\r\n" +
+ $"Sec-WebSocket-Accept: {accept}\r\n" +
+ "\r\n";
+
+ await response.WriteRawAsync(Encoding.ASCII.GetBytes(handshake)).ConfigureAwait(false);
+
+ // 握手写完,这条连接的读写都归 WebSocket:HTTP 层别再兜底写响应
+ response.Detach();
+
+ return WebSocket.CreateFromStream(response.Stream, new WebSocketCreationOptions
+ {
+ IsServer = true,
+ KeepAliveInterval = TimeSpan.FromSeconds(30),
+ });
+ }
+
+ private static async Task WriteProbeAsync(LocalHttpResponse response)
{
try
{
- var body = Encoding.UTF8.GetBytes("{\"ok\":true,\"ws\":true,\"name\":\"YuncangTrace\"}");
- context.Response.StatusCode = 200;
- context.Response.ContentType = "application/json; charset=utf-8";
- context.Response.Headers["Access-Control-Allow-Origin"] = "*";
- context.Response.ContentLength64 = body.Length;
- await context.Response.OutputStream.WriteAsync(body, 0, body.Length).ConfigureAwait(false);
+ response.Headers["Access-Control-Allow-Origin"] = "*";
+ await response.WriteTextAsync(200, "application/json; charset=utf-8",
+ "{\"ok\":true,\"ws\":true,\"name\":\"YuncangTrace\"}").ConfigureAwait(false);
}
catch
{
// 探活失败不影响主流程
}
- finally
- {
- try { context.Response.Close(); } catch { /* 忽略 */ }
- }
}
// ==================== 消息循环 ====================
@@ -599,7 +614,9 @@ public sealed class LocalWsServer : IDisposable
try
{
- if (Socket.State == WebSocketState.Open)
+ // CloseReceived 也要回一帧 Close:只 Dispose 的话浏览器会报
+ // 「The remote party closed the WebSocket connection without completing the close handshake」
+ if (Socket.State is WebSocketState.Open or WebSocketState.CloseReceived)
{
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(2));
await Socket.CloseAsync(WebSocketCloseStatus.NormalClosure, "bye", timeout.Token)
diff --git a/desktop/Services/LoopbackHttpServer.cs b/desktop/Services/LoopbackHttpServer.cs
new file mode 100644
index 0000000..fdb46d0
--- /dev/null
+++ b/desktop/Services/LoopbackHttpServer.cs
@@ -0,0 +1,593 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Net;
+using System.Net.Sockets;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace YuncangTrace.LocalService.Services;
+
+///
+/// 回环地址上的极简 HTTP/1.1 服务端(TcpListener + 手写报文解析)。
+///
+/// 为什么不用 :它跑在 HTTP.sys 上。现场机器上 HTTP 服务被安全软件/系统优化
+/// 禁用,或者卡在 STOP_PENDING(服务停不下来、也起不来)时,HttpListener.Start() 会抛
+/// HttpListenerException(6)「句柄无效」 —— 本机 HTTP 与 WebSocket 会**同时**起不来
+/// (2026-10-23 现场升级到 1.0.113 后就是这个现象)。
+///
+/// 自己开 TCP 监听只依赖回环端口:不需要 HTTP.sys、不需要 urlacl、不需要管理员权限,
+/// 端口被别的进程占了也只是普通的 。
+///
+/// 只监听 127.0.0.1 和 ::1(浏览器把 localhost 解析成哪个都能连上),一个请求一条连接,
+/// 响应后由服务端关闭(Connection: close)—— 本机接口都是低频调用,够用且实现简单。
+///
+internal sealed class LoopbackHttpServer : IDisposable
+{
+ /// 请求头上限(含请求行;正常请求远小于它)
+ private const int MaxHeaderBytes = 32 * 1024;
+
+ /// 请求体上限(本机接口只有小 JSON)
+ private const int MaxBodyBytes = 4 * 1024 * 1024;
+
+ /// 等请求头的超时:浏览器会预先建立连接(preconnect)却不发请求,不能一直占着
+ private static readonly TimeSpan RequestTimeout = TimeSpan.FromSeconds(30);
+
+ private readonly int _port;
+ private readonly Func _handler;
+ private readonly Action? _log;
+ private readonly List _listeners = new();
+ private CancellationTokenSource? _cts;
+ private Task? _acceptLoop;
+ private bool _disposed;
+
+ public LoopbackHttpServer(int port, Func handler, Action? log = null)
+ {
+ _port = port;
+ _handler = handler;
+ _log = log;
+ }
+
+ public bool IsRunning { get; private set; }
+
+ /// 启动监听;端口被占/被安全软件拦会抛 (调用方自己决定弹不弹窗)
+ public void Start()
+ {
+ if (IsRunning) return;
+
+ var started = new List();
+ try
+ {
+ // IPv4 回环是主路径(前端写死 127.0.0.1);IPv6 回环让 localhost 解析到 ::1 的浏览器也能连
+ started.Add(Listen(IPAddress.Loopback));
+ try
+ {
+ started.Add(Listen(IPAddress.IPv6Loopback));
+ }
+ catch (Exception ex)
+ {
+ _log?.Invoke($"[http] {_port} 端口的 IPv6 回环未监听(不影响 IPv4):{ex.Message}");
+ }
+ }
+ catch
+ {
+ foreach (var listener in started)
+ {
+ try { listener.Stop(); } catch { /* 忽略 */ }
+ }
+ throw;
+ }
+
+ _listeners.AddRange(started);
+ _cts = new CancellationTokenSource();
+ IsRunning = true;
+
+ // 传快照:Stop() 会清空 _listeners
+ var snapshot = _listeners.ToArray();
+ _acceptLoop = Task.Run(() => AcceptLoopAsync(snapshot, _cts.Token));
+ }
+
+ private TcpListener Listen(IPAddress address)
+ {
+ var listener = new TcpListener(address, _port);
+ listener.Start();
+ return listener;
+ }
+
+ public void Stop()
+ {
+ if (!IsRunning) return;
+ IsRunning = false;
+
+ try { _cts?.Cancel(); } catch { /* 忽略 */ }
+
+ foreach (var listener in _listeners)
+ {
+ try { listener.Stop(); } catch { /* 忽略 */ }
+ }
+ _listeners.Clear();
+
+ _cts?.Dispose();
+ _cts = null;
+ _acceptLoop = null;
+ }
+
+ public void Dispose()
+ {
+ if (_disposed) return;
+ _disposed = true;
+ Stop();
+ }
+
+ // ==================== 接受连接 ====================
+
+ private async Task AcceptLoopAsync(TcpListener[] listeners, CancellationToken ct)
+ {
+ var tasks = new List();
+ foreach (var listener in listeners)
+ {
+ tasks.Add(AcceptAsync(listener, ct));
+ }
+
+ try
+ {
+ await Task.WhenAll(tasks).ConfigureAwait(false);
+ }
+ catch
+ {
+ // Stop() 会让各监听退出,属于正常路径
+ }
+ }
+
+ private async Task AcceptAsync(TcpListener listener, CancellationToken ct)
+ {
+ while (!ct.IsCancellationRequested)
+ {
+ TcpClient client;
+ try
+ {
+ client = await listener.AcceptTcpClientAsync(ct).ConfigureAwait(false);
+ }
+ catch (OperationCanceledException)
+ {
+ break;
+ }
+ catch (ObjectDisposedException)
+ {
+ break;
+ }
+ catch (Exception ex)
+ {
+ if (ct.IsCancellationRequested) break;
+
+ _log?.Invoke($"[http] 接受连接失败(继续监听):{ex.Message}");
+ try
+ {
+ await Task.Delay(50, ct).ConfigureAwait(false);
+ }
+ catch
+ {
+ break;
+ }
+ continue;
+ }
+
+ _ = Task.Run(() => HandleClientAsync(client, ct), CancellationToken.None);
+ }
+ }
+
+ private async Task HandleClientAsync(TcpClient client, CancellationToken ct)
+ {
+ using (client)
+ {
+ try
+ {
+ client.NoDelay = true;
+ using var stream = client.GetStream();
+
+ LocalHttpRequest? request;
+ using (var timeout = CancellationTokenSource.CreateLinkedTokenSource(ct))
+ {
+ timeout.CancelAfter(RequestTimeout);
+ request = await LocalHttpRequest.ReadAsync(stream, timeout.Token).ConfigureAwait(false);
+ }
+
+ if (request is null) return; // 空连接 / 报文不合法:直接关掉
+
+ var response = new LocalHttpResponse(stream, request.Method);
+ await _handler(request, response).ConfigureAwait(false);
+
+ if (!response.Detached && !response.Sent)
+ {
+ await response.WriteTextAsync(500, "text/plain; charset=utf-8", "本机服务内部错误").ConfigureAwait(false);
+ }
+ }
+ catch (OperationCanceledException)
+ {
+ // 等请求头超时 / 服务停止
+ }
+ catch (IOException)
+ {
+ // 浏览器取消请求(页面刷新、关闭)——很常见,不记日志
+ }
+ catch (Exception ex)
+ {
+ if (!ct.IsCancellationRequested) _log?.Invoke($"[http] 处理连接出错:{ex.Message}");
+ }
+ }
+ }
+}
+
+/// 解析完成的本机 HTTP 请求
+internal sealed class LocalHttpRequest
+{
+ /// 请求头上限(含请求行)
+ private const int MaxHeaderBytes = 32 * 1024;
+
+ /// 请求体上限
+ private const int MaxBodyBytes = 4 * 1024 * 1024;
+
+ private readonly Dictionary _headers;
+
+ private LocalHttpRequest(string method, string target, string path, string query,
+ Dictionary headers, byte[] body, string remoteAddress)
+ {
+ Method = method;
+ Target = target;
+ Path = path;
+ Query = query;
+ _headers = headers;
+ Body = body;
+ RemoteAddress = remoteAddress;
+ }
+
+ /// HTTP 方法(GET / POST / OPTIONS ...)
+ public string Method { get; }
+
+ /// 原始请求目标(可能带查询串)
+ public string Target { get; }
+
+ /// URL 路径(不含查询串;保留 %XX 编码,和 HttpListener 的 AbsolutePath 一样由调用方决定要不要解码)
+ public string Path { get; }
+
+ /// 查询串(不含 '?',没有就是空串)
+ public string Query { get; }
+
+ /// 请求体(没有就是空数组)
+ public byte[] Body { get; }
+
+ /// 对端地址(日志用)
+ public string RemoteAddress { get; }
+
+ public IReadOnlyDictionary Headers => _headers;
+
+ public string? Header(string name) => _headers.TryGetValue(name, out var value) ? value : null;
+
+ /// 是不是 WebSocket 升级请求
+ public bool IsWebSocketRequest
+ {
+ get
+ {
+ var connection = Header("Connection") ?? string.Empty;
+ return Method.Equals("GET", StringComparison.OrdinalIgnoreCase)
+ && string.Equals(Header("Upgrade"), "websocket", StringComparison.OrdinalIgnoreCase)
+ && connection.Contains("upgrade", StringComparison.OrdinalIgnoreCase);
+ }
+ }
+
+ /// 读一条请求;空连接/报文不合法返回 null(调用方直接关连接)
+ public static async Task ReadAsync(Stream stream, CancellationToken ct)
+ {
+ var reader = new BufferedSocketReader(stream);
+
+ var requestLine = await reader.ReadLineAsync(MaxHeaderBytes, ct).ConfigureAwait(false);
+ if (string.IsNullOrEmpty(requestLine)) return null;
+
+ var parts = requestLine.Split(' ');
+ if (parts.Length < 3) return null;
+
+ var method = parts[0];
+ var target = parts[1];
+
+ var headers = new Dictionary(StringComparer.OrdinalIgnoreCase);
+ var headerBytes = requestLine.Length;
+
+ while (true)
+ {
+ var line = await reader.ReadLineAsync(MaxHeaderBytes, ct).ConfigureAwait(false);
+ if (line is null) return null; // 连接半截断了
+ if (line.Length == 0) break; // 头部结束
+
+ headerBytes += line.Length;
+ if (headerBytes > MaxHeaderBytes) return null;
+
+ var colon = line.IndexOf(':');
+ if (colon <= 0) continue;
+
+ var name = line[..colon].Trim();
+ var value = line[(colon + 1)..].Trim();
+ if (name.Length == 0) continue;
+
+ // 重复头(如 Connection)合并,行为跟 HttpListener 一致
+ headers[name] = headers.TryGetValue(name, out var existing) ? existing + ", " + value : value;
+ }
+
+ // 只接受回环 Host(以前 HttpListener 只注册了 localhost/127.0.0.1,别的 Host 直接 400):
+ // 同时挡掉 DNS rebinding —— 恶意域名解析到 127.0.0.1 后带着自己的 Host 来打本机接口
+ if (headers.TryGetValue("Host", out var host) && host.Length > 0 && !IsLoopbackHost(host)) return null;
+
+ var queryIndex = target.IndexOf('?');
+ var path = queryIndex >= 0 ? target[..queryIndex] : target;
+ var query = queryIndex >= 0 ? target[(queryIndex + 1)..] : string.Empty;
+
+ // 绝对地址形式(代理/个别客户端会这么发)
+ if (Uri.TryCreate(target, UriKind.Absolute, out var absolute) && absolute.Scheme.StartsWith("http", StringComparison.OrdinalIgnoreCase))
+ {
+ path = absolute.AbsolutePath;
+ query = absolute.Query.TrimStart('?');
+ }
+
+ byte[] body = Array.Empty();
+
+ var chunked = headers.TryGetValue("Transfer-Encoding", out var transferEncoding)
+ && transferEncoding.Contains("chunked", StringComparison.OrdinalIgnoreCase);
+
+ if (chunked)
+ {
+ var decoded = await ReadChunkedBodyAsync(reader, ct).ConfigureAwait(false);
+ if (decoded is null) return null;
+ body = decoded;
+ }
+ else if (headers.TryGetValue("Content-Length", out var contentLengthRaw)
+ && long.TryParse(contentLengthRaw, out var contentLength))
+ {
+ if (contentLength < 0 || contentLength > MaxBodyBytes) return null;
+
+ if (contentLength > 0)
+ {
+ // 浏览器发大 body 前会等 100 Continue,不回它会一直卡着
+ if (headers.TryGetValue("Expect", out var expect)
+ && expect.Contains("100-continue", StringComparison.OrdinalIgnoreCase))
+ {
+ var cont = Encoding.ASCII.GetBytes("HTTP/1.1 100 Continue\r\n\r\n");
+ await stream.WriteAsync(cont, ct).ConfigureAwait(false);
+ await stream.FlushAsync(ct).ConfigureAwait(false);
+ }
+
+ var read = await reader.ReadExactAsync((int)contentLength, ct).ConfigureAwait(false);
+ if (read is null) return null;
+ body = read;
+ }
+ }
+
+ var remote = (stream as NetworkStream)?.Socket.RemoteEndPoint?.ToString() ?? string.Empty;
+ return new LocalHttpRequest(method, target, path, query, headers, body, remote);
+ }
+
+ private static bool IsLoopbackHost(string host)
+ {
+ var value = host.Trim();
+
+ if (value.StartsWith('['))
+ {
+ var end = value.IndexOf(']');
+ if (end > 0) value = value[1..end];
+ }
+ else
+ {
+ // 去掉端口(IPv6 字面量有多个冒号,已在上面按方括号处理)
+ var colon = value.LastIndexOf(':');
+ if (colon > 0 && value.IndexOf(':') == colon) value = value[..colon];
+ }
+
+ return value.Equals("localhost", StringComparison.OrdinalIgnoreCase)
+ || value == "127.0.0.1"
+ || value == "::1";
+ }
+
+ private static async Task ReadChunkedBodyAsync(BufferedSocketReader reader, CancellationToken ct)
+ {
+ using var body = new MemoryStream();
+
+ while (true)
+ {
+ var sizeLine = await reader.ReadLineAsync(1024, ct).ConfigureAwait(false);
+ if (sizeLine is null) return null;
+
+ var semicolon = sizeLine.IndexOf(';');
+ var hex = (semicolon >= 0 ? sizeLine[..semicolon] : sizeLine).Trim();
+ if (!int.TryParse(hex, System.Globalization.NumberStyles.HexNumber, null, out var size)) return null;
+
+ if (size == 0)
+ {
+ // 吃掉 trailer,直到空行
+ while (true)
+ {
+ var trailer = await reader.ReadLineAsync(MaxHeaderBytes, ct).ConfigureAwait(false);
+ if (trailer is null) return null;
+ if (trailer.Length == 0) break;
+ }
+ break;
+ }
+
+ if (body.Length + size > MaxBodyBytes) return null;
+
+ var data = await reader.ReadExactAsync(size, ct).ConfigureAwait(false);
+ if (data is null) return null;
+ body.Write(data, 0, data.Length);
+
+ var crlf = await reader.ReadLineAsync(8, ct).ConfigureAwait(false);
+ if (crlf is null) return null;
+ }
+
+ return body.ToArray();
+ }
+}
+
+/// 本机 HTTP 响应(一个请求只发一次;发了之后由服务端关连接)
+internal sealed class LocalHttpResponse
+{
+ private static readonly Encoding Utf8 = new UTF8Encoding(false);
+
+ private readonly Stream _stream;
+
+ internal LocalHttpResponse(Stream stream, string requestMethod)
+ {
+ _stream = stream;
+ RequestMethod = requestMethod;
+ }
+
+ public string RequestMethod { get; }
+
+ /// 响应头(必须在写出前设置)
+ public Dictionary Headers { get; } = new(StringComparer.OrdinalIgnoreCase);
+
+ /// 底层连接(WebSocket 握手后交给 WebSocket.CreateFromStream)
+ public Stream Stream => _stream;
+
+ /// 是否已经写过响应
+ public bool Sent { get; private set; }
+
+ /// 连接已被上层接管(WebSocket):HTTP 层不要再写兜底响应
+ public bool Detached { get; private set; }
+
+ private bool IsHead => RequestMethod.Equals("HEAD", StringComparison.OrdinalIgnoreCase);
+
+ public void Detach() => Detached = true;
+
+ public Task WriteTextAsync(int statusCode, string? contentType, string body)
+ => WriteBytesAsync(statusCode, contentType, Utf8.GetBytes(body));
+
+ public async Task WriteBytesAsync(int statusCode, string? contentType, byte[] body)
+ {
+ var head = BuildHead(statusCode, contentType, body.Length);
+ await _stream.WriteAsync(head).ConfigureAwait(false);
+ if (!IsHead && body.Length > 0)
+ {
+ await _stream.WriteAsync(body).ConfigureAwait(false);
+ }
+ await _stream.FlushAsync().ConfigureAwait(false);
+ Sent = true;
+ }
+
+ /// 原样写一段内容(WebSocket 101 握手用)
+ public async Task WriteRawAsync(byte[] bytes)
+ {
+ await _stream.WriteAsync(bytes).ConfigureAwait(false);
+ await _stream.FlushAsync().ConfigureAwait(false);
+ Sent = true;
+ }
+
+ private byte[] BuildHead(int statusCode, string? contentType, int contentLength)
+ {
+ var builder = new StringBuilder(256);
+ builder.Append("HTTP/1.1 ").Append(statusCode).Append(' ').Append(ReasonPhrase(statusCode)).Append("\r\n");
+ builder.Append("Date: ").Append(DateTime.UtcNow.ToString("R")).Append("\r\n");
+
+ // 204/304 按规范不能带实体
+ if (statusCode is not 204 and not 304)
+ {
+ builder.Append("Content-Length: ").Append(contentLength).Append("\r\n");
+ }
+
+ if (!string.IsNullOrEmpty(contentType))
+ {
+ builder.Append("Content-Type: ").Append(contentType).Append("\r\n");
+ }
+
+ builder.Append("Connection: close\r\n");
+
+ foreach (var header in Headers)
+ {
+ builder.Append(header.Key).Append(": ").Append(header.Value).Append("\r\n");
+ }
+
+ builder.Append("\r\n");
+ return Encoding.Latin1.GetBytes(builder.ToString());
+ }
+
+ private static string ReasonPhrase(int statusCode) => statusCode switch
+ {
+ 200 => "OK",
+ 204 => "No Content",
+ 400 => "Bad Request",
+ 401 => "Unauthorized",
+ 404 => "Not Found",
+ 405 => "Method Not Allowed",
+ 413 => "Payload Too Large",
+ 500 => "Internal Server Error",
+ 503 => "Service Unavailable",
+ _ => "OK",
+ };
+}
+
+///
+/// 带缓冲的 socket 读取器:按行读头部、按长度读 body(不越过报文边界)
+///
+internal sealed class BufferedSocketReader
+{
+ private readonly Stream _stream;
+ private readonly byte[] _buffer = new byte[4096];
+ private int _start;
+ private int _end;
+
+ public BufferedSocketReader(Stream stream) => _stream = stream;
+
+ private async ValueTask FillAsync(CancellationToken ct)
+ {
+ if (_start < _end) return true;
+
+ _start = 0;
+ _end = await _stream.ReadAsync(_buffer.AsMemory(), ct).ConfigureAwait(false);
+ return _end > 0;
+ }
+
+ /// 读一行(去掉 CRLF);连接断了返回 null
+ public async Task ReadLineAsync(int maxLength, CancellationToken ct)
+ {
+ var builder = new StringBuilder(64);
+
+ while (true)
+ {
+ if (!await FillAsync(ct).ConfigureAwait(false)) return null;
+
+ var current = _buffer[_start++];
+ if (current == (byte)'\n')
+ {
+ if (builder.Length > 0 && builder[^1] == '\r') builder.Length--;
+ return builder.ToString();
+ }
+
+ builder.Append((char)current);
+ if (builder.Length > maxLength) return null;
+ }
+ }
+
+ /// 精确读 count 字节;连接提前断开返回 null
+ public async Task ReadExactAsync(int count, CancellationToken ct)
+ {
+ if (count == 0) return Array.Empty();
+
+ var result = new byte[count];
+ var read = 0;
+
+ while (read < count)
+ {
+ if (_start < _end)
+ {
+ var take = Math.Min(_end - _start, count - read);
+ Buffer.BlockCopy(_buffer, _start, result, read, take);
+ _start += take;
+ read += take;
+ continue;
+ }
+
+ var n = await _stream.ReadAsync(result.AsMemory(read, count - read), ct).ConfigureAwait(false);
+ if (n == 0) return null;
+ read += n;
+ }
+
+ return result;
+ }
+}