feat(desktop): 启动接收时自动检测并申请防火墙放行
上一次实测卡在「连接码解析正确但连不上」,根因是对端 Windows 防火墙 拦截入站,而用户几乎不可能自己联想到这一层。新增 firewall.rs, 在点「启动接收」时自动检测,缺规则就申请一次放行。 三条设计约束 1. 只在确实缺规则时申请。每次启动都弹 UAC 属于骚扰。 2. 被拒绝就记住。写标记文件到配置目录,之后只在界面留一个手动按钮, 不再自动弹窗;用户点「放行防火墙」会清除标记重新申请。 3. 规则尽量窄。只放行本程序、只放行专用/域网络,不碰公用网络, 更不整体关闭防火墙。 提权全部交给操作系统的标准机制(Windows UAC、macOS 授权对话框), 程序不接触也不存储任何凭据。 各平台 - Windows:netsh 查规则;添加时把命令写进临时批处理再用 Start-Process -Verb RunAs 提权执行。不把参数塞进 PowerShell 的 -ArgumentList —— 程序路径含空格时会被二次分词,引号层层嵌套极易出错, 批处理里的引号由我们自己写死,不再被重新解析 - macOS:先查 socketfilterfw 全局状态,防火墙没开就直接判定无需处理; 否则查本程序是否被拦,需要时用 osascript 的管理员授权添加。 路径含引号或反斜杠时拒绝拼接命令,改为提示手动操作 - Linux:只检测与给出 ufw / firewalld 的命令,不自动改规则。 各发行版防火墙前端差异过大,自动修改风险高于收益 界面 接收页在检测到可能被拦时显示橙色提示,附「放行防火墙」与 「复制手动放行命令」两个按钮。已放行或防火墙未开启时不显示任何东西。 验证:cargo test 35/35。防火墙相关 3 项均为只读,不改动任何系统设置: 状态查询不 panic 且分类正确、手动说明包含可操作信息、拒绝标记可持久化 往返。本机实测返回 Allowed(防火墙未开启),符合预期。 未验证:Windows 与 Linux 分支在这台 Mac 上无法执行, netsh/UAC 那条路径需要在 Windows 上实测。
This commit is contained in:
@@ -0,0 +1,301 @@
|
|||||||
|
//! 系统防火墙放行。
|
||||||
|
//!
|
||||||
|
//! 接收端要监听入站 TCP,而 Windows 防火墙默认拦截未授权程序的入站连接,
|
||||||
|
//! 表现是「对方能解析连接码,但连接一直超时」——这类问题用户几乎不可能
|
||||||
|
//! 自己联想到防火墙。所以由程序主动检测并申请放行。
|
||||||
|
//!
|
||||||
|
//! 三条设计约束:
|
||||||
|
//! 1. **只在确实缺规则时申请**。每次启动都弹 UAC 是骚扰。
|
||||||
|
//! 2. **被拒绝就记住**。写一个标记文件,之后只在界面上留一个手动按钮,
|
||||||
|
//! 不再自动弹窗。
|
||||||
|
//! 3. **规则尽量窄**。只放行本程序、只放行专用/域网络,不碰公用网络,
|
||||||
|
//! 也不整体关闭防火墙。
|
||||||
|
//!
|
||||||
|
//! 提权本身由操作系统的标准机制完成(Windows 的 UAC、macOS 的
|
||||||
|
//! 授权对话框),程序不接触也不存储任何凭据。
|
||||||
|
|
||||||
|
use anyhow::{bail, Context, Result};
|
||||||
|
use std::path::PathBuf;
|
||||||
|
|
||||||
|
/// 规则显示名。检测与添加都用它,改名会导致旧规则失效。
|
||||||
|
pub const RULE_NAME: &str = "QFT Desktop";
|
||||||
|
|
||||||
|
#[derive(Clone, Debug, PartialEq, Eq)]
|
||||||
|
pub enum FirewallStatus {
|
||||||
|
/// 已放行,或系统防火墙未开启,总之入站不会被拦
|
||||||
|
Allowed,
|
||||||
|
/// 缺少放行规则,入站很可能被拦
|
||||||
|
Missing,
|
||||||
|
/// 查不出来(命令不可用、输出无法解析等),不要据此吓唬用户
|
||||||
|
Unknown(String),
|
||||||
|
/// 本平台不做自动放行
|
||||||
|
Unsupported(&'static str),
|
||||||
|
}
|
||||||
|
|
||||||
|
impl FirewallStatus {
|
||||||
|
pub fn needs_action(&self) -> bool {
|
||||||
|
matches!(self, Self::Missing)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// 用户拒绝过提权的标记。存在则不再自动弹窗。
|
||||||
|
fn declined_marker() -> PathBuf {
|
||||||
|
crate::platform::config_dir().join("firewall-declined")
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn was_declined() -> bool {
|
||||||
|
declined_marker().is_file()
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn remember_declined() {
|
||||||
|
let path = declined_marker();
|
||||||
|
if let Some(parent) = path.parent() {
|
||||||
|
let _ = crate::platform::ensure_dir(parent);
|
||||||
|
}
|
||||||
|
let _ = std::fs::write(&path, b"1");
|
||||||
|
}
|
||||||
|
|
||||||
|
pub fn forget_declined() {
|
||||||
|
let _ = std::fs::remove_file(declined_marker());
|
||||||
|
}
|
||||||
|
|
||||||
|
fn current_exe() -> Result<PathBuf> {
|
||||||
|
std::env::current_exe().context("无法获取本程序路径")
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------- Windows
|
||||||
|
|
||||||
|
#[cfg(target_os = "windows")]
|
||||||
|
pub fn status() -> FirewallStatus {
|
||||||
|
use std::os::windows::process::CommandExt;
|
||||||
|
const CREATE_NO_WINDOW: u32 = 0x0800_0000;
|
||||||
|
|
||||||
|
let output = std::process::Command::new("netsh")
|
||||||
|
.args([
|
||||||
|
"advfirewall",
|
||||||
|
"firewall",
|
||||||
|
"show",
|
||||||
|
"rule",
|
||||||
|
&format!("name={RULE_NAME}"),
|
||||||
|
])
|
||||||
|
.creation_flags(CREATE_NO_WINDOW)
|
||||||
|
.output();
|
||||||
|
|
||||||
|
match output {
|
||||||
|
// netsh 在找不到规则时退出码非 0,输出里也会明说
|
||||||
|
Ok(out) if out.status.success() => FirewallStatus::Allowed,
|
||||||
|
Ok(_) => FirewallStatus::Missing,
|
||||||
|
Err(e) => FirewallStatus::Unknown(format!("无法执行 netsh:{e}")),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// 触发 UAC 并添加入站放行规则。
|
||||||
|
///
|
||||||
|
/// 用临时批处理承载命令,而不是把参数塞进 PowerShell 的 `-ArgumentList`:
|
||||||
|
/// 程序路径里带空格时,经过 PowerShell 再到 netsh 会被重新分词,
|
||||||
|
/// 引号层层嵌套极易出错。批处理文件由我们自己写死引号,不再被二次解析。
|
||||||
|
#[cfg(target_os = "windows")]
|
||||||
|
pub fn grant() -> Result<()> {
|
||||||
|
use std::os::windows::process::CommandExt;
|
||||||
|
const CREATE_NO_WINDOW: u32 = 0x0800_0000;
|
||||||
|
|
||||||
|
let exe = current_exe()?;
|
||||||
|
let script = std::env::temp_dir().join(format!("qft-firewall-{}.bat", std::process::id()));
|
||||||
|
let content = format!(
|
||||||
|
"@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",
|
||||||
|
exe.display()
|
||||||
|
);
|
||||||
|
std::fs::write(&script, content).context("写入临时放行脚本失败")?;
|
||||||
|
|
||||||
|
let status = std::process::Command::new("powershell")
|
||||||
|
.args([
|
||||||
|
"-NoProfile",
|
||||||
|
"-WindowStyle",
|
||||||
|
"Hidden",
|
||||||
|
"-Command",
|
||||||
|
&format!(
|
||||||
|
"Start-Process -FilePath cmd -ArgumentList '/c','\"{}\"' -Verb RunAs -WindowStyle Hidden -Wait",
|
||||||
|
script.display()
|
||||||
|
),
|
||||||
|
])
|
||||||
|
.creation_flags(CREATE_NO_WINDOW)
|
||||||
|
.status();
|
||||||
|
|
||||||
|
let _ = std::fs::remove_file(&script);
|
||||||
|
match status {
|
||||||
|
// 用户在 UAC 上点了「否」时 Start-Process 会失败,退出码非 0
|
||||||
|
Ok(s) if s.success() => Ok(()),
|
||||||
|
Ok(_) => bail!("未获得管理员授权,防火墙规则没有添加"),
|
||||||
|
Err(e) => bail!("调用提权失败:{e}"),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------- macOS
|
||||||
|
|
||||||
|
#[cfg(target_os = "macos")]
|
||||||
|
pub fn status() -> FirewallStatus {
|
||||||
|
const TOOL: &str = "/usr/libexec/ApplicationFirewall/socketfilterfw";
|
||||||
|
if !std::path::Path::new(TOOL).exists() {
|
||||||
|
return FirewallStatus::Unknown("系统上没有 socketfilterfw".into());
|
||||||
|
}
|
||||||
|
|
||||||
|
// 应用层防火墙没开时,入站根本不会被拦,不需要做任何事
|
||||||
|
match std::process::Command::new(TOOL).arg("--getglobalstate").output() {
|
||||||
|
Ok(out) => {
|
||||||
|
let text = String::from_utf8_lossy(&out.stdout);
|
||||||
|
if text.contains("disabled") {
|
||||||
|
return FirewallStatus::Allowed;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Err(e) => return FirewallStatus::Unknown(format!("无法执行 socketfilterfw:{e}")),
|
||||||
|
}
|
||||||
|
|
||||||
|
let Ok(exe) = current_exe() else {
|
||||||
|
return FirewallStatus::Unknown("无法获取本程序路径".into());
|
||||||
|
};
|
||||||
|
match std::process::Command::new(TOOL)
|
||||||
|
.args(["--getappblocked", &exe.display().to_string()])
|
||||||
|
.output()
|
||||||
|
{
|
||||||
|
Ok(out) => {
|
||||||
|
let text = String::from_utf8_lossy(&out.stdout).to_lowercase();
|
||||||
|
if text.contains("blocked") && !text.contains("not blocked") {
|
||||||
|
FirewallStatus::Missing
|
||||||
|
} else {
|
||||||
|
FirewallStatus::Allowed
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Err(e) => FirewallStatus::Unknown(format!("查询失败:{e}")),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// 通过系统授权对话框把本程序加入放行列表。
|
||||||
|
///
|
||||||
|
/// macOS 通常会在首次监听时自己弹「是否允许接受传入网络连接」,
|
||||||
|
/// 那一步就够了;这里只处理用户当时点了「拒绝」的情况。
|
||||||
|
#[cfg(target_os = "macos")]
|
||||||
|
pub fn grant() -> Result<()> {
|
||||||
|
let exe = current_exe()?;
|
||||||
|
let path = exe.display().to_string();
|
||||||
|
if path.contains('"') || path.contains('\\') {
|
||||||
|
bail!("程序路径包含无法安全转义的字符,请手动在「系统设置 → 网络 → 防火墙」里放行")
|
||||||
|
}
|
||||||
|
let inner = format!(
|
||||||
|
"/usr/libexec/ApplicationFirewall/socketfilterfw --add '{path}' && \
|
||||||
|
/usr/libexec/ApplicationFirewall/socketfilterfw --unblockapp '{path}'"
|
||||||
|
);
|
||||||
|
let script = format!("do shell script \"{inner}\" with administrator privileges");
|
||||||
|
|
||||||
|
let status = std::process::Command::new("osascript")
|
||||||
|
.args(["-e", &script])
|
||||||
|
.status()
|
||||||
|
.context("调用 osascript 失败")?;
|
||||||
|
if status.success() {
|
||||||
|
Ok(())
|
||||||
|
} else {
|
||||||
|
bail!("未获得授权,防火墙放行没有生效")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------- Linux
|
||||||
|
|
||||||
|
#[cfg(all(unix, not(target_os = "macos")))]
|
||||||
|
pub fn status() -> FirewallStatus {
|
||||||
|
// 各发行版的防火墙前端差异过大(ufw / firewalld / 裸 iptables / nftables),
|
||||||
|
// 自动改规则风险高于收益,只做检测与提示。
|
||||||
|
FirewallStatus::Unsupported("Linux 上请按下方提示手动放行")
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(all(unix, not(target_os = "macos")))]
|
||||||
|
pub fn grant() -> Result<()> {
|
||||||
|
bail!("Linux 上不自动修改防火墙,请按界面提示手动执行")
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------- 手动说明
|
||||||
|
|
||||||
|
/// 自动放行失败或不支持时,给用户可以照抄的命令。
|
||||||
|
pub fn manual_instructions(port: u16) -> String {
|
||||||
|
let exe = current_exe()
|
||||||
|
.map(|p| p.display().to_string())
|
||||||
|
.unwrap_or_else(|_| "qft-desktop".into());
|
||||||
|
|
||||||
|
#[cfg(target_os = "windows")]
|
||||||
|
{
|
||||||
|
format!(
|
||||||
|
"以管理员身份打开 PowerShell,执行:\n\n\
|
||||||
|
New-NetFirewallRule -DisplayName \"{RULE_NAME}\" -Direction Inbound \\\n\
|
||||||
|
\x20 -Program \"{exe}\" -Action Allow -Profile Private,Domain\n\n\
|
||||||
|
或在「允许应用通过 Windows Defender 防火墙」里勾选该程序的专用网络。"
|
||||||
|
)
|
||||||
|
}
|
||||||
|
#[cfg(target_os = "macos")]
|
||||||
|
{
|
||||||
|
let _ = port;
|
||||||
|
format!(
|
||||||
|
"打开「系统设置 → 网络 → 防火墙 → 选项」,把下面这个程序设为\
|
||||||
|
「允许传入连接」:\n\n{exe}\n\n\
|
||||||
|
若防火墙本身是关闭的,则无需任何操作。"
|
||||||
|
)
|
||||||
|
}
|
||||||
|
#[cfg(all(unix, not(target_os = "macos")))]
|
||||||
|
{
|
||||||
|
let _ = exe;
|
||||||
|
format!(
|
||||||
|
"按你所用的防火墙执行其一:\n\n\
|
||||||
|
ufw: sudo ufw allow {port}/tcp && sudo ufw allow {}/udp\n\
|
||||||
|
firewalld: sudo firewall-cmd --add-port={port}/tcp --add-port={}/udp --permanent && sudo firewall-cmd --reload",
|
||||||
|
port - 1,
|
||||||
|
port - 1,
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[cfg(test)]
|
||||||
|
mod tests {
|
||||||
|
use super::*;
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn status_query_never_panics_and_is_classified() {
|
||||||
|
// 只做只读查询,不改动任何系统设置
|
||||||
|
let value = status();
|
||||||
|
match &value {
|
||||||
|
FirewallStatus::Allowed
|
||||||
|
| FirewallStatus::Missing
|
||||||
|
| FirewallStatus::Unsupported(_) => {}
|
||||||
|
FirewallStatus::Unknown(reason) => assert!(!reason.is_empty(), "未知原因不能为空"),
|
||||||
|
}
|
||||||
|
// 只有 Missing 才该触发后续动作
|
||||||
|
assert_eq!(
|
||||||
|
value.needs_action(),
|
||||||
|
matches!(value, FirewallStatus::Missing)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn manual_instructions_mention_the_actual_program() {
|
||||||
|
let text = manual_instructions(39393);
|
||||||
|
assert!(!text.trim().is_empty());
|
||||||
|
// 说明里必须出现可操作的东西:程序路径或具体端口
|
||||||
|
assert!(
|
||||||
|
text.contains("qft") || text.contains("39393") || text.contains("防火墙"),
|
||||||
|
"说明应包含可操作信息:{text}"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn declined_marker_round_trips() {
|
||||||
|
// 记住/遗忘的状态必须能持久化,否则每次启动都会重新弹窗
|
||||||
|
let existed = was_declined();
|
||||||
|
remember_declined();
|
||||||
|
assert!(was_declined(), "记录拒绝后应能读回");
|
||||||
|
forget_declined();
|
||||||
|
assert!(!was_declined(), "清除后应恢复");
|
||||||
|
if existed {
|
||||||
|
remember_declined();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
+64
-1
@@ -3,6 +3,7 @@ mod client;
|
|||||||
mod connect_code;
|
mod connect_code;
|
||||||
mod direct_ap;
|
mod direct_ap;
|
||||||
mod discovery;
|
mod discovery;
|
||||||
|
mod firewall;
|
||||||
mod optical_cache;
|
mod optical_cache;
|
||||||
mod pairing;
|
mod pairing;
|
||||||
mod platform;
|
mod platform;
|
||||||
@@ -144,6 +145,8 @@ struct PcPeerState {
|
|||||||
total: u64,
|
total: u64,
|
||||||
started: Option<Instant>,
|
started: Option<Instant>,
|
||||||
status: String,
|
status: String,
|
||||||
|
firewall: firewall::FirewallStatus,
|
||||||
|
firewall_note: String,
|
||||||
}
|
}
|
||||||
|
|
||||||
struct QftApp {
|
struct QftApp {
|
||||||
@@ -236,7 +239,9 @@ impl QftApp {
|
|||||||
done: 0,
|
done: 0,
|
||||||
total: 0,
|
total: 0,
|
||||||
started: None,
|
started: None,
|
||||||
status: "接收方启动后会显示 6 位配对码;发送方搜索到对方并输入该码即可传输。".into(),
|
status: "接收方启动后会显示连接码;发送方输入该码即可传输。".into(),
|
||||||
|
firewall: firewall::FirewallStatus::Unknown("尚未检测".into()),
|
||||||
|
firewall_note: String::new(),
|
||||||
},
|
},
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1058,6 +1063,35 @@ impl QftApp {
|
|||||||
})
|
})
|
||||||
.collect();
|
.collect();
|
||||||
|
|
||||||
|
if self.pc.firewall.needs_action() || !self.pc.firewall_note.is_empty() {
|
||||||
|
ui.add_space(10.0);
|
||||||
|
ui.group(|ui| {
|
||||||
|
let blocked = self.pc.firewall.needs_action();
|
||||||
|
let color = if blocked {
|
||||||
|
egui::Color32::from_rgb(220, 140, 60)
|
||||||
|
} else {
|
||||||
|
egui::Color32::from_rgb(80, 200, 120)
|
||||||
|
};
|
||||||
|
ui.horizontal_wrapped(|ui| {
|
||||||
|
ui.colored_label(color, if blocked { "⚠ 系统防火墙可能拦截入站连接" } else { "● 防火墙" });
|
||||||
|
if !self.pc.firewall_note.is_empty() {
|
||||||
|
ui.label(&self.pc.firewall_note);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
if blocked {
|
||||||
|
ui.horizontal_wrapped(|ui| {
|
||||||
|
if ui.button("放行防火墙").clicked() {
|
||||||
|
firewall::forget_declined();
|
||||||
|
self.ensure_firewall();
|
||||||
|
}
|
||||||
|
if ui.small_button("复制手动放行命令").clicked() {
|
||||||
|
ui.ctx().copy_text(firewall::manual_instructions(port));
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
ui.add_space(14.0);
|
ui.add_space(14.0);
|
||||||
ui.group(|ui| {
|
ui.group(|ui| {
|
||||||
ui.heading("把连接码告诉发送方");
|
ui.heading("把连接码告诉发送方");
|
||||||
@@ -1194,9 +1228,38 @@ impl QftApp {
|
|||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// 检测防火墙,必要时**自动**申请一次放行。
|
||||||
|
///
|
||||||
|
/// 只在确实缺规则、且用户此前没拒绝过时才弹系统授权框——
|
||||||
|
/// 每次启动都弹 UAC 属于骚扰。用户点过「否」就记住,
|
||||||
|
/// 之后只在界面上留一个手动按钮。
|
||||||
|
fn ensure_firewall(&mut self) {
|
||||||
|
self.pc.firewall = firewall::status();
|
||||||
|
if !self.pc.firewall.needs_action() {
|
||||||
|
self.pc.firewall_note.clear();
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
if firewall::was_declined() {
|
||||||
|
self.pc.firewall_note =
|
||||||
|
"此前拒绝过防火墙授权。若对方连不上,请点下方按钮重新放行。".into();
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
match firewall::grant() {
|
||||||
|
Ok(()) => {
|
||||||
|
self.pc.firewall = firewall::status();
|
||||||
|
self.pc.firewall_note = "已放行系统防火墙。".into();
|
||||||
|
}
|
||||||
|
Err(e) => {
|
||||||
|
firewall::remember_declined();
|
||||||
|
self.pc.firewall_note = format!("{e}。若对方连不上,可稍后手动放行。");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
fn start_pc_receiver(&mut self) {
|
fn start_pc_receiver(&mut self) {
|
||||||
let Some(dir) = self.pc.save_dir.clone() else { return };
|
let Some(dir) = self.pc.save_dir.clone() else { return };
|
||||||
self.stop_pc();
|
self.stop_pc();
|
||||||
|
self.ensure_firewall();
|
||||||
let token = pairing::new_session_token();
|
let token = pairing::new_session_token();
|
||||||
let (tx, rx) = mpsc::channel();
|
let (tx, rx) = mpsc::channel();
|
||||||
match ReceiverServer::start(dir, token, tx) {
|
match ReceiverServer::start(dir, token, tx) {
|
||||||
|
|||||||
Reference in New Issue
Block a user