Skip to content

Latest commit

 

History

History
197 lines (152 loc) · 7.75 KB

ROADMAP.md

File metadata and controls

197 lines (152 loc) · 7.75 KB

KSL 后续计划

本文档记录 Linux Kernel Security Lab(KSL)1.0 之后的候选发展方向,方便未来维护、 讨论和贡献。它不是发布时间承诺;具体内容会根据真实 Kernel CTF 和授权研究中的需求 调整。

当前稳定基线

KSL 1.0 已完成并验证以下核心闭环:

workspace
→ Linux Git source
→ reproducible Kconfig
→ kernel build
→ BusyBox initramfs
→ isolated QEMU
→ GDB / 9p share
→ logs and metadata
→ research records

1.0 的端到端验证基线是 Linux 6.6.45 x86_64、QEMU TCG、BusyBox initramfs、 KASAN/KCOV 和无网络 9p 共享。未来开发应保持该流程兼容且可重复。

规划原则

  • 优先解决真实使用中重复、易错且可以安全自动化的操作;
  • 保持 plan/--apply 机制,高影响操作不能默认执行;
  • 默认隔离未知输入,不扩大网络和宿主文件访问范围;
  • 本机绝对路径、镜像、日志和大型附件继续默认忽略;
  • 新功能应包含测试、文档、失败路径和可复现元数据;
  • 不为单个题目硬编码不可复用的逻辑;
  • 不以功能数量作为版本升级标准。

近期:1.1 工程质量

目标:提高稳定性,让修改能够自动回归验证。

  • 建立 CI:go test、go vet、Shell 语法、格式和文档链接检查;
  • 增加 cli、bootstrap、source、emulate、research 和路径安全单元测试;
  • 覆盖命令失败路径、错误参数、缺失产物和非零 QEMU 退出状态;
  • 测试 rootfs 内容和连续构建哈希一致性;
  • 增加 9p QEMU 参数及 emulate metadata schema 测试;
  • 提供发布检查清单,统一 VERSION、tag、Changelog 和文档版本;
  • 改善错误信息,给出可直接执行的恢复建议。

验收方向:核心包覆盖率显著提高,CI 能在不启动真实 VM 的情况下检查绝大多数逻辑, 保留可选的本机 QEMU 集成测试。

中期:1.2 CTF 研究体验

目标:减少人工整理工作,但不自动执行题目载荷。

  • 扩展 research case 模板,可选创建 notes/、poc/、patches/ 和 configs/;
  • 增加附件清单及 SHA-256 记录命令;
  • 将最近一次 build/emulate 元数据快照关联到 research case;
  • 支持导入、导出不包含大型 artifacts 的案例包;
  • 增加实验运行备注、结果状态和对照组记录;
  • 提供 crash log 收集与归档入口;
  • 提供基于 vmlinux 的本地符号查询辅助命令;
  • 增加通用的题目初始化清单和复现报告模板。

这些功能只组织用户明确提供的、经过授权的 CTF/研究资料,不自动下载未知 PoC, 也不自动运行共享目录中的程序。

中期:1.3 架构与镜像

目标:扩大经过验证的实验环境范围。

  • 完成 arm64 交叉编译、Image、QEMU virt 和串口启动端到端验证;
  • 增加 arm64 对应的 doctor/bootstrap 依赖检查;
  • 为 x86_64 和 arm64 分别记录可复现验证基线;
  • 支持可配置的 initramfs 内容清单;
  • 支持将指定的本地文件显式加入 rootfs staging;
  • 增加 raw ext4 rootfs 的创建、检查和只读启动流程;
  • 研究可选的持久化数据盘,而不改变默认临时 rootfs;
  • 改进模块目录、固件和 9p mount 配置。

长期候选方向

以下内容尚未分配版本:

  • 多内核版本矩阵和 workspace 克隆辅助;
  • Clang/LLVM、GCC 和交叉工具链元数据统一;
  • KASAN、KCSAN、UBSAN、KFENCE、KCOV 的配置 profile 组合;
  • QEMU snapshot、只读磁盘和实验恢复点;
  • 串口日志事件摘要和 panic/oops 检测;
  • GDB 初始化文件生成及符号路径检查;
  • 构建缓存和产物完整性检查;
  • Podman/Docker 开发工具链封装;
  • Debian/Ubuntu 之外的依赖文档或适配;
  • JSON 输出模式,便于外部脚本集成;
  • shell completion 和更一致的子命令帮助;
  • research case schema 版本和迁移机制。

未来生态:独立研究仓库

Fuzz 和 AI 分析与 KSL 密切相关,但不纳入 KSL Core。未来采用独立仓库方案,避免 把不同工具链、运行时、模型服务和凭据依赖加入稳定的 Lab 核心。

规划中的职责关系:

kernel-security-lab
├── 管理 workspace 和 Linux source
├── 生成 bzImage、vmlinux、.config 和 rootfs
├── 启动 QEMU/GDB 并保存日志与元数据
└── 管理 research case

kernel-fuzz-lab
├── 读取 KSL 构建产物和 workspace 元数据
├── 管理 fuzz 配置、corpus、coverage 和 crash
└── 将 crash/reproducer 归档到 KSL research case

kernel-ai-analysis
├── 只读分析源码、构建信息、crash 和运行日志
├── 辅助调用栈归类、源码上下文整理和报告生成
└── 将结果写入 research case 的 notes/analysis

kernel-fuzz-lab 候选范围

  • 对接一个或多个外部 kernel fuzz 引擎;
  • 管理 fuzz 专用 Kconfig fragment 和运行配置;
  • 管理 corpus、coverage、crash、reproducer 和去重结果;
  • 记录 fuzz 工具版本、参数、输入及输出哈希;
  • 消费 KSL 已生成的内核、符号、rootfs 和 QEMU 信息;
  • 将确认后的结果导入 KSL research case。

kernel-ai-analysis 候选范围

  • 支持本地模型或显式配置的远程模型服务;
  • 读取 crash log、调用栈、源码上下文、patch 和实验元数据;
  • 辅助聚类、摘要、根因假设和研究报告草稿;
  • 记录模型、提示、输入范围、输出和人工复核状态;
  • 默认只读访问内核源码,不自动修改 workspace;
  • 不自动执行 PoC、共享目录程序或模型生成的命令。

仓库间集成约定

KSL 将优先提供通用、工具无关的边界,而不是内置具体引擎:

  • 稳定的 build/emulate JSON metadata;
  • kernel、vmlinux、.config、rootfs 及 SHA-256 artifact manifest;
  • 带版本的 research case schema;
  • 外部结果导入和来源记录;
  • 明确的只读输入、可写输出和权限边界;
  • 工具名称、版本、命令、时间、退出状态和 provenance 记录。

只有当多个独立项目出现稳定且重复的共同需求时,才考虑在 KSL 中增加通用接口; 不会为了单个 fuzz 引擎或模型供应商在 KSL Core 中加入专用逻辑。

暂不计划

为了保持边界清晰,当前不计划:

  • 默认启用 guest 网络;
  • 自动共享 HOME、项目根目录或敏感宿主路径;
  • 自动运行从网络或共享目录发现的程序;
  • 在 KSL Git 仓库中提交大型 kernel、rootfs 或 CTF artifacts;
  • 代替 Git 完成复杂 merge/rebase 或自动清理用户工作树;
  • 将 KSL 发展为通用虚拟机管理器或完整 Linux 发行版构建系统;
  • 在 KSL Core 中内置具体 fuzz 引擎、corpus 调度或 crash 去重服务;
  • 在 KSL Core 中内置模型运行时、AI 服务 SDK、API 凭据或自动化 agent;
  • 让外部 fuzz/AI 项目直接取得不受限制的宿主文件、网络或命令执行权限。

新需求评估标准

增加功能前建议回答:

  1. 它是否来自至少一次真实、授权的实验需求?
  2. 是否能复用于多个内核版本或 CTF 题目?
  3. 是否会扩大网络、文件、设备或权限边界?
  4. 是否需要 plan/--apply 保护?
  5. 如何验证成功、失败和回滚路径?
  6. 需要记录哪些版本、hash 和命令才能复现?
  7. 是否有更简单的脚本或文档方案?

版本维护流程

每个稳定版本建议依次完成:

确定范围
→ 实现和测试
→ 更新详细手册
→ 更新 README/ROADMAP/CHANGELOG
→ 运行发布检查
→ 更新 VERSION
→ 创建 release commit
→ 创建 annotated tag
→ 人工确认后推送

版本发布不应提交本机 workspace profile、内核输出、rootfs、QEMU 日志或 research artifacts。