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:
+64
-1
@@ -3,6 +3,7 @@ mod client;
|
||||
mod connect_code;
|
||||
mod direct_ap;
|
||||
mod discovery;
|
||||
mod firewall;
|
||||
mod optical_cache;
|
||||
mod pairing;
|
||||
mod platform;
|
||||
@@ -144,6 +145,8 @@ struct PcPeerState {
|
||||
total: u64,
|
||||
started: Option<Instant>,
|
||||
status: String,
|
||||
firewall: firewall::FirewallStatus,
|
||||
firewall_note: String,
|
||||
}
|
||||
|
||||
struct QftApp {
|
||||
@@ -236,7 +239,9 @@ impl QftApp {
|
||||
done: 0,
|
||||
total: 0,
|
||||
started: None,
|
||||
status: "接收方启动后会显示 6 位配对码;发送方搜索到对方并输入该码即可传输。".into(),
|
||||
status: "接收方启动后会显示连接码;发送方输入该码即可传输。".into(),
|
||||
firewall: firewall::FirewallStatus::Unknown("尚未检测".into()),
|
||||
firewall_note: String::new(),
|
||||
},
|
||||
}
|
||||
}
|
||||
@@ -1058,6 +1063,35 @@ impl QftApp {
|
||||
})
|
||||
.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.group(|ui| {
|
||||
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) {
|
||||
let Some(dir) = self.pc.save_dir.clone() else { return };
|
||||
self.stop_pc();
|
||||
self.ensure_firewall();
|
||||
let token = pairing::new_session_token();
|
||||
let (tx, rx) = mpsc::channel();
|
||||
match ReceiverServer::start(dir, token, tx) {
|
||||
|
||||
Reference in New Issue
Block a user