Repository navigation
KOOK Linux 移植版 v0.0.12
KOOK Linux 移植版 v0.0.12
一轮安全审查之后的加固版:Web 安全开了、权限收紧、凭据分三层
基于官方 Windows PC 客户端
0.112.0(构建c5af713-kook_3321)移植
社区作品,与 KOOK 官方无关 · 官方从未发布 Linux 版
⚠️ 先看这一条:登录状态的行为变了
如果你没有安装系统密钥环(gnome-keyring / kwallet),这版开始不会保存登录状态——
每次启动都要重新登录。
这不是 bug,是安全加固的代价。旧版本在 safeStorage 不可用时会把登录令牌用 Base64
存下来,那只是编码,任何能读你配置目录的进程都能还原成明文。这版起改成三层:
系统密钥环(真后端) → 用 Electron safeStorage 加密 ← 最佳
↓ 不可用
secret-tool 取主密钥 → AES-256-GCM 加密 ← 可用
↓ 不可用
拒绝落盘 + 提示 → 本次登录不持久化 ← 安全兜底
想恢复「记住登录」,装 gnome-keyring(GNOME)或 kwallet(KDE)后重启客户端即可,
已有的旧格式凭据会自动重加密迁移。
确实接受明文落盘的风险,可以设 KOOK_INSECURE_STORE=1,会以 v0: 标记保存并弹一次警告。
启动日志里能直接看到当前用的是哪一层:
[secret] 凭据存储 mode=safeStorage backend=gnome_libsecret secure=true
安全加固
- 开启 Chromium Web 安全保护
此前为兼容性关闭。实测开启后页面加载完整(文本 5721 字符 / 2989 节点),无新增错误。 - 系统权限按来源校验
媒体、屏幕分享、剪贴板等权限原先无条件放行,现在先校验请求来源是否属于kookapp.cn
域名或本地资源服务,不在白名单内直接拒绝并记日志。 - 登录凭据三层存储
见上。关键细节:Linux 上 Electron 的basic_text后端isEncryptionAvailable()
照样返回true,但用的是 Chromium 内置硬编码口令,实际等同明文——已单独识别并判为不安全。
问题修正
- 三个设置项此前完全不生效
「关闭硬件加速」「关闭到托盘」「效能模式」都读同一个配置读取函数,而它依赖的path
模块在调用之后才 require,异常被 try/catch 静默吞掉,读到的永远是默认值。 - 域名切换从来没生效过
GET_ACTIVE_DOMAIN返回的是{origin, api},而官方读activeApiOrigin/
activeH5Origin/activeFirstPartyOrigins,取值永远undefined,一路回落到默认服务器。
现在按官方形状返回。 - 窗口初始尺寸设置无声失败
官方 preload 用send调WINDOW_SET_SIZE_ORIGIN,主进程从未注册。 - 两条伪成功
SYSTEM_GET_FILE走真实文件对话框(无窗口时返回-1,避免挂死调用方);
SYSTEM_SWITCH_SERVER_API改为真实切换并落盘,非白名单域名直接拒绝。
工程
- 新增 IPC 契约表:
209 个通道全覆盖,当前分布 A 已完整实现 91 / B Linux 替代实现 33 / C 明确不支持 27 /
D 临时兼容桩 58(本次两条伪成功已从 D 挪进 A)。另有形状契约专项与 sendSync 同步通道清单。 - 新增
scripts/check-upstream.mjs上游兼容性检测:对比官方版本、commitId、
通道清单与关键文件哈希,官方更新后跑一次就知道哪里要改。 - docs/SECURITY.md
记录了安全审查每一条的处置结论与实测数据,包括哪些能改、哪些改了会白屏。
下载
| 格式 | 文件 | 大小 |
|---|---|---|
| AppImage | KOOK-0.0.12-x86_64.AppImage |
225.2 MiB |
| deb | kook_0.0.12_amd64.deb |
159.1 MiB |
| rpm | kook-linux-0.0.12.x86_64.rpm |
177.6 MiB |
SHA-256 校验
f07fa0a9dced387254aee4d75e211595b316678cae14d4af6eba639db02082fd KOOK-0.0.12-x86_64.AppImage
1732866849fb9e056673332ca6a3e81ce43e6b665cbd33ca3bfdf29972ce89c6 kook_0.0.12_amd64.deb
5b804ced79e083ddefcfeca785cfb6193a7c22883089a4807d009239cc2fa530 kook-linux-0.0.12.x86_64.rpm
安装
# AppImage —— 任何 glibc 发行版
chmod +x KOOK-0.0.12-x86_64.AppImage
./KOOK-0.0.12-x86_64.AppImage
# Debian / Ubuntu / Deepin / UOS
sudo dpkg -i kook_0.0.12_amd64.deb && sudo apt -f install
# Fedora / RHEL / openSUSE
sudo rpm -i kook-linux-0.0.12.x86_64.rpmAppImage 不需要手加 --no-sandbox 之类的参数,启动器会自己判断会话环境。
已知限制
- 屏幕覆盖的「全屏游戏时显示」「在系统桌面上显示」需要 X11 会话
- Wayland 下全局快捷键在窗口无焦点时可能收不到
- 没有系统密钥环时不保存登录状态(见开头)
- 仅 x86_64,暂无 ARM 真机验证,不发布 arm64 包
从旧版本升级
直接覆盖安装即可,配置与登录数据保留。已登录的用户升级后需要重新登录一次
(凭据格式从旧版迁移到新格式)。
了解更多
- 功能清单与环境要求:README
- IPC 契约表:docs/IPC-CONTRACT.md
- 安全审查响应:docs/SECURITY.md
- 完整提交记录:v0.0.11...v0.0.12
- 问题反馈:Issues 或 cylqm@qq.com