go-diskfs：纯 Go 磁盘操作库，免挂载免 root 操作磁盘镜像与文件系统

来源：微信公众号

go-diskfs 是一个纯 Go 语言实现的磁盘操作库，可以在不挂载磁盘的情况下，原生地进行磁盘、磁盘镜像和文件系统的操作。它提供了一套完整的 API，用于分区管理、文件系统创建和文件操作。

GitHub：https://github.com/diskfs/go-diskfs

为什么选择 go-diskfs

传统磁盘操作通常需要使用 gdisk、fdisk、mkfs.vfat、mtools 等命令行工具，但这些工具有明显限制：

需要安装依赖工具
需要 fork/exec 到命令行或 shell，带来进程开销
挂载磁盘通常需要 root 权限
挂载过程存在安全风险
可能被迫启动虚拟机来运行 libguestfs

go-diskfs 全部解决：

优势	说明
纯 Go 实现	无需任何外部工具依赖
无需挂载	所有操作在用户空间完成
跨平台	任何支持 Go 的平台都能运行
低权限	普通用户权限即可操作镜像文件
安全可靠	避免挂载带来的风险

核心概念

Backend（后端）：抽象层，处理底层读写操作。当前支持 file 后端，可访问块设备和原始镜像文件。

Disk（磁盘）：代表一个文件或块设备，可读写分区表、打开或创建文件系统。

Partition（分区）：磁盘的一个切片，由分区表描述它们在磁盘上的布局。

Filesystem（文件系统）：用于创建、读取和写入目录与文件，可以放在整个磁盘上（无需分区），也可以放在某个分区中。

主要功能

分区表操作

支持两种分区格式：

MBR（Master Boot Record）：传统分区表格式
GPT（GUID Partition Table）：现代分区表格式

// 获取现有分区表
table, err := disk.GetPartitionTable()

// 创建新的分区表
err := disk.Partition()

文件系统支持

FAT32：UEFI 启动分区、小容量存储设备、跨平台数据交换
ISO9660：系统安装镜像、启动光盘镜像、软件发布介质
此外还支持 Squashfs 等只读文件系统

文件操作

// 创建目录
err := fs.Mkdir("/path/to/dir")

// 读取目录内容
entries, err := fs.Readdir("/path/to/dir")

// 打开文件（类似 os.OpenFile）
file, err := fs.OpenFile("/path/to/file", os.O_RDWR|os.O_CREATE, 0644)

// 文件读写
n, err := file.Write([]byte("content"))
n, err := file.Read(buffer)
offset, err := file.Seek(0, io.SeekStart)

快速开始

安装：

go get github.com/diskfs/go-diskfs

创建分区磁盘

package main

import (
    "github.com/diskfs/go-diskfs"
    "github.com/diskfs/go-diskfs/disk"
)

func main() {
    // 创建一个 100MB 的磁盘镜像
    diskImg, err := diskfs.Create("/tmp/disk.img", 100*1024*1024)
    if err != nil {
        panic(err)
    }

    // 创建 GPT 分区表
    table := &gpt.Table{
        Partitions: []*gpt.Partition{
            {
                Start: 2048,
                End:   204800,
                Type:  gpt.EFISystemPartition,
            },
        },
    }

    err = diskImg.Partition(table)
    if err != nil {
        panic(err)
    }
}

创建 FAT32 文件系统

// 在第一个分区创建 FAT32 文件系统
fs, err := diskImg.CreateFilesystem(1, diskfs.Fat32)
if err != nil {
    panic(err)
}

// 创建目录
err = fs.Mkdir("/EFI/BOOT")

// 创建文件并写入
file, err := fs.OpenFile("/EFI/BOOT/BOOTX64.EFI", os.O_CREATE|os.O_WRONLY, 0644)
_, err = file.Write(bootLoaderData)
file.Close()

只读文件系统

ISO9660 和 Squashfs 属于一次性创建后只读的文件系统：

GetFilesystem()：读取只读文件系统，但不能写入。任何 Mkdir()、OpenFile() 的写入/追加/创建模式或 Write() 都会返回错误。
CreateFilesystem()：创建只读文件系统并写入内容。所有工作在本地临时目录中进行，完成后调用 Finalize()，之后变为只读。

ISO 镜像创建

// 创建 ISO 文件系统
isoFs, err := diskImg.CreateFilesystem(0, diskfs.ISO9660)

// 创建目录和文件
isoFs.Mkdir("/data")
file, _ := isoFs.OpenFile("/data/readme.txt", os.O_CREATE|os.O_WRONLY, 0644)
file.Write([]byte("Hello, ISO!"))
file.Close()

// 完成 ISO 镜像（必须调用）
err = isoFs.Finalize()

重要：不调用 Finalize()，将不会生成任何 ISO 内容。