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:
Generated
+1
-1
@@ -2587,7 +2587,7 @@ checksum = "d55d956fa96f5ec02be2e13af0e20391a5aa83d6a074e3ad368959d0fab299ea"
|
|||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "qft-desktop"
|
name = "qft-desktop"
|
||||||
version = "0.4.10"
|
version = "0.4.11"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"anyhow",
|
"anyhow",
|
||||||
"base64",
|
"base64",
|
||||||
|
|||||||
+1
-1
@@ -1,6 +1,6 @@
|
|||||||
[package]
|
[package]
|
||||||
name = "qft-desktop"
|
name = "qft-desktop"
|
||||||
version = "0.4.10"
|
version = "0.4.11"
|
||||||
edition = "2024"
|
edition = "2024"
|
||||||
rust-version = "1.95"
|
rust-version = "1.95"
|
||||||
|
|
||||||
|
|||||||
+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")]
|
#[cfg(target_os = "windows")]
|
||||||
fn run_powershell(script: &str) -> std::io::Result<std::process::Output> {
|
fn run_powershell(script: &str) -> std::io::Result<std::process::Output> {
|
||||||
use std::os::windows::process::CommandExt;
|
use std::os::windows::process::CommandExt;
|
||||||
@@ -238,27 +266,19 @@ pub fn grant() -> Result<()> {
|
|||||||
const CREATE_NO_WINDOW: u32 = 0x0800_0000;
|
const CREATE_NO_WINDOW: u32 = 0x0800_0000;
|
||||||
|
|
||||||
let exe = current_exe()?;
|
let exe = current_exe()?;
|
||||||
let exe_literal = exe.display().to_string().replace('\'', "''");
|
let temp = std::env::temp_dir();
|
||||||
let script = std::env::temp_dir().join(format!("qft-firewall-{}.ps1", std::process::id()));
|
let pid = std::process::id();
|
||||||
// 写成 .ps1 文件而不是把命令塞进 -ArgumentList:程序路径里带空格时,
|
// 写成 .ps1 文件而不是把命令塞进 -ArgumentList:程序路径里带空格时,
|
||||||
// 经过 PowerShell 再到子进程会被重新分词,引号层层嵌套极易出错。
|
// 经过 PowerShell 再到子进程会被重新分词,引号层层嵌套极易出错。
|
||||||
// 脚本文件里的单引号字符串不会被二次解析。
|
// 脚本文件里的单引号字符串不会被二次解析。
|
||||||
let content = format!(
|
let script = temp.join(format!("qft-firewall-{pid}.ps1"));
|
||||||
"$ErrorActionPreference='Stop'\r\n\
|
let marker = temp.join(format!("qft-firewall-{pid}.ok"));
|
||||||
$exe = '{exe_literal}'\r\n\
|
let _ = std::fs::remove_file(&marker);
|
||||||
# 先清掉一切针对本程序的入站阻止规则。Windows 在用户点掉「安全警报」\r\n\
|
std::fs::write(
|
||||||
# 弹窗时会自动建这种规则,名字是程序名,且优先级高于任何放行规则。\r\n\
|
&script,
|
||||||
Get-NetFirewallApplicationFilter -Program $exe -ErrorAction SilentlyContinue |\r\n\
|
grant_script(&exe.display().to_string(), &marker.display().to_string()),
|
||||||
\x20 Get-NetFirewallRule -ErrorAction SilentlyContinue |\r\n\
|
)
|
||||||
\x20 Where-Object {{ $_.Direction -eq 'Inbound' -and $_.Action -eq 'Block' }} |\r\n\
|
.context("写入临时放行脚本失败")?;
|
||||||
\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 status = std::process::Command::new("powershell")
|
let status = std::process::Command::new("powershell")
|
||||||
.args([
|
.args([
|
||||||
@@ -275,9 +295,18 @@ pub fn grant() -> Result<()> {
|
|||||||
.status();
|
.status();
|
||||||
|
|
||||||
let _ = std::fs::remove_file(&script);
|
let _ = std::fs::remove_file(&script);
|
||||||
|
// 外层退出码只能说明「UAC 弹窗流程本身」没出错,说明不了脚本跑没跑通:
|
||||||
|
// Start-Process -Wait 返回的是启动器的退出码,不是被提权进程的。
|
||||||
|
// 上一版就是因此把一个语法错误的脚本误报成了放行成功。
|
||||||
|
let succeeded = marker.exists();
|
||||||
|
let _ = std::fs::remove_file(&marker);
|
||||||
match status {
|
match status {
|
||||||
// 用户在 UAC 上点了「否」时 Start-Process 会失败,退出码非 0
|
// 用户在 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!("未获得管理员授权,防火墙规则没有添加"),
|
Ok(_) => bail!("未获得管理员授权,防火墙规则没有添加"),
|
||||||
Err(e) => bail!("调用提权失败:{e}"),
|
Err(e) => bail!("调用提权失败:{e}"),
|
||||||
}
|
}
|
||||||
@@ -379,22 +408,18 @@ pub fn manual_instructions(port: u16) -> String {
|
|||||||
// -Profile Any 是必须的。这里早先写的是 Private,Domain,与本模块
|
// -Profile Any 是必须的。这里早先写的是 Private,Domain,与本模块
|
||||||
// grant() 的注释自相矛盾,照抄的用户会重建出一条在公用网络上
|
// grant() 的注释自相矛盾,照抄的用户会重建出一条在公用网络上
|
||||||
// (也就是 Direct AP 虚拟网卡上)根本不适用的规则。
|
// (也就是 Direct AP 虚拟网卡上)根本不适用的规则。
|
||||||
|
// 剪贴板里**只放命令**,不放任何说明文字。用户是整段粘进 PowerShell 的,
|
||||||
|
// 混在里面的中文散文会被当成 cmdlet 名逐行报错,把真正的报错淹没掉。
|
||||||
|
// 同理绝不使用 `\` 续行——那是 bash 语法,PowerShell 用反引号;
|
||||||
|
// 一条命令就写一行,宁可长。
|
||||||
format!(
|
format!(
|
||||||
"以管理员身份打开 PowerShell,依次执行:\n\n\
|
"# 在管理员 PowerShell 中整段粘贴执行\n\
|
||||||
# 1. 清掉系统自动创建的阻止规则(它优先级高于放行规则)\n\
|
$exe = \"{exe}\"\n\
|
||||||
Get-NetFirewallApplicationFilter -Program \"{exe}\" |\n\
|
Get-NetFirewallApplicationFilter -Program $exe | Get-NetFirewallRule | Where-Object {{ $_.Direction -eq 'Inbound' -and $_.Action -eq 'Block' }} | Remove-NetFirewallRule\n\
|
||||||
\x20 Get-NetFirewallRule |\n\
|
|
||||||
\x20 Where-Object {{ $_.Direction -eq 'Inbound' -and $_.Action -eq 'Block' }} |\n\
|
|
||||||
\x20 Remove-NetFirewallRule\n\n\
|
|
||||||
# 2. 建立覆盖所有网络类型的放行规则\n\
|
|
||||||
Remove-NetFirewallRule -DisplayName \"{RULE_NAME}\" -ErrorAction SilentlyContinue\n\
|
Remove-NetFirewallRule -DisplayName \"{RULE_NAME}\" -ErrorAction SilentlyContinue\n\
|
||||||
New-NetFirewallRule -DisplayName \"{RULE_NAME}\" -Direction Inbound \\\n\
|
New-NetFirewallRule -DisplayName \"{RULE_NAME}\" -Direction Inbound -Program $exe -Action Allow -Profile Any -Enabled True\n\
|
||||||
\x20 -Program \"{exe}\" -Action Allow -Profile Any\n\n\
|
Get-NetFirewallProfile | Select-Object Name,Enabled,AllowInboundRules\n\
|
||||||
# 3. 确认没有开启「阻止所有传入连接」\n\
|
Get-NetFirewallApplicationFilter -Program $exe | Get-NetFirewallRule | Select-Object DisplayName,Enabled,Direction,Action,Profile\n"
|
||||||
Get-NetFirewallProfile | Select-Object Name,Enabled,AllowInboundRules\n\n\
|
|
||||||
第 3 步里 AllowInboundRules 若为 False,需要到\n\
|
|
||||||
「Windows 安全中心 → 防火墙和网络保护 → 对应网络」里\n\
|
|
||||||
取消勾选「阻止所有传入连接」,否则前两步都不会起作用。"
|
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
#[cfg(target_os = "macos")]
|
#[cfg(target_os = "macos")]
|
||||||
@@ -591,10 +616,52 @@ mod tests {
|
|||||||
!text.contains("Private,Domain"),
|
!text.contains("Private,Domain"),
|
||||||
"照抄这条命令会重建出在 Direct AP 网卡上不适用的规则:{text}"
|
"照抄这条命令会重建出在 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;
|
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]
|
#[test]
|
||||||
fn status_is_read_only_and_repeatable() {
|
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.
|
// a nominally larger page that is only decoded 10~18 times per second.
|
||||||
const DEFAULT_CHUNK_SIZE: u16 = 320;
|
const DEFAULT_CHUNK_SIZE: u16 = 320;
|
||||||
const UI_FONT_NAME: &str = "qft-ui";
|
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 {
|
fn main() -> eframe::Result {
|
||||||
let options = eframe::NativeOptions {
|
let options = eframe::NativeOptions {
|
||||||
|
|||||||
Reference in New Issue
Block a user