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("写入临时放行脚本失败")?;