fix(desktop): 提权脚本用了 bash 的 \ 续行导致放行必然失败,且失败被误报为成功

用户的终端输出把我上一版的 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。
This commit is contained in:
zhy200308
2026-08-12 10:54:05 +08:00
parent 2bb6ce63ae
commit 9c16cc1690
4 changed files with 105 additions and 36 deletions
+100 -33
View File
@@ -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<std::process::Output> {
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() {
// 检测必须无副作用:连续调用结果一致,且不改动任何系统设置
+3 -1
View File
@@ -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 {