适用于 Linux 的 RoamSwitch
架构与安全白皮书

§1

RoamSwitch for Linux 是一款常驻网络安全和系统诊断应用程序，它将 macOS RoamSwitch 的零信任网络防御模型引入 Linux（systemd + nftables 环境）。

此版本针对客户端计算机（工作站、笔记本电脑、单板计算机），并假设机器在网络之间移动时遵循机器的自主行为。强化服务器/无头基础设施版本（RoamSwitch 服务器版本 - 始终在线默认拒绝、关键路径 FIM 完整性、远程 Webhooks 和静态策略实施）作为专用服务器版本提供。

它通过网关 MAC 地址识别连接的 Wi-Fi/有线网络，并自动切换活动的 nftables 防火墙配置文件。除此之外，它在不受信任的网络上提供三层中间人防御 - VPN 隧道 + 终止开关（WireGuard 或 Tailscale，主要防御）、预防性 ARP/NDP 锁定 和 ARP 欺骗检测 - 加上行为勒索软件检测（fanotify + Shannon entropy + canary），这是一种标记的被动链路防护或阻止网络钓鱼连接 (NFQUEUE + SNI)、端口异常防护、BadUSB 缓解、内核本地权限升级 (LPE) 抢占（Frag Gap CVE-2026-53362 缓解）、eBPF 运行时威胁传感器 (Falco / Tetragon) 与亚秒级进程冻结 (SIGSTOP) 和 Air-Gap 网络隔离 集成， 24 项安全健康评估和内置模型上下文协议 (MCP) 服务器。

本白皮书描述了每种防御机制的架构、威胁模型和设计，特别是如何在代码级别保证“完全本地处理；机器发送的唯一内容是对签名检测数据的请求，不携带任何关于您的信息”的原则。它避免了营销语言；可以根据分布式包（二进制）的实际行为和附录中的自检来检查声明。 Linux 版 RoamSwitch 是专有的免费软件，其源代码未发布 (§11)。

§2

RoamSwitch for Linux 主要针对在不受信任网络之间漫游的 笔记本电脑/移动工作站。

范围内的攻击者

• 同一 LAN 上的攻击者 — 共享 Wi-Fi 上的端口扫描、ARP/NDP 欺骗（包括恶意路由器广告）以查找中间人、恶意 DHCP、MAC 泛洪后的被动嗅探、对开发服务器的未经授权的访问或意外绑定到 0.0.0.0 的本地 LLM API。
• 恶意 USB 设备 (BadUSB) — 冒充键盘并在屏幕锁定之前注入击键；未注册的 USB 大容量存储，用于数据泄露或携带恶意软件。
• 勒索软件/无文件恶意软件 — 通过下载的文件进入并对用户的文档进行批量加密。
• 基于 DNS 的 C2 和网络钓鱼 — 使用名称解析到达 C2 服务器或网络钓鱼站点的恶意软件。

超出范围

• 已经拥有root权限的攻击者；内核或固件级 Rootkit。
• 物理删除磁盘的攻击（全盘加密领域；RoamSwitch 诊断是否存在加密但不加密）。
• AirDrop 式近距离无线共享控制（Linux 上没有操作系统本机机制；不支持）。

§3

适用于 Linux 的 RoamSwitch 在 Rust 中跨七个 crate 实现。与守护进程的所有通信都通过 /run/roamswitch/roamswitch.sock （Unix 域套接字）。 守护程序、应用程序或 MCP 服务器中没有侦听 TCP/UDP 套接字。 应用程序 binds 唯一的东西是单个 Unix 套接字，以防止第二个实例。

# 用户空间（非特权）
roamswitch-app      GTK3 + AppIndicator 托盘
roamswitch (CLI)    面向 shell 的轻量前端
roamswitch-mcp      stdio JSON-RPC（由 AI 客户端启动）
      │
      │  AF_UNIX  /run/roamswitch/roamswitch.sock  （仅本地 IPC）
      ▼
roamswitch-daemon   root / systemd Type=notify + WatchdogSec=30
  · nftables 配置文件控制（inet roamswitch 表）
  · sentinel 循环（网络判定与配置文件应用）
  · VPN 隧道 + 断网开关（WireGuard: wg-quick / roamswitch_vpn，Tailscale: roamswitch_ts）
  · 预防性 ARP/NDP 锁定（neigh 表固定） / 检测
  · 端口异常防护（roamswitch_dev_guard）
  · fanotify 防护（勒索软件／恶意软件）
  · 链路防护（NFQUEUE — inet roamswitch_linkguard）
  · 诱饵引擎 / 隔离 Vault
  · 内核 LPE 加固（禁用 userns、Yama LSM）
  · eBPF 运行时联动（/var/run/roamswitch/events.sock）
  · 以毫秒级 SIGSTOP 冻结攻击进程并联动 Air-Gap
  · USB 监控（evdev EVIOCGRAB — BadUSB） / 批准队列
  · Ed25519 许可证验证

roamswitch-updater  独立的 systemd 定时器 helper。是唯一拥有
                    HTTP/TLS 协议栈的 crate（每日获取一次签名清单）
roamswitch-core     纯逻辑库（所有 crate 共用）
roamswitchkit       MCP 客户端 SDK

与守护程序的所有通信都通过 /run/roamswitch/roamswitch.sock （具有 0700 等效权限的目录）。用户配置以纯文本 JSON 形式存储在 ~/.config/roamswitch/config.json 处。守护进程以 root 权限读取 /home/*/.config/roamswitch/config.json（它以 HOME=/root 运行）。配置永远不会离开机器；没有帐户注册，也没有云同步。

§4

哨兵循环（默认为 5 秒循环）从 /proc/net/arp 和 ip neigh 读取默认网关的 MAC，并将其与 config.json 中注册的 MAC 进行匹配。使用 MAC 而不是 SSID，因为 SSID 很容易被欺骗。配置文件切换时显示的桌面通知会说明切换的 reason（“未注册的网络”/“您对注册网络 X 的设置”/“无网络连接”）。

所有规则都隔离在名为 inet roamswitch 的专用 nftables 表中，并且永远不会与其他防火墙配置（ufw/firewalld）发生冲突。手动覆盖到期（1 小时/2 小时/4 小时/直到午夜/直到清除/直到下次断开连接）由守护进程作为单个写入者强制执行。 GUI 永远不会写过期日期；它会重新读取守护进程在下一个时钟周期重写的 config.json 并将其反映在 UI 中（避免冲突）。

Air-Gap（紧急网络隔离）

一种完全隔离模式，在 inet roamswitch 表的输入和输出挂钩上设置 policy drop（优先级 -100），仅允许 lo。

• 失败关闭 — 在守护程序重新启动时，检测标记文件 (/run/roamswitch/airgap.active) 重新断言隔离。
• 自我修复 — 如果外部进程删除带有 nft delete table 的规则，哨兵循环会在几秒钟内重新应用。
• 自动过期 — 激活后 600 秒（与 macOS maxAirGapDuration 相同），隔离会自动解除，防止因误点击而导致连接永久丢失。

table inet roamswitch {
    chain input {
        type filter hook input priority -100; policy <accept|drop>;
        iif "lo" accept
        ct state established,related accept
        # balanced/lockdown：其余全部 drop
    }
    chain output {
        type filter hook output priority -100; policy <accept|drop>;
        # 仅在 Air-Gap 时 policy drop，仅允许 lo 与 ct established
    }
}

被动链接防护（网络钓鱼连接检测）

该守护进程监视出站连接的去向，并标记（或者，对于狭窄的“明显的网络钓鱼”集，阻止）与危险主机的连接。它取代了旧的粘贴 URL 检查器，后者需要用户采取行动。

• Interception — 专用的 nftables 表 inet roamswitch_linkguard 挂钩 output 路径，并通过 NFQUEUE 将 DNS 问题和新的/早期的 Web 连接排队到用户空间工作线程。 NFQUEUE 是一个基于 AF_NETLINK 的内核↔用户空间判决通道；守护进程不绑定任何套接字，也不产生任何数据包。队列规则带有 bypass，因此如果工作线程未运行，流量将畅通无阻（Air-Gap 仍然是单独的硬停止）。
• Hostnamesources — DNS 问题名称、TLS ClientHello SNI（因此使用 DoH 的浏览器仍被主机名覆盖）以及明文 HTTP Host 标头。加密的 ClientHello (ECH) 一旦广泛部署，就是一个已知的盲点。
• Verdict（roamswitch-core，纯逻辑）— 根据本地网络钓鱼/威胁源和一组离线启发式检查主机：受保护品牌的 IDN/易混淆同形异义词、非官方域中的品牌令牌、原始 IP 主机、高风险 TLD。

只有热门信息或品牌同形异义主机才会被硬阻止；启发式标记的所有内容都是警告。 warn 模式 保持 与危险主机的连接最多 8 秒，同时询问用户；如果保留到期且没有答复，则为 fail-close （数据包被丢弃且判决未缓存） - 不回答“此站点正常吗？”不得表示“是”，下次尝试会再次提示。 block 模式显示一个通知和一个允许对话框 每个主机 （浏览器打开与同一被阻止主机的多个连接不再淹没通知）。在危险的批准对话框中，默认按钮是“继续阻止”，“允许”被设计为安静的非默认选项。可以永久允许被阻止的主机，也可以在收到通知后五分钟内允许 (linkGuard.allowlist)。

DNS 经过检查，从未伪造：列入黑名单的 DNS 问题仅产生通知；强制执行发生在后续 TCP 连接上，因此 RoamSwitch 永远不会注入合成 DNS 响应。 feed 是网络钓鱼/诈骗域的编译列表，在软件包中提供并由每日更新程序刷新（§11）。在没有提要的情况下，离线启发式仍然运行。加载前会检查 feed 文件的 Ed25519 签名；不良或丢失的提要无法“仅启发式”，而绝不会“允许所有”。

VPN 隧道 + 终止开关（主要的 MITM 防御）

不依赖于第 2 层完整性的反 MITM 保护。在不受信任的网络上，到受信任端点的始终在线加密隧道使本地 ARP/NDP 欺骗、恶意 DHCP 和被动嗅探变得无关紧要 — 攻击者只能看到密文。 ARP/NDP 锁定和下面的检测是此功能的次要功能。

两个后端可供选择 —“WireGuard（配置文件）”或“Tailscale（退出节点）”。 RoamSwitch 没有实施自己的加密技术，也不是 VPN 提供商。两个后端都是可选的依赖项；如果不存在，GUI 将显示安装命令。

(A) WireGuard 后端

• 不提供 VPN 服务器 — 使用用户提供的 WireGuard 配置：来自 Mullvad、IVPN 或 Proton VPN 等提供商的 .conf，或用户自己的 WireGuard 服务器（VPS 或家庭服务器）。没有提供默认配置。
• Config — 守护程序验证 .conf 并将其存储在 /etc/wireguard/roamswitch.conf（0600，接口 roamswitch）。它不能存在于其他地方：Ubuntu 24.04+ / Debian 13 上的 AppArmor wg-quick 配置文件拒绝 wg-quick 读取 /etc/wireguard/ 之外的 .conf — 即使作为 root 也是如此。分割隧道配置（AllowedIPs 不是 0.0.0.0/0 / ::/0）被标记为“并非所有流量都受到保护”。
• Kill-switch — 专用的 nftables 表 inet roamswitch_vpn（policy drop，两个钩子） 丢弃除环回、隧道接口（roamswitch，与 oifname 匹配）、固定端点 IP、DHCP 和 ICMP 之外的所有内容。它是在 之前安装的 隧道启动（首先通过 getent ahosts 解析到固定 IP 的端点），因此不存在泄漏窗口。如果 wg-quick up 失败，终止开关将保持开启状态。

(B) Tailscale 后端

• 对于已经运行 Tailscale 的用户。 RoamSwitch not 运行 tailscale up / 登录 / 安装 tailscaled — 它读取 tailscale status --json 并运行 tailscale set --exit-node=<node> / --exit-node= （清除）。
• 需要出口节点 — 反 MITM 保护仅适用于路由所有流量的出口节点。如果未配置任何内容，则不会启用保护，并且 UI 会警告“未受保护”。如果所选节点离线，保护会自动解除并通知用户（通过死节点路由所有内容将使连接陷入黑洞）。
• Kill-switch (inet roamswitch_ts, policy drop) — Tailscale 的传输无法固定到单个端点 IP（DERP 中继 + 漫游对等点），因此这比 WireGuard 更宽松 X12__。它允许：环回、隧道接口 (tailscale0)、CGNAT 范围 100.64.0.0/10 和 fd7a:115c:a1e0::/48、STUN (udp/3478)、DERP (tcp/443)、udp/41641、DHCP、ICMP、MagicDNS (100.100.100.100:53)、已建立的连接。 其他所有内容 — 任意 UDP、本地解析器的 DNS、SMB、mDNS、纯文本 HTTP、任意 TCP — 均被丢弃。
• Kill-switch 警告 — (1) 比 WireGuard 后端更广泛的允许列表（udp/3478、tcp/443、整个 CGNAT /10）。 (2) 路径上的攻击者仍然可以看到元数据（Tailscale 正在使用、DERP 区域、计时）并且可以丢弃/延迟 — 但无法读取隧道有效负载。 (3) 当直接 UDP 被阻止时，机密性将依赖于 Tailscale 自己的固定证书 DERP TLS。 (4) 在 MagicDNS 关闭 + 本地解析器的情况下，DNS 在武装时中断（UI 警告）。 (5) 启用前必须先登录强制门户。

写入事件按照 PID 进行跟踪。如果单个进程在 5 秒内创建 20 个或更多 distinct 文件，且熵≥ 7.92，则会被视为勒索软件批量加密：该进程会被 SIGSTOP 冻结，并触发 Air-Gap。

• YARA 扫描和熵跟踪完全分离 — YARA 恶意软件检查无一例外地应用于所有写入文件（零绕过、扫描 ~/.cache/、node_modules/、/tmp/ 和存档）。同时，勒索软件熵爆发分析排除了自然压缩格式（.zip、.tgz、.tar.gz、.gz、.png、.jpg、.mp4、.wasm）和经过验证的包管理器（npm、npx、cargo、rustc、dpkg、apt、tar）在构建/缓存树中操作以消除误报 SIGSTOP 冻结。
• 同一文件的重复覆盖 （例如 shred 的三遍）算作一个事件。
• 关键进程保护 — PID 根据硬编码的 NEVER_FREEZE 列表（systemd、dockerd、NetworkManager、sshd、gnome-shell、...）进行检查，并且永远不会冻结，从而防止机器范围内的挂起。

金丝雀（诱饵文件）

诱饵文件被放置在用户的文档、桌面、下载和图片文件夹以及专用目录中，并以 3 秒为周期与 SHA-256 基线进行比较。任何重命名、删除、截断或内容更改都会立即触发 Air-Gap。因为守护进程以 root 身份运行，所以它会枚举 /home/* 并将金丝雀部署到每个真实用户的目录中。

fanotify 监控 · 隔离库 · ClamAV

• 守护进程在挂载级别监视 /home、/var/tmp、/dev/shm，并通过 FAN_CLASS_CONTENT（后备 FAN_CLASS_NOTIF）在文件系统级别监视 /。
• 通知优先，无静默隔离。 裸露的 YARA / ClamAV 命中是 绝不会静默隔离或 FAN_DENY’d。真实签名在 /run/roamswitch/approvals.json 中提出模式请求（隔离/允许/稍后）；在用户确认之前，任何内容都不会进入保管库。只有实际的 execve 才是 FAN_DENY，并且只有当 pre_exec_blocking_enabled 开启时。批准超时失败开放。
• EICAR 等测试签名仅记录到通知历史 — 行业标准测试字符串不会发出通知，只会记录到通知历史中，并且在 fanotify 防护和下载防护中都不会被隔离或阻止。
• YARA 和 ClamAV 扫描仪都遵循用户配置的 scan_exclusions 路径列表（绝对路径，递归应用；它包含旧版 clamav_exclusions）。提示上的“允许”和“隔离”选项卡中的“恢复”都附加到它，因此不会重新标记同一文件。
• 检测到并确认的真正恶意软件已转移到 ~/.local/share/roamswitch/quarantine/。金库是0700；每个样本都是 0400 （只读，不可执行）。恢复时，文件返回到 0644 并被 chowned 到目标目录的所有者。
• 权限事件循环执行零文件系统 I/O — 配置由专用后台线程读取到 Mutex<GuardConfig> 快照中；热路径访问器只是锁定和复制。这是一个设计不变性：阻塞 FAN_OPEN_PERM 会冻结机器。
• 当 ClamAV 存在时，会根据本地数据库扫描新下载的可执行文件（.sh、.deb、.elf、...）和危险的 AI 模型（.pkl、.pt）。 ClamAV 是一个 可选依赖项 ；没有它，其他防御措施也能发挥作用。安装后，每日更新程序 (§11) 会调用 freshclam，以便签名数据库保持最新状态。

内核本地权限提升 (LPE) 抢占和强化

当攻击者或恶意软件获得非特权用户立足点时，深度防御可防止利用 Linux 内核漏洞获取 root 权限。

• 禁用非特权用户命名空间（Frag Gap CVE-2026-53362 缓解） — 许多现代 Linux 内核 LPE 漏洞依赖于非特权用户调用 unshare(CLONE_NEWUSER) 来创建隔离的用户命名空间，随后访问未初始化的内核结构或具有提升的命名空间功能的旧网络子系统。 RoamSwitch 通过一键强化或设置向导评估和实施 user.max_user_namespaces = 0（或 kernel.unprivileged_userns_clone = 0）。即使使用未修补的内核零日漏洞，这也可以关闭非特权进程的攻击面。
• Yama LSM 内存保护 — 强制执行 kernel.yama.ptrace_scope = 1（或 2）可防止未经授权的进程通过 ptrace 附加或通过 /proc/$pid/mem 读取内存，从而保护浏览器会话和 GPG/SSH 私钥。
• Core Dump Suppression — 设置 fs.suid_dumpable = 0 可防止敏感进程将纯文本内存转储写入磁盘而导致崩溃。
• /tmp 和 /dev/shm noexec 安装防御 — 为了防止有效负载丢弃并执行攻击，RoamSwitch 在连接到不受信任的网络时会使用 noexec,nosuid,nodev 重新安装 /tmp 和 /dev/shm。

eBPF 运行时威胁传感器和自主进程冻结（桌面 eBPF Guard）

RoamSwitch 客户端守护程序包括与内核内现代 eBPF 传感器（Falco / Tetragon / BTF）的本机集成。

# eBPF 运行时威胁检测与自主拦截流程
[恶意进程 (LPE/恶意软件)]
    │ 非法系统调用执行 (Frag Gap 利用尝试)
    ▼
[Linux 内核 (eBPF 探针)]
    │ eBPF 环形缓冲区 (2MB 精简设计)
    ▼
[Falco (RoamSwitch Optimized)]
    │ 内存中 UNIX 套接字直接通信 (/var/run/roamswitch/events.sock)
    ▼
[roamswitch-daemon (root)]
    ├─► ① 以毫秒级冻结攻击进程：kill(pid, SIGSTOP) [状态：Ts]
    ├─► ② 完全切断网络：nftables input/output drop [启动 Air-Gap]
    └─► ③ 桌面紧急通知：GTK3 模态框 & libnotify 通知

• Direct UNIX Domain Socket IPC (/var/run/roamswitch/events.sock) — 来自 Falco 或其他 eBPF 传感器的警报直接通过内存中 UNIX 套接字接收，无需写入磁盘日志，从而消除磁盘 I/O 延迟并实现亚秒级响应切换。
• 自主多层缓解（进程冻结和气隙） — 当收到优先级为 Critical 或 Emergency 的事件（例如内核 LPE、命名空间逃逸或勒索软件执行）时，守护进程在违规 PID 上执行 SIGSTOP 以立即暂停进程执行（状态：Ts），跨 inet roamswitch（气隙）部署 policy drop，并立即触发桌面通知。
• 面向桌面的低开销及日志膨胀防止调优（RoamSwitch Optimized） — 为抑制笔记本电脑和工作站的电池消耗、CPU 负载和磁盘枯竭，随附了优化配置文件（99-roamswitch-optimized.yaml）：
  • 严重性过滤 (priority: warning) — 过滤掉 95% 的常规通知/信息事件。
  • Kernel Early Drop (drop_failed_exit: true) — 直接在内核驱动程序中丢弃失败的系统调用退出，将上下文切换和 CPU 负载减半。
  • 紧凑环形缓冲区 (cpus_for_each_buffer: 2) — 将环形缓冲区大小减少至 2MB，将常驻 RAM 保持在 30–50MB，CPU 使用率 <1%。
  • 强制日志轮换上限 (/etc/logrotate.d/roamswitch-falco) — 通过 7 代压缩轮换强制实施严格的 50MB 上限。
• 混合弹性（独立与 eBPF 模式） — 没有 Falco，RoamSwitch 通过内核 sysctl (user.max_user_namespaces = 0)、nftables 漫游配置文件、fanotify 熵跟踪和金丝雀来保护系统。借助 Falco，深层内核行为遥测可拦截高级零日漏洞并实时冻结攻击者进程。

§6

USB事件被监控；跟踪键盘类 (HID) 设备和 USB 大容量存储。 默认关闭 （发货 isEnabled = false，与 macOS USBKeyboardGuard / USBStorageGuard 匹配）。从首次运行向导或 USB 选项卡中选择加入；启用会显示一个确认对话框。

流氓 USB 键盘（击键注入）

• 无内核级物理端口取消授权（重要）。旧的实现（≤1.0.6）将 0 写入 /sys/bus/usb/devices/*/authorized 对于未注册的键盘，物理上断开连接。在键盘+鼠标组合接收器（常见于 Raspberry Pi 或迷你 PC）上，这也会断开鼠标连接，从而锁定没有内置输入的机器。 RoamSwitch 现在硬拒绝将 authorized=0 写入任何暴露 HID 接口 (bInterfaceClass 03) 的设备，并且守护程序在启动时重新授权任何 authorized==0 HID 设备，以自我修复先前版本变砖的机器。
• 按键在软件中被删除。 在检测到未注册的键盘时，会在该设备的 /dev/input/eventN 上获取独占的 evdev EVIOCGRAB（仅在 /proc/bus/input/devices 中具有 kbd 处理程序的节点，与 VID:PID 匹配）。鼠标节点未受影响。这是 macOS CGEventTap 的 Linux 版本；设备保持通电状态。
• Safety — 仅当有另一个键盘可供输入（内置键盘或经批准并连接的 USB 键盘）时才会进行抓取，因此具有单个新键盘的机器永远不会被锁定。
• 批准对话框 — 在抓取旁边，批准请求在 /run/roamswitch/approvals.json 中排队，GUI 显示模式（允许/拒绝）。允许将设备列入白名单并释放抓取。 3 分钟后失效打开。

流氓 USB 大容量存储设备

当插入未注册的 USB 大容量存储设备（无 HID 接口）、启用防护且网络不受信任/处于锁定状态时，它会以 authorized=0（对于非 HID 设备来说是安全的）保存，并显示批准对话框。允许重新授权和白名单；拒绝保留。 macOS 版本与 1.7.4 中的“保留只读 + 批准提示”模型保持一致。

身份识别和追溯

HID 由 bInterfaceClass == "03" 和 /proc/bus/input/devices 中的 Handlers= 行确定。组合接收器（一个 VID:PID 带有 kbd 和鼠标部分）由 VID:PID 合并。 守护进程启动时出现的未注册键盘是祖父；仅抓取事后热插拔的键盘。

§7

roamswitch-core 中的 LinuxHealthChecker 评估 24 个项目，并生成 0-100 分、A-F 等级和每个项目的建议。从 GTK 仪表板、CLI (roamswitch status) 和 MCP (get_security_report) 中， 所有 24 个项目的标题、详细信息和推荐均以用户的语言 （10 种语言）显示。

每次检查都基于读取本地文件和命令输出（getenforce、mokutil、resolvectl、ss、...）。 没有任何类型的外部查询。

信任感知分级. RoamSwitch 故意在受信任（家庭）网络上应用 not 进行强化 — 将网关 MAC 固定为永久（这将在路由器重新启动时使 LAN 陷入黑洞）、重新安装 /tmp 和 /dev/shm noexec （这会破坏软件包构建和某些安装程序）以及默认范围下的威胁保护 DNS — 显示为绿色带有解释而不是红色的“未强化”，并指出它会自动应用于不受信任的网络。运行时真相来自 /run/roamswitch/state.json (active_level / network_trusted / fanotify_ready)，由守护进程在每个周期写入。 fanotify 项检查防护是否确实被标记并正在运行（/run/roamswitch/fanotify.ready），而不仅仅是内核支持它。暴露端口项读取守护程序的实时配置文件（MCP 硬代码已消失）。

每项强化。 具有自动修复功能的失败项目（内核 sysctl / Yama / 核心转储、/tmp noexec、USB 零信任、网关 ARP 固定、威胁保护 DNS、fanotify 防护关闭时重新启动守护进程）在 GTK 仪表板中带有“🔧 强化”按钮。守护进程以 root 身份运行，因此除了守护进程重新启动之外不需要 pkexec 。

§8

roamswitch-mcp 通过 stdio 进行 JSON-RPC，由 Claude Desktop、Cursor 和 Antigravity 等 AI 客户端生成。每个工具都是只读且完全本地。

MCP 服务器自身不打开任何网络连接，仅通过 roamswitchkit 连接守护进程的 Unix 套接字，或直接调用 roamswitch-core 的逻辑。唯一的例外是默认关闭的 run_active_vuln_scan，它会向本机 127.0.0.1 发送非破坏性探测。

在本地 LLM 实战演练中发现并修复的错误归因问题
2026 年 9 月，我们使用本 MCP 服务器让本地 LLM（Qwen 3.8 27B）进行一次事件调查实战演练（fire drill）时，发现模型误读了 get_port_anomaly_incidents 返回的数据，把一个与本次事件无关的旧端口阻断记录，错误地编入了当前正在发生的事件叙述中。原因在于：不带时间戳的「当前阻断端口」快照，与带时间戳的真实事件历史，在同一个响应中未加区分地一并返回。修复方案是新增说明字段，明确标注哪一部分是时间线数据、哪一部分只是快照。修复后，用同一场景对同一模型重新运行，模型引用了说明字段中的文字，明确拒绝将旧端口归因于当前事件。我们通过自动回归测试和真实本地 LLM 复现两种方式，验证了修复的有效性。

§9

RoamSwitch for Linux 使 恰好是一种出站请求 ：签名清单的每日更新者 GET (§11)。其他一切——每项评估、检测和审计——都在本地完成。 RoamSwitch for Linux 是专有的免费软件，其源代码未公开，因此以下检查由 lafine 执行；结果在 9.2 中，并且附录 C 中的步骤可以单独从分布式包中重现。

9.1 审核方法

1. Crate 隔离 — HTTP/TLS 堆栈仅允许在 一个 crate 、roamswitch-updater 中使用，它构建独立的计时器驱动的更新程序二进制文件。如果 roamswitch-core、roamswitch-daemon、roamswitch-app、roamswitch-mcp 或 roamswitchkit 引入 reqwest / hyper / ureq / rustls / native-tls / openssl，或者 roamswitch-updater 之外的任何 .rs 文件使用 TcpStream /，scripts/audit_no_network.sh（在 CI 中运行，门控）将导致构建失败TcpListener / UdpSocket / to_socket_addrs / lookup_host。
2. 依赖树检查 — 搜索完整的 Cargo.lock 以查找遥测/分析/崩溃报告 SDK（sentry、opentelemetry，...）。
3. roamswitch-updater review — 它的单一请求目标，没有查询字符串/cookies/识别标头，以及它下载的所有内容的 Ed25519 验证。
4. 子进程枚举 - 每个Command::new(...)调用站点都经过审查。

9.2 结果

9.3 面向外部的操作的完整列表

每个可能导致数据包直接或间接离开本地计算机的操作：

所有其他 RoamSwitch 功能 — nftables 控制、邻居表的 ARP/NDP 固定（ip neigh，无数据包出口）、链路保护（NFQUEUE，仅 AF_NETLINK）、端口扫描（解析 ss 输出）、ARP 监控、健康评估、熵监控、金丝雀、fanotify、USB 监控（evdev 抓取）、隔离、日志审计、URL 和秘密审计 — 仅使用 本地文件读取来完成以及子进程输出的分析。 §4 VPN 隧道是唯一的“用户明确配置的出站通信”，其目的地是用户自己的 VPN 服务器 - 没有数据流向 lafine 的基础设施。

§10

• 没有帐户 — 无需用户注册，无需登录，也无需请求电子邮件地址。
• 配置仅在本地 — 以明文形式存储在 ~/.config/roamswitch/config.json 处，并且永远不会离开机器。没有云同步。
• 评估结果仅在本地 — 安全报告和日志审核结果仅显示在屏幕上，并且如果用户选择，还可以导出到本地文件。
• 许可证密钥已离线验证 — Pro / Business 许可证令牌包含 Ed25519 签名并使用公钥进行验证。不会向 lafine 服务器发出任何查询。
• 没有崩溃报告 — 出现紧急情况时，不会向任何地方发送堆栈跟踪。
• 每日更新程序不会发送任何有关您的信息 — 没有查询字符串、没有cookie、没有设备或安装标识符、通用User-Agent。这是下载，而不是报告。链接防护判决、阻止的主机和扫描结果仅写入本地活动视图/日志，从不传输。

§11

macOS RoamSwitch Pro Lifetime 的购买者可以在自己的 Linux 计算机上免费获得商业功能。

分销和供应链

• 固定 glibc 地板 — 发行版二进制文件构建在 Debian 12（书虫、glibc 2.36）容器内。这可以防止 Debian 12 / Ubuntu 22.04 及更高版本上的符号版本不匹配。如果引入需要超过 2.36 的依赖项，“验证 glibc 底层”CI 步骤将导致构建失败。
• 签名密钥管理 — apt/rpm 存储库签名的私钥仅存在于 GitHub Actions 加密密钥中；仅将公钥提交到存储库。

11.3 每日更新程序

roamswitch-updater 是由 systemd 计时器（roamswitch-update.timer、具有随机 3 小时延迟的 OnCalendar=daily 和 Persistent=true）运行的独立二进制文件。它是到达网络的唯一组件。每次运行：

1. GET https://lafine.net/updates/v1/manifest 及其独立签名。
2. 使用专用的威胁源签名密钥验证清单的 Ed25519 签名 - 与 Sparkle 应用程序更新密钥分开。服务器端 CI 每天都会对 feed 进行重新签名，以便私钥存在于 CI 秘密中；将其范围限定为提要意味着泄漏只会让攻击者提供错误的阻止列表（污水坑/警告 - 没有代码路径，没有应用程序更新路径）。应用程序更新签名密钥永远不会离开 macOS 钥匙串。未验证的清单将被丢弃 - 更新程序永远不会回退到未签名的数据。
3. 如果威胁源版本发生更改，请下载该源，验证其 SHA-256 和 Ed25519 签名，并为链接防护自动安装它 (§4)。
4. 如果安装了 ClamAV，则调用 freshclam。
5. 记录最新的应用程序版本以获取通知（更新程序 never 安装应用程序；在 Linux 上，用户运行 apt upgrade）。

任何步骤的失败（脱机、错误签名、freshclam 丢失）都会记录为 updates.lastError 并且进程仍然退出 0，因此计时器运行永远不会生成 systemd 失败通知。整个机制被 updates.json 中的 updates.enabled = false 或 systemctl disable --now roamswitch-update.timer 禁用；然后，该产品将根据包中捆绑的数据运行。威胁源也在 包内 中提供，因此全新安装在更新程序运行之前就有一个工作源，并且 apt upgrade 即使在禁用更新程序的情况下也会刷新它。

§12

• OS：Ubuntu 22.04 / 24.04 及更高版本、Debian 12 及更高版本、Linux Mint / Pop!_OS / Primary / Zorin、Raspberry Pi OS 64 位 (Bookworm)、Ubuntu for Raspberry Pi
• 架构：x86_64 / aarch64
• Required：systemd、nftables、iproute2（ip neigh — ARP/NDP 锁）（由 .deb / .rpm 依赖项自动拉入）
• 可选：clamav（恶意软件扫描）、nmcli（Wi-Fi 加密检测）、libnotify（桌面通知）、wireguard-tools（VPN 隧道的 WireGuard 后端 + 终止开关，§4）、tailscale（其 Tailscale 后端，§4）、polkit / pkexec（从 GUI 运行升级）
• 不支持：非systemd发行版（Alpine / Void / Devuan）
• Display：1280×720或更大（窗口和字体自动缩放到屏幕尺寸，支持小型Raspberry Pi显示器）

附录 A

附录 B

table inet roamswitch {                 # 配置文件防火墙（Air-Gap / balanced / lockdown）
    chain input {
        type filter hook input priority -100; policy <accept|drop>;
        iif "lo" accept
        ct state established,related accept
        # balanced/lockdown：其余全部 drop
    }
    chain output {
        type filter hook output priority -100; policy <accept|drop>;
        # 仅在 Air-Gap 时 policy drop，仅允许 lo 与 ct established
    }
}

table inet roamswitch_linkguard {        # §4.5 — 独立于配置文件表
    chain output {
        type filter hook output priority 0; policy accept;
        udp dport 53                       queue num 92 bypass
        tcp dport 53                       queue num 92 bypass
        tcp dport { 80, 443 } ct state new,established queue num 92 bypass
    }
}

table inet roamswitch_dev_guard {        # §4 端口异常防护／手动端口隔离，独立的表
    chain input {
        type filter hook input priority -10; policy accept;
        iif != "lo" tcp dport { … } drop
    }
}

table inet roamswitch_vpn {              # §4 WireGuard 后端断网开关
    chain output {
        type filter hook output priority -150; policy drop;
        oifname "lo" accept
        oifname "roamswitch" accept
        meta l4proto { icmp, ipv6-icmp } accept
        udp sport 68 udp dport 67 accept          # DHCP
        ip  daddr { <endpoint v4> } udp dport <port> accept
        ip6 daddr { <endpoint v6> } udp dport <port> accept
        ct state established,related accept
    }
    chain input  { type filter hook input priority -150; policy drop; … }  # 对称
}

table inet roamswitch_ts {               # §4 Tailscale 后端断网开关（更宽松）
    chain output {
        type filter hook output priority -150; policy drop;
        oifname "lo" accept
        oifname "tailscale0" accept
        meta l4proto { icmp, ipv6-icmp } accept
        udp sport 68 udp dport 67 accept          # DHCP（v6 一侧同样对称）
        ip  daddr 100.64.0.0/10 accept            # tailnet CGNAT
        ip6 daddr fd7a:115c:a1e0::/48 accept
        ip  daddr 100.100.100.100 udp dport 53 accept   # MagicDNS
        ip  daddr 100.100.100.100 tcp dport 53 accept
        udp dport 3478 accept                     # STUN
        udp dport 41641 accept                    # WireGuard 直连
        tcp dport 443 accept                      # DERP 回退
        ct state established,related accept
    }
    chain input  { type filter hook input priority -150; policy drop; … }  # 对称
}

网关/IPv6 路由器/DNS 解析器 (§4) 的 ARP/NDP 固定是在内核邻居表 (ip neigh replace … nud permanent) 中完成的，而不是在 nftables 中完成的。固定条目记录在 /var/lib/roamswitch/arp_lock.json 中。