高级配置

本文档介绍 Cirno 的高级配置选项和配置文件系统。

配置文件

Cirno 的配置存储在 /data/system/Cirno/ 目录下,包含两个 JSON 文件:

GlobalSettings.json

全局设置,包含:

  • 冻结方式
  • 日志级别
  • ReKernel 集成配置
  • 厂商兼容层配置

ApplicationSettings.json

应用级别设置,包含:

  • 白名单 / 黑名单列表
  • 后台播放豁免列表
  • 后台定位豁免列表
  • 网速识别启用列表
  • 网络解冻启用列表
  • 进程级冻结排除配置

注:配置文件采用 JSON 格式,如果你不熟悉 JSON 语法,请不要手动编辑。配置损坏后可能导致应用异常或配置丢失。


配置备份与恢复

备份配置

  1. 点击底部导航栏最右侧的全局设置
  2. 滚动到页面底部
  3. 点击导出配置
  4. 选择保存位置

备份文件为 ZIP 格式,包含 GlobalSettings.jsonApplicationSettings.json 两个文件。

恢复配置

  1. 点击底部导航栏最右侧的全局设置
  2. 滚动到页面底部
  3. 点击导入配置
  4. 选择备份的 ZIP 文件

注:导入的 ZIP 文件必须仅包含 GlobalSettings.jsonApplicationSettings.json 两个文件,否则导入失败。

恢复后配置立即生效,基本无需重启设备。配置备份支持跨设备迁移。


日志查看

Cirno 的日志输出到 /data/system/Cirno/log 目录。

查看方式

  1. 点击主页的日志一栏
  2. 查看实时日志输出

日志级别

可在全局设置中调整日志级别:

级别说明推荐场景
调试输出详细调试信息反馈 Bug 或分析问题时
信息输出常规信息日常使用(推荐
警告仅输出可能出错的信息稳定后关闭详细日志
错误仅输出错误信息稳定后关闭详细日志

冻结方式

Cirno 基于 cgroup v2 实现冻结,支持以下方式:

方式说明推荐
V2 UID按 UID 冻结,兼容性好推荐
V2 Frozen按 cgroup 路径冻结推荐

注:冻结方式在全局设置中选择,更改后立即生效。


ReKernel 集成

ReKernel 是内核级 Binder 和网络事件监听模块,通过 Netlink 套接字与 Cirno 通信。

功能增强

启用 ReKernel 后可以使用:

  • 网络解冻:收到网络数据包时临时解冻应用
  • 异步缓存清理:减少 Binder 解冻次数

选择建议

根据内核版本选择 ReKernel 版本:

内核版本推荐版本
5.10 及以上ReKernel_LKM(推荐
5.4 及以下ReKernel_KPM

下载地址:

安装步骤

  1. 根据内核版本下载对应的 ReKernel
  2. 使用 KernelSU / Magisk / APatch 刷入模块
  3. 重启设备
  4. Cirno 会自动检测并启用 ReKernel 集成

注:无 ReKernel 时,Cirno 会自动回退到用户态 Hook,不影响基础冻结功能。


厂商兼容性

Cirno 会自动检测设备厂商并适配其进程管理系统:

完整支持

厂商内核模块
小米 / 红米 / POCO(MIUI / HyperOS)Millet
OPPO / OnePlus / RealmeHans

部分支持

厂商说明
三星不保证完整支持,可能存在兼容性问题

注:启用 ReKernel 后,厂商 Binder 拦截会自动退让,优先使用 ReKernel。