最后更新:2026-10-21

事故发生后的第一个小时

本页汇总了 RoamSwitch 检测到严重威胁并将其遏制后的一小时内,应按什么顺序使用哪些功能。

1. 关于本页

RoamSwitch 检测到严重威胁时,会通过网络隔离(Air-Gap)或冻结进程自动遏制。本页按环境依次整理了之后要确认什么、记录什么、何时解除。界面和操作的详细说明,请参阅各手册。

本页说明 RoamSwitch 功能的使用方法,不涉及组织内部的联络、法律应对和恢复计划。

2. 任何环境,顺序都相同

遏制措施是有原因才触发的。在匆忙解除之前,请按下面的顺序进行。

  1. 确认。按时间顺序查看什么时候、检测到了什么、先后顺序如何。
  2. 留存。在解除或重启之前,先导出记录和证据。解除或重启之后,运行时状态的信息可能会丢失。
  3. 判断。判断这是自己有印象的操作,还是真正可疑的行为。
  4. 解除。确认安全之后,再解除遏制。
  5. 观察。解除之后,持续观察一段时间,看相同的检测是否再次出现。

从日志中调查时,也可以使用第 6 节的 PersonalSOC 和 AccessScope。

如果因 ARP 欺骗被隔离,也请阅读第 8 节。

如果在 Linux 桌面版上因勒索软件被隔离,也请阅读第 9 节。

隔离期间,无法在该电脑上打开本页。本页的二维码在 Mac 上显示于“隔离状态与解除指引”界面,在 Linux 桌面版上显示于解除确认界面。用连接其他线路的智能手机扫描,即可阅读本页。二维码中只包含本页的公开 URL。

3. Mac 版

  1. 打开菜单栏的 🛡️ 图标,确认显示的是"🔒 隔离中(全面)"还是"🔒 隔离中(降级模式)"。
  2. 打开"ℹ️ 隔离原因与解除说明…",阅读触发的原因。
  3. 打开 🛡️ → Mac 安全综合诊断 →“📈 安全活动日志…”。按时段、重要度、类别筛选,按时间顺序查看紧接之前检测到了什么。点击图表中的柱形,可只筛选该时间段。
  4. 使用 Pro 时,可将筛选后的结果导出为 CSV 留存。
  5. 如果事先开启了“🧾 进程执行记录…”(Pro),已启动进程的历史也可用于调查。此记录默认关闭。
  6. 当勒索软件或 XProtect 的检测触发隔离时,会在此之前自动保存取证数据。内容包括正在运行的进程列表、网络连接、最近修改的文件列表以及每个文件的 SHA-256。保存位置是 ~/Library/Application Support/RoamSwitch/incident-evidence/。Mac 上无法进行数据包捕获。
  7. 回想是否有可能的相关操作(例如启动了可疑应用)。
  8. 在同一菜单中选择"🔓 解除 Air-Gap 隔离",并在确认对话框中选择"解除",通信会立即恢复。

遭遇勒索软件破坏时,使用 🛡️ → 恶意软件防护 (XProtect & ClamAV) →“🗂 勒索软件恢复…”(Pro)。可从 RoamSwitch 定期创建的 APFS 本地快照中,将文件提取到其他位置(~/RoamSwitch-Recovered/<ID>/)。不会覆盖当前文件。提取时需要“完全磁盘访问”权限。

对于无法从快照恢复的文件,请在 No More Ransom 的解密工具列表或日本警察厅的勒索软件危害防范对策(受害恢复一项)中寻找解密工具。工具只覆盖部分类型,RoamSwitch 本身不进行解密。使用前请先清除感染源,保留被加密的文件和勒索信,并且不要支付赎金。隔离期间,请用连接其他线路的智能手机查询。

解除后通信仍未恢复时
仅当被误拦截而一直无法通信时,才使用 🛡️ → 🧰 恢复与卸载 →“🆘 紧急恢复网络…”。这是最后的手段。

4. Linux 桌面版

  1. 打开系统托盘的 🛡️ 图标。如果网络因严重威胁而被隔离,会显示"🚨 解除 Air-Gap 并恢复通信"。此时先不要点击。
  2. 在主窗口的“Notifications”中打开最近 7 天的通知历史,确认通知了什么。
  3. 在“Incident Timeline”(实验性功能)中,按时间顺序查看从检测、响应到解除的过程。
  4. 在“Security Activity Log”中,组合时段、类别、重要度和关键词进行筛选,调查紧接之前发生的事。可在同一界面中查看 Incident Timeline 和 Notifications 的内容。
  5. 回想是否有可能的相关操作。确认安全后,点击托盘中的“🚨 解除 Air-Gap 并恢复通信”。
若通信未恢复,请从托盘的恢复子菜单中使用“紧急恢复网络”。通知、隔离状态、被冻结的进程和时间线,也可以用命令确认(见下面的“5.”)。

5. Linux Server Edition

Server Edition 通过命令操作(Linux 桌面版也可使用。sudo roamswitch server ack 仅用于 Server Edition)。高可信度的隔离(如金丝雀被篡改)在既没有 ack、也没有确认原因已消除的情况下,默认经过 3600 秒(1 小时)后会转入降级(DEGRADED)模式。降级期间,除维护用 SSH 端口和已允许 IP 的管理通道外,新的通信会持续被阻断,且不会自动放开。

5.1 确认通知

如果配置了 Telegram、LINE 或 Webhook,通知已发送到那里。即使没有配置,最近一周的通知也保留在本地。

roamswitch notifications

5.2 查看隔离状态

显示 eBPF 运行时防护当前的隔离状态以及已检测到的事件历史。

roamswitch server ebpf

5.3 确认被冻结的进程

防护用 SIGSTOP 冻结的进程列表。在记录证据之前不会恢复。

roamswitch frozen list

5.4 留存证据

eBPF 运行时防护以进程为单位遏制威胁时,会自动生成取证包。内容包括约 30 秒的数据包捕获,以及已知 PID 时的 /proc/<pid> 快照(没有 tshark 的环境中,只省略数据包捕获)。保存位置是 /var/lib/roamswitch/incident-evidence/<时间戳>-<ID>/。

隔离整台主机时,也会在后台生成同样的包。但在没有安装采集工具(roamswitch-incident-capture)的环境中,不会生成任何内容,也不会报错。请确认包是否存在。如果不存在,或想保留遏制之前的状态,请手动采集。

sudo roamswitch-incident-capture snapshot --pid <PID> --reason "first-response"

5.5 导出时间线和执行记录

将统一事件时间线(实验性)导出为 JSON Lines。执行记录器可按时段或进程检索。

roamswitch timeline --export incident.jsonl
sudo roamswitch events search --since 2h

5.6 判断并解除

因误报而被冻结的进程,用下面的命令恢复(resume all 可恢复全部)。

roamswitch frozen resume <PID>

要永久放行同一误报时,将其添加到允许列表。加上 --exe 并绑定到可执行文件的路径,伪造进程名也无法绕过。

sudo roamswitch server allowlist add <rule> <process> --exe <path>

对隔离进行确认应答(ack)。FULL 隔离期间,在保持严格隔离的同时确认应答。视为运维人员已接手处置,转入降级和自动解除都会停止。降级期间,确认应答即可解除。

sudo roamswitch server ack

5.7 被锁在外面时

从云服务商的 Web 管理控制台(VNC 或串行控制台)登录,解除紧急隔离。默认情况下,维护用 SSH 端口和管理来源 IP 的管理会话在隔离期间也会保留。

sudo roamswitch emergency-restore

5.8 事后整理

取证包不会自动删除。超过保留期限(默认 30 天)的,用下面的命令删除。

sudo roamswitch-incident-capture prune --keep-days 30

6. 从日志中调查(PersonalSOC 与 AccessScope)

RoamSwitch 附带了两个用于检查日志的独立工具:PersonalSOC 和 AccessScope。两者都是只读的,不会更改设置,也不会阻断通信。分析不使用网络,只在本设备内进行,因此隔离期间也能使用。

6.1 PersonalSOC:把本机的日志和检测汇总成一份报告

读取本机的认证日志(Mac 为 sudo 和 sshd,Linux 为 auth.log、auditd、nginx、apache 等)以及 RoamSwitch 尚未解决的检测,把风险参考值、时间线和 IOC(IP、域名、URL、哈希)汇总到一份报告中。

sudo personalsoc scan --report

6.2 AccessScope:从访问日志中查找攻击

从 Web 服务器和 SSH 等访问日志中找出暴力破解、Web Shell、攻击链、来自陌生来源的登录成功等,并附上证据行号和可信度(确定、可能性高、假设)。它不会直接断定已被入侵。

sudo accessscope scan --auto --since 24h --report report.md
以管理员权限(sudo)运行
认证日志、journald、fail2ban、Web 服务器和 auditd 的日志,没有管理员权限就无法读取。请在上面的命令前加 sudo 执行。不加 sudo 时,读不了的日志会显示为“无法读取”,报告则显示“没有可读取的日志”。这种“无检出”并不证明安全。两个工具都不会自行提升权限。

6.3 在哪个阶段使用

sudo accessscope scan --auto --since 24h --since-last --new-only

7. 结束之后

解除后,在时间线(Mac 上为“安全活动日志”)中观察一段时间,看同样的检测是否再次出现。导出的记录和证据包不要删除,请妥善保管。

更换密码和密钥、联系相关方等在 RoamSwitch 之外进行的应对,本页不涉及。

8. 因 ARP 欺骗被隔离时

在公共 Wi-Fi 等环境中,同一网络内的攻击者冒充路由器来窃听通信,这就是 ARP 欺骗。RoamSwitch 会检测网关(路由器)MAC 地址的突然变化等情况。Mac 和 Linux 桌面版的思路相同。

  1. 会隔离的情况。在未登记的网络(保护级别为 Lockdown)上检测到与网关有关的异常时,会自动隔离。在已登记的地点(家里或单位等),不会自动隔离,而是显示警告。只有选择“立即全部阻断”时才会隔离。
  2. 解除之前要确认的事。应用的确认界面也会显示同样主旨的提示。要确认的是:同一网络中的其他设备是否在伪造 ARP,以及网关的 MAC 地址是否与可信值一致(Linux 的确认界面会显示当前值和可信值)。如果是公共 Wi-Fi,先换到网络共享等其他线路再解除更安全。
  3. 自动解除。不会仅凭时间解除。网关的 MAC 地址在 60 秒以上的时间内连续 3 次确认与可信值一致后,会自动解除并通知。若一直无法确认,默认经过 1 小时后会转入大幅限制通信的状态(降级)。降级不会随时间放开,需要手动解除。
  4. 手动解除时。Mac 使用菜单中的“解除 Air-Gap 隔离”。Linux 桌面版使用托盘中的“解除 Air-Gap 并恢复通信”,或 sudo roamswitch emergency-restore。原因仍在时解除,通信会恢复,并受到同样的影响。请确认后再解除。
  5. 解除之后。观察一段时间,看相同的检测是否再次出现。若再次出现,请不要使用该网络,换到其他线路。

9. 因勒索软件被隔离时(Linux 桌面版)

短时间内有大量文件被改写时,RoamSwitch 会判定为可能是勒索软件,冻结正在改写文件的进程(SIGSTOP),并切断网络(Air-Gap)。Air-Gap 确认界面会打开,显示原因、进程以及被改写的文件数量。本节适用于 Linux 桌面版。Mac 请阅读 3.。

  1. 确认。在确认界面和通知历史中,查看哪个进程改写了哪些文件。被冻结的进程也可以用 roamswitch frozen list 查看(5.3)。
  2. 记录。在解除或重启之前,按 5.4 和 5.5 的步骤保存证据和时间线。
  3. 判断。如果被冻结的进程是你熟悉的操作(如备份或压缩),则是误报,用 sudo roamswitch frozen resume <PID> 恢复。如果是真正的攻击,不要恢复,先记录证据,再终止该进程。
  4. 找回文件。被改写的文件可以从快照中取出。在界面中,打开“勒索软件恢复”标签页(1.11.21 及以后),在“★推荐”下选择“事前”;在命令行中,使用 sudo roamswitch-ransomware-rollback list 和 sudo roamswitch-ransomware-rollback restore-files <ID> <PATH>。

    对象是 btrfs 或 LVM,ext4 的主目录无法使用。受损之前的快照默认每 6 小时创建一次。检测时创建的快照已被加密,不能用于恢复。

    取出不会覆盖,默认放在 <对象>/RoamSwitch-Recovered/<ID>/。会覆盖的 restore 是最后手段(仅限命令行)。
  5. 寻找解密工具。没有快照时,可在 No More Ransom 的解密工具列表或日本警察厅的勒索软件危害防范对策(受害恢复部分)中寻找解密工具。工具只覆盖已被分析的部分类型,RoamSwitch 不进行解密。使用前,请先清除感染源,保留加密文件和勒索信,不要支付赎金。由于通信已被切断,请用其他线路的智能手机或另一台电脑查询。
  6. 解除。仅靠时间不会解除。只有在确认原因已消除时,或通过托盘中的“解除 Air-Gap 并恢复通信”或 sudo roamswitch emergency-restore 解除时,才会解除。
  7. 观察。解除后,确认同样的检测不会再次出现。取出的文件在放回原位之前,先检查其内容。