linuxkit/mkimage-squashfs

SquashFS镜像生成工具Docker镜像

镜像概述

本Docker镜像基于SquashFS工具链（包含mksquashfs等核心工具）构建，提供独立、便捷的SquashFS文件系统生成环境。无需在主机系统安装SquashFS工具，通过容器化方式即可快速创建压缩的只读SquashFS镜像，适用于需要高效生成SquashFS文件系统的各类场景。

核心功能与特性

• 完整工具链集成：内置mksquashfs及相关依赖工具，支持SquashFS标准生成流程
• 多压缩算法支持：兼容gzip、lzma、xz、lzo、zstd等主流压缩算法
• 灵活配置能力：支持自定义压缩级别、文件系统权限、包含/排除文件规则
• 无依赖环境：容器化设计，无需主机系统预装SquashFS工具链，即开即用
• 轻量级设计：基于精简基础镜像构建，减少资源占用

使用场景

• 嵌入式系统开发：生成设备固件中的只读文件系统镜像
• 数据分发：创建压缩率高、结构紧凑的只读数据分发包
• 应用打包：构建包含应用及依赖的只读运行环境镜像
• 系统备份：生成文件系统的只读快照用于备份或迁移

使用方法与配置说明

基础使用流程

1. 准备待打包文件目录（需生成SquashFS镜像的源文件集合）
2. 通过docker run命令运行镜像，挂载源文件目录并指定输出路径
3. 获取生成的SquashFS镜像文件

常用命令示例

基础生成命令

bash
docker run --rm -v /path/to/source/files:/source -v /path/to/output:/output squashfs-generator mksquashfs /source /output/image.squashfs

• /path/to/source/files：主机上待打包的源文件目录（需绝对路径）
• /path/to/output：主机上用于接收输出镜像的目录（需绝对路径）
• image.squashfs：生成的SquashFS镜像文件名

指定压缩算法与级别

bash
docker run --rm -v /path/to/source:/source -v /path/to/output:/output squashfs-generator mksquashfs /source /output/image.squashfs -comp xz -Xcompression-level 6

• -comp xz：使用xz压缩算法（可选值：gzip、lzma、xz、lzo、zstd）
• -Xcompression-level 6：设置xz压缩级别（1-9，数值越高压缩率越高但速度越慢）

排除指定文件/目录

bash
docker run --rm -v /path/to/source:/source -v /path/to/output:/output squashfs-generator mksquashfs /source /output/image.squashfs -e /source/temp -e /source/*.log

• -e /source/temp：排除源目录下的temp子目录
• -e /source/*.log：排除源目录下所有.log后缀文件

核心参数说明

通过mksquashfs命令行参数配置生成规则，常用参数如下：

• -comp <algorithm>：指定压缩算法（默认gzip）
• -b <block_size>：设置块大小（1K-128K，默认128K）
• -noappend：不追加到现有镜像（默认行为，生成全新镜像）
• -root-owned：将所有文件所有者设为root（适用于系统级文件系统）
• -keep-as-directory：将源目录本身包含在镜像根目录（默认仅包含目录内容）
• -wildcards：允许使用通配符匹配文件/目录

注意事项

1. 源文件目录需通过-v参数挂载至容器内，建议挂载为/source（可自定义，需在命令中对应调整路径）
2. 输出目录需具备写入权限，避免因权限问题导致生成失败
3. 大文件集合生成时建议增加--memory参数限制容器内存使用（如--memory 2g）
4. 生成的SquashFS镜像可通过unsquashfs工具挂载或解压（需主机安装squashfs-tools）