- ModelInstaller: 模型 Id 限定为单段安全名称,拒绝路径分隔符/绝对路径/ 符号链接,源目录枚举跳过重解析点,防止写到模型库外 - DirectoryRemote: 清单验签失败如实记录;包 URL 仅允许 http(s) 公网地址, 拦截 file:/私有 IP/环回/元数据地址(SSRF);SafePath 逐级解析符号链接 并确认仍在根目录内 - 本机后端健康检查改为一次性会话令牌双向校验(/api/health 返回指纹), 同机伪造服务无法通过身份确认;所有 /api 请求需带令牌,封面图走 query 只含 7 个安全文件,基于最新 origin2/main(含已合入的 #32 课件)。
240 lines
9.4 KiB
C#
240 lines
9.4 KiB
C#
using System;
|
||
using System.Diagnostics;
|
||
using System.IO;
|
||
using System.Net.Http;
|
||
using System.Threading;
|
||
using System.Threading.Tasks;
|
||
using GC.UI.Server;
|
||
using Microsoft.AspNetCore.Builder;
|
||
|
||
namespace GC;
|
||
|
||
/// <summary>
|
||
/// 新界面启动壳。
|
||
///
|
||
/// 发布包带 <c>GC-UI</c>(Flutter 前端)时,启动器只做三件事:
|
||
/// 1. 在自己的进程里起后端(本地 HTTP API + 模型窗口宿主),等 <c>/api/health</c> 就绪;
|
||
/// 2. 拉起 Flutter 窗口;
|
||
/// 3. 界面退出后关掉后端。
|
||
///
|
||
/// 后端跑在进程内而不是单独一个 exe:两者用的是同一套 .NET 运行时,
|
||
/// 拆成两个自包含进程等于把 60MB 运行时复制两份,发布包会白白大一倍。
|
||
///
|
||
/// 缺 Flutter 前端时返回 <c>false</c>,由调用方回退到内置 Avalonia 界面——
|
||
/// 这样 `dotnet run`、只编了启动器的开发场景都能正常打开。
|
||
/// </summary>
|
||
internal static class FlutterShell
|
||
{
|
||
/// <summary>与前端、后端共用的默认端口(定义在 GC.Services.GcUiContract)。</summary>
|
||
private const int Port = Services.GcUiContract.DefaultPort;
|
||
|
||
private static readonly HttpClient Http = new() { Timeout = TimeSpan.FromSeconds(1.5) };
|
||
|
||
private static WebApplication? _backend;
|
||
|
||
public static bool TryRun(string[] args)
|
||
{
|
||
var dir = AppContext.BaseDirectory;
|
||
var uiPath = FindUi(dir);
|
||
if (uiPath == null) return false;
|
||
|
||
// 本次会话的一次性令牌:进程内后端与 Flutter 前端都从这里拿到同一个值。
|
||
// 只有我们拉起的后端才持有它,同机其他进程伪造的健康响应过不了 IsHealthy 的身份校验。
|
||
// 允许外部预设(自动化测试 / 高级部署固定令牌),未预设才现场生成随机值。
|
||
var token = Environment.GetEnvironmentVariable(Services.GcUiContract.TokenEnvVar);
|
||
if (string.IsNullOrEmpty(token)) token = Services.GcUiContract.NewSessionToken();
|
||
Environment.SetEnvironmentVariable(Services.GcUiContract.TokenEnvVar, token);
|
||
|
||
var port = Port;
|
||
AvaloniaHost? uiHost = null;
|
||
|
||
// 用户可能重复启动:只有当端口上已有一个「持有同一令牌」的后端时才复用。
|
||
// 同机其他程序即便占端口并返回 200,也没有令牌,会被 IsHealthy 拒绝,
|
||
// 于是我们改到下一个端口起自己的后端,绝不把前端交给伪装服务。
|
||
if (!IsHealthy(port, token))
|
||
{
|
||
// 端口可能被别的程序占用:17890 起向后试几个,选第一个能起来且健康的。
|
||
var start = Environment.GetEnvironmentVariable(Services.GcUiContract.PortEnvVar) is { Length: > 0 }
|
||
? Services.GcUiContract.PortFromEnvironment()
|
||
: Port;
|
||
|
||
for (var candidate = start; candidate < start + Services.GcUiContract.PortScanRange; candidate++)
|
||
{
|
||
var app = TryStartBackend(args, candidate, out var host);
|
||
if (app == null) continue;
|
||
|
||
if (WaitHealthy(candidate, token, TimeSpan.FromSeconds(25)))
|
||
{
|
||
port = candidate;
|
||
_backend = app;
|
||
uiHost = host;
|
||
break;
|
||
}
|
||
|
||
StopBackend(app);
|
||
}
|
||
|
||
if (_backend == null) return false;
|
||
}
|
||
|
||
AppDomain.CurrentDomain.ProcessExit += (_, _) => StopBackend(_backend);
|
||
|
||
var ui = Start(uiPath, dir, port, token);
|
||
if (ui == null)
|
||
{
|
||
StopBackend(_backend);
|
||
_backend = null;
|
||
return false;
|
||
}
|
||
|
||
// 前端窗口已拉起。模型窗口由 Avalonia 承载,而 macOS 的 AppKit 要求
|
||
// NSApplication 必须在**主线程**——所以事件循环要跑在这里(当前正是主线程),
|
||
// 不能再丢到副线程,否则一点「启动模型」就会把整个后端带崩。
|
||
ui.EnableRaisingEvents = true;
|
||
var closed = 0;
|
||
void RequestClose()
|
||
{
|
||
if (Interlocked.Exchange(ref closed, 1) == 1) return;
|
||
uiHost?.Shutdown();
|
||
}
|
||
|
||
ui.Exited += (_, _) => RequestClose();
|
||
if (ui.HasExited) RequestClose();
|
||
|
||
if (!ui.HasExited && uiHost != null)
|
||
{
|
||
// 阻塞直到界面退出(或图形环境初始化失败)。
|
||
uiHost.RunOnCurrentThread();
|
||
}
|
||
|
||
// Avalonia 起不来(无桌面会话)时仍要等界面退出,避免后端被提前收掉。
|
||
if (!ui.HasExited) ui.WaitForExit();
|
||
|
||
StopBackend(_backend);
|
||
_backend = null;
|
||
return true;
|
||
}
|
||
|
||
// ---------------------------------------------------------------- 产物定位
|
||
|
||
/// <summary>
|
||
/// Flutter 桌面产物。
|
||
/// macOS 是 <c>GC-UI.app/Contents/MacOS/GC-UI</c>;Windows 是 <c>GC-UI.exe</c>;
|
||
/// Linux 是 <c>GC-UI</c>。
|
||
/// </summary>
|
||
private static string? FindUi(string dir)
|
||
{
|
||
if (OperatingSystem.IsMacOS())
|
||
{
|
||
var exe = Path.Combine(dir, "GC-UI.app", "Contents", "MacOS", "GC-UI");
|
||
if (File.Exists(exe)) return exe;
|
||
}
|
||
|
||
foreach (var name in OperatingSystem.IsWindows() ? new[] { "GC-UI.exe" } : new[] { "GC-UI" })
|
||
{
|
||
var path = Path.Combine(dir, name);
|
||
if (File.Exists(path)) return path;
|
||
}
|
||
return null;
|
||
}
|
||
|
||
// ---------------------------------------------------------------- 进程管理
|
||
|
||
/// <summary>在本进程内启动后端;端口被占用等失败情况返回 null。</summary>
|
||
/// <param name="uiHost">成功时交出模型窗口宿主,由调用方在主线程跑事件循环。</param>
|
||
private static WebApplication? TryStartBackend(string[] args, int port, out AvaloniaHost? uiHost)
|
||
{
|
||
uiHost = null;
|
||
try
|
||
{
|
||
var app = BackendServer.Start(args, port, out var host);
|
||
uiHost = host;
|
||
app.StartAsync().GetAwaiter().GetResult();
|
||
return app;
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
Console.Error.WriteLine($"[shell] 后端启动失败(端口 {port}): {ex.Message}");
|
||
return null;
|
||
}
|
||
}
|
||
|
||
private static void StopBackend(WebApplication? app)
|
||
{
|
||
if (app == null) return;
|
||
try
|
||
{
|
||
using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(3));
|
||
app.StopAsync(cts.Token).GetAwaiter().GetResult();
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
Console.Error.WriteLine($"[shell] 关闭后端失败: {ex.Message}");
|
||
}
|
||
}
|
||
|
||
private static Process Start(string fileName, string workingDirectory, int port, string token)
|
||
{
|
||
var info = new ProcessStartInfo(fileName)
|
||
{
|
||
WorkingDirectory = workingDirectory,
|
||
UseShellExecute = false,
|
||
};
|
||
|
||
// 把实际端口传给前端:它读这个环境变量拼 baseUrl,换端口不需要重新编译界面。
|
||
info.Environment[Services.GcUiContract.PortEnvVar] = port.ToString();
|
||
// 同一个会话令牌也交给前端,作为每个 /api 请求的身份凭证。
|
||
info.Environment[Services.GcUiContract.TokenEnvVar] = token;
|
||
|
||
// macOS .app 内的二进制也需要可执行位;发布包由 zip 解开时可能丢失。
|
||
if (!OperatingSystem.IsWindows())
|
||
{
|
||
try { File.SetUnixFileMode(fileName, UnixFileMode.UserRead | UnixFileMode.UserWrite | UnixFileMode.UserExecute); }
|
||
catch { /* 权限不足时交给系统判断 */ }
|
||
}
|
||
|
||
return Process.Start(info)!;
|
||
}
|
||
|
||
// ---------------------------------------------------------------- 健康检查
|
||
|
||
/// <summary>
|
||
/// 健康探测必须带本次会话令牌:后端校验通过才说明这是「我们拉起的那个后端」。
|
||
/// 同机伪装进程即使返回 HTTP 200,也因为没有令牌而拿不到 200(后端会 401),
|
||
/// 但这里额外再比对响应体里的密钥指纹,双保险——即便对方原样回一个 200 也骗不过。
|
||
/// </summary>
|
||
private static bool IsHealthy(int port, string token)
|
||
{
|
||
try
|
||
{
|
||
using var request = new HttpRequestMessage(HttpMethod.Get, $"http://127.0.0.1:{port}/api/health");
|
||
request.Headers.TryAddWithoutValidation(Services.GcUiContract.TokenHeader, token);
|
||
using var response = Http.Send(request);
|
||
if (!response.IsSuccessStatusCode) return false;
|
||
|
||
// 状态码 200 还不够:伪装进程可能盲回一个 200。真正的后端会用会话令牌
|
||
// 派生指纹填进 health 响应,这里比对指纹确认对方确实持有同一个令牌。
|
||
var body = response.Content.ReadAsStringAsync().GetAwaiter().GetResult();
|
||
using var json = System.Text.Json.JsonDocument.Parse(body);
|
||
var proof = json.RootElement.TryGetProperty("sessionProof", out var p) ? p.GetString() : null;
|
||
var expected = Services.GcUiContract.DeriveSessionProof(token);
|
||
return string.Equals(proof, expected, StringComparison.OrdinalIgnoreCase);
|
||
}
|
||
catch
|
||
{
|
||
return false;
|
||
}
|
||
}
|
||
|
||
private static bool WaitHealthy(int port, string token, TimeSpan timeout)
|
||
{
|
||
var deadline = DateTime.UtcNow + timeout;
|
||
while (DateTime.UtcNow < deadline)
|
||
{
|
||
if (IsHealthy(port, token)) return true;
|
||
Thread.Sleep(250);
|
||
}
|
||
return false;
|
||
}
|
||
}
|