nxdumptool 终极指南：3 步完成 Switch 卡带与数字游戏的完整备份-育师

nxdumptool 终极指南：3 步完成 Switch 卡带与数字游戏的完整备份

【免费下载链接】nxdumptoolGenerates XCI/NSP/HFS0/ExeFS/RomFS/Certificate/Ticket dumps from Nintendo Switch gamecards and installed SD/eMMC titles.项目地址: https://gitcode.com/gh_mirrors/nx/nxdumptool

实体卡带一旦刮伤、损坏或丢失，数百元的游戏收藏就可能就此蒸发；数字版游戏则更脆弱——面临下架、服务器调整或账号异常时，你花真金白银购买的内容随时可能无法再次访问。面对这类风险，Nintendo Switch 玩家真正需要的，是一个简单可靠的「本地数据保全」方案。nxdumptool正是为此而生的开源Switch 游戏备份工具：它能从游戏卡带与已安装的 SD/eMMC 存储中，生成 XCI、NSP、HFS0、ExeFS、RomFS、证书与票证等多种格式的完整备份，把游戏数据牢牢握回自己手里。

一张表看懂 nxdumptool 能备份什么

nxdumptool 的备份能力覆盖了卡带、数字内容和系统文件三大领域，几乎不存在死角：

备份对象	输出格式	典型用途
游戏卡带	XCI	完整卡带镜像，可选剥离证书、前置钥匙区
数字游戏	NSP	已安装游戏打包备份，支持去除主机绑定信息
票证 / 证书	Ticket / Cert	游戏验证文件独立提取
卡带分区	HFS0 / HashFS	分区原始镜像或解包文件
游戏内部文件	ExeFS / RomFS	单个 NCA 节区提取，便于分析
系统内容	原始镜像	系统更新、字体、qlaunch 等运行时转储
eMMC 存储	文件复制	拷贝受 FS 系统模块保护的隐藏文件

值得一提的是，它连多游戏合一的卡带（如 SM3DAS）都能正确识别，这也是同类工具里少见的硬实力。

三步完成首次备份：从克隆仓库到跑通全流程

整个「零基础首备」流程只需要三步，全程约 10 分钟：

获取并编译。在已配置好 Switch 开发环境的电脑上执行：
```
git clone https://gitcode.com/gh_mirrors/nx/nxdumptool cd nxdumptool make
```
部署到 Switch。将编译生成的 NRO 文件复制到 SD 卡/switch/nxdumptool/目录。
插卡开跑。启动工具，插入游戏卡带，进入 Gamecard 标签页选择 XCI 备份，等待完成即可。

小贴士：当前仓库是 rewrite 开发分支，持续集成会为每个提交自动构建产物；如果某个功能（例如特定游戏的 RomFS 转储）在正式版上失效，优先尝试本分支的 PoC 构建，往往能解决问题。

三种典型备份场景：问题、方案与操作

场景一：实体卡带收藏保护。问题在于卡带物理损坏不可逆。解决方案是生成 XCI 完整镜像，把数据从塑料载体中「解放」出来。操作：插入卡带 → Gamecard 标签 → 选择 XCI Dump → 完成后将文件转移到外部存储。

场景二：数字游戏数据保全。数字版受服务器与账号双重约束，随时有失效风险。用 NSP 备份即可获得一份可离线保存的完整包。操作：进入 Titles 功能选中目标游戏 → 选择 NSP Dump → 按需勾选参数后开始。

场景三：游戏文件分析。对开发者和数据爱好者来说，最有用的是 ExeFS / RomFS 提取。操作：通过内置的 NCA 浏览器定位目标节区 → 选择提取类型 → 把解包文件交给 PC 侧工具进一步研究。它底层用自定义 devoptab 包装器实现分区浏览，读取受保护文件时比普通文件管理器可靠得多。

关键配置项解读：按需调优备份行为

默认配置位于romfs/default_config.json，以下参数值得你重点关注：

配置项	推荐值	说明
`overclock`	开启	提升卡带读取速度，缩短备份时间
`prepend_key_area`	按需	需要保留钥匙区的完整镜像时开启
`keep_certificate`	关闭	涉及个人证书，默认剥离更安全
`calculate_checksum`/`lookup_checksum`	开启	校验备份完整性，强烈建议保留
`trim_dump`	按需	裁剪冗余数据，减小 XCI 体积
`remove_console_data`（NSP）	开启	去除主机绑定信息，提升兼容性
`enable_screenshots`等 nacp 选项	按需	通过 Control 补丁解除截图、录像、HDCP 等限制

重要提醒：备份请严格限定为自己合法拥有的游戏内容，仅用于个人存档与备份目的。

进阶玩法：USB 直连 PC 与批量队列备份

当 SD 卡空间告急时，nxdumptool 的 USB ABI 协议能让你把备份数据直接流式写入电脑，完全不占卡带机存储。host/目录提供了完整的协议规范（当前版本 1.4）与配套 Python 脚本：Windows 用户需用 Zadig 安装 libusbK 驱动，Linux 用户则要添加一条 udev 规则，之后即可在 Switch 端选择 USB 传输模式，数据会以 8 MiB 分块可靠传输到 PC。

另一项效率利器是批量 NSP 队列备份：把多个游戏一次性加入队列，工具会逐个自动处理，单个失败也不会中断整体流程，适合游戏库庞大的玩家晚间挂机备份。

常见备份失败的排查清单

现象	原因	对策
USB 传输中途超时	宿主机驱动不匹配或未处理 ZLT 终止包	换用 libusbK 驱动，并确保脚本版本与 ABI 匹配
特定游戏 RomFS 备份失败	旧版本对多层 NCA 读取支持不足	改用 rewrite 分支的 PoC 构建
卡带读取明显偏慢	未开启超频选项	在配置中打开`overclock`
数字游戏备份报错	票据或主机绑定数据异常	检查`remove_console_data`等 NSP 选项
备份文件校验不通过	存储介质异常或中断	开启 checksum 校验后重新备份

深入一点：读懂它的工程结构

想二次开发或排查问题，可以顺着这几个目录入手：source/core/是全部核心备份逻辑（NCA、XCI、NSP 解析与转储均在此）；source/views/是基于定制版 borealis 的界面实现；source/tasks/负责后台任务与事件驱动线程（卡带插拔监控、USB 会话等）；host/README.md则是自写 USB 宿主机实现的绝佳起点。整体模块划分清晰，接口定义严谨，适合有一定基础的同学直接上手。