feat(client): 新增 Windows 桌面端(sing-box TUN 全局代理)
ci-pangolin / Lint — shellcheck (push) Has been cancelled
ci-pangolin / Unit Tests — nginx cfg + compose (push) Has been cancelled
ci-pangolin / OpenAPI Sync Check (push) Has been cancelled
ci-pangolin / Redline Scan — 脱敏 (UI 文案) (push) Has been cancelled
ci-pangolin / Flutter — analyze + test (push) Has been cancelled
ci-pangolin / Image Build — pangolin-edge (push) Has been cancelled

Windows 与 macOS 桌面同路线:Flutter 应用 + sing-box.exe 子进程 + wintun TUN
接管整机流量。Dart/桥接层此前已 Windows-ready(kernel_process._buildCommand /
_resolveBinaryPath、desktop_vpn_bridge 配置路径、fetch-desktop-bin.sh),本次补
原生外壳 + 提权 + 打包:

- flutter create --platforms=windows 生成 windows/ runner(flutter_secure_storage
  已注册 windows 插件,token 存储可用)。
- runner.exe.manifest 设 requestedExecutionLevel=requireAdministrator:启动 UAC
  提权,sing-box 子进程继承管理员权以创建 wintun TUN(与 _buildCommand 既有设计一致)。
- windows/CMakeLists.txt 增 install 规则:打包时把 app/kernel/dist/desktop/windows-*/
  {sing-box.exe,wintun.dll} 拷到 app exe 同级目录(存在才拷,缺失告警,类比 android
  build.gradle 占位)。
- kernel_process.dart 启动时校验 wintun.dll 与 sing-box.exe 同目录,缺失早警。
- windows/README.md:拉内核二进制 / 管理员终端 flutter run / 打包 / 出网验证步骤。

提权用 requireAdministrator(每次 UAC),正式版可换特权 helper(BACKLOG,类比 SMJobBless)。

本机(macOS)验证:flutter analyze 无 error。Windows 真机 build/连通验证待后续
(无 Windows 机器,状态同 Android/iOS:代码就绪、未真机验证)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
wangjia
2026-06-17 07:49:26 +08:00
parent f1bd35afd9
commit caeef20df3
21 changed files with 1212 additions and 1 deletions
+12
View File
@@ -346,6 +346,18 @@ class DesktopKernelProcess implements KernelProcess {
final binPath = await _resolveBinaryPath();
_log('binary: $binPath');
// Windows: sing-box loads wintun.dll (from its own directory) to create the
// TUN adapter. Warn early if it is missing so a failed connect is diagnosable
// rather than surfacing as an opaque sing-box error.
if (Platform.isWindows) {
final wintun = File('${File(binPath).parent.path}\\wintun.dll');
if (!await wintun.exists()) {
_log('[kernel] WARNING: wintun.dll not found next to sing-box.exe '
'(${wintun.path}); TUN will fail to start. Run '
'app/kernel/fetch-desktop-bin.sh windows amd64.');
}
}
// 2. 读取配置,提取 Clash API 地址和 secret
final clashEndpoint = await _parseClashEndpoint(configPath);
final clashUrl = 'http://${clashEndpoint.$1}';