stagex/gen_initramfs

Linux内核initramfs生成工具镜像文档

镜像概述和主要用途

该Docker镜像集成了Linux内核initramfs（初始内存文件系统）生成工具，用于创建和定制Linux启动过程中所需的初始内存文件系统。initramfs作为内核启动阶段的临时根文件系统，负责加载必要的驱动程序、模块和工具，以完成根文件系统的挂载和系统初始化。本镜像简化了initramfs的构建流程，提供标准化工具链，支持多场景下的定制需求。

核心功能和特性

• 多内核版本支持：兼容主流Linux内核版本，可指定目标内核版本生成对应initramfs
• 灵活定制能力：支持通过配置文件或命令行参数定制文件系统内容（添加/移除文件、目录、模块）
• 驱动集成：可自动检测并集成内核模块，或手动指定需包含的驱动文件
• 压缩格式支持：提供gzip、xz、lz4等多种压缩算法，优化镜像大小
• 轻量级设计：基于精简基础镜像，减少依赖，提升构建效率

使用场景和适用范围

• 内核开发：内核开发者构建包含自定义驱动或调试工具的initramfs
• 系统管理：系统管理员配置加密根文件系统解密、远程启动等特殊启动环境
• 嵌入式系统：嵌入式设备定制精简initramfs，减少启动时间和资源占用
• 教学与调试：学习Linux启动流程，或调试启动阶段的内核/驱动问题

使用方法和配置说明

基本使用示例

bash
# 生成默认配置的initramfs（使用容器内默认内核版本，输出到当前目录）
docker run --rm -v $(pwd):/output docker.xuanyuan.run/initramfs-tools generate

常用参数说明

高级配置示例

1. 指定内核版本并使用xz压缩

bash
docker run --rm \
  -v $(pwd):/output \
  -e KERNEL_VERSION=5.15.0-78-generic \
  -e COMPRESSION=xz \
  docker.xuanyuan.run/initramfs-tools generate

2. 挂载自定义配置和模块

bash
# 挂载本地内核源码/模块目录及自定义配置文件
docker run --rm \
  -v /path/to/local/kernel/modules:/lib/modules \  # 本地内核模块
  -v /path/to/custom/config:/etc/initramfs-tools/config \  # 自定义配置
  -v $(pwd):/output \
  -e KERNEL_VERSION=5.15.0-custom \
  initramfs-tools generate

3. docker-compose配置示例

yaml
version: '3'
services:
  build-initramfs:
    image: docker.xuanyuan.run/initramfs-tools
    volumes:
      - ./output:/output
      - ./kernel-modules:/lib/modules
      - ./custom-config:/etc/initramfs-tools/config
    environment:
      - KERNEL_VERSION=5.15.0-custom
      - COMPRESSION=xz
    command: generate

定制配置文件格式

通过CONFIG_FILE指定的配置文件支持以下关键字（示例）：

conf
# 添加自定义文件到initramfs（源路径:目标路径）
FILES="/path/to/local/tool:/usr/local/bin/tool"

# 添加内核模块（支持通配符）
MODULES="ext4 vfat usb-storage"

# 设置启动脚本（覆盖默认init脚本）
INIT_SCRIPT="/path/to/custom-init-script"

输出说明

生成的initramfs文件默认命名格式为initrd.img-${KERNEL_VERSION}.${COMPRESSION}，可通过OUTPUT_PATH环境变量自定义路径和文件名。