Skip to content

Security: JunieXD/FlowWatch

SECURITY.md

安全说明

FlowWatch 会处理本机流量统计信息,并且在启用 Clash/Mihomo 时可能保存控制器密钥。

支持的版本

0.1.x 系列仅为最新发布版本提供安全修复。

报告安全问题

请使用 GitHub 私密安全报告。不要为安全问题创建公开 Issue,也不要提交生产数据库或 Clash 配置。请使用虚构的密钥和数据提供最小复现步骤。

当前安全设计

  • 当前仅接受监听在本机地址的 HTTP 控制器。
  • Clash 密钥按当前设计以明文保存在 SQLite 中。
  • 程序创建的数据目录权限为 0700;数据库和 LaunchAgent 文件权限为 0600。
  • 普通 CLI 输出会隐藏密钥内容。
  • 不持久化原始数据包、远端域名、远端 IP 和原始控制器响应。
  • LaunchAgent 的标准输出和错误输出写入 /dev/null;运行状态以容量受限的元数据保存在 SQLite 中。
  • 安装器会在执行下载的程序前,根据发布页的 SHA256SUMS 校验归档文件。

这些措施不能防止已以同一 macOS 用户身份运行的进程读取密钥。需要系统钥匙串保护的用户,在项目提供钥匙串集成前不应启用 Clash 数据来源。

FlowWatch 0.1.x 不包含 Apple 代码签名或公证。发布校验和可发现下载损坏或架构不匹配,但校验和与发布文件托管在同一位置,不能替代独立可信的签名。需要签名和公证软件的用户应从已审阅源代码自行构建,或等待未来的已签名版本。

There aren't any published security advisories