1. 项目缘起：为什么Xavier AGX需要扩展/home？

手头这台NVIDIA Jetson AGX Xavier开发套件，性能确实没得说，但用久了就会发现一个尴尬的问题：自带的32GB eMMC存储空间，在装完JetPack系统、配好开发环境、再跑几个深度学习模型之后，基本就所剩无几了。特别是/home目录，作为用户文件、代码仓库、数据集和模型权重的默认存放地，空间告急是家常便饭。每次编译大型工程或者下载数据集，都得小心翼翼地清理临时文件，这种“带着镣铐跳舞”的感觉严重影响了开发效率。

于是，给这台“性能猛兽”加装一块大容量固态硬盘（SSD），并将/home目录迁移或扩展到新硬盘上，就成了一个非常实际且迫切的需求。这不仅仅是增加存储空间那么简单，更是将高速的NVMe SSD性能真正赋能给日常开发工作流的关键一步。想象一下，你的代码编译、模型训练的数据读取速度都能得到显著提升，那种流畅感是eMMC无法比拟的。

网络上相关的讨论很多，从“如何在固态硬盘上装Ubuntu双系统”到各种“Linux磁盘分区和挂载”的教程，都说明了这是嵌入式开发和边缘计算玩家的共同痛点。但针对Xavier AGX这个特定平台，尤其是其ARM架构和独特的硬件接口，很多通用教程里的细节并不完全适用，直接照搬很容易踩坑。比如，如何确认主板上的M.2接口兼容性？如何在ARM架构的Ubuntu系统下正确分区格式化？又如何安全地将/home目录“搬家”而不影响现有系统？本文将结合我自己的实操经验，为你提供一个从硬件安装到软件配置的完整指南。

2. 硬件准备与选型：为Xavier AGX挑选合适的SSD

给Xavier AGX加装SSD，第一步是硬件选型。这看似简单，实则有几个关键点需要特别注意，选错了可能无法识别甚至损坏设备。

2.1 接口与规格确认

NVIDIA Jetson AGX Xavier开发套件提供了一个M.2 Key M接口，专门用于连接NVMe PCIe SSD。这里有一个至关重要的细节：它仅支持PCIe 3.0 x4通道的NVMe SSD，不支持SATA协议的M.2 SSD。如果你手头有一块闲置的SATA M.2 SSD（比如金士顿A400系列的一些型号），那么很遗憾，它无法在Xavier AGX上使用。在购买前，务必确认SSD的规格是“NVMe PCIe”，而不是“SATA”。

尺寸方面，标准的2280规格（22mm宽，80mm长）是最常见且兼容性最好的。虽然有些教程提到可能支持2242或2260，但为了确保固定的螺丝孔位能对上，强烈建议选择2280规格。

2.2 性能与容量考量

对于Xavier AGX这样的边缘AI平台，SSD的性能瓶颈往往不在于顺序读写，而在于4K随机读写性能，这直接影响着系统启动、应用加载和大量小文件操作的流畅度。因此，在选择时，除了关注顺序读写速度（如2000MB/s以上），更应该留意产品规格表中的随机读写IOPS值。

容量方面，取决于你的需求。如果只是扩展/home存放代码和中小型数据集，512GB或1TB是性价比之选。如果需要存放大型视觉数据集（如COCO、ImageNet）或训练多个模型，那么直接上2TB会更从容。考虑到NVMe SSD价格已相当亲民，建议至少从1TB起步。

实操心得：我最初尝试了一块某品牌的PCIe 4.0 SSD，虽然理论上向下兼容PCIe 3.0，但在Xavier AGX上偶尔会出现识别不稳定或睡眠唤醒后丢失的情况。后来换成了明确标注支持PCIe 3.0的主流品牌型号（如西部数据SN750、三星970 EVO Plus等），就再没出过问题。所以，优先选择经过社区验证或大厂出品的PCIe 3.0 NVMe SSD更为稳妥。

2.3 安装前的物理准备

1. 断电与防静电：务必关闭Xavier AGX电源，并拔掉所有连接线，包括电源适配器。操作前触摸一下接地的金属物体释放静电，避免损坏精密的电子元件。
2. 拆卸底盖：Xavier AGX的底部由几颗十字螺丝固定。使用合适的螺丝刀将其全部拧下，小心地揭开底盖。你会看到主板，M.2插槽通常位于主板中央或一侧，有一个明显的缺口。
3. 安装SSD：将NVMe SSD以约30度角插入M.2插槽（金手指对齐缺口），然后轻轻向下按压，使SSD平贴在主板的散热垫或支架上，最后使用附带的螺丝（通常固定在主板或包装内）将SSD尾部固定。确保螺丝拧紧，但力度要适中，避免滑丝。
4. 复原与通电：装回底盖，拧紧螺丝。先不要急着上电，检查一遍所有连接线是否都已接回。

注意：有些Xavier AGX套件可能自带了散热片或导热垫。如果SSD本身不带散热片，确保SSD的主控芯片区域与主板上的导热材料有良好接触，这对长时间高负载运行的稳定性很重要。

3. 系统识别与磁盘分区

硬件安装妥当后，接下来就是让系统识别这块新硬盘。这个过程在Linux下非常标准，但对于不常操作磁盘的用户来说，每一步都需要谨慎。

3.1 确认磁盘已被识别

首先，给Xavier AGX上电并进入系统。打开一个终端，使用lsblk或fdisk -l命令来查看所有块设备。

sudo fdisk -l

你应该能看到类似如下的输出，除了原有的/dev/mmcblk0（eMMC）外，多出了一个/dev/nvme0n1的设备（具体名称可能因SSD型号略有不同，但前缀通常是nvme）。

Disk /dev/nvme0n1: 931.5 GiB, 1000204886016 bytes, 1953525168 sectors Disk model: Samsung SSD 970 EVO Plus 1TB Units: sectors of 1 * 512 = 512 bytes Sector size (logical/physical): 512 bytes / 512 bytes I/O size (minimum/optimal): 512 bytes / 512 bytes

看到这个，恭喜你，硬件安装和基础识别成功了。/dev/nvme0n1就是你的新SSD。如果没看到，请重新检查硬件连接，并确认SSD型号是否兼容。

3.2 使用fdisk进行分区

接下来，我们需要在这块空白磁盘上创建一个分区。这里我们计划创建一个单独的分区来承载整个/home。使用fdisk工具进行操作：

sudo fdisk /dev/nvme0n1

进入fdisk的交互式命令行后，按照以下步骤操作（Command后的字母需要输入并回车）：

1. 输入n创建新分区。
2. 选择分区类型，直接回车选择默认的p(主分区)。因为我们只创建一个分区，主分区即可。
3. 分区号，直接回车选择默认的1。
4. 第一个扇区，直接回车从默认的起始位置开始（通常是2048）。
5. 最后一个扇区，直接回车选择默认的结束位置（即使用整个磁盘）。如果你想只使用部分空间，可以输入类似+500G的格式。
6. 输入p打印分区表，确认分区信息是否正确。你应该看到类似/dev/nvme0n1p1的分区被创建。
7. 关键一步：输入t来更改分区类型。分区1应该已经被自动选中。然后输入83，这是“Linux”文件系统类型的十六进制代码。虽然对于ext4这不是必须的，但这是一个好习惯。
8. 最后，输入w将分区表写入磁盘并退出。这个操作是不可逆的，请务必确认前序步骤无误。

退出后，系统可能会提示需要重新读取分区表。你可以使用partprobe命令或者直接重启来让内核识别新的分区。

sudo partprobe /dev/nvme0n1

再次使用lsblk，你应该能看到新创建的分区/dev/nvme0n1p1。

3.3 格式化分区为ext4

分区创建好后，需要将其格式化为文件系统。对于Linux系统的/home目录，ext4是最通用、最稳定且性能良好的选择。使用mkfs.ext4命令进行格式化：

sudo mkfs.ext4 /dev/nvme0n1p1

这个命令会清空分区上的所有数据，请再次确认设备名是否正确。格式化过程很快，完成后你会看到文件系统创建成功的相关信息。

为什么选择ext4？相比更现代的btrfs或xfs，ext4在ARM平台上的支持最为成熟，工具链完整，且是绝大多数Linux发行版的默认选项。其日志（journaling）特性可以保证在意外断电等情况下的数据一致性，这对于开发板来说非常重要。虽然xfs在处理大文件时可能有优势，但ext4在综合性能和稳定性上依然是/home这类目录的稳妥之选。

4. 临时挂载与/home数据迁移

在将新分区正式挂载为/home之前，我们需要先将数据从旧的/home目录迁移过来。为了安全起见，我们采用“临时挂载 -> 复制数据 -> 切换挂载点”的流程。

4.1 创建临时挂载点并复制数据

首先，创建一个临时目录，用于挂载新的SSD分区：

sudo mkdir /mnt/new_home

然后，将新格式化的分区挂载到这个临时目录：

sudo mount /dev/nvme0n1p1 /mnt/new_home

现在，我们需要将当前/home目录下的所有内容（包括隐藏的配置文件）复制到新位置。确保此时没有其他用户登录，并且关闭所有图形界面程序和不必要的后台进程，以减少文件被锁定的风险。使用rsync命令进行复制，它能更好地保留文件属性、权限和符号链接：

sudo rsync -avx /home/ /mnt/new_home/

参数解释：

• -a: 归档模式，保留所有文件属性（权限、所有权、时间戳等）。
• -v: 显示详细过程。
• -x: 保持文件系统边界，不跨越其他挂载点（避免复制/proc,/sys等虚拟文件系统）。

这个过程耗时取决于你原/home目录的数据量。完成后，可以粗略检查一下数据是否完整：

sudo ls -la /mnt/new_home/

你应该能看到所有用户目录（如ubuntu）和文件都已被复制过来。

4.2 备份原/home并准备切换

在切换之前，强烈建议对原有的/home目录进行重命名备份，而不是直接删除。这样万一迁移过程出现问题，可以迅速回退。

首先，卸载临时挂载点：

sudo umount /mnt/new_home

然后，重命名当前的/home目录：

sudo mv /home /home.backup

现在，创建一个新的空/home目录：

sudo mkdir /home

5. 配置永久挂载：修改/etc/fstab

要让系统在每次启动时自动将SSD分区挂载到/home，需要编辑/etc/fstab文件。这是Linux系统中定义文件系统静态信息的核心配置文件。

5.1 获取分区的UUID

在fstab中，我们通常使用分区的UUID（全局唯一标识符）而不是设备名（如/dev/nvme0n1p1）来指定挂载目标，因为设备名可能会因硬件检测顺序变化而改变，但UUID是固定的。

使用blkid命令查看分区的UUID：

sudo blkid /dev/nvme0n1p1

输出会类似于：

/dev/nvme0n1p1: UUID="a1b2c3d4-e5f6-7890-abcd-ef1234567890" TYPE="ext4" PARTUUID="xxxx-xx"

记下UUID=后面的那串用引号括起来的字符（例如a1b2c3d4-e5f6-7890-abcd-ef1234567890）。

5.2 编辑/etc/fstab文件

使用文本编辑器（如nano或vim）以sudo权限打开/etc/fstab：

sudo nano /etc/fstab

在文件末尾添加一行新的配置：

UUID=a1b2c3d4-e5f6-7890-abcd-ef1234567890 /home ext4 defaults,nofail 0 2

让我们分解这行配置的每个字段：

1. UUID=...: 挂载的设备源，这里填入你刚才查到的UUID。
2. /home: 挂载点（mount point），即我们要挂载到的目录路径。
3. ext4: 文件系统类型。
4. defaults,nofail: 挂载选项。
   • defaults：包含了rw, suid, dev, exec, auto, nouser, async等常用选项。
   • nofail：这个选项对于Xavier AGX这类嵌入式设备尤其重要。它表示即使该设备在启动时不存在（比如你后来拔掉了SSD），系统也不会因此卡住并进入紧急恢复模式，而是会跳过它继续启动。这增加了系统的健壮性。
5. 0: dump备份工具标志。0表示该文件系统不需要被dump备份。
6. 2: 文件系统检查顺序。根文件系统/应为1，其他非根文件系统（如/home）通常设为2。表示在系统启动时，fsck工具会按顺序检查文件系统。

编辑完成后，保存并退出编辑器。

5.3 测试并应用新的挂载配置

在重启之前，先测试一下fstab配置是否正确。使用mount -a命令会尝试挂载/etc/fstab中所有未挂载的文件系统：

sudo mount -a

如果这条命令没有报错，并且使用df -h或lsblk命令能看到/dev/nvme0n1p1已经成功挂载到了/home目录，那就说明配置正确。

现在，你可以将之前备份的数据（实际上还在/home.backup里）的所有权恢复给新挂载的/home目录。因为/home是一个新挂载的空目录，你可以直接将备份目录的内容移动回来（但更安全的方式是再次用rsync从备份同步，因为/home.backup是原磁盘上的数据，移动操作很快）：

sudo rsync -avx /home.backup/ /home/

确认数据无误后，可以重启系统：

sudo reboot

重启后，使用df -h检查，你的/home目录应该已经显示为SSD的容量，并且所有用户文件都在。登录用户账户，检查桌面环境、终端配置、开发环境等是否都工作正常。

6. 疑难排查与进阶优化

即使按照步骤操作，也可能遇到一些问题。这里总结几个常见坑点及其解决方案。

6.1 挂载失败与fstab错误排查

如果系统启动后无法进入图形界面，或者通过串口登录发现/home目录是空的，很可能是/etc/fstab配置错误。此时，你可以通过以下步骤恢复：

1. 在启动菜单（如果有）或通过串口进入单用户模式/恢复模式。
2. 以root身份挂载根文件系统为可写：mount -o remount,rw /
3. 编辑/etc/fstab，检查UUID是否正确，或者暂时注释掉（在行首加#）我们添加的那一行，然后重启。这会让系统使用原来的/home（如果/home.backup还在，可以手动挂载SSD并移动数据）。
4. 使用blkid再次确认SSD分区的UUID，并检查/etc/fstab的语法（特别是逗号、空格和Tab）。

一个常见错误：在fstab中错误地使用了PARTUUID而不是UUID。blkid命令会同时输出两者，务必使用UUID=后面的那串长字符。

6.2 权限与所有权问题

数据迁移后，偶尔会出现某些文件或目录权限不对，导致特定程序无法运行。例如，你可能会遇到类似.config目录下某个配置文件权限为root，导致普通用户应用无法读取。

解决方法是在数据迁移完成后，确保/home目录及其下所有内容的所有权归对应的用户。假设你的用户名是ubuntu：

sudo chown -R ubuntu:ubuntu /home/ubuntu

-R参数表示递归处理所有子目录和文件。

6.3 性能调优与Trim支持

为了让SSD发挥最佳性能并延长寿命，可以启用定期TRIM操作。TRIM命令允许操作系统告诉SSD哪些数据块已不再使用，便于SSD主控进行垃圾回收，避免性能下降。

对于ext4文件系统，可以在挂载选项中加入discard来启用在线TRIM，但这对性能有轻微影响。更推荐的方式是使用fstrim工具定期执行。

首先，检查你的SSD和内核是否支持TRIM：

sudo hdparm -I /dev/nvme0n1 | grep -i trim

如果输出中包含“Data Set Management TRIM supported”，则支持。

然后，可以手动执行一次TRIM：

sudo fstrim -v /home

最后，配置一个每周运行的cron任务来自动执行TRIM。编辑root的crontab：

sudo crontab -e

添加一行（例如每周日凌晨3点执行）：

0 3 * * 0 /sbin/fstrim /home

6.4 空间监控与日志管理

将/home迁移到大容量SSD后，也别忘了管理。可以使用du和ncdu等工具定期查看目录大小，清理缓存和临时文件。另外，系统日志（/var/log）仍然在eMMC上，如果日志量很大，也需要定期清理或配置日志轮转（logrotate），避免占满根分区。

一个实用的命令是查看当前目录下各子目录的大小：

sudo du -sh /home/ubuntu/* | sort -hr

7. 扩展思路：更灵活的存储方案

对于更复杂的应用场景，单一的/home扩展可能还不够。这里提供两个进阶思路：

7.1 创建独立的数据分区

如果你希望将系统、用户文件和大型数据集完全分离，可以在SSD上创建多个分区。例如：

• /dev/nvme0n1p1: 挂载到/home，用于用户文件和代码。
• /dev/nvme0n1p2: 挂载到/data，专门用于存放数据集、模型文件等只读或低频写入的大文件。

这样，即使/home需要重装系统，/data里的数据也能完好无损。在/etc/fstab中为每个分区添加对应的挂载项即可。

7.2 使用LVM进行动态管理

如果你预见存储需求会频繁变化，可以考虑使用LVM（逻辑卷管理）。LVM可以在物理磁盘（PV）上创建卷组（VG），然后在卷组中动态地创建、扩展或缩小逻辑卷（LV）。这样，你无需预先精确划分分区大小，后期可以灵活调整。

例如，将整个SSD（/dev/nvme0n1）初始化为一个物理卷，加入一个卷组，然后创建一个逻辑卷并格式化为ext4，最后挂载到/home。未来如果需要扩容，只需要添加新的物理磁盘到卷组，然后扩展逻辑卷和文件系统即可，无需迁移数据。不过，LVM会引入一定的复杂性，适合对Linux存储管理比较熟悉的用户。

对于大多数Xavier AGX用户来说，本文所述的“单分区扩展/home”方案已经足够简单、稳定和高效。它直接解决了存储空间不足的核心痛点，并利用NVMe SSD的高性能提升了整体开发体验。完成这一切后，你的Xavier AGX将真正摆脱存储束缚，在边缘AI项目中大展拳脚。