Skip to content

Security: Dongwu259/GPU_Scope

Security

SECURITY.md

安全政策 (Security Policy)

支持的版本

版本 是否维护
0.1.x ✅ 当前维护中

报告漏洞

如果你发现了安全漏洞,请勿通过公开 Issue 披露,以免被恶意利用。

请通过以下渠道私下报告:

  • GitHub Security Advisory:在本仓库点击 Security → Report a vulnerability(推荐,可私下沟通且支持协同修复)。
  • 或邮件联系维护者(见仓库主页 / git log 中提交的作者邮箱)。

报告中请尽量包含:

  1. 漏洞类型与影响范围;
  2. 复现步骤(含环境:OS / Python / GPU 型号);
  3. 可能的利用方式或已观察到的异常;
  4. 你的建议修复方案(如有)。

我们会在 72 小时内确认收到,并尽快评估与修复;修复发布后会与你确认披露时间。


令牌与敏感文件

  • 远程写操作(/api/shutdown、/api/settings/...)由本地 API 令牌保护,令牌存于 auth.json。
  • auth.json 已被 .gitignore 忽略,切勿提交(即使你本地改过也不要 git add -f)。
  • 默认仅绑定 127.0.0.1;如需局域网访问请显式 --host 0.0.0.0,并妥善保管令牌、勿泄露给他人。
  • 历史数据(history.db)、计量状态(meter.json)均为本地文件,不含凭证,但同样不应提交。

已知安全限制(当前设计如此,使用前请知悉)

  1. GET 接口无鉴权:/api/metrics、/api/cpu、/api/memory、/api/settings、/api/history、/api/export 均不需要令牌。以 --host 0.0.0.0 运行时,任何能访问该端口的人都能读取进程列表、网卡 IP、磁盘分区、累计电费等信息。请勿在不可信网络上开放绑定。
  2. 令牌会被下发到页面(仅对外暴露时):前端需要令牌才能调用写接口,因此以 --host 0.0.0.0 运行时,服务端会把令牌注入 index.html(__API_TOKEN__),任何能打开面板的人都能拿到令牌。默认绑定回环时不注入(本地请求本就免鉴权)。令牌仅用于区分"能读到面板的人",不构成真正的访问控制。
  3. CSRF:写接口会校验 Origin 头 —— 来自非本服务页面的请求一律拒绝,除非它同时携带有效令牌。因此恶意网页无法再跨站触发 /api/shutdown 等写操作。但携带令牌的跨站请求仍会被放行(这是让局域网面板正常工作的必要取舍),所以仍建议仅在本机或受信任内网使用。
  4. 依赖第三方组件:Windows 上可选集成 LibreHardwareMonitor(由其 install_lhm.bat 从 GitHub Releases 下载),其安全性不在本项目保证范围内。

以上限制均已在 README「安全说明」中同步标注。若你希望改进其中任意一项(例如增加 Origin 校验、给 GET 加只读令牌、或局域网访问时改用 Basic Auth),欢迎提 Issue 或 PR。

There aren't any published security advisories