基于上游 Linux 稳定版自行维护的桌面内核。基线是 linux-7.3.3(kernel.org stable tarball),
在其上按序应用 13 个补丁,再配一份为桌面交互场景调过的 x86_64 配置,最终构建成 Arch Linux 软件包
linux-zakofox 与 linux-zakofox-headers。内核版本串为 7.3.3-zakofox。
目标场景:日常桌面、开发编译、游戏。取舍原则是交互延迟与响应速度优先,但不拿兼容性换:
每个改动都能用 CONFIG_ZEN_INTERACTIVE 或内核命令行/sysctl 关掉,不引入需要用户额外配置才能
正常运行的默认行为。已发现但尚未修掉的偏离项列在文末「已知问题」。
| 包名 | 内容 | provides / conflicts |
|---|---|---|
linux-zakofox |
vmlinuz、全部模块(zstd 压缩)、System.map、/boot/config |
KSMBD-MODULE NTSYNC-MODULE VIRTUALBOX-GUEST-MODULES WIREGUARD-MODULE VHBA-MODULE;conflicts=(linux) |
linux-zakofox-headers |
/usr/lib/modules/7.3.3-zakofox/build 完整头文件树、scripts/、Module.symvers、vmlinux.h(若存在) |
linux-headers=7.3.3-1;conflicts=(linux-headers) |
vmlinuz 装在 /usr/lib/modules/7.3.3-zakofox/vmlinuz,pkgbase 文件同步写入该目录,
供 Arch 的 mkinitcpio / systemd-boot 钩子识别。模块安装后 depmod 由 pacman hook 触发。
options=(!debug !strip):配置里已关调试信息,因此不需要 strip,也避免误伤 vmlinux 符号表。
13 个补丁按文件名排序依次应用(PKGBUILD 的 prepare() 里逐个 patch -Np1)。
补丁不干净时 patch 会打印 FAILED 并留下 .rej,构建通常要到编译阶段才报错——
所以改完补丁务必先本地验证一遍(见「升级上游版本」)。
| 编号 | 大小 | 名称 | 一句话 |
|---|---|---|---|
0001 |
334 KB | prjc PDS 调度器 | 引入 Project C 的 alt_* 调度器实现,默认 PDS,可选 BMQ |
0002 |
12.4 MB | cjktty | VT/fbcon 层的 UTF-8 双缓冲 + 内置 CJK 点阵字体 |
0100 |
4.2 KB | 核心配置项 | ZEN_INTERACTIVE 总开关、-O3 选项、PDS 设为默认、NAME = Zakofox |
0110 |
9.9 KB | 调度参数 | EEVDF 时间片/迁移成本/带宽片调小,附 kunit 拓扑测试 |
0120 |
17 KB | 内存与 zswap | zswap 异步压缩请求重构、mmdrop 内联化、max_map_count 上限提高 |
0130 |
1.3 KB | 块层默认调度器 | 单队列默认 BFQ、多队列默认 Kyber |
0140 |
117 KB | 网络 | BBR3 拥塞控制、TCP ECN low 标记、相关 uapi 与 selftest 同步 |
0150 |
1.9 KB | CPU 调频 | ondemand 更激进的上调阈值,intel_pstate=enable 反转开关 |
0160 |
4 KB | 显卡 | amdgpu ignore_min_pcap 参数、i915 eDP sink 唤醒修复 |
0170 |
3.7 KB | PCI | pcie_acs_override= 参数,拆分 IOMMU 组 |
0180 |
5.6 KB | 中断与时间 | 中断强制线程化选项、tick/vtime 热路径内联 |
0190 |
32 KB | 虚拟光驱 | drivers/scsi/vhba(CONFIG_VHBA=m) |
0200 |
10.7 KB | 架构与杂项 | x86-64 ISA 等级选择、split-lock 默认放宽、evdev RCU 回收等 |
Project C 的 alt_* 调度器,以 CONFIG_SCHED_ALT 为总开关、与 CFS 二选一编译。
新增 kernel/sched/alt_core.c、alt_core.h、alt_sched.h、alt_debug.c、alt_topology.c、
alt_topology.h、pds.h、bmq.h,以及 Documentation/scheduler/sched-BMQ.txt;
并把调度器与内核其余部分的接口在 SCHED_ALT 下对齐:
kernel/sched/{Makefile,build_policy.c,build_utility.c,sched.h,topology.c,debug.c,stats.c,stats.h, syscalls.c,idle.c,cputime.c,pelt.c,pelt.h,cpufreq_schedutil.c}- 阻塞/唤醒链路:
kernel/locking/{rtmutex.c,ww_mutex.h}、kernel/delayacct.c、kernel/exit.c、include/linux/sched/{deadline.h,rt.h,prio.h,topology.h}、include/linux/sched.h kernel/workqueue.c(per-CPU 工作队列与 alt 调度器的亲和性配合)kernel/cgroup/cpuset.c(cpuset 与 alt 调度器共存)kernel/{sysctl.c,time/posix-cpu-timers.c,trace/trace_osnoise.c,trace/trace_selftest.c}fs/proc/base.c、fs/f2fs/checkpoint.c(把sched_setscheduler相关的权限/回收路径适配)init/Kconfig(choice prompt "Alternative CPU Scheduler")、kernel/Kconfig.preempt
PDS 的特点是「每 CPU 一个运行队列 + 位图选核 + 不需要全局锁」,唤醒延迟稳定, 对交互和游戏帧生成时间友好;BMQ 是同一实现的另一种任务选优策略,配置里默认不启用。
让 VT/fbcon 直接显示 UTF-8 中文,不依赖用户态字体切换:
drivers/tty/vt/vt.c:控制台缓冲扩为两倍(vc_screenbuf_size * 2),前半是原有的u16字符码,后半(screenpos_utf8())存原始 UTF-16 码点,供全角字形查表用;screen_glyph()在遇到0xff/0xfe占位时返回真实码点;kzalloc(vc->vc_screenbuf_size * 2)。drivers/tty/vt/selection.c:选区复制按 UTF-8 还原,复制中文不乱码。drivers/video/fbdev/core/bitblit.c:font_bits()增加ch == 0xff/0xfe分支, 按cellsize选CJK16x16/CJK32x32字体,索引为fontdata + c_utf * cellsize_utf * 2 (+ cellsize_utf)——即每个码点占两个相邻字形槽 (半角位 + 全角位),因此.charcount = 65536 * 2。drivers/video/fbdev/core/{fbcon.c,fbcon.h}及四个旋转实现{fbcon_ccw.c,fbcon_cw.c,fbcon_rotate.c,fbcon_ud.c}:旋转缓冲同样要多维护一份 CJK 缓冲, 否则旋转过的控制台中文会错位。lib/fonts/{Kconfig,Makefile,font.h,fonts.c,font_cjk_16x16.c,font_cjk_32x32.c}: 新增CONFIG_FONT_CJK_16x16/CONFIG_FONT_CJK_32x32(depends on FRAMEBUFFER_CONSOLE && VT_CONSOLE,select CONSOLE_TRANSLATIONS),字体索引CJK16x16_IDX = 14、CJK32x32_IDX = 15。
16×16 字体数据由补丁内联携带:65536 个字形 × 32 字节 = 2 MB 二进制,写成
/* 序号 0xXXXX */ 注释的 C 数组后 font_cjk_16x16.h 是 12 MB 文本。
上游 cjktty 的 32×32 字形表(font_cjk_32x32.h)在 7.2 系列补丁里是空文件,
.charcount 却声明为 65536 * 2,编进去只会得到一张越界可读的空表,因此本内核
把 CONFIG_FONT_CJK_32x32 关掉:16 行字体(默认)下中文完全正常,bitblit.c 的
if (!font || !font->data) return vc->vc_font.data; 会让 32 行字体回落到 ASCII 字形而不是越界读。
需要 32×32 中文时用 scripts/gen-cjk-font.py --size 32 生成数据、打开开关再重编。
init/Kconfig:新增config ZEN_INTERACTIVE(bool "Tune kernel for interactivity",默认 y), 下面所有调优补丁都以它为条件——关掉即可回到纯上游行为,不需要逐个撤销补丁。init/Kconfig:Alternative CPU Scheduler的默认值改为default SCHED_PDS if ZEN_INTERACTIVE+default SCHED_BMQ。init/Kconfig+Makefile:新增config CC_OPTIMIZE_FOR_PERFORMANCE_O3及KBUILD_CFLAGS += -O3分支(当前配置未启用,实际用-O2)。Makefile:NAME = Zakofox;init/Makefile在UTS_VERSION里插一个ZEN标记,uname -v可区分。kernel/sched/debug.c:SCHED_ALT下屏蔽cgroup_mode相关代码,否则与 alt 调度器重复定义。
仅在 CONFIG_ZEN_INTERACTIVE 下生效:
| 参数 | 上游 | zakofox | 影响 |
|---|---|---|---|
sysctl_sched_base_slice |
0.70 ms | 0.40 ms | EEVDF 基础时间片缩短,切换更细粒度 |
sysctl_sched_migration_cost |
0.50 ms | 0.30 ms | 负载均衡更愿意搬任务 |
sysctl_sched_cfs_bandwidth_slice |
5 ms | 3 ms | cgroup 带宽片更细 |
另新增 kernel/sched/alt_topology_test.c(kunit 测试,验证 P/E 核与 SMT 的选核逻辑)。
mm/zswap.c:把每次压缩/解压都要走的acomp_req分配改成每 CPU 复用 + 异步回调, 写回路径不再在原子上下文里同步等待压缩完成。include/linux/mm.h:DEFAULT_MAX_MAP_COUNT从USHRT_MAX - MAPCOUNT_ELF_CORE_MARGIN(≈65530) 提到INT_MAX - MAPCOUNT_ELF_CORE_MARGIN。Wine/Proton、JVM、大型浏览器这类大量mmap的程序不再需要手动sysctl -w vm.max_map_count=...。include/linux/sched/mm.h:mmdrop/mmdrop_sched/mmdrop_lazy_tlb_sched/membarrier_mm_sync_core_before_usermode改__always_inline(都在上下文切换热路径上)。Documentation/mm/multigen_lru.rst两处文档同步。
block/elevator.c 的 elevator_set_default():ZEN_INTERACTIVE 下
- 单队列(
nr_hw_queues == 1或共享 tag 集):默认 BFQ(CONFIG_IOSCHED_BFQ存在时), 桌面交互与顺序读写下延迟更平滑; - 多队列(NVMe 等):默认 Kyber(
CONFIG_MQ_IOSCHED_KYBER存在时), 在不牺牲吞吐的前提下给读请求优先权。
都不满足时保持上游的 mq-deadline 回落逻辑。
- 新增
net/ipv4/tcp_bbr3.c与CONFIG_TCP_CONG_BBR3(tcp_bbr3可sysctl切换, 默认拥塞控制仍是cubic,见配置表)。 TCP_ECN_LOW标记(include/uapi/linux/tcp.h、include/net/tcp.h、net/ipv4/tcp_input.c): 低延迟场景下 ECN 的标记策略更积极。net/ipv4/{tcp.c,tcp_cong.c,tcp_bbr.c,tcp_input.c,tcp_output.c,tcp_metrics.c,tcp_timer.c}、include/net/{tcp.h,tcp_cong.h,inet_connection_sock.h}、include/uapi/linux/{tcp.h,inet_diag.h,rtnetlink.h}同步;tools/testing/selftests/net/tcp_ca_kfunc.c跟着改。
drivers/cpufreq/cpufreq_ondemand.c:DEF_FREQUENCY_UP_THRESHOLD 80 → 55,
MICRO_FREQUENCY_UP_THRESHOLD 95 → 60,DEF_SAMPLING_DOWN_FACTOR 1 → 5
(升频更早、降频更慢,桌面短时负载不会来回抖动)。
intel_pstate 增加 enable 覆盖值,可以覆盖之前 disable 的内核命令行。
同时去掉 CPU_FREQ_GOV_SCHEDUTIL 的 select,避免和 PDS 的负载估算重复。
- amdgpu:新增
ignore_min_pcap模块参数(部分显卡的最低功耗上限设得过高, 导致频率被人为压低),并在amdgpu_pm.c的 sysfs 里对应返回 0。 - i915:
intel_edp_wake_sink(),eDP 面板睡眠唤醒时补一次DP_SET_POWER写,修部分笔记本 唤醒后黑屏。
drivers/pci/quirks.c:pcie_acs_override= 参数(downstream / multifunction / id:vvvv:dddd),
把没有真实 ACS 的设备拆成独立 IOMMU 组,方便 VFIO 直通。会 taint 内核,且不是安全边界。
kernel/irq/Kconfig+kernel/irq/manage.c、include/linux/interrupt.h:新增CONFIG_FORCE_IRQ_THREADING(默认关)与nothreadirqs命令行反转开关,force_irqthreads()在开启时走 static key(static_branch_likely)而不是常量判断。include/linux/tick.h、include/linux/vtime.h:tick_nohz_full_enabled()、tick_nohz_task_switch()、vtime_accounting_enabled*()、vtime_task_switch()改__always_inline,减少每 tick 与上下文切换的函数调用开销。- 原来还带一个 Debian 式的
unprivileged_userns_clone(kernel/fork.c), 因依赖 7.3 不存在的CONFIG_USER_NS_UNPRIVILEGED且会让非特权沙箱默认失效,已整段移除。
drivers/scsi/vhba/:vhba 内核模块(CONFIG_VHBA=m),配合 CDEmu 之类把镜像挂成光驱。
drivers/scsi/{Kconfig,Makefile} 注册,VHBA-MODULE 由包 provides。
arch/x86/Kconfig.cpu+arch/x86/Makefile:新增X86_64_VERSION(1..3,默认 1 = x86-64 baseline), 在!X86_NATIVE_CPU时按 psABI 微架构等级统一出编译参数;本配置取 1,保证在任何 x86-64 机器上可启动。arch/x86/kernel/cpu/bus_lock.c:ZEN_INTERACTIVE下sysctl_sld_mitigate默认 0 (split lock 检测的缓解默认关闭,性能优先;可用 sysctl 打开)。drivers/input/evdev.c:客户端释放改成 RCU 回调延迟回收,避免高频输入下synchronize_rcu()卡顿。fs/btrfs/compression.c、fs/erofs/zdata.c:PageWorkingset()→folio_test_workingset(page_folio())的 folio 迁移适配。arch/{x86,arm,riscv,s390,sparc}/include/asm/mmu_context.h、arch/x86/include/asm/sync_core.h、include/linux/perf_event.h:热路径函数__always_inline。Documentation/admin-guide/kernel-parameters.txt:上述新参数(nothreadirqs、pcie_acs_override=、sched_pds_sleep_credit=、intel_pstate=enable)的说明。
配置唯一事实来源是 zakofox-x86_64.config:prepare() 里复制成 .config 后跑
make olddefconfig,若有漂移会打印 diff 作为警告(不中断构建),需人工确认漂移是否可接受。
| 配置项 | 值 | 原因 |
|---|---|---|
CONFIG_ZEN_INTERACTIVE |
y |
全部调优的总开关 |
CONFIG_SCHED_ALT + CONFIG_SCHED_PDS |
y / y |
桌面交互优先的调度器 |
CONFIG_PREEMPT |
y(PREEMPT_DYNAMIC 关) |
静态全抢占,避免 dynamic 模式下的静态键分支 |
CONFIG_HZ |
1000 |
桌面响应 |
CONFIG_NO_HZ_FULL |
y |
空闲 CPU 不被打扰 |
CONFIG_RCU_NOCB_CPU_DEFAULT_ALL |
y |
回调卸载到 rcuo 线程,减少软中断抖动 |
CONFIG_NR_CPUS |
128(非 MAXSMP) |
够用且显著缩短编译、减小镜像 |
CONFIG_CC_OPTIMIZE_FOR_PERFORMANCE |
y(-O2) |
当前取上游默认;-O3 选项已备好未启用 |
CONFIG_LTO_NONE |
y |
避免 LTO 与 cjktty 大字体文件、PDS 的编译期问题 |
CONFIG_LOCALVERSION |
"-zakofox" |
版本串;LOCALVERSION_AUTO 关 |
CONFIG_DEBUG_INFO_NONE |
y |
不要 DWARF/BTF,包体积从数百 MB 降到 ~160 MB |
CONFIG_FONT_CJK_16x16 |
y |
控制台中文(16 行字体);32×32 因上游字形表为空而关闭 |
CONFIG_TCP_CONG_BBR3 |
y |
可选拥塞控制;CONFIG_DEFAULT_TCP_CONG="cubic" 保持上游默认 |
CONFIG_ZSWAP + ZSWAP_DEFAULT_ON |
y / y,压缩器 zstd |
内存紧张时的兜底,无需手动开 |
CONFIG_ZRAM |
y,默认 zstd 多后端 |
沿用 7.3 上游实现(见下) |
CONFIG_MODULE_COMPRESS_ZSTD + _ALL |
y |
模块全量 zstd 压缩 |
CONFIG_MODULE_SIG_ALL + SHA512 |
y |
模块签名(MODULE_SIG_FORCE 关,仍可加载外部模块) |
CONFIG_X86_64_VERSION |
1 |
x86-64 baseline,兼容任何 x86-64 机器 |
CONFIG_VHBA |
m |
虚拟光驱 |
CPU 侧未启用 CONFIG_X86_NATIVE_CPU:内核需要能在别的机器上启动,
make localmodconfig 风格的「只对本机 CPU 优化」不适合发行包。想要本机极限性能可在
X86_64_VERSION 上调到 2/3 后自行重编。
makepkg -s # 或 makepkg -sioc 保留构建目录依赖:base-devel bc cpio gettext libelf pahole perl python tar xz zstd。
4 核机器上 --noprepare 全量约 3~5 小时(make -j$(nproc)),建议至少 8 核 / 16 GB。
.github/workflows/build.yml:在 archlinux:base-devel 容器里以非 root 用户跑
makepkg --noconfirm --nocheck --cleanbuild --syncdeps,ccache 与内核源码 tarball 走 Actions cache
(key 带 hashFiles('PKGBUILD','*.config','*.patch')),job 超时 350 分钟。
产物 linux-zakofox-7.3.3(两个 .pkg.tar.zst,约 160 MB)与 build-logs 上载为 artifact;
包本身不上传 release,需要的话自行下载 artifact 后 pacman -U。
触发条件:推送 main 且改动 PKGBUILD / *.patch / *.config / scripts/** / workflow 自身,
或手动 workflow_dispatch(可指定并行任务数)。只改 README.md、LICENSE 不会触发重建。
注意:workflow 里
concurrency: cancel-in-progress: true。一次全量构建约 2 小时 15 分, 这期间不要往main推任何会匹配上述路径的提交,否则正在跑的构建会被取消—— 只改README.md、LICENSE不受影响。
PKGBUILD 打包脚本(pkgbase=linux-zakofox,两个 pkgname)
zakofox-x86_64.config 内核配置,唯一事实来源
0001-zakofox-prjc-pds-7.3.patch
0002-zakofox-cjktty-7.2.patch
0100-zen-core-config.patch
0110-zen-sched.patch
0120-zen-mm-zswap.patch
0130-zen-block-elevator.patch
0140-zen-tcp.patch
0150-zen-cpufreq.patch
0160-zen-gpu.patch
0170-zen-pci-acs.patch
0180-zen-irq-vtime.patch
0190-zen-vhba.patch
0200-zen-arch-misc.patch
SHA256SUMS 补丁与配置的校验值
scripts/gen-cjk-font.py 用 TTF 生成 CJK 点阵字体的工具(可选)
.github/workflows/build.yml
补丁与配置必须平铺在仓库根目录:makepkg 的 source=() 对本地文件只按 basename 查找,
带子目录的路径(patches/x.patch)会直接报「没有在创建目录中找到,也不是一个 URL」。
scripts/gen-cjk-font.py 可以把任意含中文的 TTF 渲染成内核要的点阵表,用来替换补丁里的
lib/fonts/font_cjk_16x16.h / font_cjk_32x32.h:
# 16x16,U+4E00..9FFF 中日韩统一表意文字
python3 scripts/gen-cjk-font.py --font /usr/share/fonts/TTF/YourFont.ttf --size 16 \
--start 0x4e00 --end 0x9fff --output /tmp/font_cjk_16x16.h输出格式与 cjktty 一致:每个码点「先左半 16/64 字节、再右半」两个槽位,逐行写
/* 序号 0xXXXX */ 注释,方便 diff。--size 32 生成 128 字节/字形的 32×32 表。
不指定 --start/--end 时遍历整个 BMP(会跳过代理区与无法渲染的码点)。
- 改
PKGBUILD的pkgver与 tarballsha256sums,同步 workflow 的KERNEL_VERSION; - 验证
0001(prjc)能在新版本上干净应用;不行就换对应版本的 tkg0009-prjc.patch; - 验证
0002(cjktty):7.3 起 fbcon 的旋转缓冲被内联进struct fbcon_par, 从 7.2 版补丁直接搬能过是因为相关条件判断恰好兼容,升到 7.4 需重新对齐; 01xx/02xx按需 rebase,最容易受上游重构影响的是0110(sched)、0120(mm/zswap)、0200(arch/x86);makepkg --nobuild看.config漂移,逐个大文件make <obj>.o先验证再全量编。
-O3未启用:0100提供了CONFIG_CC_OPTIMIZE_FOR_PERFORMANCE_O3,但配置里仍是-O2。 想试可以把开关打开重编,注意-O3在部分子系统(尤其fs/、net/)历史上出过边界问题,出问题先退回。- 32×32 中文未启用:见
0002一节的说明,上游字形表为空文件,故主动关闭;需要时用scripts/gen-cjk-font.py --size 32自行生成。 - zram 未做 zen 式重构:7.3 上游已有
CONFIG_ZRAM_BACKEND_*多后端与zcomp新接口, 旧式 zram 补丁在其上会编译失败,因此 zram 完全走上游实现,只保留块层默认调度器的调优。 - 构建前缀不感知 ccache 以外的加速:本机 4 核实测约 3~5 小时;CI 冷缓存约 2 小时 15 分,
热缓存(
hashFiles未变时)会快一些,但内核一旦改动源码级内容就全量重编。
已修掉的两项:
0180里 Debian 式的unprivileged_userns_clone(依赖 7.3 不存在的CONFIG_USER_NS_UNPRIVILEGED,会默认禁掉非特权 user namespace,破坏 bwrap/Flatpak/Firefox 沙箱) 已从补丁中移除,回到上游「非特权 userns 默认允许」;空的 32×32 CJK 字形表也通过配置关闭。
内核本体 GPL-2.0-only(见 LICENSE)。各补丁遵循其上游原始许可:
prjc 调度器 GPL-2.0,cjktty GPL-2.0,其余调优补丁 GPL-2.0。
这个项目没有一行内核代码是凭空写的:上游内核、调度器、中文控制台、点阵字体、打包脚本, 全部来自下面这些项目与人。感谢他们。
上游内核
- Linux 内核(Linus Torvalds)—— https://github.com/torvalds/linux
- kernel.org 发布与镜像 —— https://www.kernel.org/
调度器
- Project C / prjc(PDS、BMQ,Alfred Chen)—— https://gitlab.com/alfredchen/linux-prjc
- linux-tkg(提供按内核版本适配好的 prjc 补丁)—— https://github.com/Frogging-Family/linux-tkg
桌面内核调优
- zen-kernel(zen-sauce 调优补丁集的来源)—— https://github.com/zen-kernel/zen-kernel
- Liquorix(Liquorix kernel 打包与配置参考)—— https://github.com/damentz/liquorix-package
中文控制台
- cjktty 原始补丁(zhmars)—— https://github.com/zhmars/cjktty-patches
- cjktty 维护分支(Capricornus007,7.x 系列补丁)—— https://github.com/Capricornus007/cjktty-patches
打包与参考
- Arch Linux 官方 linux 打包脚本 —— https://gitlab.archlinux.org/archlinux/packaging/packages/linux
- Arch Linux —— https://archlinux.org/
字体
- Maple Mono(
scripts/gen-cjk-font.py的推荐字体来源)—— https://github.com/subframe7536/maple-font