NxDumpTool快速上手：一次搞定Switch卡带与数字版游戏的8类数据备份-平芜编程栈

NxDumpTool快速上手：一次搞定Switch卡带与数字版游戏的8类数据备份

【免费下载链接】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

实体卡带会磨损、数字版游戏可能因商店调整而下架，而系统里那些被保护的文件你根本拷不出来——这些损失其实都能用备份提前规避。NxDumpTool 就是这样一款专为 Nintendo Switch 设计的开源备份工具，它能把游戏卡带和已安装的 SD/eMMC 游戏完整转存为 XCI、NSP、RomFS、证书、票证等多种格式，相当于给整个游戏库加了一道保险。

三句话讲清它能做什么

输入来源	能拿到的产物	一句话说明
游戏卡带	XCI 镜像、卡带头、证书、Hash FS 分区	卡带的"整卡克隆"，含可选 KeyArea
数字版游戏	NSP 安装包、独立 Ticket、单个 NCA	把已安装游戏重新打包带回 PC
游戏内部	ExeFS、RomFS、Patch RomFS	拆开 NCA 提取文件系统内容
系统层面	系统更新包、qlaunch 等系统标题	运行时导出受保护文件

它的核心逻辑很简单：读取 → 解密/重组 → 写出。背后有事件驱动的后台线程自动监听卡带插拔，有 AES-128-CTR 加密数据的处理能力，也有针对 BucketTree 多层存储的优化，但你完全不需要理解这些——界面里每项操作都有明确的中文提示和校验环节。

四步完成首次部署

第一步：准备环境。需要一台已破解（如大气层 CFW）的 Switch 主机，一张剩余空间充足的 microSD 卡，以及一台装有 devkitPro 工具链的电脑用于编译。

第二步：获取源码。克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/nx/nxdumptool

💡 项目当前处于 rewrite 分支的积极开发阶段，代码以"概念验证（PoC）"构建的形式提供，稳定性已经过充分测试，可以放心使用。

第三步：编译。确认环境变量DEVKITPRO已设置后，在项目根目录执行：

make

编译会自动处理libs/下的依赖库（libnxtc、libusbhsfs），最终在根目录生成nxdumptool.nro文件。

第四步：部署并首次体验。把生成的.nro复制到 SD 卡的/switch/nxdumptool/目录，从相册启动。插入一张卡带，切到"Gamecard"页签，选择"Dump gamecard image (XCI)"即可开始整卡备份；"User titles"页签则对应已安装的数字游戏。建议先备份一张不重要的卡带走通全流程。

三个典型场景：从入门到实用

场景一：给实体卡带做"整卡克隆"。问题：卡带一旦损坏或遗失，实体收藏就永久损失。解决：插入卡带 → 进入 Gamecard 页签 → 选择 XCI 备份 → 将产物存到外部存储。默认会计算并校验 SHA-256 校验和，保证镜像完整性。

场景二：数字版游戏"下架前自救"。问题：数字版依赖任天堂服务器，商店下架后就无处可买。解决：在 Titles 页签选中已安装游戏 → 选择 NSP 打包 → 等待完成。NSP 备份还会顺带处理 Ticket 导出，并支持在打包时补丁掉截图、录屏、HDCP 等限制。

场景三：拆解游戏内部文件。问题：想分析 RomFS 里的资源、替换素材或研究文件结构却无从下手。解决：选中目标游戏 → 进入 NCA 浏览器 → 选择 ExeFS / RomFS / Patch RomFS 分区 → 以解包目录或原始镜像形式导出。

五个进阶玩法，按需解锁

USB 直连 PC 备份—— 适合不想频繁拔插 SD 卡的场景。host/目录下提供了完整的 USB ABI 技术文档（host/README.md）和依赖脚本，Switch 端选择 USB 模式后数据直接流向电脑。适合：大容量游戏用户。
批量队列 NSP 导出—— 在队列里一次添加多个游戏逐个处理，中途单个失败不会中断整体流程。适合：游戏库动辄几十款的重度收藏者。
eMMC 与系统分区浏览—— 借助自定义 devoptab 包装器，可以浏览并复制平时受 FS 系统模块保护的文件。适合：想研究系统文件的技术爱好者。
完整系统更新导出—— 带校验和与签名验证的系统更新包备份，升级前留底更安心。适合：经常折腾固件的老玩家。
深度卡带解剖—— 卡带头、证书、InitialData、CardInfo、LAFW 固件等独立区域均可单独导出。适合：数据保全爱好者和逆向研究者。

高频踩坑问答

问：插入卡带后提示"nogc 补丁已启用"，什么都做不了？现象：Gamecard 页签只显示错误提示。原因：CFW 开启了禁用卡带读取的 nogc 补丁。解法：在 CFW 设置里关闭该补丁后重启（注意：这会更新过时的 Lotus ASIC 固件）。

问：备份到一半失败？现象：任务中断且日志有 I/O 报错。原因：最常见是 SD 卡空间不足或卡带接触不良。解法：先确认目标分区剩余空间，再取出卡带清洁金手指后重新插入重试。

问：USB 连不上电脑？现象：Switch 显示"未连接 USB host"。原因：PC 端缺少 USB 驱动或 udev 规则。解法：Windows 用 Zadig 安装 libusbK 驱动；Linux 按host/README.md添加 udev 规则后执行udevadm control --reload-rules。

问：升级系统后游戏备份报校验失败？现象：NSP 打包后校验和不匹配。原因：标题缓存过期。解法：在 Options 页签执行"Wipe local title cache"清空本地缓存后重载应用。

延伸资源与下一步

核心逻辑：source/core/—— 全部备份与解密实现，include/core/提供对应头文件。
界面层：source/views/与source/tasks/—— 基于定制版 borealis 的 UI 与后台任务管理。
配置模板：romfs/default_config.json—— 含超频、命名规范、压缩、校验等默认参数；界面文案在romfs/i18n/en-US/下，按 JSON 分模块维护。
二次开发：code_templates/提供了可参考的 PoC 示例（如dump_title_infos.c、nxdt_rw_poc.c），Makefile里预留了构建类型参数。