针对 v0.0.11 的静态代码审查,逐条记录结论与处置。 所有「可以改」的结论都来自本机实测,没有实测依据的一律保持原状并写明原因—— 为了看起来安全而把客户端搞挂,不是安全加固。
原配置:
webPreferences: {
nodeIntegration: false,
contextIsolation: false,
sandbox: false,
webSecurity: false,
}实测对比(同一台机器、同一份官方 webapp、GNOME / Wayland 会话):
| 配置 | 页面文本长度 | DOM 节点数 |
|---|---|---|
webSecurity: false(原) |
337 | 1292 |
webSecurity: true(现) |
5721 | 2989 |
开启后页面加载完整,本地资源服务与同源拦截都不受影响,也没有新增网络错误
(改变前后都有相同的 4 条 [api] POST 失败,属于应用本身在未登录状态下的接口调用)。
实测 contextIsolation: true 的结果:页面文本长度 0,DOM 只剩 61 个节点,等于白屏。
原因:官方 preload 是原版文件,它在 preload 里直接 require('electron') 并把对象挂到
window 上,页面脚本依赖这些注入。开启隔离后注入全部失效,官方 webapp 起不来。
两个硬约束:
- preload 需要 Node 能力(
fs/path/child_process),sandbox 下不可用。 - 启动参数带
--no-sandbox:AppImage 的chrome-sandbox位于只读 squashfs, SUID 位设不上去,不加--no-sandbox时 Electron 直接静默退出 (这正是 v0.0.7 双击没反应的原因之一)。
结论:这一项当前无解,除非放弃 AppImage 分发形态或要求用户手工设置 SUID。 已在 README 的已知限制里说明。
原实现对所有请求无条件放行 notifications / media / display-capture /
clipboard-read / clipboard-sanitized-write / fullscreen / background-sync,
不校验请求来源。
现改为:先校验发起请求的 URL,再决定是否放行。
const ORIGIN_OK = (u) =>
/^https:\/\/([a-z0-9-]+\.)*kookapp\.cn([/?#]|$)/i.test(url) ||
/^http:\/\/127\.0\.0\.1(:\d+)?([/?#]|$)/i.test(url) ||
/^http:\/\/localhost(:\d+)?([/?#]|$)/i.test(url) ||
/^(file|devtools):/i.test(url)- 白名单覆盖:官方域名(含子域)、本地资源服务、本地文件、devtools
- 不在白名单内的请求直接拒绝,并打日志
[perm] 拒绝来源不明的权限请求 setPermissionRequestHandler与setPermissionCheckHandler两处都加了校验
实测:正常使用下没有任何请求被误拒(日志里 0 条 [perm] 拒绝记录),页面加载完整。
保留的弱点:白名单是域名级的,不是每次调用都二次确认。如果 webapp 自身出现 XSS,攻击者仍能在允许的域名内申请麦克风。进一步收紧需要改官方 preload 的调用链, 风险大于收益,暂不做。
safeStorage 不可用时退化为 Base64(只是编码,不提供保密性)。
状态:已在 v0.0.12 修复。现在按四层递降,没有「静默 Base64」这条路径:
| 优先级 | 条件 | 产物 | 日志 mode= |
|---|---|---|---|
| 1 | safeStorage 且后端是真后端(gnome_libsecret / kwallet*) |
Electron 密文 | safeStorage |
| 2 | 有 secret-tool(libsecret Secret Service) |
自管 AES-256 主密钥 + AES-256-GCM,格式 v2:iv:tag:ct |
keyring |
| 3 | 两者都没有 | 拒绝落盘,返回空串 + 一次性弹窗说明 | none |
| 4 | 显式 KOOK_INSECURE_STORE=1 |
v0: 前缀明文 + 警告弹窗 |
insecure |
这一条里最容易被忽略的事实:Electron 在 Linux 上的 basic_text 后端使用的是
Chromium 内置的硬编码口令,safeStorage.isEncryptionAvailable() 仍然返回 true,
但实际等同明文。如果按常见写法只判断 isEncryptionAvailable(),这层防护形同虚设。
实现里用 getSelectedStorageBackend() 把 basic_text 单独摘出来,判为不安全。
历史数据迁移:读取 important.ka 时识别三种旧格式(Electron 密文 / v0: / 旧版裸 Base64),
发现裸 Base64 且当前有安全后端时当场重加密回写,同一存储里的其他键原样保留。
实测(隔离 Electron 进程,真实调用 createRuntime,非 mock):
| 场景 | 后端判定 | 产物 | 往返 |
|---|---|---|---|
| 本机正常 | safeStorage · gnome_libsecret |
Electron 密文 | ✅ |
| 屏蔽 safeStorage | keyring · libsecret |
v2: AES-GCM |
✅ |
| 两者都无 | none |
空(拒绝保存) | 按设计失败 |
同上 + KOOK_INSECURE_STORE=1 |
insecure |
v0: + 警告 |
✅ |
种入旧版明文 ka |
keyring |
落盘变 v2:,其他键未丢 |
✅ |
代价(用户可感知):没有密钥环的机器会丢掉「记住登录」,每次启动都要重新登录。 这是刻意的取舍——把明文等价物当作正常持久化结果,等于这层加固白做。降级路径与恢复方法写在 README「已知限制」。
这是审查报告里唯一可以静态确认、并且实测复现的确定性缺陷。
原代码在第 48 行就调用 globalPref('disabled_hardware_acceleration', false),
而 const path = require('path') 在第 55 行。readGlobalStore() 内部的
try/catch 把 ReferenceError: path is not defined 静默吞掉,返回 {},
于是所有桌面设置读到的都是默认值。
实测复现:把 disabled_hardware_acceleration 设为 true 后启动,
日志里根本没有「硬件加速已按设置关闭」这一行——设置完全没被读到。
修法:把 path / fs / os 的 require 提到文件顶部,globalPref 之前。
修复后实测:
[linux-main] 硬件加速已按设置关闭(重启后生效)
同一份配置,修复后能正确读到。顺带修好了「关闭到托盘」「效能模式」这两个
同样走 globalPref() 的设置项。
状态:已完成,产出 docs/IPC-CONTRACT.md(209 条全覆盖)。
| 类别 | 含义 | 数量 |
|---|---|---|
| A | 已完整实现 | 91 |
| B | Linux 替代实现 | 33 |
| C | 明确不支持 | 27 |
| D | 临时兼容桩 | 58 |
三条实质发现(都已修):
WINDOW_SET_SIZE_ORIGIN静默无效:preload 在window.js:129用send调用,主进程从未注册, 请求落到 catch-all 返回{},所以「设置窗口初始尺寸」一直是空转。已补真实实现。- 两条伪成功:
SYSTEM_GET_FILE返回{code:0,data:null}、SYSTEM_SWITCH_SERVER_API返回true但根本没切域名。现在前者走真实dialog.showOpenDialog(无窗口时返回-1而不是弹窗挂死sendSync调用方),后者真读白名单、真写linux-store/domain.json、重启仍生效。 GET_ACTIVE_DOMAIN形状不符:原返回{origin, api},而官方runtime-domain.js读activeApiOrigin,所以域名选择一路回落到config.appServer——不是「切不动」,是没接上。 现在返回官方形状,旧键保留兜底。
形状类问题单列在契约表 §9.2,不与 A/B/C/D 分类混在一起,否则「注册了但字段错」会被归类掩盖。
| 项 | 状态 |
|---|---|
| 主进程模块化(main.js 约 2600 行) | 计划中,优先级低于安全项 |
| 上游版本兼容性检测 | ✅ 已落地 scripts/check-upstream.mjs + patches/upstream-baseline.json(209 通道 + 43 个契约文件哈希 + webapp 指纹) |
| 处理器自动化测试 | 进行中(文件选择 / 服务器切换 / 窗口尺寸三条先做) |
| CI 自动构建 / 测试矩阵 | 计划中 |
| SHA-256 校验 | 已在 Release 说明中提供 |
审查报告提到「官方接口可能存在注入攻击风险」。这部分不属于本仓库范围:
- 官方接口的问题应通过官方安全渠道提交,本仓库不做公开复现
- 本仓库能做的只是强化客户端自身边界(就是 P0-1 / P0-2 / P0-3 这几条)
- 两项工作并行,互不阻塞
以上结论来自本机实测,测试环境:CachyOS / GNOME / Wayland / x86_64。 没有做模糊测试,也没有做实际漏洞利用验证。生产环境风险请自行评估。