From 9c16cc1690ef4782f4c5e1d20b303759889d6a92 Mon Sep 17 00:00:00 2001 From: zhy200308 <2258391712@qq.com> Date: Wed, 12 Aug 2026 10:54:05 +0800 Subject: [PATCH] =?UTF-8?q?fix(desktop):=20=E6=8F=90=E6=9D=83=E8=84=9A?= =?UTF-8?q?=E6=9C=AC=E7=94=A8=E4=BA=86=20bash=20=E7=9A=84=20\=20=E7=BB=AD?= =?UTF-8?q?=E8=A1=8C=E5=AF=BC=E8=87=B4=E6=94=BE=E8=A1=8C=E5=BF=85=E7=84=B6?= =?UTF-8?q?=E5=A4=B1=E8=B4=A5=EF=BC=8C=E4=B8=94=E5=A4=B1=E8=B4=A5=E8=A2=AB?= =?UTF-8?q?=E8=AF=AF=E6=8A=A5=E4=B8=BA=E6=88=90=E5=8A=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用户的终端输出把我上一版的 bug 直接暴露了出来:手动放行命令里 `New-NetFirewallRule ... -Direction Inbound \` 后面接换行——`\` 是 bash 的 续行语法,PowerShell 用反引号,于是命令被拆成两条,两条都报错。 同一个 `\` 也写在了 grant() 生成的提权脚本里,所以「放行防火墙」按钮在 Windows 上是**必然失败**的。更糟的是它还误报成功:Start-Process -Wait 返回的是启动器的退出码,不是被提权进程的,脚本语法错误照样得到 0。 用户看到的「已提交放行规则,正在复检…」+ 复检仍显示缺少规则,就是这么来的。 三处修复: 1. 脚本一律一条命令一行,绝不使用任何续行。新增测试逐行断言不以 `\` 结尾。 2. 提权脚本跑完必须写一个成功标记文件,grant() 以标记存在与否判定成败, 不再相信外层退出码。拿不到标记时给出明确提示而不是假装成功。 3. 「复制手动放行命令」现在只放命令,不再夹杂中文说明。用户是整段粘进 PowerShell 的,混在里面的散文会被逐行当成 cmdlet 报错,把真正的错误 淹没掉——用户的终端输出里满屏都是这个。加测试断言每一行都是命令或注释。 另外 APP_VERSION 是 main.rs 里的手写常量,上一版我只改了 Cargo.toml, 界面仍显示 v0.4.9,用户无法判断自己跑的是不是新构建。改为 env!("CARGO_PKG_VERSION"),从此只有一个版本号来源。 用户机器上的诊断结果排除了另外两种成因:三个配置文件的 AllowInboundRules 都是 NotConfigured(没有开启「阻止所有传入连接」),按程序路径也查不到任何 阻止规则。所以剩下的就是放行规则本身没建成——正是本次修复的这个 bug。 版本号 0.4.10 → 0.4.11。 --- desktop/Cargo.lock | 2 +- desktop/Cargo.toml | 2 +- desktop/src/firewall.rs | 133 ++++++++++++++++++++++++++++++---------- desktop/src/main.rs | 4 +- 4 files changed, 105 insertions(+), 36 deletions(-) diff --git a/desktop/Cargo.lock b/desktop/Cargo.lock index 784d836..9c96cbb 100644 --- a/desktop/Cargo.lock +++ b/desktop/Cargo.lock @@ -2587,7 +2587,7 @@ checksum = "d55d956fa96f5ec02be2e13af0e20391a5aa83d6a074e3ad368959d0fab299ea" [[package]] name = "qft-desktop" -version = "0.4.10" +version = "0.4.11" dependencies = [ "anyhow", "base64", diff --git a/desktop/Cargo.toml b/desktop/Cargo.toml index fbc31ca..f807869 100644 --- a/desktop/Cargo.toml +++ b/desktop/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "qft-desktop" -version = "0.4.10" +version = "0.4.11" edition = "2024" rust-version = "1.95" diff --git a/desktop/src/firewall.rs b/desktop/src/firewall.rs index cc83074..bf664a7 100644 --- a/desktop/src/firewall.rs +++ b/desktop/src/firewall.rs @@ -191,6 +191,34 @@ pub fn classify_probe(probe_output: &str) -> FirewallStatus { } } +/// 生成提权后要执行的放行脚本。 +/// +/// 不加 `#[cfg]`,好让脚本文本在任何平台上都能被测试——这段脚本上一版 +/// 里混进了一个 `\` 续行(bash 语法,PowerShell 用反引号 `), +/// 结果脚本在用户机器上直接语法错误,而外层 `Start-Process -Wait` 返回的 +/// 是启动器的退出码,程序还以为放行成功了。所以现在: +/// **一条命令占一行,绝不使用任何续行**,并且由脚本自己写一个成功标记, +/// 让调用方能验证它是真的跑完了。 +fn grant_script(exe: &str, marker: &str) -> String { + let exe = exe.replace('\'', "''"); + let marker = marker.replace('\'', "''"); + format!( + "$ErrorActionPreference = 'Stop'\r\n\ + $exe = '{exe}'\r\n\ + $marker = '{marker}'\r\n\ + # 先清掉一切针对本程序的入站阻止规则。Windows 在用户点掉「安全警报」\r\n\ + # 弹窗时会自动建这种规则,名字是程序名,且优先级高于任何放行规则。\r\n\ + $blocking = Get-NetFirewallApplicationFilter -Program $exe -ErrorAction SilentlyContinue | Get-NetFirewallRule -ErrorAction SilentlyContinue | Where-Object {{ $_.Direction -eq 'Inbound' -and $_.Action -eq 'Block' }}\r\n\ + if ($blocking) {{ $blocking | Remove-NetFirewallRule -ErrorAction SilentlyContinue }}\r\n\ + # 重建放行规则。Profile Any 是刻意的:Windows 把没见过的网络\r\n\ + # (尤其是 Direct AP 虚拟网卡)默认归为公用网络。\r\n\ + Remove-NetFirewallRule -DisplayName '{RULE_NAME}' -ErrorAction SilentlyContinue\r\n\ + New-NetFirewallRule -DisplayName '{RULE_NAME}' -Direction Inbound -Program $exe -Action Allow -Profile Any -Enabled True | Out-Null\r\n\ + # 只有真的建成了才写标记,调用方据此判断成败\r\n\ + Set-Content -Path $marker -Value 'ok' -Encoding ASCII\r\n" + ) +} + #[cfg(target_os = "windows")] fn run_powershell(script: &str) -> std::io::Result { use std::os::windows::process::CommandExt; @@ -238,27 +266,19 @@ pub fn grant() -> Result<()> { const CREATE_NO_WINDOW: u32 = 0x0800_0000; let exe = current_exe()?; - let exe_literal = exe.display().to_string().replace('\'', "''"); - let script = std::env::temp_dir().join(format!("qft-firewall-{}.ps1", std::process::id())); + let temp = std::env::temp_dir(); + let pid = std::process::id(); // 写成 .ps1 文件而不是把命令塞进 -ArgumentList:程序路径里带空格时, // 经过 PowerShell 再到子进程会被重新分词,引号层层嵌套极易出错。 // 脚本文件里的单引号字符串不会被二次解析。 - let content = format!( - "$ErrorActionPreference='Stop'\r\n\ - $exe = '{exe_literal}'\r\n\ - # 先清掉一切针对本程序的入站阻止规则。Windows 在用户点掉「安全警报」\r\n\ - # 弹窗时会自动建这种规则,名字是程序名,且优先级高于任何放行规则。\r\n\ - Get-NetFirewallApplicationFilter -Program $exe -ErrorAction SilentlyContinue |\r\n\ - \x20 Get-NetFirewallRule -ErrorAction SilentlyContinue |\r\n\ - \x20 Where-Object {{ $_.Direction -eq 'Inbound' -and $_.Action -eq 'Block' }} |\r\n\ - \x20 Remove-NetFirewallRule -ErrorAction SilentlyContinue\r\n\ - # 重建放行规则。profile=any 是刻意的:Windows 把没见过的网络\r\n\ - # (尤其是 Direct AP 虚拟网卡)默认归为公用网络。\r\n\ - Remove-NetFirewallRule -DisplayName '{RULE_NAME}' -ErrorAction SilentlyContinue\r\n\ - New-NetFirewallRule -DisplayName '{RULE_NAME}' -Direction Inbound -Program $exe \\\r\n\ - \x20 -Action Allow -Profile Any -Enabled True | Out-Null\r\n" - ); - std::fs::write(&script, content).context("写入临时放行脚本失败")?; + let script = temp.join(format!("qft-firewall-{pid}.ps1")); + let marker = temp.join(format!("qft-firewall-{pid}.ok")); + let _ = std::fs::remove_file(&marker); + std::fs::write( + &script, + grant_script(&exe.display().to_string(), &marker.display().to_string()), + ) + .context("写入临时放行脚本失败")?; let status = std::process::Command::new("powershell") .args([ @@ -275,9 +295,18 @@ pub fn grant() -> Result<()> { .status(); let _ = std::fs::remove_file(&script); + // 外层退出码只能说明「UAC 弹窗流程本身」没出错,说明不了脚本跑没跑通: + // Start-Process -Wait 返回的是启动器的退出码,不是被提权进程的。 + // 上一版就是因此把一个语法错误的脚本误报成了放行成功。 + let succeeded = marker.exists(); + let _ = std::fs::remove_file(&marker); match status { // 用户在 UAC 上点了「否」时 Start-Process 会失败,退出码非 0 - Ok(s) if s.success() => Ok(()), + Ok(s) if s.success() && succeeded => Ok(()), + Ok(s) if s.success() => bail!( + "提权成功但放行脚本没有跑完,规则未生效。请点「复制手动放行命令」,\ + 在管理员 PowerShell 里执行并把报错发出来" + ), Ok(_) => bail!("未获得管理员授权,防火墙规则没有添加"), Err(e) => bail!("调用提权失败:{e}"), } @@ -379,22 +408,18 @@ pub fn manual_instructions(port: u16) -> String { // -Profile Any 是必须的。这里早先写的是 Private,Domain,与本模块 // grant() 的注释自相矛盾,照抄的用户会重建出一条在公用网络上 // (也就是 Direct AP 虚拟网卡上)根本不适用的规则。 + // 剪贴板里**只放命令**,不放任何说明文字。用户是整段粘进 PowerShell 的, + // 混在里面的中文散文会被当成 cmdlet 名逐行报错,把真正的报错淹没掉。 + // 同理绝不使用 `\` 续行——那是 bash 语法,PowerShell 用反引号; + // 一条命令就写一行,宁可长。 format!( - "以管理员身份打开 PowerShell,依次执行:\n\n\ - # 1. 清掉系统自动创建的阻止规则(它优先级高于放行规则)\n\ - Get-NetFirewallApplicationFilter -Program \"{exe}\" |\n\ - \x20 Get-NetFirewallRule |\n\ - \x20 Where-Object {{ $_.Direction -eq 'Inbound' -and $_.Action -eq 'Block' }} |\n\ - \x20 Remove-NetFirewallRule\n\n\ - # 2. 建立覆盖所有网络类型的放行规则\n\ + "# 在管理员 PowerShell 中整段粘贴执行\n\ + $exe = \"{exe}\"\n\ + Get-NetFirewallApplicationFilter -Program $exe | Get-NetFirewallRule | Where-Object {{ $_.Direction -eq 'Inbound' -and $_.Action -eq 'Block' }} | Remove-NetFirewallRule\n\ Remove-NetFirewallRule -DisplayName \"{RULE_NAME}\" -ErrorAction SilentlyContinue\n\ - New-NetFirewallRule -DisplayName \"{RULE_NAME}\" -Direction Inbound \\\n\ - \x20 -Program \"{exe}\" -Action Allow -Profile Any\n\n\ - # 3. 确认没有开启「阻止所有传入连接」\n\ - Get-NetFirewallProfile | Select-Object Name,Enabled,AllowInboundRules\n\n\ - 第 3 步里 AllowInboundRules 若为 False,需要到\n\ - 「Windows 安全中心 → 防火墙和网络保护 → 对应网络」里\n\ - 取消勾选「阻止所有传入连接」,否则前两步都不会起作用。" + New-NetFirewallRule -DisplayName \"{RULE_NAME}\" -Direction Inbound -Program $exe -Action Allow -Profile Any -Enabled True\n\ + Get-NetFirewallProfile | Select-Object Name,Enabled,AllowInboundRules\n\ + Get-NetFirewallApplicationFilter -Program $exe | Get-NetFirewallRule | Select-Object DisplayName,Enabled,Direction,Action,Profile\n" ) } #[cfg(target_os = "macos")] @@ -591,10 +616,52 @@ mod tests { !text.contains("Private,Domain"), "照抄这条命令会重建出在 Direct AP 网卡上不适用的规则:{text}" ); + // 用户是整段粘进 PowerShell 的,任何非命令行都会被当成 cmdlet 报错 + for line in text.lines() { + let line = line.trim(); + assert!( + line.is_empty() + || line.starts_with('#') + || line.starts_with('$') + || line.starts_with("Get-") + || line.starts_with("New-") + || line.starts_with("Remove-"), + "剪贴板里只能有命令和注释,这一行会被 PowerShell 当成 cmdlet:{line}" + ); + } } let _ = text; } + /// `\` 续行是 bash 语法,PowerShell 用反引号。上一版在提权脚本和手动 + /// 命令里都写了 `\`,导致脚本在用户机器上直接语法错误,而外层退出码 + /// 又是 0,程序还误报了「放行成功」。 + #[test] + fn generated_scripts_use_no_backslash_continuation() { + let script = grant_script(r"C:\Program Files\QFT\qft-desktop.exe", r"C:\Temp\qft.ok"); + for (index, line) in script.lines().enumerate() { + assert!( + !line.trim_end().ends_with('\\'), + "第 {} 行用了 bash 的 `\\` 续行,PowerShell 不认:{line}", + index + 1 + ); + } + assert!(!manual_instructions(39393).contains("\\\n")); + } + + #[test] + fn grant_script_quotes_paths_and_reports_success() { + let script = grant_script(r"C:\Program Files\QFT\qft-desktop.exe", r"C:\Temp\qft.ok"); + // 带空格的路径必须整体在单引号里,否则会被重新分词 + assert!(script.contains(r"$exe = 'C:\Program Files\QFT\qft-desktop.exe'")); + // 必须写成功标记,否则调用方无法区分「跑通了」和「脚本报错了」 + assert!(script.contains("Set-Content -Path $marker")); + assert!(script.contains("-Profile Any")); + // 单引号要按 PowerShell 的规则翻倍转义 + let tricky = grant_script("C:\\o'brien\\qft.exe", "C:\\t.ok"); + assert!(tricky.contains("'C:\\o''brien\\qft.exe'"), "{tricky}"); + } + #[test] fn status_is_read_only_and_repeatable() { // 检测必须无副作用:连续调用结果一致,且不改动任何系统设置 diff --git a/desktop/src/main.rs b/desktop/src/main.rs index 0e6e370..f7d059e 100644 --- a/desktop/src/main.rs +++ b/desktop/src/main.rs @@ -28,7 +28,9 @@ use std::{ // a nominally larger page that is only decoded 10~18 times per second. const DEFAULT_CHUNK_SIZE: u16 = 320; const UI_FONT_NAME: &str = "qft-ui"; -const APP_VERSION: &str = "0.4.9"; +/// 直接取自 Cargo.toml。此前是手写常量,结果我改了 Cargo.toml 的版本号、 +/// 界面却还显示旧版本,用户据此无法判断自己跑的到底是不是新构建。 +const APP_VERSION: &str = env!("CARGO_PKG_VERSION"); fn main() -> eframe::Result { let options = eframe::NativeOptions {