fix(firewall): 规则必须用 profile=any,否则在公用网络下完全不生效

实测发现的真 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 上实测。
This commit is contained in:
zhy200308
2026-08-11 18:48:41 +08:00
parent 0f0dbaef47
commit bcadcf0b53
2 changed files with 49 additions and 7 deletions
+28 -2
View File
@@ -41,8 +41,34 @@ Caused by: 拒绝访问。 (os error 5)
「放行防火墙(需要管理员授权)」按钮——**提权只在你点击时发生**, 「放行防火墙(需要管理员授权)」按钮——**提权只在你点击时发生**,
不会在启动时自动弹 UAC。 不会在启动时自动弹 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: 管理员 PowerShell:
+21 -5
View File
@@ -8,8 +8,8 @@
//! 1. **只在确实缺规则时申请**。每次启动都弹 UAC 是骚扰。 //! 1. **只在确实缺规则时申请**。每次启动都弹 UAC 是骚扰。
//! 2. **被拒绝就记住**。写一个标记文件,之后只在界面上留一个手动按钮, //! 2. **被拒绝就记住**。写一个标记文件,之后只在界面上留一个手动按钮,
//! 不再自动弹窗。 //! 不再自动弹窗。
//! 3. **规则尽量窄**。只放行本程序、只放行专用/域网络,不碰公用网络, //! 3. **规则尽量窄**。只放行本程序这一个可执行文件,绝不整体关闭防火墙。
//! 也不整体关闭防火墙。 //! 但**不能按网络配置文件收窄**——见下方 `grant()` 里的说明。
//! //!
//! 提权本身由操作系统的标准机制完成(Windows 的 UAC、macOS 的 //! 提权本身由操作系统的标准机制完成(Windows 的 UAC、macOS 的
//! 授权对话框),程序不接触也不存储任何凭据。 //! 授权对话框),程序不接触也不存储任何凭据。
@@ -64,8 +64,18 @@ pub fn status() -> FirewallStatus {
.output(); .output();
match output { match output {
// netsh 在找不到规则时退出码非 0,输出里也会明说 Ok(out) if out.status.success() => {
Ok(out) if out.status.success() => FirewallStatus::Allowed, // 光有同名规则还不够:规则若绑在不适用于当前网络的 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, Ok(_) => FirewallStatus::Missing,
Err(e) => FirewallStatus::Unknown(format!("无法执行 netsh:{e}")), Err(e) => FirewallStatus::Unknown(format!("无法执行 netsh:{e}")),
} }
@@ -76,6 +86,12 @@ pub fn status() -> FirewallStatus {
/// 用临时批处理承载命令,而不是把参数塞进 PowerShell 的 `-ArgumentList`: /// 用临时批处理承载命令,而不是把参数塞进 PowerShell 的 `-ArgumentList`:
/// 程序路径里带空格时,经过 PowerShell 再到 netsh 会被重新分词, /// 程序路径里带空格时,经过 PowerShell 再到 netsh 会被重新分词,
/// 引号层层嵌套极易出错。批处理文件由我们自己写死引号,不再被二次解析。 /// 引号层层嵌套极易出错。批处理文件由我们自己写死引号,不再被二次解析。
///
/// `profile=any` 是刻意的,早先写成 `private,domain` 是个真实的 bug:
/// Windows 对没见过的 Wi-Fi 默认归类为**公用网络**,此时 private 规则
/// 根本不适用——规则建了、也显示已启用,但连接照样被拦,极难排查。
/// 收窄到某个 profile 并不能带来实际安全收益:QFT 的入站真正靠的是
/// 连接码里的秘密加失败计数,没有秘密的连接一律被拒。
#[cfg(target_os = "windows")] #[cfg(target_os = "windows")]
pub fn grant() -> Result<()> { pub fn grant() -> Result<()> {
use std::os::windows::process::CommandExt; use std::os::windows::process::CommandExt;
@@ -87,7 +103,7 @@ pub fn grant() -> Result<()> {
"@echo off\r\n\ "@echo off\r\n\
netsh advfirewall firewall delete rule name=\"{RULE_NAME}\" >nul 2>&1\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 \ 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() exe.display()
); );
std::fs::write(&script, content).context("写入临时放行脚本失败")?; std::fs::write(&script, content).context("写入临时放行脚本失败")?;