Skip to content

KOOK Linux 移植版 v0.0.12

Choose a tag to compare

@kanniganfan kanniganfan released this 19 Nov 14:25
· 19 commits to main since this release

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.rpm

AppImage 不需要手加 --no-sandbox 之类的参数,启动器会自己判断会话环境。

已知限制

  • 屏幕覆盖的「全屏游戏时显示」「在系统桌面上显示」需要 X11 会话
  • Wayland 下全局快捷键在窗口无焦点时可能收不到
  • 没有系统密钥环时不保存登录状态(见开头)
  • 仅 x86_64,暂无 ARM 真机验证,不发布 arm64 包

从旧版本升级

直接覆盖安装即可,配置与登录数据保留。已登录的用户升级后需要重新登录一次
(凭据格式从旧版迁移到新格式)。

了解更多