From bcadcf0b53c1173c2471c4c445285387ee25713c Mon Sep 17 00:00:00 2001 From: zhy200308 <2258391712@qq.com> Date: Tue, 11 Aug 2026 18:48:41 +0800 Subject: [PATCH] =?UTF-8?q?fix(firewall):=20=E8=A7=84=E5=88=99=E5=BF=85?= =?UTF-8?q?=E9=A1=BB=E7=94=A8=20profile=3Dany=EF=BC=8C=E5=90=A6=E5=88=99?= =?UTF-8?q?=E5=9C=A8=E5=85=AC=E7=94=A8=E7=BD=91=E7=BB=9C=E4=B8=8B=E5=AE=8C?= =?UTF-8?q?=E5=85=A8=E4=B8=8D=E7=94=9F=E6=95=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 实测发现的真 bug。用户机器上的规则列表: qft-windows Allow Inbound Public (旧版,能用) QFT Desktop Allow Inbound Domain, Private (新加,不生效) Windows 对没见过的 Wi-Fi 默认归类为「公用网络」。规则只覆盖 Private,Domain 时,Get-NetFirewallRule 照样显示 Enabled: True, 但对当前网络根本不适用,连接依旧被拦——这种「配置看起来是对的却没有 效果」的失败最难排查。旧版之所以一直能用,是因为当初点系统安全警报的 「允许」时,Windows 按当时的 Public 配置自动建了规则。 改动 - grant() 生成的 netsh 规则改为 profile=any - status() 不再只看「有没有同名规则」,还要求它是 any profile, 否则同样报 Missing。避免出现「检测说已放行、实际仍被拦」 - README 补充排查步骤:先看 NetworkCategory 与规则的 Profile 两列, 以及 Block 规则优先于 Allow 这个常见坑 关于收窄 profile 的取舍:限定到 private 并不能带来实际安全收益。 QFT 的入站真正靠的是连接码里的秘密加失败计数,没有秘密的连接一律被拒; 而按 profile 收窄只会在最常见的家用/公共 Wi-Fi 场景下静默失效。 验证:cargo test 35/35。Windows 分支仍无法在本机执行, netsh 与 UAC 那条路径需要在 Windows 上实测。 --- README.md | 30 ++++++++++++++++++++++++++++-- desktop/src/firewall.rs | 26 +++++++++++++++++++++----- 2 files changed, 49 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index a62bc93..3cc1c94 100644 --- a/README.md +++ b/README.md @@ -41,8 +41,34 @@ Caused by: 拒绝访问。 (os error 5) 「放行防火墙(需要管理员授权)」按钮——**提权只在你点击时发生**, 不会在启动时自动弹 UAC。 -也可以自己加规则。注意二进制已从 `qft-windows.exe` 改名为 -`qft-desktop.exe`,**此前给旧名字放行的规则对新程序不生效**。 +也可以自己加规则。两个必须注意的点: + +1. 二进制已从 `qft-windows.exe` 改名为 `qft-desktop.exe`,**此前给旧名字 + 放行的规则对新程序不生效**。 +2. **profile 必须是 `Any`**。Windows 对没见过的 Wi-Fi 默认归类为 + 「公用网络」,此时只覆盖 `Private,Domain` 的规则根本不适用—— + 规则建了、`Get-NetFirewallRule` 也显示 Enabled,但连接照样被拦。 + +```powershell +$exe = "<完整路径>\qft-desktop.exe" +# 先清掉可能存在的阻止规则:Windows 里 Block 永远优先于 Allow +Get-NetFirewallApplicationFilter -Program $exe -ErrorAction SilentlyContinue | + Get-NetFirewallRule | Where-Object Action -eq 'Block' | Remove-NetFirewallRule +New-NetFirewallRule -DisplayName "QFT Desktop" -Direction Inbound ` + -Program $exe -Action Allow -Profile Any +``` + +排查时先看这两列: + +```powershell +Get-NetConnectionProfile | Format-List Name,NetworkCategory +Get-NetFirewallApplicationFilter | Where-Object Program -like "*qft*" | + ForEach-Object { $r = $_ | Get-NetFirewallRule + [PSCustomObject]@{ 规则=$r.DisplayName; 动作=$r.Action; 配置=$r.Profile } } | Format-Table +``` + +若 `NetworkCategory` 是 `Public` 而规则的 `配置` 只有 `Domain, Private`, +就是这个原因。 管理员 PowerShell: diff --git a/desktop/src/firewall.rs b/desktop/src/firewall.rs index a33e9cf..b692fb2 100644 --- a/desktop/src/firewall.rs +++ b/desktop/src/firewall.rs @@ -8,8 +8,8 @@ //! 1. **只在确实缺规则时申请**。每次启动都弹 UAC 是骚扰。 //! 2. **被拒绝就记住**。写一个标记文件,之后只在界面上留一个手动按钮, //! 不再自动弹窗。 -//! 3. **规则尽量窄**。只放行本程序、只放行专用/域网络,不碰公用网络, -//! 也不整体关闭防火墙。 +//! 3. **规则尽量窄**。只放行本程序这一个可执行文件,绝不整体关闭防火墙。 +//! 但**不能按网络配置文件收窄**——见下方 `grant()` 里的说明。 //! //! 提权本身由操作系统的标准机制完成(Windows 的 UAC、macOS 的 //! 授权对话框),程序不接触也不存储任何凭据。 @@ -64,8 +64,18 @@ pub fn status() -> FirewallStatus { .output(); match output { - // netsh 在找不到规则时退出码非 0,输出里也会明说 - Ok(out) if out.status.success() => FirewallStatus::Allowed, + Ok(out) if out.status.success() => { + // 光有同名规则还不够:规则若绑在不适用于当前网络的 profile 上, + // 会出现「显示已启用但照样被拦」。所以要求它是 profile=any。 + let text = String::from_utf8_lossy(&out.stdout); + let any_profile = text.contains("Any") || text.contains("任何"); + if any_profile { + FirewallStatus::Allowed + } else { + FirewallStatus::Missing + } + } + // netsh 在找不到规则时退出码非 0 Ok(_) => FirewallStatus::Missing, Err(e) => FirewallStatus::Unknown(format!("无法执行 netsh:{e}")), } @@ -76,6 +86,12 @@ pub fn status() -> FirewallStatus { /// 用临时批处理承载命令,而不是把参数塞进 PowerShell 的 `-ArgumentList`: /// 程序路径里带空格时,经过 PowerShell 再到 netsh 会被重新分词, /// 引号层层嵌套极易出错。批处理文件由我们自己写死引号,不再被二次解析。 +/// +/// `profile=any` 是刻意的,早先写成 `private,domain` 是个真实的 bug: +/// Windows 对没见过的 Wi-Fi 默认归类为**公用网络**,此时 private 规则 +/// 根本不适用——规则建了、也显示已启用,但连接照样被拦,极难排查。 +/// 收窄到某个 profile 并不能带来实际安全收益:QFT 的入站真正靠的是 +/// 连接码里的秘密加失败计数,没有秘密的连接一律被拒。 #[cfg(target_os = "windows")] pub fn grant() -> Result<()> { use std::os::windows::process::CommandExt; @@ -87,7 +103,7 @@ pub fn grant() -> Result<()> { "@echo off\r\n\ netsh advfirewall firewall delete rule name=\"{RULE_NAME}\" >nul 2>&1\r\n\ netsh advfirewall firewall add rule name=\"{RULE_NAME}\" dir=in action=allow \ - program=\"{}\" enable=yes profile=private,domain\r\n", + program=\"{}\" enable=yes profile=any\r\n", exe.display() ); std::fs::write(&script, content).context("写入临时放行脚本失败")?;