PersonalSOC

PersonalSOC

个人安全运营中心

PersonalSOC 会汇总本设备的日志和防护状况,生成便于发现异常的报告。它是一个小型安全运营中心(SOC),面向没有专职安全人员的个人,让您带着依据理解自己设备的状况,并决定下一步行动。

它随 RoamSwitch 安装程序一同提供,但是独立于 RoamSwitch 的应用(有自己的图标)。即使没有安装 RoamSwitch 也能使用。

一键检查状况

只需按下「检查状况」,就会以只读方式检查本设备的日志(按操作系统:SSH 认证、auditd、Web、DNS、macOS 统一日志)、MCP 设置以及 RoamSwitch 的检测历史。不会提升权限,无法读取的日志会报告为「无法读取」。

仪表板

通过图表,一眼掌握综合风险(估计)、按严重度的数量、按类别的发生次数、发生趋势以及 MITRE ATT&CK 技术。

报告

将来源、按类别的检出事项和 IOC(无害化表示)汇总为 Markdown 报告。时间以本设备的本地时间、易读的形式显示。

由 LLM 自主调查(可选,默认关闭)

启用后,检查完成后 LLM 会自主调查,并以审计员的身份撰写报告。PersonalSOC 只向 LLM 提供经允许的只读工具,不会交给它 shell 或文件。

定期运行(可选)

Mac 使用 launchd、Linux 使用 systemd 的用户权限登记,仅在出现上次没有的检测结果时才通知(通知只包含数量)。不使用 root。

支持 10 种语言

日语、英语、德语、西班牙语、法语、意大利语、韩语、葡萄牙语、简体中文和繁体中文。自动跟随操作系统的语言。

RoamSwitch MCP 联动

如果已安装 RoamSwitch,PersonalSOC 会从 RoamSwitch 的 MCP 服务器(只读)获取未解决的检测和配置诊断中未通过的项目,与日志中的检测结果一起汇总到同一份报告中。相同的检测会合并为一条,并附上次数和最新时间。在 LLM 调查中,也只能调用 RoamSwitch 的只读工具,run_* 之类的执行类工具会被拒绝。未安装 RoamSwitch 时会跳过此来源,也可以在设置中关闭。

界面示例

PersonalSOC dashboard: overall risk gauge, severity donut, occurrences by category, hourly trend and MITRE ATT&CK counts
PersonalSOC report tab: current status summary, status by category and trend tables
PersonalSOC settings: automatic status check sources, scheduled runs, LLM integration and display language

所示界面中的数据(IP 地址等)均为虚构。

报告输出示例

这是报告示例(已启用 LLM 联动的情况)。可以复制为 Markdown 直接分享。

所示的 IP 地址和日志均为虚构。报告可以用显示语言(10 种语言)输出。

启动方法

Mac:打开「应用程序」文件夹中的「PersonalSOC」(与 RoamSwitch 不同的图标)。

Linux:从应用列表中打开「PersonalSOC」(独立图标)。在终端中运行 personalsoc-app。

命令行:personalsoc scan --report(报告)、personalsoc scan --llm <名称>(LLM 自主调查)。

隐私与适用范围

PersonalSOC 的日志分析全部在本设备内完成。它不会开放监听端口,界面也不会加载外部网站。

LLM 联动默认关闭。启用后,会启动您选择的 LLM 命令(opencode、claude、codex、agy 等),并传递检测内容和作为依据的日志行(密钥、令牌等机密已被遮盖)。根据该命令的设置,内容可能会被发送到外部服务。发送目的地和处理方式取决于您所选的 LLM 及其提供者的条款。

RoamSwitch 的「Zero-Telemetry」(不向外部发送通信内容和日志)是针对 RoamSwitch 本体的说明。启用 PersonalSOC 的 LLM 联动后产生的通信不在其范围内。如果保持 LLM 联动关闭,PersonalSOC 不会将日志内容发送到设备之外。

许可

PersonalSOC 采用 Apache License 2.0 许可,不适用 RoamSwitch 的使用许可协议(EULA)。许可文本、NOTICE 以及随附的第三方软件清单,在 Mac 上位于应用内部(PersonalSOC.app/Contents/Resources),在 Linux 上位于 /usr/share/licenses/personalsoc/。

运行环境与更新

macOS 12 或更高版本。Linux 需要 WebKitGTK 4.1(libwebkit2gtk-4.1),deb / rpm 会自动安装;在 Arch(AUR)上请将 webkit2gtk-4.1 作为可选依赖安装。在 Mac 上,可以在设置的「更新」中直接在应用内更新。只有按下按钮时才会联网,下载的文件会先验证签名再安装。在 Linux 上,它包含在 RoamSwitch 软件包的更新中。