一张卡带的临终告别Switch 备份工具 nxdumptool 的完整上手指南【免费下载链接】nxdumptoolGenerates XCI/NSP/HFS0/ExeFS/RomFS/Certificate/Ticket dumps from Nintendo Switch gamecards and installed SD/eMMC titles.项目地址: https://gitcode.com/gh_mirrors/nx/nxdumptoolnxdumptool 是一款专为 Nintendo Switch 设计的开源备份工具它能从游戏卡带和已安装的 SD/eMMC 存储中生成 XCI、NSP、HFS0、ExeFS、RomFS、证书与票证等多种格式的完整备份。如果你担心实体卡带损坏、数字游戏下架或者想做合法的游戏数据归档它就是给游戏数据上双保险的那把钥匙。从一次惨痛经历说起先说一个真实的故事。一位朋友收藏了多年的《塞尔达传说》实体卡带某天从包里掏出来时金手指已经氧化得没法读盘。那一刻他意识到手里这盘传家宝其实只是一块随时可能报废的塑料。而数字版游戏也没好到哪去——商店下架、服务器关闭都意味着你花钱买的东西可能在某天清晨消失。于是问题变成了如何在游戏还能正常读取时给它做一份全尸级别的备份nxdumptool 就是为这个问题而生的。它不是一个一键复制文件的简单脚本而是一套能读懂 Switch 存储结构、绕过系统限制、把数据原样抠出来的完整方案。接下来我带你从零开始把它跑起来再一步步讲清楚每种备份该怎么用。第一步先让最小示例跑起来别急着研究功能先让工具能在你的机器上编译通过建立它能用的信念感。获取源码克隆项目仓库git clone https://gitcode.com/gh_mirrors/nx/nxdumptool准备环境nxdumptool 需要 devkitPro 工具链含 libnx并设置环境变量DEVKITPRO。如果你经常编译 Switch 自制程序这套环境应该已经有了。编译进入项目目录后直接执行makeMakefile 会自动编译 libs/ 下的依赖库libnxtc、libusbhsfs最终生成nxdumptool.nro。部署把生成的.nro文件复制到 SD 卡的/switch/nxdumptool/目录从自制程序启动器进入即可。 注意当前仓库是 nxdumptool 的 rewrite 重写分支版本号 2.0.0官方定位是实验性但经过充分测试。遇到个别场景跑不通时可以尝试该分支提供的 PoC 概念验证构建。在动手备份前先看懂它到底能导出什么很多新手卡在第一步是因为分不清这些格式到底对应什么。其实 nxdumptool 的全部能力可以归成一张表备份对象输出格式一句话说明游戏卡带整体XCI卡带完整镜像最常见的全量备份已安装游戏NSP数字版打包备份也可来自卡带内的游戏卡带分区Hash FSHFS0卡带内部文件系统的原始/解包导出游戏内部文件ExeFS / RomFSNCA 内部文件系统提取认证数据Certificate / Ticket卡带证书、数字版票证元数据NCA / NPDM / NACP单个内容归档或程序元数据再加上卡带头部、InitialData、CardIdSet、Lotus ASIC 固件LAFW等进阶导出项你会发现它不是在复制游戏而是在拆解整张卡带。卡带还是数字先选好你的备份路径动手前先明确目标因为两条路径的入口完全不同对比维度实体卡带已安装数字游戏入口Gamecard 选项卡Titles 选项卡主备份格式XCINSP是否含卡带专属数据是证书、头部等否可批量操作单卡处理支持批量排队导出适合人群卡带收藏党数字游戏重度用户选定路径后下面的场景可以直接照着做。场景一实体卡带收藏保护问题实体卡带随时可能物理损坏需要一份完整的数字镜像。方案使用 XCI 全量镜像备份。进入 Gamecard 选项卡工具会自动识别卡带并显示版本、容量、捆绑更新版本等属性。选择Dump gamecard image (XCI)后有几个选项值得你逐个确认Prepend KeyArea把 4 KiB 的 KeyArea 块附加到 XCI 前部生成完整 XCI。默认关闭追求兼容性可以打开。Keep certificate保留卡带证书用于唯一标识每张卡带。出于隐私考虑默认关闭。Trim dump去掉最后一个 HFS 分区之后的填充数据显著缩小文件体积。Calculate checksum计算 CRC32 校验和建议保持开启如果联网还可以让工具通过公开接口反向查重验证你备份的卡带是否已被他人 dump 过这正是很多存档验证数据库的比对依据。结果一张 16GB 卡带经过 trim 后通常能省下 1~2GB 空间且备份文件带校验和可放心长期保存。场景二数字游戏归档与批量备份问题数字版游戏依赖任天堂服务器存在下架与停服风险。方案用 NSP 格式归档已安装游戏。在 Titles 选项卡选中目标游戏后选择 NSP dump。这里藏着 nxdumptool 最懂行的特性Control.nacp 补丁。它能在打包时替你改写游戏的运行限制——比如解除截图/录像禁用、取消账号绑定要求、关闭 HDCP 限制。简单说备份下来的 NSP 甚至可以当作一份去限制化的存档。如果你数字库很大工具还支持批量排队导出bulk queued NSP dumping把多个游戏加入队列一次跑完中途某个游戏出错不会中断整个任务。结果你的整个数字游戏库变成一堆可以随时重装、不受服务器状态影响的本地文件。场景三大文件备份的正确姿势——USB 直连 PC问题XCI/NSP 动辄十几 GB写进 SD 卡既慢又占空间。方案让 Switch 通过 USB 直接把数据流到 PC。nxdumptool 内置了一套 USB ABI 协议详见仓库host/目录的技术文档Switch 端选择输出存储为USB host (PC)PC 端运行主机程序即可接收数据流。这套方案的好处是Switch 只负责读PC 只负责存大文件传输既不用经过 SD 卡中转也不受 FAT 单文件 4GB 上限困扰。PC 端配置要点Linux安装 libusb并添加一条 udev 规则idVendor057e, idProduct3000后执行sudo udevadm control --reload-rules。Windows用 Zadig 给设备安装 libusbK 驱动再运行host/目录下的 Python 主机端脚本依赖见requirements-win32.txt。顺带一提工具还通过 libusbhsfs 支持 USB 移动硬盘/优盘FAT、NTFS、EXT 均可用存储不够时插一块硬盘就是扩容方案。常见报错与排查思路备份路上你会遇到几个教科书级的坑先记下来遇事不慌报错现象原因处理方式提示nogc 补丁已启用自制固件禁用了卡带读取关闭 nogc 补丁注意这可能会触发 LAFW 固件更新提示需要更新 LAFW卡带要求的 Lotus ASIC 固件版本过低用该卡带在官方系统更新一次主机再试提示插入了 Switch 2 卡带当前版本不支持 T2 卡带取出更换 Switch 1 或 Switch 2 Edition 卡带提示文件大小超过可用空间目标存储剩余空间不足换输出存储或开启 XCI Trim 选项文件名出现大量下划线非法字符被自动替换SD 卡还只保留 ASCII这是正常机制可自定义 Filename 避免如果怀疑是程序问题项目在romfs/logs/保留了日志提交 issue 时附上日志能大幅提高排查效率。进阶技巧让备份又快又稳超频加速配置项overclock默认开启会在 dump 期间对 CPU 与内存超频以提升速度官方认为这相对安全如果你用 sys-clk 给程序配了专用时钟档位它会自动让路。命名规范naming_convention支持两种输出命名——完整版{名称} [{ID}][v{版本}][{类型}]或仅{ID}_v{版本}_{类型}。追求可读性选前者追求文件系统兼容性选后者。直接改默认配置所有默认参数都集中在romfs/default_config.json比如 NSP 的remove_console_data去除控制台绑定数据和enable_screenshots允许截图等在改 UI 前可以先看看这份文件理解每个开关的语义。想深入了解实现推荐按source/core核心备份逻辑→source/tasks后台任务→source/views基于 borealis 的界面的顺序读源码模块划分非常清晰。写在最后回到开头那个朋友的故事他后来用 nxdumptool 给全柜子的卡带都做了 XCI 备份连卡带头部和证书都没落下。备份不是折腾而是给多年收藏上的一道保险。无论你是担心卡带老化的收藏党、怕游戏下架的数字党还是想研究 Switch 文件系统的技术爱好者nxdumptool 都值得放进你的工具箱。它免费、开源、格式覆盖全面而且重写分支正在快速迭代——下一个版本可能就会带来你想要的特性。动手跑一次make你的备份之旅就开始了。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
一张卡带的临终告别：Switch 备份工具 nxdumptool 的完整上手指南
一张卡带的临终告别Switch 备份工具 nxdumptool 的完整上手指南【免费下载链接】nxdumptoolGenerates XCI/NSP/HFS0/ExeFS/RomFS/Certificate/Ticket dumps from Nintendo Switch gamecards and installed SD/eMMC titles.项目地址: https://gitcode.com/gh_mirrors/nx/nxdumptoolnxdumptool 是一款专为 Nintendo Switch 设计的开源备份工具它能从游戏卡带和已安装的 SD/eMMC 存储中生成 XCI、NSP、HFS0、ExeFS、RomFS、证书与票证等多种格式的完整备份。如果你担心实体卡带损坏、数字游戏下架或者想做合法的游戏数据归档它就是给游戏数据上双保险的那把钥匙。从一次惨痛经历说起先说一个真实的故事。一位朋友收藏了多年的《塞尔达传说》实体卡带某天从包里掏出来时金手指已经氧化得没法读盘。那一刻他意识到手里这盘传家宝其实只是一块随时可能报废的塑料。而数字版游戏也没好到哪去——商店下架、服务器关闭都意味着你花钱买的东西可能在某天清晨消失。于是问题变成了如何在游戏还能正常读取时给它做一份全尸级别的备份nxdumptool 就是为这个问题而生的。它不是一个一键复制文件的简单脚本而是一套能读懂 Switch 存储结构、绕过系统限制、把数据原样抠出来的完整方案。接下来我带你从零开始把它跑起来再一步步讲清楚每种备份该怎么用。第一步先让最小示例跑起来别急着研究功能先让工具能在你的机器上编译通过建立它能用的信念感。获取源码克隆项目仓库git clone https://gitcode.com/gh_mirrors/nx/nxdumptool准备环境nxdumptool 需要 devkitPro 工具链含 libnx并设置环境变量DEVKITPRO。如果你经常编译 Switch 自制程序这套环境应该已经有了。编译进入项目目录后直接执行makeMakefile 会自动编译 libs/ 下的依赖库libnxtc、libusbhsfs最终生成nxdumptool.nro。部署把生成的.nro文件复制到 SD 卡的/switch/nxdumptool/目录从自制程序启动器进入即可。 注意当前仓库是 nxdumptool 的 rewrite 重写分支版本号 2.0.0官方定位是实验性但经过充分测试。遇到个别场景跑不通时可以尝试该分支提供的 PoC 概念验证构建。在动手备份前先看懂它到底能导出什么很多新手卡在第一步是因为分不清这些格式到底对应什么。其实 nxdumptool 的全部能力可以归成一张表备份对象输出格式一句话说明游戏卡带整体XCI卡带完整镜像最常见的全量备份已安装游戏NSP数字版打包备份也可来自卡带内的游戏卡带分区Hash FSHFS0卡带内部文件系统的原始/解包导出游戏内部文件ExeFS / RomFSNCA 内部文件系统提取认证数据Certificate / Ticket卡带证书、数字版票证元数据NCA / NPDM / NACP单个内容归档或程序元数据再加上卡带头部、InitialData、CardIdSet、Lotus ASIC 固件LAFW等进阶导出项你会发现它不是在复制游戏而是在拆解整张卡带。卡带还是数字先选好你的备份路径动手前先明确目标因为两条路径的入口完全不同对比维度实体卡带已安装数字游戏入口Gamecard 选项卡Titles 选项卡主备份格式XCINSP是否含卡带专属数据是证书、头部等否可批量操作单卡处理支持批量排队导出适合人群卡带收藏党数字游戏重度用户选定路径后下面的场景可以直接照着做。场景一实体卡带收藏保护问题实体卡带随时可能物理损坏需要一份完整的数字镜像。方案使用 XCI 全量镜像备份。进入 Gamecard 选项卡工具会自动识别卡带并显示版本、容量、捆绑更新版本等属性。选择Dump gamecard image (XCI)后有几个选项值得你逐个确认Prepend KeyArea把 4 KiB 的 KeyArea 块附加到 XCI 前部生成完整 XCI。默认关闭追求兼容性可以打开。Keep certificate保留卡带证书用于唯一标识每张卡带。出于隐私考虑默认关闭。Trim dump去掉最后一个 HFS 分区之后的填充数据显著缩小文件体积。Calculate checksum计算 CRC32 校验和建议保持开启如果联网还可以让工具通过公开接口反向查重验证你备份的卡带是否已被他人 dump 过这正是很多存档验证数据库的比对依据。结果一张 16GB 卡带经过 trim 后通常能省下 1~2GB 空间且备份文件带校验和可放心长期保存。场景二数字游戏归档与批量备份问题数字版游戏依赖任天堂服务器存在下架与停服风险。方案用 NSP 格式归档已安装游戏。在 Titles 选项卡选中目标游戏后选择 NSP dump。这里藏着 nxdumptool 最懂行的特性Control.nacp 补丁。它能在打包时替你改写游戏的运行限制——比如解除截图/录像禁用、取消账号绑定要求、关闭 HDCP 限制。简单说备份下来的 NSP 甚至可以当作一份去限制化的存档。如果你数字库很大工具还支持批量排队导出bulk queued NSP dumping把多个游戏加入队列一次跑完中途某个游戏出错不会中断整个任务。结果你的整个数字游戏库变成一堆可以随时重装、不受服务器状态影响的本地文件。场景三大文件备份的正确姿势——USB 直连 PC问题XCI/NSP 动辄十几 GB写进 SD 卡既慢又占空间。方案让 Switch 通过 USB 直接把数据流到 PC。nxdumptool 内置了一套 USB ABI 协议详见仓库host/目录的技术文档Switch 端选择输出存储为USB host (PC)PC 端运行主机程序即可接收数据流。这套方案的好处是Switch 只负责读PC 只负责存大文件传输既不用经过 SD 卡中转也不受 FAT 单文件 4GB 上限困扰。PC 端配置要点Linux安装 libusb并添加一条 udev 规则idVendor057e, idProduct3000后执行sudo udevadm control --reload-rules。Windows用 Zadig 给设备安装 libusbK 驱动再运行host/目录下的 Python 主机端脚本依赖见requirements-win32.txt。顺带一提工具还通过 libusbhsfs 支持 USB 移动硬盘/优盘FAT、NTFS、EXT 均可用存储不够时插一块硬盘就是扩容方案。常见报错与排查思路备份路上你会遇到几个教科书级的坑先记下来遇事不慌报错现象原因处理方式提示nogc 补丁已启用自制固件禁用了卡带读取关闭 nogc 补丁注意这可能会触发 LAFW 固件更新提示需要更新 LAFW卡带要求的 Lotus ASIC 固件版本过低用该卡带在官方系统更新一次主机再试提示插入了 Switch 2 卡带当前版本不支持 T2 卡带取出更换 Switch 1 或 Switch 2 Edition 卡带提示文件大小超过可用空间目标存储剩余空间不足换输出存储或开启 XCI Trim 选项文件名出现大量下划线非法字符被自动替换SD 卡还只保留 ASCII这是正常机制可自定义 Filename 避免如果怀疑是程序问题项目在romfs/logs/保留了日志提交 issue 时附上日志能大幅提高排查效率。进阶技巧让备份又快又稳超频加速配置项overclock默认开启会在 dump 期间对 CPU 与内存超频以提升速度官方认为这相对安全如果你用 sys-clk 给程序配了专用时钟档位它会自动让路。命名规范naming_convention支持两种输出命名——完整版{名称} [{ID}][v{版本}][{类型}]或仅{ID}_v{版本}_{类型}。追求可读性选前者追求文件系统兼容性选后者。直接改默认配置所有默认参数都集中在romfs/default_config.json比如 NSP 的remove_console_data去除控制台绑定数据和enable_screenshots允许截图等在改 UI 前可以先看看这份文件理解每个开关的语义。想深入了解实现推荐按source/core核心备份逻辑→source/tasks后台任务→source/views基于 borealis 的界面的顺序读源码模块划分非常清晰。写在最后回到开头那个朋友的故事他后来用 nxdumptool 给全柜子的卡带都做了 XCI 备份连卡带头部和证书都没落下。备份不是折腾而是给多年收藏上的一道保险。无论你是担心卡带老化的收藏党、怕游戏下架的数字党还是想研究 Switch 文件系统的技术爱好者nxdumptool 都值得放进你的工具箱。它免费、开源、格式覆盖全面而且重写分支正在快速迭代——下一个版本可能就会带来你想要的特性。动手跑一次make你的备份之旅就开始了。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
