1. 项目概述：当Linux遇到苹果的“保险箱”
作为一名常年混迹于Linux和macOS双系统的开发者，我经常遇到一个让人头疼的“物理隔阂”：在macOS上用APFS格式化的移动硬盘或U盘，插到Ubuntu电脑上，系统直接“视而不见”。文件管理器里空空如也，lsblk命令能看到磁盘设备，却无法挂载。这感觉就像你有一个保险箱，钥匙却落在了另一个城市。这个项目要解决的，就是如何在Ubuntu上打开这个来自苹果的“APFS保险箱”，安全、稳定地读取其中的数据。
APFS是苹果公司在2017年推出的新一代文件系统，专为闪存/SSD优化，带来了克隆、快照、空间共享等先进特性，迅速成为macOS、iOS等设备的默认选择。然而，由于其专有性和较新的内核驱动支持状态，主流的Linux发行版默认并不包含完整的APFS读写支持。这不仅仅是技术爱好者的需求，对于需要在不同操作系统间迁移数据的设计师、视频剪辑师，或者使用macOS作为工作机但用Linux服务器做开发的工程师来说，这是一个实实在在的痛点。本文将带你从原理到实践，一步步拆解在Ubuntu上挂载APFS磁盘的全过程，并分享我踩过的坑和总结的稳定方案。
2. 核心方案选型与原理浅析
面对APFS这个“黑盒子”，我们主要有两种思路来打开它：一是利用FUSE在用户空间实现文件系统驱动；二是寻找并编译内核级的原生驱动。两种方案各有优劣，选择哪一种取决于你的具体需求和对系统稳定性的要求。
2.1 FUSE方案：灵活安全的用户空间桥梁
FUSE允许非特权用户在用户空间实现一个完整的文件系统，而无需修改内核代码。对于APFS，最成熟的项目是apfs-fuse。它的工作原理是，通过一个用户态进程与内核的FUSE模块通信，将APFS磁盘的读写操作“翻译”成Linux内核能理解的VFS调用。
为什么首选FUSE？
- 安全性高：运行在用户空间，即使驱动崩溃，也不会导致整个内核崩溃，顶多是挂载点无响应。
- 无需内核编译：直接通过包管理器安装，对新手极其友好，避免了编译内核模块的复杂性和风险。
- 版本兼容性好：通常能跟上APFS格式的更新，社区维护相对活跃。
它的局限性在于：
- 性能开销：由于需要在内核和用户空间之间多次切换上下文，读写性能，尤其是大量小文件操作，会低于内核原生驱动。
- 功能限制：早期版本可能只支持读取，较新的版本才逐渐加入写入支持，且对APFS的所有高级特性（如加密卷、快照）支持可能不完整。
2.2 内核模块方案：追求极致的原生性能
另一种方案是使用apfs.ko这样的内核模块。Linux内核从5.4版本开始，通过CONFIG_APFS_FS配置选项实验性地引入了APFS只读支持。但如果你想用上更新、功能更全的驱动，可能需要手动编译第三方内核模块，比如来自linux-apfs项目的驱动。
内核模块的优势很明显：
- 原生性能：作为内核的一部分运行，直接与VFS交互，性能损失极小，接近本地文件系统的体验。
- 功能可能更全面：一些积极维护的第三方内核模块可能比FUSE驱动更早支持写入、加密等特性。
但缺点同样突出：
- 高风险：编译和插入第三方内核模块有导致系统不稳定甚至无法启动的风险。
- 维护麻烦：每次升级内核，都可能需要重新编译和安装模块。
- 门槛高：涉及内核编译，对用户的技术要求较高。
注意：对于绝大多数以安全读取数据为首要目标的用户，我强烈建议从FUSE方案开始。它足够稳定，能满足大部分场景，且操作可逆，风险可控。除非你有极致的性能需求且愿意承担风险，否则不要轻易尝试手动编译内核模块。
3. 实战：使用apfs-fuse在Ubuntu上挂载APFS磁盘
接下来，我们以最稳妥的apfs-fuse方案为例，进行完整实操。我的环境是Ubuntu 22.04 LTS，但步骤适用于大多数现代Ubuntu版本及Debian系发行版。
3.1 系统准备与驱动安装
首先，确保系统已更新，并安装必要的编译工具和库。FUSE本身是内核的一部分，但我们需要安装其用户态库和开发头文件。
# 更新软件包列表并升级系统 sudo apt update && sudo apt upgrade -y # 安装编译apfs-fuse所需的依赖 sudo apt install -y git cmake make gcc g++ libfuse3-dev bzip2 libbz2-dev zlib1g-dev关键依赖说明：
libfuse3-dev：这是FUSE 3.x版本的开发库。Ubuntu 20.04及以上版本默认使用FUSE 3。如果你的系统较老，可能需要libfuse-dev（FUSE 2）。bzip2,libbz2-dev,zlib1g-dev：apfs-fuse的源代码压缩包可能需要这些库来解压，或者其内部使用了相关压缩算法。
接下来，获取并编译apfs-fuse。我推荐使用其GitHub仓库的最新稳定代码。
# 克隆 apfs-fuse 仓库 git clone https://github.com/sgan81/apfs-fuse.git cd apfs-fuse # 编译并安装 # 通常使用其提供的编译脚本 ./build.shbuild.sh脚本会自动执行cmake配置和make编译。如果一切顺利，编译出的可执行文件apfs-fuse会位于当前目录。为了方便使用，我们可以将其安装到系统路径：
# 安装到系统（可选，但推荐） sudo cp apfs-fuse /usr/local/bin/ sudo chmod +x /usr/local/bin/apfs-fuse3.2 识别磁盘与分区
将你的APFS格式外部磁盘（移动硬盘或U盘）连接到Ubuntu电脑。首先，我们需要找到它对应的设备标识符。
# 使用 lsblk 命令列出所有块设备 lsblk -f这个命令会输出类似下面的信息：
NAME FSTYPE FSVER LABEL UUID FSAVAIL FSUSE% MOUNTPOINTS sda ├─sda1 vfat FAT32 EFI 67E3-17ED ├─sda2 apfs Macintosh HD └─sda3 apfs Data nvme0n1 ├─nvme0n1p1 vfat FAT32 C4DA-2A21 ├─nvme0n1p2 ext4 1.0 e0a0b1c2-d3e4-5678-f901-234567890abc / ...找到你的外接磁盘。它通常以sdb、sdc或nvme1n1等形式出现。关键是要识别出FSTYPE为apfs的分区。例如上图中，外接磁盘sda上有两个APFS分区：sda2和sda3。记下你需要挂载的分区设备名，比如/dev/sda2。
一个重要提示：APFS容器内可能包含多个卷（如“Macintosh HD”系统卷和“Data”数据卷）。apfs-fuse通常需要挂载整个APFS容器（例如/dev/sda2），然后你会在挂载点下看到容器内的各个卷。具体行为可能因APFS版本和驱动版本而异。
3.3 创建挂载点并执行挂载
挂载点就是一个空目录，作为访问磁盘内容的入口。
# 创建一个挂载点，例如在 /mnt 下 sudo mkdir -p /mnt/macdisk # 使用 apfs-fuse 挂载 # 基本语法：apfs-fuse -o allow_other [设备] [挂载点] sudo apfs-fuse -o allow_other /dev/sda2 /mnt/macdisk参数解析：
-o allow_other：这是一个FUSE选项，允许非root用户（即你自己）访问挂载点内的文件。如果没有这个选项，即使挂载成功，普通用户也可能无法列出或读取文件。/dev/sda2：上一步找到的APFS分区设备。/mnt/macdisk：自定义的挂载点目录。
执行命令后，如果没有报错，就说明挂载成功了。现在，你可以通过文件管理器访问/mnt/macdisk，或者用ls命令查看：
ls -la /mnt/macdisk/你应该能看到APFS容器内的目录结构，通常包含root（系统卷）和Data（数据卷）等子目录，直接进入即可访问文件。
3.4 实现开机自动挂载（可选但实用）
如果你需要频繁使用这块磁盘，每次手动挂载很麻烦。我们可以通过修改/etc/fstab文件来实现自动挂载。但请注意，FUSE文件系统在fstab中的配置略有不同。
首先，你需要找到APFS分区的UUID，它比设备名（如sda2）更稳定，不会因为接入其他USB设备而改变。
# 使用 blkid 命令查看分区的UUID sudo blkid /dev/sda2输出会包含类似UUID="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"的信息。复制这个UUID。
然后，编辑/etc/fstab文件：
sudo nano /etc/fstab在文件末尾添加一行：
# 自动挂载 APFS 分区 UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx /mnt/macdisk apfs-fuse allow_other,defaults 0 0重要说明：
- 文件系统类型这里写
apfs-fuse，而不是apfs。 - 选项
allow_other是必须的，defaults包含了常见的挂载选项（如自动挂载、可执行等）。 - 最后两个
0表示不进行dump备份和不进行fsck磁盘检查。
保存并退出。下次重启系统，或者运行sudo mount -a命令，磁盘就会自动挂载到/mnt/macdisk了。
实操心得：在配置
fstab自动挂载前，务必先手动用apfs-fuse命令挂载成功一次，确保所有参数正确。一个错误的fstab条目可能导致系统无法正常启动到图形界面。如果不幸发生，可以进入恢复模式或使用Live USB来修正/etc/fstab文件。
4. 进阶配置与疑难排错实录
即使按照标准步骤操作，你也可能会遇到一些问题。下面是我在实践中总结的几个常见场景和解决方案。
4.1 权限问题与用户映射
这是最常见的问题之一。即使使用了allow_other选项，你可能会发现挂载点里的文件所有者是root，或者你的用户无法写入（如果驱动支持写操作）。
问题表现：ls -l显示文件所有者为root，你无法修改或删除文件。解决方案：在挂载时使用uid和gid选项，将文件所有权映射到当前用户。
首先，查看你的用户ID和组ID：
id -u # 显示用户ID，比如 1000 id -g # 显示主组ID，比如 1000然后，在挂载命令中加入这些参数：
sudo apfs-fuse -o allow_other,uid=1000,gid=1000 /dev/sda2 /mnt/macdisk对应的/etc/fstab条目可以修改为：
UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx /mnt/macdisk apfs-fuse allow_other,uid=1000,gid=1000,defaults 0 04.2 只读挂载与写入支持
默认情况下，出于安全考虑，apfs-fuse可能以只读模式挂载。如果你需要写入文件，必须确保：
- 你使用的
apfs-fuse版本支持写入功能。可以查看项目的GitHub Release说明。 - 在挂载时明确启用写入。
启用写入的挂载命令：
sudo apfs-fuse -o allow_other,rw /dev/sda2 /mnt/macdisk重要警告：对APFS磁盘进行写入操作仍被视为实验性功能。在进行任何写操作（包括删除）之前，请务必对重要数据做好备份！写入支持可能不完善，存在损坏文件系统的风险。
4.3 处理加密的APFS卷
如果你的APFS磁盘在macOS上启用了FileVault加密，那么在Linux上挂载时会遇到障碍。apfs-fuse目前对加密卷的支持有限。
现象：挂载命令成功执行，但挂载点目录为空或无法访问。尝试方案：
- 在macOS上先解密：这是最安全可靠的方法。将磁盘插回macOS，确保已解锁并解密，然后安全弹出。有时这样操作后，再插到Linux上就能以非加密形式识别了（但这取决于加密类型）。
- 查阅驱动文档：极少数情况下，新版本的
apfs-fuse可能提供了实验性的加密支持，可能需要额外的命令行参数来提供密码。请务必仔细阅读你所使用版本的官方文档。
对于加密卷，如果没有官方支持的稳定方案，在Linux上直接挂载的成功率很低。数据迁移的需求，建议通过网络共享（SMB/AFP）或使用中间格式的磁盘（如exFAT）来解决。
4.4 常见错误与排查命令
下面是一个快速排查表，帮助你定位问题：
| 问题现象 | 可能原因 | 排查命令与解决方案 |
|---|---|---|
| 命令未找到 | apfs-fuse未安装或不在PATH | which apfs-fuse； 确保已执行sudo cp到/usr/local/bin或将其路径加入PATH。 |
| 挂载失败，报权限错误 | 无sudo权限或FUSE模块未加载 | 1. 确保命令前有sudo。2. 检查FUSE模块：`lsmod |
| 挂载点不为空 | 选择的挂载点目录已存在文件 | 选择一个空目录，或使用-o nonempty选项（不推荐，有风险）。 |
| 设备忙或资源不可用 | 磁盘或分区已被系统或其他进程占用 | sudo lsof /dev/sda2查看哪个进程占用，并结束它。或尝试重启后直接挂载。 |
| 挂载后文件乱码/无法访问 | 字符编码问题或驱动兼容性问题 | 尝试指定编码挂载：-o codepage=utf8,iocharset=utf8。更新apfs-fuse到最新版本。 |
| 性能极慢 | FUSE开销或驱动优化问题 | 考虑使用-o big_writes等性能选项。对于大量文件传输，耐心是美德，或考虑内核方案。 |
一个关键的诊断习惯：在执行任何sudo挂载命令后，立即查看系统日志，它能提供最详细的错误信息：
sudo dmesg | tail -20 # 或使用 journalctl sudo journalctl -xe --since "1 minute ago"5. 备选方案与长期维护建议
虽然apfs-fuse是当前的最佳平衡选择，但了解其他可能性有助于你应对更复杂的情况。
方案A：使用商业软件（如Paragon APFS for Linux）有一些商业公司提供了Linux内核级的APFS驱动，通常以DKMS模块的形式提供，性能更好，功能更全（包括写入和加密支持）。它们可能提供免费试用或需要付费购买。如果你在企业环境中需要稳定可靠的双向读写支持，这是一个值得考虑的选项。安装过程通常提供.deb或.rpm包，相对简便。
方案B：在虚拟机中访问如果你已经安装了VirtualBox或VMware，并且宿主机是Linux，可以在虚拟机中运行一个macOS系统。将物理APFS磁盘直接挂载给macOS虚拟机，这是兼容性100%完美的方案，但资源消耗最大。
长期维护建议：
- 关注项目动态：在GitHub上Star
sgan81/apfs-fuse项目，关注其Release更新。APFS格式本身也在演进，驱动需要持续更新以保持兼容。 - 谨慎对待系统升级：尤其是涉及内核版本升级时（如从Ubuntu 22.04 LTS升级到24.04 LTS），在升级后要重新测试APFS挂载功能。如果是从源码编译的
apfs-fuse，可能需要重新编译。 - 建立数据迁移规范：对于经常需要在macOS和Linux间交换的数据，可以考虑专门使用exFAT或FAT32格式的磁盘（两者在两大系统上都有良好的原生支持），或者利用网络共享（SMB/NFS），将APFS磁盘仅作为macOS的备份或归档盘使用。
最后，分享一个我个人的小技巧：我习惯在~/.bashrc或~/.zshrc里为常用的APFS磁盘挂载命令设置别名。比如：
alias mount-mac-backup='sudo apfs-fuse -o allow_other,uid=$(id -u),gid=$(id -g) /dev/disk/by-uuid/YOUR-UUID-HERE /mnt/macbackup'这样，每次需要连接我的Mac备份硬盘时，只需要在终端输入mount-mac-backup并输入密码即可，非常高效。技术工具的价值，最终体现在它如何无缝地融入并优化我们的工作流之中。
