CyanFS：openEuler存储项目的革命性虚拟磁盘卷管理系统

【免费下载链接】cyanfsThis component is designed for the openEuler Storage project scenario, enabling virtual disk volume management with snapshot support. It is compatible with both UEFI and Linux kernel environments, and is embedded into applications in the form of library functions, effectively enhancing the isolation and management efficiency of virtual volume storage.项目地址: https://gitcode.com/openeuler/cyanfs

前往项目官网免费下载：https://ar.openeuler.org/ar/

CyanFS是openEuler存储项目场景下的革命性虚拟磁盘卷管理系统，专为虚拟机镜像文件存储设计，提供高效的快照支持和跨平台兼容性，有效提升虚拟卷存储的隔离性与管理效率。无论是在UEFI环境还是Linux内核环境中，CyanFS都能以库函数形式无缝嵌入应用，为用户带来简单而强大的存储管理体验。

🚀 CyanFS核心功能解析

1️⃣ 精简高效的文件系统设计

CyanFS采用极简架构，专注于虚拟机镜像文件的存储需求：

• 无目录结构：避免复杂的目录查找逻辑，简化文件管理流程
• 大文件优化：针对大尺寸镜像文件（每个Extent为1MB）设计的存储方案
• 扇区粒度IO：支持512字节扇区级别的精准数据操作

核心设计体现在其独特的磁盘结构中，包含超级块（A/B备份模式）、数据块和日志块三大部分。超级块位于磁盘最开始的8192字节，采用双备份机制确保系统可靠性，其结构定义可见core/internal.h。

2️⃣ 创新的Extent管理机制

CyanFS引入了灵活的Extent（数据块）管理模式，每个Extent有三种状态：

• Map状态：已分配并写入数据，对应磁盘上的连续空间
• Free状态：空闲状态，读取返回全零，写入时自动分配空间
• Parent状态：指向祖辈镜像的Extent，实现高效的写时复制(COW)

这种设计使得CyanFS能够实现快速的镜像创建和快照功能，当需要修改Parent状态的Extent时，系统会自动分配新空间、复制原始数据并更新状态，整个过程对用户透明。

3️⃣ 完整的镜像文件管理接口

CyanFS提供了一套直观易用的镜像管理命令集，包括：

• Create：创建新的镜像文件
• Fork：基于父镜像创建子镜像（快照功能）
• Rename：安全地重命名镜像文件
• Truncate：调整镜像文件大小
• Delete：删除不再需要的镜像
• Lookup/List：查找和遍历系统中的镜像

这些接口通过utils/mkfs.c和utils/edit.c等工具实现，为用户提供了便捷的镜像管理体验。

💻 跨平台架构与实现

1️⃣ 分层设计理念

CyanFS采用清晰的分层架构，确保跨平台兼容性：

• 核心层：平台无关，处理文件系统业务逻辑，位于core/目录
• IO层：平台相关，负责IO接收与发送，分别在linux/和uefi/目录实现

这种设计使CyanFS能够轻松适配不同操作系统环境，同时保持核心逻辑的一致性。

2️⃣ Linux平台实现

在Linux环境下，CyanFS通过通用块层接口实现虚拟磁盘映射，主要组件包括：

• linux/main.c：Linux平台入口点
• linux/vdisk.c：虚拟磁盘实现
• linux/configfs.c：配置文件系统接口

用户可以通过简单的Makefile编译构建Linux版本，具体参见项目根目录下的Makefile。

3️⃣ UEFI平台支持

CyanFS为UEFI环境提供了完整支持，基于EDK2框架实现：

• uefi/CyanfsDxe/：CyanFS UEFI驱动
• uefi/Demo/：UEFI环境下的演示程序
• uefi/Include/Protocol/Cyanfs.h：UEFI协议定义

这使得CyanFS能够在系统启动早期就提供存储服务，满足特殊场景需求。

🛠️ 快速上手CyanFS

1️⃣ 环境准备

CyanFS的编译和使用需要相应的开发环境：

• Linux平台：标准GCC工具链和内核头文件
• UEFI平台：EDK2开发环境

2️⃣ 获取源码

git clone https://gitcode.com/openeuler/cyanfs cd cyanfs

3️⃣ 编译Linux版本

cd linux make

4️⃣ 编译UEFI版本

# 需要配置好EDK2环境 build -p Cyanfs.dsc -a X64 -t GCC5 -b RELEASE

5️⃣ 使用工具创建镜像

# 创建一个1GB的镜像文件 ./utils/mkfs/mkfs.cyanfs -s 1G myimage.img

🔍 深入了解CyanFS

CyanFS的设计文档和测试用例提供了更多技术细节：

• cyanfs设计说明.md：详细的设计方案
• cyanfs概述.md：项目背景和整体架构
• testcase/：包含多种场景的测试脚本，如testcase/journals.sh用于测试日志功能

🎯 应用场景与优势

CyanFS特别适合以下场景：

• 云桌面VOI模式：保护物理机上的虚拟机镜像不被未授权修改
• 嵌入式系统：精简的设计和低资源占用适合嵌入式环境
• 多系统启动：UEFI和Linux的跨平台支持使其成为多系统启动方案的理想选择

相比传统文件系统，CyanFS带来的核心优势包括：

• 更高的隔离性：私有API设计避免操作系统直接访问
• 更快的快照操作：基于COW的Extent管理实现秒级快照
• 更好的可靠性：A/B超级块和日志机制确保数据安全
• 更低的资源占用：元数据全部加载至内存，减少IO需求

CyanFS正通过持续的开发和优化，为openEuler存储项目提供更加强大和灵活的虚拟磁盘卷管理能力，无论是新手用户还是专业开发者，都能从中受益。

【免费下载链接】cyanfsThis component is designed for the openEuler Storage project scenario, enabling virtual disk volume management with snapshot support. It is compatible with both UEFI and Linux kernel environments, and is embedded into applications in the form of library functions, effectively enhancing the isolation and management efficiency of virtual volume storage.项目地址: https://gitcode.com/openeuler/cyanfs