如何在Linux系统挂载APFS分区？li/linux-apfs-rw模块安装与使用教程

【免费下载链接】linux-apfs-rwAPFS module for linux, with experimental write support项目地址: https://gitcode.com/gh_mirrors/li/linux-apfs-rw

Apple File System（APFS）是苹果设备默认使用的文件系统，而li/linux-apfs-rw项目为Linux系统提供了实验性的APFS读写支持。本教程将详细介绍如何在Linux系统中安装并使用该模块挂载APFS分区，帮助用户轻松访问苹果设备的存储内容。

一、项目简介：Linux下的APFS解决方案

li/linux-apfs-rw是一个开源的Linux内核模块，旨在实现对APFS文件系统的支持，包括实验性的写入功能。该项目支持Linux内核4.12及以上版本（推荐5.18+），通过反向工程实现了APFS的核心功能。项目主要文件包括：

• 核心头文件：apfs.h、apfs_raw.h
• 核心实现：super.c（超级块管理）、inode.c（索引节点处理）、file.c（文件操作）
• 构建配置：Makefile

二、安装前准备：系统环境要求

在开始安装前，请确保您的系统满足以下条件：

1. 内核版本检查

uname -r # 需4.12及以上，推荐5.18+

2. 安装内核头文件

根据不同Linux发行版安装对应的内核开发工具：

# Debian/Ubuntu sudo apt-get install linux-headers-$(uname -r) # Arch/Manjaro sudo pacman -Sy linux-headers # RHEL/Rocky/CentOS/Fedora sudo yum install kernel-headers kernel-devel

三、编译安装：从源码构建模块

1. 获取源码

git clone https://gitcode.com/gh_mirrors/li/linux-apfs-rw cd linux-apfs-rw

2. 编译模块

项目使用Makefile管理构建流程，核心编译规则在Makefile中定义：

# 编译模块（默认只读模式） make # 可选：启用默认可写模式（实验性，不推荐） # make APFS_CONFIG=-DCONFIG_APFS_RW_ALWAYS

编译成功后会生成apfs.ko内核模块文件，包含以下核心组件：

• B树管理：btree.c
• 压缩算法：compress.c、lzfse/
• 事务处理：transaction.c

3. 安装模块

# 加载模块 sudo insmod apfs.ko # 若提示缺少依赖，先加载libcrc32c sudo modprobe libcrc32c

四、挂载APFS分区：完整操作指南

1. 识别APFS设备

使用fdisk或lsblk查看APFS分区设备路径（通常为/dev/sdXn）：

sudo fdisk -l | grep -i apfs

2. 基本挂载命令

# 创建挂载点 sudo mkdir /mnt/apfs # 只读挂载（推荐） sudo mount -t apfs /dev/sdXn /mnt/apfs # 实验性读写挂载（风险！） sudo mount -t apfs -o readwrite /dev/sdXn /mnt/apfs

3. 高级挂载选项

示例：挂载卷2并验证元数据

sudo mount -t apfs -o cknodes,vol=2 /dev/sdXn /mnt/apfs

4. 卸载分区

sudo umount /mnt/apfs

五、注意事项：数据安全与限制

1. 已知限制

• 写入风险：实验性写支持可能导致数据损坏，建议仅用于测试
• 不支持特性：Fusion Drive、加密APFS分区
• 性能问题：启用cknodes选项会显著降低性能

2. 故障排查

若遇到挂载问题，查看内核日志：

dmesg | grep -i apfs

常见问题解决：

• "未知符号"错误：确保已加载libcrc32c模块
• 挂载失败：检查设备路径是否正确，APFS分区是否损坏

六、总结：Linux与APFS的桥梁

li/linux-apfs-rw模块为Linux用户提供了访问APFS分区的实用方案，尽管写入功能仍处于实验阶段，但只读模式已能满足大多数数据恢复和文件访问需求。随着项目的持续发展，未来有望实现更完善的APFS支持。

如果您在使用过程中遇到问题，可参考项目README.rst或提交issue获取帮助。

【免费下载链接】linux-apfs-rwAPFS module for linux, with experimental write support项目地址: https://gitcode.com/gh_mirrors/li/linux-apfs-rw