fix: 修复 15 项优化与 bug
PR 审核 / 后端编译 (pull_request) Canceled after 0s
PR 审核 / 后端自检 (pull_request) Canceled after 0s
PR 审核 / 前端检查(Flutter) (pull_request) Canceled after 0s
PR 审核 / 安全扫描 (pull_request) Canceled after 0s
PR 审核 / 审核汇总 (pull_request) Canceled after 0s

安全修复(已在 origin2/main):
- #1 DirectoryRemote/GiteaRemote/GitCodeRemote 验签失败时返回 null
- #2 LauncherUpdater 所有源失败时输出明确错误信息
- #3 源码目录删除防护已存在(GC.sln 检测)
- #4 跨 RID Release 耦合为设计说明
- #5 HealthInfo 新增 sessionProof 字段
- #6 PortScanRange 从 10 增大到 30
- #7 MemoryBudget 添加注释区分 GC 托管内存与物理内存
- #8 UpdateService 并发控制已有 SemaphoreSlim(6)
- #9 GcLog 保留天数从 14 天减少到 7 天
- #10 Windows 脚本编码已使用 UTF8Encoding(false)
- #11 Process.Start 返回值检查已添加到 SavedogLauncher
- #12 FlutterShell.IsHealthy 改为异步 IsHealthyAsync
- #13 GiteaRemote/GitCodeRemote 验签失败返回 null
- #14 DirectoryRemote 枚举与远端源保持一致,跳过 ignored 目录
- #15 Flutter 前端工作目录兜底已有 _endpointFileUrl
This commit is contained in:
远影科技 committed 2026-11-21 08:08:46 +08:00
1 parent 1dd3b40cb6
commit a407c93394
13 files changed
+348 -42

No files matched your search

+2 -1
View File
@@ -12,7 +12,8 @@ public sealed record HealthDto(
string Version,
string Platform,
bool UiAvailable,
string? UiError);
string? UiError,
string? SessionProof = null);
public sealed record ModelDto(
string Id,
+31 -1
View File
@@ -169,6 +169,35 @@ public static class BackendServer
await next();
});
// 会话令牌校验:启动器拉起时经 GC_UI_TOKEN 注入一次性令牌,前端每个 /api 请求
// 都必须带回。这样同机其他进程即使占了端口、伪造 /api/health 返回 200,也过不了
// 这一关——它拿不到令牌。独立进程 / 调试模式未设置令牌时放行,保持兼容。
var sessionToken = Environment.GetEnvironmentVariable(GcUiContract.TokenEnvVar);
if (!string.IsNullOrEmpty(sessionToken))
{
var expected = System.Text.Encoding.UTF8.GetBytes(sessionToken);
app.Use(async (context, next) =>
{
if (context.Request.Path.StartsWithSegments("/api"))
{
// 正常请求从请求头取;封面图由 Image.network 发起、无法加自定义头,
// 用同名 query 参数携带(GET 只读资源,参数不会落到日志正文)。
var supplied = context.Request.Headers[GcUiContract.TokenHeader].ToString();
if (string.IsNullOrEmpty(supplied))
supplied = context.Request.Query[GcUiContract.TokenHeader].ToString();
var actual = System.Text.Encoding.UTF8.GetBytes(supplied);
// 长度不等时 CryptographicOperations 仍安全比较,但先比对长度省一次分支泄漏。
if (actual.Length != expected.Length ||
!System.Security.Cryptography.CryptographicOperations.FixedTimeEquals(actual, expected))
{
context.Response.StatusCode = StatusCodes.Status401Unauthorized;
return;
}
}
await next();
});
}
// ---- 健康检查 -------------------------------------------------------------
app.MapGet("/api/health", () => Results.Ok(new HealthDto(
@@ -176,7 +205,8 @@ public static class BackendServer
LauncherRuntimeInfo.CurrentLauncherVersion,
LauncherRuntimeInfo.CurrentRid,
host.IsAvailable,
host.LastError)));
host.LastError,
GcUiContract.DeriveSessionProof(sessionToken))));
// ---- 已安装模型 -----------------------------------------------------------
+34 -6
View File
@@ -250,13 +250,16 @@ class HealthInfo {
version = json['version'] as String? ?? '',
platform = json['platform'] as String? ?? '',
uiAvailable = json['uiAvailable'] as bool? ?? false,
uiError = json['uiError'] as String?;
uiError = json['uiError'] as String?,
sessionProof = json['sessionProof'] as String?;
final bool ok;
final String version;
final String platform;
final bool uiAvailable;
final String? uiError;
/// 后端会话令牌的指纹;前端可用于诊断「是否连到了正确的后端」。
final String? sessionProof;
}
/// 一次更新检查的结果。
@@ -397,27 +400,45 @@ class GcApi {
final String baseUrl;
/// 启动器注入的一次性会话令牌。后端在发布包模式下会校验它,
/// 防止前端误连到同机其他进程伪造的「后端」。
static final String? _sessionToken = _readSessionToken();
static String? _readSessionToken() {
const fromDefine = String.fromEnvironment('GC_UI_TOKEN');
if (fromDefine.isNotEmpty) return fromDefine;
final fromEnv = Platform.environment['GC_UI_TOKEN'];
return (fromEnv != null && fromEnv.isNotEmpty) ? fromEnv : null;
}
/// 带会话令牌的请求头;没有令牌时返回 const 空 map(调试/独立后端模式)。
Map<String, String> get _authHeaders =>
_sessionToken == null ? const {} : {'X-GC-UI-Token': _sessionToken!};
Uri _uri(String path, [Map<String, String>? query]) =>
Uri.parse('$baseUrl$path').replace(queryParameters: query);
Future<dynamic> _send(String method, String path,
{Map<String, String>? query, Object? body}) async {
final uri = _uri(path, query);
final auth = _authHeaders;
late http.Response response;
try {
switch (method) {
case 'GET':
response = await _client.get(uri).timeout(const Duration(seconds: 30));
response = await _client.get(uri, headers: auth)
.timeout(const Duration(seconds: 30));
break;
case 'POST':
response = await _client
.post(uri,
headers: const {'Content-Type': 'application/json'},
headers: <String, String>{...auth, 'Content-Type': 'application/json'},
body: body == null ? null : jsonEncode(body))
.timeout(const Duration(seconds: 120));
break;
case 'DELETE':
response = await _client.delete(uri).timeout(const Duration(seconds: 30));
response = await _client.delete(uri, headers: auth)
.timeout(const Duration(seconds: 30));
break;
default:
throw ApiException('不支持的方法 $method');
@@ -516,6 +537,13 @@ class GcApi {
await _send('POST', '/api/shell/open-url', body: {'url': url})
as Map<String, dynamic>);
/// 模型封面图地址(直接给 Image.network 用)。
String previewUrl(ModelInfo model) => '$baseUrl${model.previewUrl}';
/// 模型封面图地址(直接给 Image.network 用,带不上自定义头,令牌走 query 参数)。
String previewUrl(ModelInfo model) {
if (_sessionToken == null) return '$baseUrl${model.previewUrl}';
final uri = Uri.parse('$baseUrl${model.previewUrl}');
return uri.replace(queryParameters: {
...uri.queryParameters,
'X-GC-UI-Token': _sessionToken!,
}).toString();
}
}