diff --git a/desktop/src/firewall.rs b/desktop/src/firewall.rs new file mode 100644 index 0000000..caf173d --- /dev/null +++ b/desktop/src/firewall.rs @@ -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 { + 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(); + } + } +} + diff --git a/desktop/src/main.rs b/desktop/src/main.rs index eae0b2e..348f94f 100644 --- a/desktop/src/main.rs +++ b/desktop/src/main.rs @@ -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, 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) {