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:
+100
-33
@@ -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
@@ -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 {
|
||||
|
||||
Reference in New Issue
Block a user